📄
pasted-code-1792125144083.txt
txt
260 lines
▶
# Proyecto: MorphBody — Mod de modelos personalizados para Minecraft
## 1. Objetivo principal
Desarrollar un mod completo y funcional llamado **MorphBody** para Minecraft Java Edition 1.18.2, utilizando Minecraft Forge 40.x y Java 17.
El mod debe permitir que los jugadores utilicen modelos de personajes personalizados en tercera persona, con geometría, texturas, animaciones y proporciones propias. Debe estar inspirado en las posibilidades de Customizable Player Models (CPM), pero funcionar como un sistema independiente y tener su propio cargador de modelos.
No quiero únicamente una plantilla vacía, un ejemplo de código o un mod que registre comandos sin hacer nada. Necesito un proyecto funcional, compilable y preparado para probarse dentro de Minecraft.
## 2. Compatibilidad
- Minecraft Java Edition 1.18.2.
- Minecraft Forge 40.x.
- Java 17.
- Gradle y ForgeGradle compatibles con esa versión.
- Multijugador dedicado y juego individual.
- El servidor debe ser la autoridad para determinar qué modelo utiliza cada jugador.
Evitar APIs de versiones modernas que no existan en Minecraft 1.18.2.
## 3. Importación de modelos
El mod debe permitir importar modelos creados con Customizable Player Models.
Formato de origen principal:
- `.cpmproject`
El cargador debe analizar el contenido real del formato y no limitarse a cambiar la extensión del archivo.
Debe intentar conservar, siempre que sea técnicamente posible:
- Geometría y cubos.
- Jerarquía de grupos y partes.
- Texturas y colores.
- Transformaciones, pivotes y rotaciones.
- Partes adicionales como orejas, cuernos, alas y colas.
- Animaciones y sus keyframes.
- Escalado y proporciones del personaje.
Si el formato `.cpmproject` es un proyecto de edición y no un formato adecuado para cargar directamente durante el juego, implementar un importador o conversor utilizando las especificaciones y APIs reales de CPM.
No inventar una compatibilidad con CPM que no haya sido comprobada. Si alguna característica no puede convertirse, mostrar un aviso que identifique qué se ha omitido.
No depender del mod CPM instalado en el juego, salvo que se implemente explícitamente un adaptador opcional.
## 4. Sistema de archivos
El mod debe crear automáticamente sus carpetas y archivos de configuración al iniciarse.
Estructura propuesta:
.minecraft/
└── morphbody/
├── models/
│ └── gato/
│ ├── model.cpmproject
│ └── textures/
│ └── texture.png
├── animations/
├── cache/
├── config.json
└── README.txt
Cada subcarpeta dentro de `models` representa un modelo disponible. El nombre de la carpeta será el identificador del modelo.
El formato exacto de almacenamiento puede modificarse si es necesario, pero debe estar documentado.
Requisitos:
- Crear automáticamente las carpetas.
- No borrar archivos del usuario.
- Detectar modelos inválidos o incompletos.
- Informar errores de importación en el registro y en los mensajes del juego.
- Recargar modelos sin reiniciar el juego cuando sea posible.
- Proporcionar un ejemplo de modelo funcional y su textura.
- Incluir instrucciones para instalar nuevos modelos.
## 5. Renderizado del jugador
Reemplazar visualmente el modelo humanoide normal del jugador por el modelo seleccionado.
Debe funcionar en:
- Primera persona, según las opciones de configuración.
- Tercera persona.
- Vista de otros jugadores en multijugador.
- Animaciones normales del jugador.
- Distintos estados de movimiento.
El modelo debe sincronizarse entre servidor y clientes para que los demás jugadores vean la apariencia correcta.
Evitar renderizar dos modelos completos superpuestos. Las capas adicionales deben utilizarse únicamente para elementos que deban conservarse.
## 6. Hitbox adaptativa y posición de los ojos
Esta es una de las funciones más importantes del proyecto.
El mod debe permitir configurar dimensiones físicas para cada modelo:
- Anchura de la hitbox.
- Altura de la hitbox.
- Posición vertical de los ojos.
- Altura y dimensiones mientras el jugador está agachado.
- Dimensiones de la postura de natación o gateo, si corresponde.
Los valores físicos deben definirse explícitamente en la configuración del modelo y no calcularse únicamente a partir de la geometría visual.
Ejemplo de configuración:
{
"id": "gato",
"displayName": "Gato antropomórfico",
"hitbox": {
"width": 0.65,
"height": 1.75,
"crouchingHeight": 1.25
},
"eyeHeight": 1.55,
"crouchingEyeHeight": 1.05
}
Los valores son ilustrativos y deben poder modificarse.
La hitbox debe controlar correctamente:
- Colisiones con bloques.
- Paso por espacios estrechos.
- Detección de entidades.
- Interacción con el entorno.
- Altura al estar de pie y agachado.
La posición de los ojos debe ajustarse al modelo para que la cámara, la línea de visión y las interacciones sean coherentes.
No utilizar únicamente un cambio visual de escala: modificar la representación física y las comprobaciones correspondientes de manera compatible con Forge 1.18.2.
Si las limitaciones de Minecraft impiden actualizar una dimensión de forma segura durante una postura, implementar una solución compatible y documentar sus limitaciones.
## 7. Animaciones
Crear un sistema de animaciones que permita:
- Caminar.
- Correr.
- Saltar.
- Caer.
- Agacharse.
- Nadar.
- Permanecer quieto.
- Mover la cola y las orejas.
- Reproducir animaciones personalizadas.
Las animaciones deben respetar los pivotes, las jerarquías y las transformaciones del modelo importado.
Cuando un modelo CPM utilice características que el sistema no pueda interpretar, mostrar una advertencia en vez de fallar silenciosamente.
## 8. Comandos y permisos
Implementar comandos con validación y mensajes claros.
Comandos para jugadores autorizados:
/morphbody list
/morphbody set
/morphbody clear
/morphbody status
Comandos administrativos:
/morphbody grant
/morphbody revoke
/morphbody reload
/morphbody info
Permisos propios:
- `morphbody.use`: permite seleccionar o quitar el modelo propio.
- `morphbody.admin`: permite administrar autorizaciones, recargar modelos y consultar información administrativa.
El sistema de permisos debe ser controlado por el servidor. No confiar en que un cliente declare que tiene permisos.
Como Forge 1.18.2 no proporciona por sí solo un sistema universal de permisos para todos los servidores, implementar una solución propia persistente y documentada, con integración opcional con sistemas de permisos compatibles.
Los administradores deben poder autorizar y retirar autorizaciones de jugadores. Las autorizaciones deben persistir tras reiniciar el servidor.
## 9. Interfaz de usuario
Añadir una interfaz gráfica para:
- Ver los modelos disponibles.
- Previsualizar los personajes.
- Seleccionar un modelo.
- Consultar sus dimensiones físicas.
- Ver errores de carga.
- Recargar la lista.
La interfaz no debe permitir eludir los permisos del servidor.
## 10. Arquitectura y sincronización
Separar el proyecto en componentes independientes:
- Gestor de modelos.
- Importador CPM.
- Renderizador.
- Sistema de animaciones.
- Gestor de dimensiones físicas.
- Gestor de permisos.
- Comandos.
- Interfaz gráfica.
- Comunicación cliente-servidor.
- Configuración y persistencia.
El servidor debe validar los modelos seleccionados y enviar a los clientes los identificadores y datos necesarios para mostrarlos.
Evitar transmitir archivos completos del modelo repetidamente durante el juego. Utilizar una estrategia de carga y caché segura.
Validar los archivos de entrada y limitar dimensiones o recursos excesivos para prevenir errores de memoria y abuso.
## 11. Ejemplo incluido
Incluir un modelo inicial de gato antropomórfico creado o editable con Blockbench, con:
- Cabeza de gato.
- Orejas.
- Torso humanoide.
- Brazos y piernas.
- Cola animable.
- Textura PNG.
- Pivotes correctamente organizados.
- Configuración de hitbox y altura de ojos.
El modelo debe servir para comprobar el cargador, el renderizado y las animaciones. No debe declararse funcional hasta haber sido probado en el juego.
## 12. Entrega obligatoria
Entregar:
1. Proyecto fuente completo.
2. Archivos Gradle y wrapper compatibles.
3. Código Java organizado.
4. Recursos y configuraciones.
5. Ejemplo de modelo y textura.
6. Instrucciones de compilación e instalación.
7. Archivo JAR compilado cuando el entorno permita generarlo.
8. Lista de funciones implementadas y funciones pendientes.
9. Registro de pruebas realizadas.
10. Instrucciones para importar modelos CPM adicionales.
## 13. Pruebas de aceptación
El trabajo solo se considerará terminado cuando se compruebe que:
- El mod se inicia sin errores en Forge 1.18.2.
- Las carpetas se crean automáticamente.
- El modelo de ejemplo se carga y se muestra realmente en el jugador.
- El modelo se sincroniza en multijugador.
- Los comandos validan correctamente sus argumentos.
- Los jugadores sin autorización no pueden cambiar su modelo.
- Los permisos administrativos persisten después de reiniciar.
- La hitbox cambia según la configuración del modelo.
- La altura de los ojos y las posturas se actualizan correctamente.
- Las animaciones funcionan en el juego.
- Los errores de importación se informan claramente.
No entregar solamente clases vacías, métodos sin implementar, archivos ficticios o mensajes que afirmen que una característica funciona sin haberla probado.
Priorizar primero un flujo funcional mínimo —cargar un modelo, renderizarlo y aplicar sus dimensiones físicas— y después desarrollar el importador CPM completo.
Plan:
Create a Fabric 1.18.2 project and a safe, reloadable model-definition format.
Add server-authoritative model selection, persistent permissions, and sync.
Apply per-model dimensions/eye height and implement the renderer only where the 1.18.2 APIs support it.
Include an example model, resources, and clear import limitations.
Creé MorphBody como mod Fabric 1.18.2 con Yarn build.4 y Java 17. La especificación adjunta pedía Forge, pero este proyecto está preparado para Fabric.
Incluye selección de modelos mediante comandos, permisos persistentes por UUID, sincronización servidor-cliente, carga validada de geometría cúbica JSON, renderizado en tercera persona, animaciones básicas y dimensiones/altura de ojos configurables. El ejemplo «cat» usa la skin de cada jugador; no incluye una textura propia.
Para probar el modelo: un operador ejecuta /morphbody grant <jugador> y el jugador autorizado usa /morphbody set cat. No se añaden objetos ni bloques; los modelos se obtienen mediante autorización del servidor.
Pendiente: importar o convertir archivos CPM, texturas personalizadas, interfaz de previsualización y primera persona. Tampoco se generaron un wrapper Gradle ni un JAR, y no se verificó el proyecto dentro del juego.
Para compilarlo en Kodari: en escritorio, pulsa Compile en la barra superior; en móvil, ⋮ → Compile Project. En la ventana, pulsa Compile y, si termina correctamente, descarga el resultado desde ese build o con el botón de descarga del .jar.
package dev.kodari.morphbody;
import net.fabricmc.api.ModInitializer;
import net.fabricmc.fabric.api.event.lifecycle.v1.ServerLifecycleEvents;
import net.fabricmc.fabric.api.networking.v1.ServerPlayConnectionEvents;
public final class MorphBody implements ModInitializer {
public static final String MOD_ID = "morphbody";
public static final System.Logger LOGGER = System.getLogger(MOD_ID);
@Override
public void onInitialize() {
ModelRepository.initialize();
MorphCommands.register();
ServerLifecycleEvents.SERVER_STARTED.register(server -> ModelRepository.loadState());
ServerPlayConnectionEvents.JOIN.register((handler, sender, server) -> {
handler.player.calculateDimensions();
MorphBodyNetwork.syncAllTo(handler.player);
});
}
}