qad3n/modport

Portar un mod al cargador b1.7.3_rewrite

Los mods Java no pueden ejecutarse. Un port es una reescritura en Rust (invitado wasm, SDK b173_api) que usa el mod descompilado como su especificación. Objetivo: misma apariencia, sensación y jugabilidad dentro de b1.7.3, desde un solo archivo tanto en el cliente como en el servidor mods/. Corrige errores de fuente y optimiza libremente cuando la apariencia y la jugabilidad sigan siendo las mismas. Nunca reemplaces una pantalla vanilla: la UI adicional es una superposición que se puede activar/desactivar.

Este archivo es el mapa completo. No leas documentos de diseño del cargador o progreso, guías o archivos completos del SDK para orientarte. Usa las herramientas, luego abre solo el archivo de ejemplo que el paso necesite.

Espacio de trabajo

Las rutas son relativas a la raíz del espacio de trabajo, la carpeta que contiene b1.7.3_rewrite/, ports/ y el repositorio del kit b1.7.3_modport/. El install.sh del kit enlaza sus herramientas a tools/modport/ (escrito T/ abajo) y esta habilidad a .claude/skills/modport; desde una carpeta de port, T/ es ../../tools/modport/. Arregla o extiende las herramientas en b1.7.3_modport/, nunca dentro de un port. En una máquina nueva, o cuando una herramienta falla por una dependencia faltante, ejecuta T/doctor.sh: imprime el comando que soluciona cada brecha. Todas las herramientas son bash: en Windows se ejecutan en Git Bash (la herramienta Bash de Claude Code en Windows) y manejan .exe, py y rutas por sí mismas. Llama a las herramientas de Python a través de T/py.sh, nunca python3 directamente.

Modos

Verifica una vez por sesión: test -f .modport-maintainer en la raíz del espacio de trabajo.

• Modo mantenedor (el marcador existe): los repositorios del cargador, SDK y kit son del propio usuario. Haz commit y push a ellos solo cuando el usuario lo pida, como indican los pasos siguientes.
• Modo usuario (sin marcador, el predeterminado): los repositorios del cargador, SDK y kit pertenecen a su autor original.
  • Las extensiones del cargador y SDK permanecen en el árbol de trabajo local. Nunca les hagas commit a esos repositorios, nunca hagas push a sus remotos, nunca ejecutes gh pr create, gh issue create ni ningún otro comando gh de escritura contra ellos, incluso cuando se te pida