Manual del administrador

Dejar el grupo listo

1. Añade el bot como administrador. Con este enlace Telegram ya le pide los permisos. Sin ser administrador el bot no ve los mensajes del grupo, y por lo tanto tampoco los intentos.
2. Dale permiso para borrar mensajes e invitar usuarios. Borrar: los intentos secretos (siempre en modo Topos, y en el clásico secreto), fotos enviadas al grupo por error (revelarían el lugar) y las fotos reportadas como inapropiadas. Sin ese permiso, el modo Topos se juega con los intentos a la vista, con aviso. Invitar: quien llega con un enlace de /invitar recibe del bot su propia entrada al grupo, de un solo uso.
3. Escribe /estado. El bot responde con una lista de ✅ y ❌: si es administrador, si puede borrar, cuántas personas abrieron el chat privado y cuántas fotos hay.
4. Que cada jugador escriba /start al bot por privado, una vez. Telegram no deja que un bot escriba primero, y el modo Topos funciona con mensajes privados (roles e informes). Quien no lo hizo, al pulsar «Unirme» recibe un botón que lo lleva directo.
5. Fotos. Para empezar no hacen falta: si faltan fotos del grupo, el bot usa fotos de reserva. Pero las fotos del grupo son las que dan conversación, y quien las aporta gana puntos.
6. /jugar y listo.

Una partida, paso a paso

Lo que pasa desde que alguien escribe /jugar hasta que se reparten los puntos. Los tiempos son los de serie.

1. Alguien escribe /jugar en el grupo
2. ¿El bot es administrador?

   No: muestra la lista de preparación y no abre sala.

3. ¿Hay al menos 3 fotos disponibles?las del grupo más las de reserva, si está activada

   No: «Faltan N fotos en el banco».

4. Sala abierta 90 sbotón «Unirme»; quien abrió ya está dentro

   Avisa por privado a quienes usaron /avisarme. Cada 15 s dice quién llegó; a 30 s del cierre, cuánto queda. Quien se une con menos de 10 s deja la sala en 30 s; con menos de 30 s, en 60 s. /extender suma 30 s (una vez por persona; admins, sin límite por persona). Tope: 3 min desde que se abrió, extienda quien extienda. /empezar cierra ya (quien abrió o un admin).

5. ¿Se unieron suficientes?Topos: 5 · clásico: 2

   No: «La sala se cerró». Nadie pierde nada.

6. ¿Hay 3 fotos que nadie de la sala haya visto?

   No: la sala se cierra y el bot invita por privado a aportar fotos.

7. Se elige el modosegún «Modo de juego» y cuántos son

   Topos: sobres sellados (el bot reparte los roles por privado y da 15 s para leerlos). Clásico: empieza directo.

8. Avistamiento (×3)una foto por avistamiento

   Sala de situación 15 s (sin intentos) · operativo hasta 3 min, con «✅ Listo» o /listo · en Topos, intentos por privado y mapa anónimo cada 30 s · boletines a los 30 y 90 s · el primer acierto abre un cierre de fronteras de 60 s · balance del operativo 15 s (5 s tras el último).

9. Final del modo Topos

   Interrogatorio (60 s) → veredicto con voto secreto (60 s, o menos si votan todos; vale un avistamiento más) → recuento (con empate, ganan los topos) → golpe al analista (60 s, si ganan los agentes) → revelación de roles.

10. Puntos, medallas y ranking

    Quienes jugaron valoran cada foto durante 10 minutos (👍/👎). Después se paga a quien la aportó.

11. Invitación a aportar fotospor privado, como mucho una vez al día por persona

Las fotos

Cada grupo tiene su banco de fotos. Las aportan los jugadores por privado al bot y nadie las aprueba antes: el bot comprueba lo técnico y el grupo valora el resto después de jugarlas.

Cómo entra una foto al banco

1. Un jugador manda una foto al bot, por privado
2. ¿La mandó como archivo?

   No: Telegram la comprimió y le borró la ubicación. El bot la guarda igual y pregunta dónde se tomó (📎 Ubicación o enlace de Google Maps). (Es el error más común: guía para jugadores.)

3. ¿Es una foto válida?JPEG, HEIC, AVIF, WebP o PNG · lado corto de 800 px o más · hasta 20 MB

   No: rechazada con el motivo.

4. ¿Tiene ubicación GPS?

   No: rechazada. No se puede arreglar después.

5. ¿En cuántos grupos comparte con el bot?

   Ninguno: la guarda 24 h y entra al banco del primer grupo donde escriba. Uno: va directo. Varios: el bot pregunta a cuál, con botones; una sola pregunta por tanda de fotos.

6. ¿Tiene un ban en ese grupo?

   Sí: rechazada.

7. ¿Ya está en el banco, o ya se jugó?también detecta versiones recortadas o reescaladas

   Sí: rechazada como duplicada.

8. ¿Tiene ya 50 fotos sin jugar en ese grupo?

   Sí: debe esperar a que se jueguen («Fotos pendientes por jugador»).

9. ¿Tiene más de 10 años?según la fecha de la cámara; sin fecha, se acepta

   Sí: rechazada («Antigüedad máxima de la foto»).

10. En el banco del grupo ✅el bot confirma con el país y un botón para retirarla

La vida de una foto

1. En el banco
2. Elegida para una partida
3. En juego
4. Jugada: 10 min de 👍/👎
5. Pagada a la fuente
6. Vuelve a salir para quien no la vio

Y las salidas del camino:

• Injugable si con 3 votos o más, la mitad o más marcan 👎. La fuente no cobra y la foto no vuelve a salir.
• 🚩 Inapropiada si alguien que la jugó la reporta y lo confirma: se borra del chat y su fuente recibe un ban en el grupo.
• Retirada por su fuente (/banco por privado) o por un admin (/retirarfoto). Se borra la copia.

Cómo elige el bot las fotos de una partida

1. Fotos del banco del grupo
2. ¿Alguien de la sala ya la vio?

   Sí: descartada. (Quien la aportó no cuenta: sabe dónde es y en modo Topos juega ese avistamiento como señuelo.)

3. ¿Modo clásico y la aportó alguien que juega?

   Sí: descartada, porque sabría la respuesta.

4. Orden de preferencia1. nunca jugadas · 2. de quien no juega · 3. una por fuente (de quien juega, solo una)
5. ¿Alcanzan para todos los avistamientos?

   Sí: a jugar.

6. Completa con fotos de reservasi «Fotos de reserva» está activado; si aún faltan, otras fotos de quien juega

Las fotos de reserva son fotos de calle de Mapillary, de lugares con suficiente cobertura para que sean jugables. Son comunes a todos los grupos, no tienen fuente (nadie cobra por ellas) y siguen la misma regla: nunca se repiten para quien ya las vio. El bot mantiene unas 30 disponibles. Si tu grupo solo quiere fotos propias, desactívalas en /config.

Los jugadores

Quién puede unirse a una sala

1. Pulsa «Unirme» o escribe /unirme
2. ¿Abrió alguna vez el chat privado con el bot?

   No: recibe un botón que abre el privado y lo une al volver.

3. ¿Tiene un ban en este grupo?

   Sí: no puede jugar.

4. ¿La sala está llena?de serie, 20 jugadores

   Sí: no entra.

5. ¿Está jugando en otro grupo?

   Sí: una partida a la vez.

6. Dentro ✅

   Si tiene un ban en otro grupo por contenido inapropiado, los admins reciben un aviso por privado (sin decir de qué grupo).

Durante y después

Reparto de roles

En modo Topos, el bot reparte los roles al azar al cerrar la sala. Cuántos topos hay depende de cuántos juegan:

topos · solitarios · agentes (el analista es uno de ellos). Con menos de 5 no hay modo Topos.

Qué recibe cada uno, en cada avistamiento

1. Empieza el avistamiento
2. Cada agente recibe su informeel mismo tipo toda la partida: señal interceptada (siempre alguien la tiene), latitud, forense, terreno, altitud, urbano, llamada o solar, sin repetir mientras alcancen

   Forense necesita la hora de la foto; terreno, datos de mapas. Si faltan, ese avistamiento recibe otro tipo que no tenga nadie.

3. Cada topo recibe el país real y un país señueloy mentiras ya escritas que apuntan al señuelo, de su tipo de «tapadera»

   El analista sabe qué tipo de informe tiene cada jugador (no su contenido), y así puede pillar una tapadera.

4. ¿El hacker eligió víctima en el avistamiento anterior?

   Sí: esa persona recibe un informe falso que apunta al señuelo, y nadie puede detectarlo. Sin hacker (5 o 6 jugadores), le pasa a un agente al azar en cerca de la mitad de los avistamientos, y los topos saben a quién.

5. ¿Quien aportó la foto está jugando?

   Sí: en ese avistamiento juega del lado de los topos, sin conocerlos. Sus intentos son señuelos.

6. A la sala de situación, en el grupo

Quién gana un avistamiento

Los agentes ganan el avistamiento si al menos un agente queda a menos de escala ÷ 40 del lugar real: 5 km con escala País. Si no, lo ganan los topos. Los intentos de topos y solitarios nunca cuentan como acierto. Al final, el veredicto vale un avistamiento más (para los agentes si entre los más señalados hay un topo; si no, para los topos), y gana el bando con más puntos; con empate, ganan los topos. Esa distancia se cambia en /config → Modo Topos → «Dificultad para los agentes».

/config, opción por opción

Solo los admins pueden usarlo. Cada botón pasa al valor siguiente. Quedó lo que un grupo de verdad decide: el resto (ritmo, dificultad, escala, reserva…) lo fija el diseño del juego. En negrita, el valor de serie.

Configuraciones sugeridas

Moderación

El bot no comparte datos entre grupos: cada grupo tiene sus fotos, rankings y bans. La única excepción es el aviso a admins por un ban por contenido inapropiado, que no dice de qué grupo viene.