05/07/2015
El fenómeno de Balatro ha capturado la atención de miles de jugadores, y con una comunidad tan activa, el mundo del modding no se ha quedado atrás. Crear un mod es solo la mitad de la batalla; la otra mitad es compartirlo con el mundo para que otros puedan disfrutar de tu trabajo. Si has desarrollado una nueva baraja, un Joker ingenioso o una mejora de calidad de vida y te preguntas cómo publicarlo, has llegado al lugar correcto. Esta guía completa te llevará de la mano a través de todo el proceso para añadir tu mod al Balatro Mod Index, el repositorio central para la comunidad de modding de este increíble juego.
Publicar tu creación no solo permite que otros la encuentren y la usen fácilmente, sino que también te establece como un contribuyente valioso en la comunidad. A continuación, desglosaremos cada paso, desde la estructura de carpetas hasta el proceso de revisión, asegurándonos de que no te pierdas ningún detalle.
Entendiendo el Balatro Mod Index
Antes de sumergirnos en los detalles técnicos, es crucial entender qué es el Balatro Mod Index. Piensa en él como una biblioteca o un catálogo centralizado donde se listan todos los mods disponibles para el juego. Este índice es utilizado por gestores de mods para que los jugadores puedan buscar, descargar e instalar mods de forma sencilla y segura. Al incluir tu mod aquí, garantizas la máxima visibilidad y accesibilidad para tu trabajo.
Preparando tu Mod para la Publicación
La organización es clave. Para que tu mod sea aceptado en el índice, debe seguir una estructura de directorios muy específica. Esto asegura que el sistema pueda leer e interpretar correctamente los archivos de tu mod. La estructura es simple pero estricta.
Estructura de Directorios Requerida
Dentro de la carpeta principal mods/, tu mod debe residir en una carpeta con el siguiente formato: Autor@NombreDelMod. Por ejemplo, si tu nombre de autor es "InertSteak" y tu mod se llama "Pokermon", la ruta sería mods/InertSteak@Pokermon/.
Dentro de esta carpeta, debes incluir los siguientes archivos:
description.md: (Obligatorio) Un archivo de texto en formato Markdown que describe tu mod.meta.json: (Obligatorio) Un archivo JSON que contiene los metadatos esenciales de tu mod.thumbnail.jpg: (Opcional pero muy recomendado) Una imagen en miniatura para representar tu mod.
Los Archivos Esenciales: description.md y meta.json
Estos dos archivos son el corazón de la presentación de tu mod en el índice.
description.md: Aquí es donde vendes tu creación. Utiliza este archivo para explicar qué hace tu mod, sus características principales, cómo instalarlo (si requiere pasos especiales) y cualquier otra información que consideres relevante. Sé claro, conciso y, si puedes, ¡añade un poco de personalidad!
meta.json: Este archivo es puramente técnico. Contiene la información que los gestores de mods usarán para catalogar y manejar tu creación. Es vital que este archivo esté correctamente formateado y contenga todos los campos requeridos. Un solo error aquí puede hacer que tu mod no sea aceptado.
Desglosando el Archivo meta.json
El archivo meta.json es un objeto JSON que contiene pares de clave-valor. A continuación, te presentamos una tabla detallada con cada campo, su propósito y un ejemplo.
| Campo | Descripción | Ejemplo |
|---|---|---|
title | El nombre que se mostrará para tu mod. | "Cartas Extendidas" |
requires-steamodded | Un valor booleano (true o false). Ponlo en true si tu mod necesita el cargador de mods Steamodded para funcionar. | true |
requires-talisman | Similar al anterior, ponlo en true si tu mod depende del mod Talisman. | false |
categories | Un array que debe contener al menos una de las categorías válidas: "Content", "Joker", "Quality of Life", "Technical", "Miscellaneous", "Resource Packs" o "API". | ["Content", "Joker"] |
author | Tu nombre de usuario o alias como creador del mod. | "Jugador Anónimo" |
repo | El enlace al repositorio de tu mod (por ejemplo, en GitHub). | "https://github.com/usuario/mi-mod" |
downloadURL | Un enlace de descarga directa a la última versión de tu mod. Se prefiere un enlace que apunte automáticamente a la última release. | "https://github.com/usuario/mi-mod/releases/latest/download/mi-mod.zip" |
version | El número de versión actual de los archivos en la downloadURL. | "1.0.0" |
folderName | (Opcional) El nombre de la carpeta de instalación. Debe ser único y no puede contener caracteres especiales como < >: " / \ | ? *. | "MiModUnico" |
automatic-version-check | (Opcional pero recomendado) Ponlo en true para que el índice actualice automáticamente el campo de versión cada hora, basándose en tu downloadURL. | true |
fixed-release-tag-updates | (Opcional) Ponlo en true si usas una etiqueta de lanzamiento fija y quieres que se actualice automáticamente cuando modifiques los archivos subyacentes. Requiere que automatic-version-check también sea true. | true |
Guía Paso a Paso para Publicar tu Mod en GitHub
El proceso de publicación se gestiona a través de GitHub, la plataforma de desarrollo colaborativo más popular. Si no estás familiarizado con ella, no te preocupes, estos pasos te guiarán.
- Hacer un 'Fork' del Repositorio: Ve al repositorio oficial de Balatro Mod Index en GitHub. En la esquina superior derecha, encontrarás un botón que dice "Fork". Al hacer clic, crearás una copia personal del repositorio en tu propia cuenta de GitHub.
- Crear el Directorio de tu Mod: En tu copia (fork) del repositorio, navega a la carpeta
mods/. Aquí es donde crearás la nueva carpeta para tu mod, siguiendo la estructuraAutor@NombreDelModque mencionamos antes. - Subir tus Archivos: Dentro de tu nueva carpeta, sube los archivos
description.md,meta.jsony, opcionalmente,thumbnail.jpg. Asegúrate de que el contenido de los archivos de texto sea correcto. - Hacer 'Commit' y 'Push': Una vez que los archivos estén en su sitio, deberás confirmar los cambios. A esto se le llama "commit". Escribe un mensaje descriptivo para tu commit (ej: "Añadir el mod MiModIncreible"). Luego, empuja ("push") estos cambios a tu repositorio fork.
- Abrir una 'Pull Request' (PR): Este es el paso final y más importante. Desde tu fork, verás una opción para crear una "Pull Request". Esto es, en esencia, una solicitud para que los mantenedores del repositorio principal incorporen tus cambios. Al crear la PR, asígnale un título claro como "Añadir mod Autor@NombreDelMod" y una breve descripción.
El Proceso de Revisión: Paciencia y Colaboración
Una vez que envíes tu Pull Request, no se publica inmediatamente. Pasa por un proceso de revisión de dos fases:
- Revisión Automatizada: Un sistema automático (GitHub Actions) revisará tu envío para asegurarse de que cumple con los estándares básicos: la estructura de carpetas es correcta, el
meta.jsones válido, etc. Si algo falla, recibirás una notificación para que puedas corregirlo. - Revisión Manual: Si pasas la revisión automática, un mantenedor del proyecto revisará tu mod manualmente. Comprobarán la calidad, la originalidad y que cumple con las políticas de la comunidad.
Una vez que ambas revisiones sean aprobadas, tu Pull Request será fusionada (merged) y ¡felicidades! Tu mod formará oficialmente parte del Balatro Mod Index y estará disponible para toda la comunidad.
Políticas de Envío y Contribuciones de Terceros
La comunidad de Balatro se basa en el respeto y la seguridad. Por ello, existen reglas estrictas:
- No al malware: Tu mod no debe contener ningún tipo de software malicioso.
- Respeta los derechos de autor: No utilices contenido protegido por derechos de autor sin permiso.
- Cero contenido ofensivo: Se prohíbe cualquier material que incite al odio, sea discriminatorio u ofensivo.
Si deseas enviar un mod creado por otra persona, debes ser extremadamente considerado. Solo se aceptarán si el mod tiene una licencia que permita la redistribución (como GPL, MIT) o si tienes permiso explícito del autor. Siempre es mejor preguntar primero.
Preguntas Frecuentes (FAQ)
¿Qué pasa si mi Pull Request es rechazada?
No te desanimes. Generalmente, si una PR es rechazada, vendrá acompañada de comentarios explicando el motivo. Lee atentamente los comentarios, realiza las correcciones necesarias en tu fork y actualiza la Pull Request. El proceso de revisión volverá a comenzar.
¿Puedo actualizar mi mod una vez publicado?
¡Sí! El proceso es similar. Simplemente actualiza los archivos en tu repositorio original (el que enlaza tu downloadURL), cambia el número de versión en tu meta.json y crea una nueva Pull Request con los cambios en el archivo meta.json de tu fork del Mod Index. Si tienes la actualización automática activada, el proceso es aún más sencillo.
¿Dónde puedo pedir ayuda si me quedo atascado?
La comunidad de modding de Balatro suele ser muy activa en plataformas como Discord. Busca servidores dedicados al juego, donde seguramente encontrarás canales para desarrolladores de mods dispuestos a echar una mano.
Contribuir a la comunidad de Balatro con tus propias creaciones es una experiencia increíblemente gratificante. Esperamos que esta guía te haya dado la confianza y el conocimiento necesarios para dar el salto y compartir tu talento con el mundo.
Si quieres conocer otros artículos parecidos a Publica tu Mod de Balatro: Guía Completa puedes visitar la categoría Guías.