FFLVoteBot - El recuento de votos automático para Mafias de Fanficslandia "Menos tiempo contando votos. Más tiempo llevando la partida." Durante una Mafia hay muchas cosas que controlar: habilidades, muertes, acciones nocturnas, discusiones... y entre todo eso aparece una tarea que todos los GM conocen: contar votos manualmente. Página tras página. Mensaje tras mensaje. Revisando si alguien cambió el voto. Comprobando si el voto era válido. Por eso nace FFLVoteBot. Un pequeño asistente diseñado para automatizar los recuentos de votos en las partidas de Mafia de Fanficslandia. ¿Qué hace FFLVoteBot? El bot se encarga de revisar el tema de la Mafia y detectar automáticamente los votos realizados por los jugadores. Puede reconocer: ✅ Nuevos mensajes del tema. ✅ Votos realizados por jugadores vivos. ✅ Cambios de voto. ✅ Desvotos. ✅ Votos inválidos. ✅ Jugadores eliminados. ✅ Citas de otros usuarios (para evitar falsos votos). Después genera un recuento actualizado con toda la información necesaria. Ejemplo: Y si está configurado, puede publicarlo automáticamente en el propio tema. ⚙️ ¿Cómo funciona? FFLVoteBot trabaja como un moderador auxiliar. No juega la partida. No decide votos. No interpreta acciones. Simplemente observa, ordena la información y ayuda al organizador. Su funcionamiento es: Lee el tema ↓ Busca nuevos mensajes ↓ ️ Detecta votos válidos ↓ Genera el recuento ↓ Publica la actualización ¿Qué necesita para funcionar?La instalación requiere: Python. Google Chrome. Selenium. Una cuenta de Fanficslandia con sesión iniciada. El bot utiliza una sesión guardada del navegador, por lo que no necesita iniciar sesión cada vez que funciona. Prepararlo para una partidaCada Mafia necesita solamente configurar: La URL del tema El bot debe saber qué partida está siguiendo. La lista de jugadores Se carga la lista de participantes. Los jugadores vivos El organizador actualiza quién sigue en juego. Con esos datos, el bot puede empezar a trabajar. Estado del proyecto Actualmente FFLVoteBot cuenta con: ✅ Lectura automática de temas. ✅ Memoria de mensajes revisados. ✅ Sistema de votos y desvotos. ✅ Validación de jugadores vivos. ✅ Recuento automático. ✅ Publicación automática en el foro. El proyecto sigue en desarrollo y puede seguir mejorándose con nuevas funciones.
Manual de instalación - FFLVoteBotEste mensaje explica cómo instalar y configurar FFLVoteBot para utilizarlo en una partida de Mafia de Fanficslandia. Antes de comenzar, se recomienda tener conocimientos básicos de manejo de archivos y consola de Windows. 1) Requisitos Para ejecutar FFLVoteBot necesitás: Programas: ✅ Windows ✅ Python 3 ✅ Google Chrome ✅ ChromeDriver compatible con tu versión de Chrome Librerías de Python: Abrir una consola dentro de la carpeta del bot y ejecutar: pip install selenium 2) Descargar y preparar la carpeta La carpeta del bot debe contener los siguientes archivos: FFLVoteBot/ ├── main.py ├── configuracion.py ├── lector.py ├── votos.py ├── recuento.py ├── publicador.py ├── estado.py ├── jugadores.json ├── partida.json ├── votos.json ├── estado.json └── recuento.txt No es necesario crear manualmente todos los archivos si ya vienen incluidos con el bot. 3) Primera configuración Abrir: configuracion.py URL de la partida Buscar: URL_TEMA = "" Colocar la dirección del tema de la Mafia. Ejemplo: URL_TEMA = ( "https://fanficslandia.com/tema/mafia-ejemplo.12345" ) 4) Configurar la sesión del navegador Buscar: CARPETA_PERFIL Ejemplo: CARPETA_PERFIL = ( "C:\\FFLVoteBot\\perfil_chrome" ) Esta carpeta guardará la sesión de Chrome. La primera vez que se ejecute: El bot abrirá Chrome. Iniciar sesión en Fanficslandia. Verificar que puede acceder al tema. Cerrar el navegador. Después de eso la sesión quedará guardada. 5) Crear la lista de jugadores Archivo: jugadores.json Debe contener todos los jugadores de la partida. Ejemplo: [ "Katuh", "madarauchiha", "Andysaster", "Ichiinou" ] Los nombres deben coincidir con los usuarios del foro. 6) Configurar el estado de la partida Archivo: partida.json Ejemplo: { "fase": "dia", "numero_dia": 1, "jugadores_vivos": [ "Katuh", "madarauchiha", "Andysaster", "Ichiinou" ] } Cuando un jugador muere, debe retirarse de la lista: "jugadores_vivos" Ejemplo: Antes: [ "Katuh", "madarauchiha", "Andysaster" ] Después de la muerte: [ "Katuh", "madarauchiha" ] 7) Reiniciar el bot para una nueva Mafia Si el bot ya fue utilizado anteriormente, limpiar la memoria. estado.json Debe quedar: { "url": "", "posts_leidos": [], "ultimo_recuento_publicado": 0 } votos.json Debe quedar: {} Esto evita que recuerde votos o mensajes de una partida anterior. 8) Formato de votación recomendado Para evitar errores, los jugadores deben votar así: Voto: Usuario Ejemplo: Voto: Katuh Para retirar un voto: Desvoto El bot ignora: Votos dentro de citas. Votos de jugadores muertos. Votos a jugadores eliminados. Usuarios inexistentes. 9) Ejecutar el bot Abrir una consola dentro de la carpeta: Ejemplo: C:\FFLVoteBot> Ejecutar: python main.py Si funciona correctamente aparecerá: ================================= FFLVoteBot iniciado ================================= A partir de ese momento comenzará a revisar la partida. 10) Durante la partida El organizador solamente debe mantener actualizado: partida.json Especialmente: jugadores_vivos El bot hará automáticamente: ✅ Lectura de nuevos posts. ✅ Detección de votos. ✅ Actualización del recuento. ✅ Publicación automática (si está activada). 11) Errores frecuentes El bot no inicia sesión Revisar: Ruta de CARPETA_PERFIL. Que Chrome no esté abierto usando ese mismo perfil. No cuenta un voto Revisar: Que el jugador exista en jugadores.json. Que el nombre coincida. Que el voto tenga formato: Voto: Usuario 12) Recomendaciones para GM Antes de iniciar una partida: ✅ Probar el bot en el tema. ✅ Hacer un voto de prueba. ✅ Confirmar que el recuento aparece correctamente. ✅ Revisar que la cuenta del bot pueda publicar. De momento comparto por privado el archivo con lo necesario (todos los .py y .json) para no dejar un bot de autopost libre.
Dejo el tema abierto, si alguno sabe programar en python y quiere echarle un ojo o algo para optimizar/mejorarlo son todos aceptados, la idea es que podamos hacer mafias un poco más seguido y no depender tanto de los tiempos de GM para los recuentos.
Mejora leve: Ahora si un jugador postea el comando El bot lo detectará y realizará un recuento al finalizar su lectura de todo el hilo, aún si no ha cumplido el tiempo necesario para el siguiente recuento. De igual modo el bot esta configurado para realizar una lectura del hilo cada 300 segundos, por lo que no será un recuento instantáneo.
