El primer mod más útil es uno que puedes compilar, encontrar y volver a iniciar. El proyecto de ejemplo de Fabric te da ese punto de partida: una pequeña carpeta de código fuente con el código, los recursos y la configuración de compilación ya conectados. Tu tarea es convertir ese punto de partida funcional en una idea propia.
Qué obtienes en el primer inicio
El ejemplo sin modificar no añade una espada, una máquina ni un bioma nuevos. Su primer éxito es que el proyecto compile y cargue. Mod Menu es una ayuda aparte que puede mostrar los mods cargados; no es una función que aporte la plantilla.

El ejemplo 26.2 sin cambios, compilado en un JAR y cargado en un juego Fabric independiente. Buscar Example en Mod Menu facilita encontrarlo. Example Mod y Me! son el nombre y el autor provisionales de la plantilla; los reemplazarás al hacer tuyo el proyecto.
Elige el código fuente para el juego que quieres admitir
Abre Archivos y elige primero la versión de Minecraft de destino. La nueva instantánea de código fuente 26.2 es la usada aquí. Las instantáneas anteriores siguen disponibles para sus propias versiones del juego; úsalas si tu proyecto necesita esa versión.
Para la instantánea 26.2, usa JDK 25. Las instantáneas antiguas de esta página tienen sus propios requisitos de compilación. Cambiar solo el número de Minecraft en un archivo de compilación no actualiza automáticamente todo el código y las dependencias que lo rodean.
Del ZIP de código fuente a un mod en ejecución
- Extrae el ZIP de código fuente en una nueva carpeta de desarrollo. Abre la carpeta que contiene realmente build.gradle, gradlew.bat y gradle.properties. Un archivo descargado del repositorio puede tener una carpeta adicional alrededor.
- Abre una terminal en esa carpeta. En Windows, ejecuta .\gradlew.bat build. En macOS o Linux, usa ./gradlew build. Deja que la primera ejecución termine de descargar las dependencias de compilación.
- Cuando la compilación termine bien, abre build/libs. Elige el JAR normal del mod. El -sources.jar contiene código fuente y no es el archivo que debes instalar para jugar de forma normal.
- Pon el JAR normal en la carpeta mods de una instancia Fabric correspondiente. Instala las dependencias que declare el fabric.mod.json de ese ejemplo e inicia esa instancia.
- Comprueba que el ejemplo cargue antes de cambiar su estructura. Conserva esta primera compilación funcional para tener con qué comparar después.
Para un juego de desarrollo independiente, ejecuta .\gradlew.bat runClient en Windows o ./gradlew runClient en macOS/Linux. Es el inicio de desarrollo de la plantilla, no un motivo para copiar código fuente a la carpeta de tus partidas habituales.
Haz un cambio reconocible
Empieza por el nombre visible y el autor en src/main/resources/fabric.mod.json, vuelve a compilar y busca tu nuevo nombre en la lista de mods. Es un cambio pequeño con un resultado evidente. Cuando ese ciclo te resulte cómodo, pasa a tu primer objeto u otra función.
Renombrar un ID de mod es un paso mayor que cambiar un nombre visible: los puntos de entrada, los paquetes Java, los recursos y las referencias a mixins pueden depender de él. Mantén esos nombres coherentes y haz un cambio cada vez. Una función pequeña que funciona es una base mejor para crecer que una carpeta grande de cambios a medio conectar.
Si tu idea necesita un modelo o una textura, nuestra guía de Blockbench empieza con un pequeño farol. Decide qué hace el objeto en tu mod por separado de cómo se ve.
Cuando se atasca la primera compilación
- Error de versión de Java: ejecuta .\gradlew.bat --version y comprueba la JVM que Gradle usa realmente. Instalar un JDK nuevo no siempre lo selecciona en tu editor.
- No se puede descargar una dependencia: lee la primera descarga fallida y vuelve a intentarlo cuando haya conexión. Cambiar la extensión del ZIP no ayudará.
- El JAR existe, pero el juego no lo ve: comprueba la instancia iniciada, su versión de Minecraft y su cargador. Nuestra guía de instalación de Fabric muestra dónde va el archivo terminado.
- No aparece nada nuevo en el mundo: el ejemplo original es un proyecto inicial, no un pack de contenido. Comprueba que cargue antes de esperar una función que aún no has añadido.
Comentarios 0
Comparte lo que funcionó, pide ayuda o responde a otro jugador.
Usa tu cuenta de Modonix para participar en la conversación y gestionar tus comentarios.
Inicia sesión para comentarAún no hay comentarios. Comparte lo que te funcionó.