Cursus — The Answer Protocol pendiente
«TAP — A shared-world retro text adventure»: un juego de aventuras de texto
multijugador con un servidor TCP y dos clientes (uno de terminal y otro gráfico) que hablan
un protocolo descrito en un RFC propio. Proyecto en grupo de 42next, rank 05.
De dónde viene — Antes de los juegos en línea con gráficos
existían los MUD (Multi-User Dungeon): mundos hechos solo de texto
donde varios jugadores conectados por red exploraban salas, hablaban y luchaban. El primero,
MUD1, lo escribieron Roy Trubshaw y Richard Bartle en la Universidad de Essex en 1978, y
durante los 80 y 90 corrieron en servidores universitarios (el enunciado cuenta que en 1990
uno era tan adictivo que los administradores programaron «apagones» para salvar la red del
campus). Técnicamente, un MUD es un caso de manual de servidor concurrente: muchas conexiones
abiertas a la vez, un estado compartido y mensajes que hay que repartir a quien corresponda.
El otro pilar del proyecto es el formato RFC: los protocolos de Internet
(TCP, HTTP, SMTP…) se definen en documentos «Request for Comments» con una gramática formal y
palabras clave como MUST y SHOULD. Aquí te dan uno inventado, el RFC 42TAP, y hay que
cumplirlo como si fuera un estándar real, hasta el punto de que los clientes de un grupo
deben funcionar con el servidor de otro.
Qué pide
Rank: 05Lenguaje: C, C++, Rust, Go o Zig (Python prohibido)Modalidad: grupo de 2–3Versión: 1.4
- Un servidor que implementa todos los comandos y eventos del protocolo.
- Un cliente de línea de comandos.
- Un cliente gráfico con el toolkit que quieras (Qt, GTK, web…; curses no cuenta
como interfaz gráfica).
- Datos estáticos del mundo en YAML o JSON: salas, objetos y personajes.
- Una herramienta de construcción propia del lenguaje (Makefile, Cargo, módulos de Go…)
con objetivos para instalar dependencias,
run-server, run-client,
run-client-gui, lint y clean.
- Reglas globales: sockets TCP, UTF-8, un mensaje por línea terminado en
\n; seguir las normas de estilo del lenguaje con anotaciones de tipo donde se
pueda; no hace falta persistencia (el estado puede perderse al reiniciar). Usar Python es
suspenso automático.
01El protocolo: RFC 42TAP
El RFC adjunto al enunciado define un protocolo de texto con tres tipos de línea: las
órdenes del cliente (CONNECT, LOOK, MOVE,
CHAT, TAKE, DROP, INVENTORY,
TALK, ATTACK, STATUS, QUEST,
QUESTS, WHO, GROUP, QUIT), las
respuestas del servidor, que empiezan por OK o por ERR con un
código de tres cifras, y los eventos asíncronos, que empiezan por EVT.
Al conectar, el servidor saluda indicando la versión del protocolo y el cliente se identifica
con un nombre que debe ser único. Un ejemplo del propio enunciado:
S: OK hello proto=1
C: CONNECT alice
S: OK connected
C: CHAT GLOBAL Hello everyone
S: OK
S: EVT GLOBAL CHAT alice Hello everyone
La sintaxis está escrita en ABNF y los códigos de error están agrupados por
familias (2xx de nombre, 3xx de movimiento, 4xx de grupos, objetos y personajes, 9xx de
conexión). El RFC deja a propósito sin especificar el combate y las misiones: eso lo decide
cada grupo y lo justifica en el README.
Qué te obliga a aprender — A leer una especificación formal y a
implementarla sin interpretarla a tu manera. ABNF (RFC 5234) es la notación con la que se
describen la mayoría de protocolos de Internet; las palabras MUST, SHOULD y MAY tienen un
significado preciso definido en el RFC 2119. Y aparece una idea clave de cualquier protocolo
de red: un mensaje de respuesta (contesta a lo que tú pediste) no es lo mismo que un evento
(llega cuando otro jugador hace algo), y ambos viajan mezclados por la misma conexión.
02El servidor
- Carga el mundo desde YAML o JSON y valida que todas las salidas y referencias
existan.
- Responde a las órdenes mal formadas con errores conformes al protocolo.
- Sigue repartiendo mensajes aunque un cliente se desconecte en mitad de un envío, y al
desconectarse un jugador borra su estado antes de anunciar su salida.
- Objetos únicos: cada objeto existe una sola vez en el mundo; cogerlo lo quita
de la sala y soltarlo lo deja disponible para los demás. Se pueden nombrar por ID
(
item.herbs) o por nombre visible, incluidos nombres de varias palabras.
Qué te obliga a aprender — Concurrencia con estado compartido.
Varios clientes pueden intentar coger el mismo objeto a la vez y solo uno puede ganar, así que
hay que elegir un modelo: un hilo por cliente con exclusión mutua, un único hilo con
poll/epoll o un runtime asíncrono. El README pide justificar esa
elección. También obliga a tratar TCP como lo que es, un flujo de bytes y no de
mensajes: el RFC exige guardar las líneas incompletas hasta que llegue el \n y
procesar por separado varias líneas que lleguen juntas. Es el mismo problema que resolvía
get_next_line, ahora con sockets.
03El mundo, el combate y las misiones
Mínimos del mundo: al menos 8 salas conectadas formando uno o más ciclos más una
rama opcional (nada de mapas en línea recta), 3 roles distintos de personajes (por
ejemplo, conversación, quien da misiones y enemigo), 4 objetos (2 obtenibles dentro del
juego) y 2 misiones sencillas. El enunciado incluye un YAML mínimo solo para ilustrar
la estructura; el formato es libre.
Combate: los jugadores empiezan con 100 puntos de vida, los enemigos tienen vida
según su tipo, ATTACK hace daño y puede provocar contraataque,
STATUS muestra la vida, quien llega a 0 reaparece en un lugar seguro con menos
vida, y los resultados se registran y se comunican a los jugadores afectados. El sistema por
turnos, las fórmulas de daño, la iniciativa y órdenes extra como DEFEND o
FLEE los diseña el grupo.
Qué te obliga a aprender — A modelar un mundo como un grafo
(salas como nodos, salidas como aristas) y a validar datos externos antes de confiar en ellos.
Y a tomar decisiones de diseño y defenderlas: el enunciado deja huecos a propósito y la
evaluación mira tanto el código como la justificación.
04Logs del servidor
Hay que registrar conexiones y desconexiones (con hora e IP), cada orden recibida con
jugador y parámetros, cada respuesta y código de error, los cambios del mundo, el progreso de
las misiones y los posibles abusos (inundación de órdenes, conexiones muy seguidas). Formato
estructurado (se recomienda JSON), niveles INFO, WARN y ERROR, y sin penalizar el rendimiento
del servidor.
Qué te obliga a aprender — Observabilidad: un servidor que
atiende a muchos clientes no se depura con printf sueltos. Un log estructurado
se puede filtrar y analizar con herramientas, y escribirlo sin bloquear el servidor es otro
pequeño problema de concurrencia.
05Los dos clientes
- CLI: muestra los mensajes en tiempo real y sigue recibiendo eventos mientras
espera lo que escribes. Puede mandar las órdenes tal cual las define el RFC o traducir
órdenes más cómodas a paquetes del protocolo; la elección se documenta.
- GUI: muestra la sala, objetos, personajes y salidas con actualización en tiempo
real; el inventario con botones para coger y soltar; botones para todas las acciones;
contadores de jugadores en la sala y en el servidor; diálogos con personajes; y el chat
(global, sala, grupo) separado del registro de eventos.
Qué te obliga a aprender — Que un cliente de red no puede
quedarse bloqueado leyendo el teclado mientras le llegan mensajes por el socket, ni bloquear
la interfaz gráfica esperando al servidor. Hay que atender dos fuentes de entrada a la vez
(hilos, multiplexación o el bucle de eventos del toolkit). Y como los clientes deben ser
intercambiables entre grupos, cualquier «atajo» fuera del protocolo rompe la
compatibilidad.
06README y trabajo en grupo
Además de las secciones comunes, el README (en inglés) debe tener: Architecture, Protocol
Implementation (con cualquier desviación del RFC justificada), Combat System, Quest System,
World Design, Server Logging, Group Contributions, Building and Running y Testing. Todos los
miembros deben tener commits en el repositorio. El enunciado sugiere un reparto: una persona
con el servidor y el CLI, otra con la GUI y el diseño del mundo.
Puntos delicados
- Fragmentación y agrupación de TCP: un
recv puede traer media
orden o tres órdenes juntas.
- Desconexiones bruscas: escribir en un socket cerrado puede generar
SIGPIPE y tumbar todo el servidor si no se trata.
- El RFC y el enunciado no siempre coinciden: por ejemplo, el RFC dice que
WHO responde OK players=<n>, mientras que el ejemplo del
enunciado devuelve un JSON con los jugadores de la sala y el total; la sintaxis ABNF habla
de CRLF en un sitio y de LF en el resto; y el código 404 se repite
con tres significados. Hay que decidir y documentar la interpretación, como pide el
enunciado.
- Caracteres de control y límites: el RFC recomienda rechazar caracteres de
control (para evitar manipular la terminal de otros jugadores) y limitar las líneas a 1024
bytes.
- Objetos duplicados por condiciones de carrera entre dos jugadores que cogen lo
mismo a la vez.