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

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

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

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

Fuente