Módulos centrales

Este grupo no trata de cómo se diseña una API compartida, sino de cómo funcionan realmente en código los módulos jugables principales de Croparia IF.

Si ya tienes una idea general de:

• Repo API
• Recipe API
• Network API

entonces esta sección es mejor para responder preguntas como:

• dónde está la clase de entrada principal de un módulo concreto
• cómo se conectan el bloque, la entidad de bloque, el menú, la pantalla, la receta y la red
• qué capa conviene tocar primero al cambiar comportamiento o añadir compatibilidad

Módulos cubiertos

• Transmutador de cultivos
• un módulo completo con entidad de bloque, menú, pantalla e interacción C2S
• Invernadero
  • un módulo más centrado en procesamiento automático y almacenamiento
• Infusor
  • un módulo típico de "estado de bloque + receta basada en objetos soltados"
• Atril ritual
  • un módulo impulsado por objetos soltados que depende más de validación estructural y emparejamiento de recetas
• FakePlayer
  • un pequeño componente de ejecución usado por los módulos centrales para interacción con el mundo

Orden de lectura sugerido

• Si quieres estudiar cómo colaboran GUI, menús y red, empieza por Transmutador de cultivos
• Si quieres estudiar recetas impulsadas por objetos soltados, empieza por Infusor y Atril ritual
• Si quieres ver cómo las entidades de bloque exponen almacenamiento y automatización, empieza por Invernadero

Patrones compartidos en estos módulos

Aunque estos módulos hacen cosas muy diferentes, siguen varios hábitos de diseño bastante consistentes:

• los puntos de entrada de interacción tienden a quedarse en la clase del bloque
• el estado persistente tiende a quedarse en la entidad de bloque
• las capacidades compartidas se exponen mediante APIs reutilizables en lugar de fundirse dentro de un único módulo
• los flujos complicados se separan en capas de entrada, estado, emparejamiento y salida

Así que, al leer estas páginas, lo más útil suele ser fijarse no tanto en un método concreto, sino en:

• dónde dibuja cada módulo sus límites de responsabilidad
• por qué depende de cierta API compartida
• en qué capa conviene engancharse al ampliarlo