Shokkoh: Translation sync from dragonminez-wiki repository

2026-10-13T23:36:54Z

Translation sync from dragonminez-wiki repository

New page

'''Cómo contribuir''' explica cómo ayudar a DragonMineZ: reportar errores, probar versiones, sugerir funciones, mejorar la documentación o trabajar en el código. Sea lo que sea que quieras hacer, el equipo estará encantado de colaborar contigo. Sigue estas pautas para que el proceso sea fluido para todos los colaboradores. Si quieres hacer una donación al proyecto, consulta [[Special:MyLanguage/Contributing#Supporting the project on Patreon|Apoyar el proyecto en Patreon]].


== Primeros pasos ==
# '''Lee el Código de Conducta.''' Al contribuir, aceptas respetar el [https://github.com/DragonMineZ/DragonMineZ/blob/main/.github/CODE_OF_CONDUCT.md Código de Conducta].
# '''Revisa los issues existentes.''' Mira los [https://github.com/orgs/DragonMineZ/projects/5 issues] para ver si alguien ya reportó tu problema o propuso tu idea.
# '''Haz un fork del repositorio''' y clona tu fork en tu entorno local para probar y desarrollar (ver abajo).
# '''Prepara tu entorno''' con las herramientas que se indican abajo.

Para clonar tu fork:

<syntaxhighlight lang="bash">
git clone https://github.com/your-username/DragonMineZ.git
</syntaxhighlight>

Asegúrate de tener instaladas estas herramientas:
* Java Development Kit (JDK) 17 (la compilación usa una toolchain de Java 17)
* Git
* Un IDE compatible con Gradle (IntelliJ IDEA o Eclipse)
No necesitas instalar Gradle ni Forge por tu cuenta: el repositorio incluye el wrapper de Gradle (<code>gradlew</code> / <code>gradlew.bat</code>), que descarga Gradle, Minecraft Forge (<code>1.20.1-47.4.10</code>) y todas las dependencias en la primera compilación.

Si no vas a hacer un fork del repositorio ni a crear un addon, puedes saltarte el paso 3. Para desarrollar addons, consulta [[Special:MyLanguage/Add-on Getting Started|Primeros pasos con addons]].


== Compilar y ejecutar ==
Ejecuta estos comandos desde la raíz del repositorio (<code>./gradlew</code> en Linux y macOS, <code>.\gradlew.bat</code> en Windows):

{| class="wikitable"
! Comando !! Qué hace
|-
| <code>./gradlew build</code> || Compilación completa. El jar que se distribuye es <code>build/libs/dragonminez-<version>.jar</code> (incluye las librerías de base de datos); el jar <code>-slim</code> no está pensado para distribuirse.
|-
| <code>./gradlew runClient</code> || Inicia un cliente de desarrollo (directorio de trabajo <code>run/</code>).
|-
| <code>./gradlew runServer</code> || Inicia un servidor dedicado de desarrollo (directorio de trabajo <code>run/</code>).
|-
| <code>./gradlew runData</code> || Ejecuta la generación de datos (directorio de trabajo <code>run-data/</code>) y escribe en <code>src/generated/resources/</code>. Ejecútalo después de cambiar los proveedores de datagen y revisa el diff generado.
|}

* '''No hay una suite de pruebas automatizadas'''. Valida tu cambio con <code>build</code> y, si afecta a la jugabilidad, probándolo en <code>runClient</code> y/o <code>runServer</code>.
* Los mods de desarrollo solo para el cliente (JEI runtime, shaders, etc.) solo se añaden a <code>runClient</code>. Mantenlo así para que no se filtren en los datos generados ni en el servidor dedicado.
* La optimización de recursos (PackSquash) se ejecuta en CI y está desactivada por defecto en las compilaciones locales. Puedes forzarla con <code>-PoptimizeResources=true</code> o <code>-PoptimizeResources=false</code>.


== Traducciones ==
* <code>src/main/resources/assets/dragonminez/lang/en_us.json</code> es el archivo de idioma de origen. Añade ahí una entrada por cada texto nuevo que puedan ver los jugadores y mantén estables las claves existentes.
* Los demás idiomas los traduce la comunidad en Crowdin. El archivo en inglés se sube a Crowdin automáticamente cuando cambia en <code>main</code>.
* Antes de abrir un pull request, comprueba que todos los archivos de idioma sean JSON válido con <code>scripts/check_lang.sh</code> (necesita <code>jq</code>).


== Cómo contribuir ==


=== Reportar errores ===
Si encontraste un error, abre un [https://github.com/DragonMineZ/DragonMineZ/issues/new?template=bug_report.yml reporte de error] e incluye todos los detalles posibles:
* Una descripción clara del problema
* Pasos para reproducirlo
* Resultado esperado y resultado real
* Capturas de pantalla, logs o reportes de crash, si los hay


=== Probar el juego ===
Cualquiera puede probar las versiones públicas y compartir lo que encuentre con el equipo: errores, exploits, problemas de balance, crashes o cualquier otra cosa que parezca rara. No necesitas ser desarrollador ni abrir un pull request para ayudar de esta forma.
* Prueba '''solo versiones públicas'''. No pruebes versiones internas o sin publicar a menos que te hayan dado acceso explícito.
* Comparte lo que encuentres en un [https://github.com/DragonMineZ/DragonMineZ/issues/new?template=bug_report.yml reporte de error] o en Discord.
* Si lo que encuentras es una '''vulnerabilidad de seguridad''' (por ejemplo, algo que se podría explotar para perjudicar a otros jugadores o servidores), sigue la [[Special:MyLanguage/Security Policy|Política de seguridad]] en lugar de abrir un issue público.


=== Sugerir funciones ===
¿Tienes una gran idea? Abre una [https://github.com/DragonMineZ/DragonMineZ/issues/new?template=feature_request.yml solicitud de función] e incluye:
* Una explicación clara y concisa de la función
* Sus posibles beneficios e impacto
* Alternativas o conceptos relacionados
También puedes sugerir funciones en el servidor de Discord.


=== Enviar pull requests ===
'''Paso 1: Crea una rama.''' <code>main</code> contiene la línea estable actual; la próxima versión se desarrolla en su propia rama de versión (por ejemplo, <code>v2.2</code>). Basa tu rama en aquella a la que va dirigido tu cambio; si no estás seguro, pregunta en Discord. Usa un nombre de rama descriptivo:

<syntaxhighlight lang="bash">
git checkout -b fix/short-description
</syntaxhighlight>

'''Paso 2: Haz tus cambios.'''
* Escribe código limpio y conciso.
* Prueba tus cambios en local para asegurarte de que funcionan como esperas.
* Sigue las convenciones y estándares de código del proyecto.

'''Paso 3: Haz commit de tus cambios''' con un mensaje de commit significativo:

<syntaxhighlight lang="bash">
git commit -m "Fix: Resolved issue with XYZ feature"
</syntaxhighlight>

'''Paso 4: Sube tus cambios (push).'''

<syntaxhighlight lang="bash">
git push origin fix/short-description
</syntaxhighlight>

'''Paso 5: Abre un pull request.''' Ve a tu fork en GitHub y envía un [https://github.com/DragonMineZ/DragonMineZ/pulls pull request].
* Describe los cambios y enlaza los issues relacionados.
* Prepárate para discutir y revisar tu código según los comentarios.
* Cada pull request se compila automáticamente con el workflow '''Compile Check''' (<code>./gradlew build</code>). Si falla, tu pull request no se fusionará. Los workflows de quienes contribuyen por primera vez pueden necesitar la aprobación de un mantenedor antes de ejecutarse.


=== Comprobaciones automáticas ===

{| class="wikitable"
! Workflow !! Cuándo se ejecuta !! Qué hace
|-
| Compile Check || Cada pull request, y los push a cualquier rama excepto <code>main</code> que toquen código, recursos o archivos de Gradle || Ejecuta <code>./gradlew build</code>
|-
| Java CI || Pull requests y push a <code>main</code> que toquen Java o <code>build.gradle.kts</code> || Ejecuta <code>./gradlew build</code> y envía el grafo de dependencias
|-
| Crowdin Check & Upload || Push a <code>main</code> que toquen la carpeta lang, cada 2 días o manualmente || Valida los archivos de idioma con <code>scripts/check_lang.sh</code> y sube <code>en_us.json</code> a Crowdin
|-
| CodeQL || Diario || Análisis de seguridad del código Java y de los workflows
|}

Los mantenedores publican las versiones en Modrinth y CurseForge desde <code>main</code> con sus workflows de publicación.


== Pautas para colaboradores ==
# '''Estándares de código'''
#* Usa nombres descriptivos para variables y métodos.
#* Formatea el código de manera consistente (sangría, espaciado, etc.).
#* Escribe comentarios para la lógica compleja.
# '''Documentación'''
#* Actualiza o añade documentación para las funciones nuevas o modificadas.
#* Asegúrate de que esta [[Special:MyLanguage/Main Page|wiki]] refleje los cambios importantes.
# '''Pruebas'''
#* Prueba a fondo en los escenarios relevantes, incluido un servidor dedicado (<code>runServer</code>) cuando tu cambio toque clases del cliente, red o lógica del servidor.
#* Corrige cualquier problema de linting o de compilación antes de enviar tu pull request.
# '''Compatibilidad'''
#* Muchos sistemas leen JSON que editan jugadores, dueños de servidores y autores de addons (configuraciones, misiones, deseos, paquetes de Esferas del Dragón). No renombres ni elimines claves de configuración, campos JSON, claves de guardado NBT ni nombres de registro sin hablarlo antes: los mundos y configuraciones antiguos deben seguir cargando.
#* Los paquetes de red se identifican por su orden de registro: añade los paquetes nuevos al final de <code>NetworkHandler.register()</code>, nunca en medio.
#* Valida en el servidor todo lo que envíe un cliente; nunca confíes en el cliente para estadísticas, desbloqueos, misiones, deseos o progreso.
# '''Documentación del proyecto'''
#* <code>CLAUDE.md</code> y la carpeta <code>AI/</code> (<code>Agents.md</code>, <code>Context.md</code>, <code>Memory.md</code>, <code>QuestAddonAPI.md</code>) describen en detalle la arquitectura, los sistemas de datos, la compilación y la automatización de versiones. Están escritos para asistentes de programación con IA, pero son igual de útiles para colaboradores humanos: lee <code>AI/Context.md</code> antes de hacer cambios grandes.


== Comunidad ==
Únete al [https://discord.gg/b5MgRNb3D7 servidor de Discord] para conversar en tiempo real.


== Apoyar el proyecto en Patreon ==
DragonMineZ es un proyecto impulsado por la comunidad, y tu apoyo ayuda al equipo a seguir mejorándolo y a lanzar nuevas funciones. Considera hacerte patrocinador en [https://patreon.com/DragonMineZ Patreon] para apoyar el desarrollo y el mantenimiento del mod.
Los patrocinadores reciben beneficios exclusivos, como:
* Acceso anticipado a nuevas funciones
* Novedades del detrás de escena
* Reconocimiento en la comunidad
Cada aporte, por pequeño que sea, ayuda a que DragonMineZ siga mejorando.


== Licencia ==
Al contribuir, aceptas que tus contribuciones se publiquen bajo la misma [https://github.com/DragonMineZ/DragonMineZ/blob/main/LICENSE licencia] que rige el proyecto.


== Gracias ==
Al equipo le entusiasma ver tus contribuciones e ideas. Si tienes alguna pregunta o necesitas ayuda, contacta al equipo.

{{Navbox Add-ons}}

Contributing/es - Revision history

Shokkoh: Translation sync from dragonminez-wiki repository