Fabric Example Mod: compila tu primer mod funcional de Java

Convierte la plantilla de código fuente de Fabric en un JAR de mod funcional, descubre dónde van los archivos y haz tu primer cambio pequeño sin alterar tu juego principal.

Idioma del contenido

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.

Fabric Example Mod cargado en Minecraft Java 26.2 y seleccionado en Mod Menu dentro del juego.

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

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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.
Aún no hay valoraciones

Archivos

Filtrar archivos Archivos: 4Versión estable

Versión 26.2-source-1ce1c77a

Estable

fabric-example-26.2-1ce1c77a.zip

0 descargas
Descargar · 62,7 KB
Requisitos y detalles
  • Formato de archivo: .zip

ZIP de código fuente para Minecraft 26.2, no un mod instalable. Extráelo, usa JDK 25, ejecuta la compilación con el wrapper de Gradle e instala el JAR normal resultante en una instancia Fabric correspondiente.

Requisitos y notas
Actualizar desde una versión anterior
Empieza una carpeta de desarrollo independiente para cada versión del juego de destino. Guarda por separado el código fuente editable y el JAR terminado.

Versión 1.21.1-source-684b5812

Estable

fabric-example-1.21.1.zip

0 descargas
Descargar · 64,6 KB
Requisitos y detalles
  • Formato de archivo: .zip

Versión 1.20.1-source-cf6a5284

Estable

fabric-example-1.20.1.zip

2 descargas
Descargar · 64,6 KB
Requisitos y detalles
  • Formato de archivo: .zip

Versión 1.19.2-source-3ea0867c

Estable

fabric-example-1.19.2.zip

2 descargas
Descargar · 64,6 KB
Requisitos y detalles
  • Formato de archivo: .zip

Novedades de las versiones

Versión 26.2-source-1ce1c77a

Estable

Código fuente oficial de ejemplo de Fabric fijado para Minecraft 26.2. Compilado con JDK 25 y cargado como un JAR normal en la guía adjunta. Los destinos de código fuente anteriores siguen en el historial.

Ver archivos

Versión 1.21.1-source-684b5812

Estable

Instantánea de código fuente para Minecraft 1.21.1; el proyecto original no asigna una versión numerada a esta rama.

Fuente: Archivos fuente de Fabric Example Mod
Los detalles de compatibilidad de abajo reflejan los destinos declarados por el autor. Consulta la fuente enlazada para toda la información sobre versiones y dispositivos.

Ver archivos

Versión 1.20.1-source-cf6a5284

Estable

Instantánea de código fuente para Minecraft 1.20.1; el proyecto original no asigna una versión numerada a esta rama.

Fuente: Archivos fuente de Fabric Example Mod
Los detalles de compatibilidad de abajo reflejan los destinos declarados por el autor. Consulta la fuente enlazada para toda la información sobre versiones y dispositivos.

Ver archivos

Versión 1.19.2-source-3ea0867c

Estable

Instantánea de código fuente para Minecraft 1.19.2; el proyecto original no asigna una versión numerada a esta rama.

Fuente: Archivos fuente de Fabric Example Mod
Los detalles de compatibilidad de abajo reflejan los destinos declarados por el autor. Consulta la fuente enlazada para toda la información sobre versiones y dispositivos.

Ver archivos

Comentarios 0

Comparte lo que funcionó, pide ayuda o responde a otro jugador.

Únete a la conversación

1Tu nombre y correo

No necesitas una cuenta. Confirma tu correo con un código antes de tu primer comentario. Solo aparece una dirección parcialmente oculta junto a tu nombre. Los comentarios de invitados se revisan antes de publicarse.

2Verificar y publicar

Aún no hay comentarios. Comparte lo que te funcionó.

Buscar en Modonix

Buscar en