Guía Definitiva para Empaquetar Mods de Starbound

Adentrarse en el universo del modding de Starbound es una de las experiencias más gratificantes que un jugador puede tener. Permite no solo personalizar el juego a tu gusto, sino también compartir tus creaciones con una comunidad vibrante y apasionada. Sin embargo, una vez que has terminado de crear tu obra maestra, surge una pregunta crucial: ¿cómo la comparto de manera eficiente y sencilla? La respuesta está en el empaquetado. Empaquetar tu mod en un único archivo .pak simplifica enormemente la instalación para otros jugadores. Esta guía te llevará de la mano a través de todo el proceso, desde los preparativos iniciales hasta la publicación final de tu mod, asegurando que tu creación llegue al universo de la forma más profesional posible.

Preparativos Esenciales Antes de Empezar

Antes de sumergirnos en la línea de comandos, hay algunas herramientas y conocimientos previos que necesitarás. No te preocupes, ¡son muy sencillos!

• Un Editor de Texto Adecuado: Olvídate del Bloc de notas de Windows. Necesitarás un editor de texto que soporte las terminaciones de línea de UNIX y la codificación UTF-8, ya que otras codificaciones pueden provocar que el juego se bloquee. Algunas excelentes opciones gratuitas son Visual Studio Code, Notepad++ o Sublime Text.
• Herramientas Opcionales (Pero Recomendadas): Para facilitar el proceso de empaquetado y desempaquetado, puedes utilizar herramientas como ModPackHelper (Windows y Linux) o PAK GUI (Windows). Estas ofrecen una interfaz gráfica que evita tener que usar la línea de comandos directamente.

Paso 1: Desempaquetar los Assets del Juego

El primer paso, y uno de los más importantes, es desempaquetar los archivos base del juego. Starbound almacena todos sus recursos (imágenes, sonidos, configuraciones, etc.) en un gran archivo llamado packed.pak para mejorar los tiempos de carga. Para poder modificar el juego o simplemente para tener una referencia de cómo están estructurados los archivos, necesitamos extraer su contenido.

Es importante destacar que este proceso es completamente seguro. No eliminará ni modificará tu archivo packed.pak original. Simplemente creará una copia de su contenido en una carpeta nueva. El juego siempre dará prioridad al archivo packed.pak, por lo que las modificaciones en los archivos desempaquetados no afectarán tu partida.

Instrucciones para Windows

1. Navega hasta la carpeta principal de instalación de Starbound. Si lo tienes en Steam, la ruta suele ser: Steam\steamapps\common\Starbound.
2. Dentro de esta carpeta, mantén presionada la tecla Shift y haz clic derecho en un espacio vacío. En el menú contextual, selecciona "Abrir la ventana de PowerShell aquí" o "Abrir símbolo del sistema aquí".
3. Escribe o pega el siguiente comando en la terminal que se ha abierto:
   .\win32\asset_unpacker.exe ".\assets\packed.pak" ".\assets\unpacked"
4. Presiona Enter. El programa comenzará a trabajar. Ten paciencia, ya que no mostrará una barra de progreso y puede tardar varios minutos dependiendo de la velocidad de tu ordenador. Sabrás que ha terminado cuando aparezca un mensaje similar a "Unpacked assets to unpacked in [tiempo]s".

Instrucciones para Mac

1. Abre la aplicación Terminal.
2. Navega hasta la carpeta de assets de Starbound usando el comando cd. Para una instalación estándar de Steam, el comando es:
   cd ~/Library/Application\ Support/Steam/steamapps/common/Starbound/assets
3. Crea una carpeta donde se guardarán los archivos desempaquetados:
   mkdir unpacked
4. Ahora, navega a la carpeta que contiene el desempaquetador:
   cd ../osx
5. Ejecuta el comando para desempaquetar. Esto puede tardar entre uno y varios minutos:
   ./asset_unpacker ../assets/packed.pak ../assets/unpacked
6. Una vez finalizado, podrás encontrar tus archivos en la carpeta "unpacked" que creaste.

Instrucciones para Linux

1. Abre una terminal y navega al directorio principal de Starbound. Con Steam, suele ser: ~/.steam/steam/steamapps/common/Starbound.
2. Escribe y ejecuta el siguiente comando. Este le dice al programa dónde está el ejecutable, qué archivo desempaquetar y dónde poner los archivos extraídos:
   linux/asset_unpacker assets/packed.pak unpacked_assets
3. Al igual que en Windows, no verás una barra de progreso. El proceso finalizará con un mensaje de confirmación en la terminal.

Paso 2: La Importancia del Archivo _metadata

Mientras creas tu mod, hay un archivo que, aunque opcional, es muy recomendable incluir: el archivo _metadata. Este archivo, sin extensión, se coloca en la raíz de la carpeta de tu mod y contiene información clave sobre él, como su nombre, autor, versión y descripción. ¿Por qué es tan importante? Facilita la identificación de tu mod en los registros de errores (el archivo starbound.log), y es esencial si otros mods necesitan establecer el tuyo como una dependencia.

Paso 3: Empaquetar tu Mod en un Archivo .pak

¡Ha llegado el momento de empaquetar tu creación! Este proceso convierte la estructura de carpetas y archivos de tu mod en un único archivo .pak, que los usuarios solo tendrán que arrastrar a su carpeta Starbound/mods/ para instalarlo. A continuación, te mostramos los diferentes métodos para lograrlo.

Método Manual: Control Total con la Línea de Comandos

Este método utiliza la herramienta asset_packer que viene con el juego y te da un control total sobre el proceso. Es muy similar al desempaquetado.

1. Asegúrate de que la carpeta de tu mod esté dentro de la carpeta Starbound/mods/.
2. Abre una terminal (PowerShell, Símbolo del sistema, etc.) en la carpeta principal de Starbound, igual que en el paso de desempaquetado.
3. Ejecuta el siguiente comando, sustituyendo <nombre_carpeta_mod> por el nombre de la carpeta de tu mod y <nombre_mod> por el nombre que quieres para tu archivo .pak final:
   Windows:.\win32\asset_packer.exe ".\mods\<nombre_carpeta_mod>" ".\mods\<nombre_mod>.pak"
   Mac:./osx/asset_packer ../mods/<nombre_carpeta_mod> ../mods/<nombre_mod>.pak
   Linux:linux/asset_packer mods/<nombre_carpeta_mod> mods/<nombre_mod>.pak
4. Una vez que el proceso termine, encontrarás tu reluciente archivo .pak en la carpeta mods, listo para ser distribuido.

Herramientas con Interfaz Gráfica (GUI)

Si la línea de comandos te intimida, existen alternativas visuales.

• PAK GUI: Es una sencilla aplicación para Windows. Solo tienes que ejecutarla, indicarle dónde está tu carpeta de Starbound, y luego arrastrar la carpeta de tu mod sobre la ventana del programa. Te guiará con unas simples indicaciones para crear el archivo .pak.
• ModPackHelper: Un script para Windows y Linux que automatiza el proceso. Lo colocas en tu carpeta mods, lo ejecutas y te presenta un menú donde puedes seleccionar el mod que quieres empaquetar. Es increíblemente rápido y eficiente.

A través del Uploader de Steam

Si tu objetivo es publicar tu mod en el Steam Workshop, estás de suerte. La herramienta de subida de mods que incluye la versión de Steam de Starbound empaquetará automáticamente tu mod en un archivo .pak antes de subirlo. Es el método más sencillo si tu canal de distribución principal será Steam.

Tabla Comparativa de Métodos de Empaquetado

Paso 4: Publicar y Compartir tu Creación

Con tu archivo .pak listo, solo queda compartirlo con el mundo. Tienes varias plataformas excelentes para hacerlo:

• Foros de Chucklefish: La comunidad oficial de Starbound. Es un lugar excelente para recibir feedback y conectar con otros modders.
• Steam Workshop: La plataforma más integrada y fácil de usar para los jugadores de Steam. La instalación se realiza con un solo clic.
• NexusMods: Otro gran repositorio de mods muy popular entre la comunidad de jugadores de PC.

Preguntas Frecuentes (FAQ)

¿Es muy difícil aprender a hacer mods para Starbound?

¡Para nada! Es un error común pensar que necesitas ser un experto en programación. El modding en Starbound es sorprendentemente accesible y no requiere experiencia previa en código. La estructura de archivos del juego, basada en JSON, es fácil de entender y modificar. No dejes que la edad o la falta de experiencia te detengan; si tienes una idea, puedes llevarla a cabo.

¿Por qué es necesario el archivo _metadata?

Reiterando su importancia, el archivo _metadata actúa como el DNI de tu mod. Permite que el juego y otras herramientas sepan cómo se llama, quién lo hizo y qué versión es. Esto es vital para la resolución de problemas, ya que si tu mod causa un error, su nombre aparecerá en el registro (log), facilitando enormemente la depuración tanto para ti como para los usuarios.

Mi juego se cierra después de instalar un mod, ¿qué hago?

El primer lugar que debes mirar es el archivo starbound.log. Lo encontrarás en la carpeta Starbound/storage/. Abre este archivo de texto y desplázate hasta el final. Generalmente, contendrá un mensaje de error claro que indica qué salió mal y, a menudo, qué archivo o mod es el culpable.