Cómo hacer un mod de Minecraft: Proyecto Fabric, código Java y compilación JAR

Esta guía se basa en Minecraft Java Edition 26.2 y Fabric para crear un mod que genera un registro en el primer inicio. Este es un ejemplo para principiantes que sigue el proceso hasta que el cargador reconoce el archivo del mod y se ejecuta el código Java que escribiste. Dado que la estructura difiere de los complementos de Bedrock y de los proyectos Forge·NeoForge, no los mezcles en un solo proyecto.

1. Preparación del entorno de desarrollo

La documentación actual de Fabric para 26.2 recomienda JDK 25. En lugar de instalar solo el entorno de ejecución de Java, instala el JDK para desarrollo y prepara IntelliJ IDEA o VS Code. Verifica el Java en uso actual con el siguiente comando en la terminal. El Project SDK y la JVM de Gradle del IDE también deben apuntar a la misma versión. Para crear para una versión anterior como 1.21.1, cambia la selección de versión en la parte superior del documento y la versión del generador juntas, y sigue los requisitos de JDK de esa versión.

java -version
javac -version

2. Creación de un proyecto en el generador de Fabric

1. Abre el generador oficial de mods de plantilla de Fabric (Template Mod Generator).
2. Configura el Mod Name como TroubleMaker Hello, Mod ID como tmhello y Package Name como com.ascgame.tmhello.
3. Ajusta la versión de Minecraft a 26.2. No es necesario agregar opciones avanzadas como Kotlin o generación de datos separada en el primer ejemplo.
4. Descarga el ZIP y descomprímelo en una ruta simple como C:/Projects/TMHello. Determina la carpeta del proyecto según tu sistema operativo real.
5. Abre build.gradle o la raíz del proyecto en el IDE y espera a que finalice la importación de Gradle. Conserva las versiones de Loader, Loom y API especificadas por el generador tal cual.

3. Comprender qué hace cada archivo

src/main/java es el código Java común, src/main/resources/fabric.mod.json es la declaración del ID del mod, clase de entrada y dependencias, y gradle.properties corresponde a la versión y la configuración del proyecto. Dependiendo del generador, el código del cliente puede dividirse en src/client/java. Este ejemplo solo cambia el código de inicialización común. No elimines arbitrariamente todos los archivos de configuración ni sobrescribas la configuración de otra versión de Internet.

4. Escribir tu clase de inicialización

Busca el archivo de implementación de ModInitializer común generado y modifícalo con la siguiente estructura. Si cambiaste el nombre del archivo a TMHello.java, haz que coincidan tanto la carpeta del paquete como el nombre de la clase. Como utiliza registros SLF4J, puedes verificar la inicialización sin la API de registro de elementos que es propensa a cambiar en diferentes versiones del juego.

package com.ascgame.tmhello;

import net.fabricmc.api.ModInitializer;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

public class TMHello implements ModInitializer {
    public static final String MOD_ID = "tmhello";
    private static final Logger LOG = LoggerFactory.getLogger(MOD_ID);

    @Override
    public void onInitialize() {
        LOG.info("TroubleMaker: my first Fabric mod is ready.");
    }
}

Manteniendo el resto del contenido de fabric.mod.json, asegúrate de que entrypoints.main apunte al nombre completo de la clase anterior. Lo siguiente es la parte a verificar, no todo el archivo. No reemplaces los mixins existentes ni la configuración del cliente por completo.

{
  "entrypoints": {
    "main": ["com.ascgame.tmhello.TMHello"]
  }
}

5. Ejecución de desarrollo y compilación del archivo final

1. Desde la raíz del proyecto, ejecuta gradlew.bat runClient en Windows o ./gradlew runClient en macOS/Linux.
2. Busca la frase TroubleMaker en la consola del cliente de desarrollo o en run/logs/latest.log. Este es un ejemplo que se imprime una vez durante la inicialización antes de entrar al mundo.
3. Cierra el juego y crea el archivo de distribución con gradlew.bat build en Windows o ./gradlew build en macOS/Linux.
4. Verifica el JAR de distribución normal en build/libs. No utilices archivos de desarrollo con sources o dev en el nombre como distribución normal.
5. Coloca el JAR en la carpeta mods de una instancia de Fabric separada de la misma versión de Minecraft. Si la Fabric API está en las dependencias generadas, instálala coincidiendo con la misma versión.
6. Ejecútalo con el lanzador real y verifica que la misma frase se imprima en los logs/latest.log de la instancia.

6. Errores comunes y recuperación

Para Unsupported class file version, verifica la versión de Java; para errores de carga de la clase de entrada, verifica primero las discrepancias entre el paquete, el nombre de la clase y los entrypoints. Si está silencioso después de colocarlo en la carpeta mods, verifica también si lo pusiste en otra instancia del lanzador. Este ejemplo no agrega datos de guardado, por lo que puedes cerrar el juego y eliminar el JAR para comparar. Al agregar elementos o bloques más adelante, lee el documento Fabric First Item de la versión de destino y ajusta la ruta del archivo y la API de registro a esa versión.

7. Información para incluir al compartir

Escribe el ID del mod, la versión de Minecraft compatible, las condiciones de Loader y Fabric API, los requisitos de JDK, las funciones de ejemplo y el método de eliminación en el README. Separa el código fuente y el JAR de distribución, y no incluyas el juego principal ni los archivos de mods de otros creadores. Para la versión inicial, distribúyela después de verificar que el registro se imprima en el lanzador general real, asignándole una versión como 1.0.0.

Documento original y criterios de verificación

Guía para principiantes redactada por el equipo operativo de TroubleMaker tras revisar la documentación de las herramientas oficiales de los creadores el 7 de octubre de 2026. El código y los diagramas son ejemplos propios para la explicación y no representan los resultados de la verificación del juego real en este servidor. Por favor, verifícalo en un mundo de prueba separado con la versión especificada en el texto antes de la distribución. Compara las últimas versiones y dependencias de cada herramienta en las fuentes a continuación:

Fabric 개발 환경

Fabric 프로젝트 생성

Fabric 모드 빌드

Fabric 공식 생성기