MV Mafia Bot: Hilo oficial

Guía de uso para GM

Formulario para crear partida

El bot está alojado en un VPS personal y por ahora, lo más cómodo es que me paséis la configuración y yo lo instancio manualmente. ¿Pe-pero Dark por qué no hacerlo en una web? Porque me da pereza y porque lo suyo sería un web con soporte para mafias, pero eso queda muy lejos

Para lanzar el bot, me tenéis que mandar un MP con lo siguiente:

1. URL del hilo: Cread primero el hilo antes de escribirme.
2. GM de la partida: Encargado de abrir y cerrar el día, anunciar resoluciones.
3. Moderadores: Los coGM que vayáis a tener. Pueden ser más de 1.
4. ¿Cada cuántos mensajes queréis recuento? Se puede desactivar.
5. ¿Cada cuántos votos queréis recuento? Se puede desactivar.

Y además necesito el siguiente archivo relleno en formato CSV. Hacedlo con un editor de textos, o el excel mismamente. Yo no lo reviso en partidas en las que participo, por lo que si está mal, no os puedo ayudar.

player,can_be_voted,allowed_votes,mod_to_lynch
no_lynch,1,0,0
SamaWoodo,1,1,0

La primera línea define las columnas de un fichero separado por comas. Cada campo representa:

• player: El nombre del jugador. Intentad escribirlo correctamente puesto que aunque el bot no distingue mayúsculas, usa este campo para escribirlos correctamente. Es decir, si escribís Samawoodo en lugar de SamaWoodo, al jugador se le llamará Samawoodo en todos los mensajes del bot.

• can_be_voted: 1 si se puede votar a este jugador, 0 si no se le puede votar. Si queréis desactivar el no linchamiento, poned este campo en 0 para no_lynch.

• allowed_votes: Cuántos votos simultáneos puede poner este jugador. Los GM tienen infinitos votos por defecto, así que no los incluyáis.

• mod_to_lynch: Modifica la mayoría necesaria para linchar a este jugador. Pensad en las habilidades amado y odiado. Un odiado por ejemplo, tendría un -1, mientras que un amado, un 1. Un jugador normal tendrá un 0.

Ejemplo: 9 jugadores, todos vanilla con NL

player,can_be_voted,allowed_votes,mod_to_lynch
no_lynch,1,0,0
SamaWoodo,1,1,0
DarkRaptor,1,1,0
n3krO,1,1,0
Soraghatsu,1,1,0
Dase,1,1,0
samusamu,1,1,0
Vespers,1,1,0
Psicotropica,1,1,0
sorakabanana,1,1,0

Comandos para GM

Los GM pueden usar cualquier comando disponible para los jugadores junto a los que vamos a describir a continuación. El bot distingue 2 tipos de administradores: los GM y los moderadores.

Solo el GM puede:

1. Abrir y cerrar el día.
2. Terminar la partida.

Tanto los moderadores como el GM pueden:

1. Votar y desvotar tantas veces como quieran, sin límites. Todos sus votos aparecen como votos de GM.
2. Usar alias de voto.
3. Reemplazar jugadores.
4. Pedir recuentos.

Abrir el día

Solo el GM puede hacerlo. Esto es una decisión de diseño y eficiencia que no va a cambiarse en un futuro próximo. El bot reconoce encabezados, que se formulan en nueva línea y con un único corchete. En concreto:

# Día X
## Jugadores vivos
Texto de roleo y fluff

Esta es la estructura de un día básico. El bot considera que el día empieza cuando en el post más reciente del GM donde aparece el encabezado

# Día

CUIDADO CON LAS TILDES. Este bot es grammar nazi con los GM.

La lista de jugadores es la primera lista ordenada (numerada) que aparezca en el post donde se abre el día. Por estética y por mi real ánimo, esta lista debe tener enlaces al ISO de cada jugador. Por ejemplo:

## Jugadores vivos
1. [NOMBRE DE JUGADOR](HILO?u=NOMBRE DE JUGADOR)
1. [Sinso](https://www.mediavida.com/foro/mafia/mafia-darkraptor-tumba-horrores-659291?u=Sinso)
1. [sorakabanana](https://www.mediavida.com/foro/mafia/mafia-darkraptor-tumba-horrores-659291?u=sorakabanana)

Cerrar el día

Es exactamente igual que para abrir el día, solo que en este caso escribiremos:

# Final del día X

De nuevo, ojo a la tilde. Para el final del día no es necesario poner la lista de jugadores vivos.

Abrir y cerrar noche

Al bot se la bufa fuerte lo que se escriba una vez se cierre el día, así que podéis poner todo el texto de roleo y mensajes que queráis durante las noches. Al bot le da igual.

Cerrar la partida

Este encabezado cerrará la instancia del bot, así como los historiales y el log de errores. Para facilitarnos la vida y ahorrar recursos del VPS, cierra la partida cuando termine. Para ello:

# Final de la partida

texto de roleo, ganadores y fluff aquí abajo.

Votar y desvotar

Los GM pueden emitir tantos votos como quieran. Por ahora, cada GM/mod es responsable de sus propios votos, por lo que solo él que emite el voto puede retirarlo. Esto posiblemente cambie en el futuro.

Votar con alias

Voto: DarkRaptor como cuervo
Voto: samusamu como regla

Un voto emitido con la palabra clave como hará que el votante cambie de GM a cuervo o regla en estos casos concretos. Toda palabra es válida. A efectos de desvoto, estos votos se siguen atribuyendo al GM que los emitió, así que deberá desvotar.

Reemplazar jugadores

Reemplazar jugadores es muy sencillo y ya no hace falta que me pidáis que edite los permisos. A partir de ahora:

### Reemplazo: SamaWoodo por Vespers

Esto hará que el bot copie los permisos de SamaWoodo y añada una entrada idéntica para el jugador Vespers. Acto seguido, se eliminará al jugador de la lista interna de jugadores vivos. IMPORTANTE: Es recomendable pero no imprescindible que editéis la lista de jugadores vivos para no confundir a los jugadores.

Modkill o eliminación forzosa de jugadores

### Modkill: SamaWoodo

Esta orden elimina al jugador de la partida, dejando de procesar votos hacia su persona o solicitudes en el hilo de juego. La mayoría se reduce en 1 para acomodarse al hecho de que hay un jugador menos. Recuerda que el bot por si solo no puede desvelar el obituario de nadie, por lo que deberá ser el GM el encargado de hacerlo.

Asesinato o jugadores que ganan la partida

### Asesinato: SamaWoodo
### Ganador: TheDomicus

Esta orden elimina al jugador de la partida, dejando de procesar votos hacia su persona o solicitudes en el hilo de juego. La mayoría se reduce en 1 para acomodarse al hecho de que hay un jugador menos. Recuerda que el bot por si solo no puede desvelar el obituario de nadie, por lo que deberá ser el GM el encargado de hacerlo.

Recuentos

Hay 2 clases de recuento:

### Recuento
### Recuento hasta #523

El primer comando hará que el bot cuente desde el inicio del día hasta el último mensaje del barrido. El segundo tipo de recuento contará desde el inicio del día hasta el post que indiquéis. Realmente los corchetes para indicar el número del mensaje son accesorios, pero es bastante cómodo para saber qué mensaje estás citando tho. Los recuentos no van a la cola de mensajes del bot, sino que se postean en cuanto se resuelve la acción.

Congelar votos

### Congelar
o 
### Congelar SamaWoodo

Un jugador congelado no puede desvotar o mover el voto a otro jugador, si había votado en el momento en el que se le congela. Si no se especifica una víctima concreta, se asume que se congelan los votos de todos los jugadores vivos.

Lynch or your lose

### Lylo

En el momento en el que el bot lee la siguiente expresión, los jugadores no podrán desvotar. Es decir, los votos emitidos son permanentes hasta el final del día.

#15
Lo tienes en el GitHub. He cerrado hoy el issue. No afecta a ninguna partida en juego.

#16
No parece

Ayer actualicé el bot y fusioné con la rama master algunos cambios que ya estaban en pruebas desde el mes pasado. En resumen, ahora los GM pueden avisar al bot para que en Lylo solo se pueda votar una vez (como en los campeonatos) y los votos se pueden congelar. He modificado la documentación para reflejar los cambios.

La actualización tocha la quiero hacer en marzo, según el tiempo que tenga.

Importante

Desde ahora y hasta nuevo aviso @Sesshoumaru1 gestionará todos los aspectos relacionados con el bot. Espero que esto sea un cambio temporal y que dentro de poco pueda retomar yo esta parte. Para configurar partidas y eso, hablad con él.