Cambios

Ir a la navegación Ir a la búsqueda
← [[Modding:Índice|Índice]]

Esta página explica cómo editar los archivos del juego para cambiar los datos, las imágenes y los mapas del juego.

==Introducción==
===¿Qué son los archivos XNB?===
El juego almacena datos, mapas y texturas en un formato comprimido con la extensión de archivo <samp>.xnb</samp> .dentro de su carpeta <samp>Content</samp>. Por ejemplo, el retrato de Abigail que se muestra durante el diálogo es <samp>Content\Portraits\Abigail.xnb</samp>. Desempaquetar ese archivo le da <samp>Abigail.png</samp> de esta manera:<br />[[File:Modding - creating an XNB mod - example portraits.png]]

(Al usar xnbcli, puede obtener un archivo extra <samp>Abigail.json</samp>. Eso solo se usa para convertirlo de nuevo en un <samp>.xnb</samp> más adelante y, por lo general, no tendrá que cambiarlo).

===¿Cómo obtengo mis cambios en el juego?===
Hay tres formas de obtener tus cambios en el juego:

# [[Modding:Content Patcher|Cree un paquete de contenido de Content Patcher]]. Esto le permite cambiar los datos XNB del juego sin programar (simplemente editando un archivo JSON) y sin reemplazar los archivos reales del juego.
# [[Modding:Guía del Modder/Introducción|Cree un mod SMAPI]] y use la [[Modding:Guía del Modder/APIs/Contenido|API de contenido]]. Sin embargo, esto requiere programación.
# Crea un mod XNB reemplazando los archivos originales del juego. Esto ya no se recomienda y no se documenta aquí; consulte el [[Modding:using XNB mods|uso de mods XNB]] para obtener más información.

===¿Dónde puedo obtener ayuda?===
La comunidad de modding de Stardew Valley es muy acogedora. No dude en pedir ayuda a la [[Modding:Comunidad|comunidad]].

==<span id="unpacking">Desempaquetar archivos del juego</span>==
No puedes editar un archivo <samp>.xnb</samp> en sí, necesita editar el archivo que está dentro de él. Sacar ese archivo interno se denomina ''desempaquetar'', y volver a colocarlo se denomina ''empaquetar''. Hay dos desempaquetadores XNB principales disponibles.

===StardewXnbHack===
{{github|Pathoschild/StardewXnbHack#readme|StardewXnbHack}} es una herramienta de código abierto y multiplataforma para descomprimir archivos XNB. No puede volver a empaquetar archivos en <samp>.xnb</samp>, pero [[Modding:Content Patcher|rara vez es necesario]].

Así es cómo:

# [[Modding:Guía del jugador/Introducción|Instale SMAPI]].
# {{github|Pathoschild/StardewXnbHack/releases|Descargar StardewXnbHack}}.(Asegúrese de descargar el archivo para su sistema operativo, como <samp>StardewXnbHack-*-para-windows.zip</samp>, ¡no el código fuente!)
# Descomprima la descarga en la [[Modding:Game folder|carpeta de su juego]], para <samp>StardewXnbHack.exe</samp> que se encuentre en la misma carpeta que <samp>StardewValley.exe</samp>.
# Haga doble click <samp>StardewXnbHack.exe</samp> (en Windows), <samp>StardewXnbHack.sh</samp> (en Linux), o <samp>StardewXnbHack.command</samp> (en MacOS) para desempaquetar todo el juego es la carpeta <samp>Content</samp>.

¡Eso es! Desempaquetar los archivos la carpeta <samp>Content (desempaquetado)</samp> folder. Los archivos desempaquetados ya serán compatibles con el [[Modding:Content Patcher|Content Patcher]].

===xnbcli===
{{github|LeonBlade/xnbcli#readme|xnbcli}} es una herramienta multiplataforma y de código abierto para empaquetar y desempaquetar archivos XNB. No puede descomprimir archivos XNB que contengan modelos de datos (como <samp>Data\FishPondData</samp> o <samp>Data\Movies</samp>), y deberá editar los archivos de datos manualmente para trabajar con mods como el Content Patcher.

Here's how:

<ol>
<li>{{github|LeonBlade/xnbcli/releases|Descargar xnbcli}}. (Asegúrese de descargar el archivo para su sistema operativo, como el <samp>xnbcli-windows-x64.zip</samp>, ¡no el código fuente!)</li>
<li>Descomprima el archivo para editarlo:
# Encuentra el archivo que deseas editar en la carpeta del juego [[Modding:Guía del jugador/Introducción#Encuentra tu carpeta del juego|<samp>Content</samp>]].
# Cópialo en la carpeta xnbcli's <samp>empacada</samp>.
# Haga doble click <samp>unpack.bat</samp> (Windows), <samp>unpack.sh</samp> (Linux), o <samp>unpack.command</samp> (Mac).
# Compruebe la carpeta <samp>Desempaquetada</samp> ara sus archivos desempaquetados. (Si no descomprimió muchos archivos, es posible que simplemente parpadee en la pantalla y desaparezca nuevamente, ¡pero eso es normal! De todos modos, verifique la carpeta para ver si hay cambios. Tenga en cuenta que 1.4 introdujo un nuevo formato de modelo de datos que xnbcli no puede manejar; para algunos datos necesitará usar [[#StardewXnbHack|StardewXnbHack]] en su lugar.)
</li>
<li>Edite el archivo desempaquetado (ver más abajo).</li>
<li>Si se trata de un archivo de datos (no de una imagen o un mapa), hay un paso más si desea reemplazar o editar el archivo con [[Modding:Content Patcher|Content Patcher]]: removiendo los metadatos XNB. Su archivo JSON actual debería verse así:
<syntaxhighlight lang="js">
{
"header": {
"target": "w",
"formatVersion": 5,
"hidef": true,
"compressed": true
},
"readers": [
{
"type": "Microsoft.Xna.Framework.Content.DictionaryReader`2[[System.Int32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089],[System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]",
"version": 0
},
{
"type": "Microsoft.Xna.Framework.Content.Int32Reader",
"version": 0
},
{
"type": "Microsoft.Xna.Framework.Content.StringReader",
"version": 0
}
],
"content": {
"0": "Weeds/0/-1/Basic/Weeds/A bunch of obnoxious weeds."
}
}
</syntaxhighlight>
Simplemente elimine todo excepto el campo de content, para que se vea así:
<syntaxhighlight lang="js">
{
"0": "Weeds/0/-1/Basic/Weeds/A bunch of obnoxious weeds."
}
</syntaxhighlight></li>
</ol>

'''Solución de problemas:'''

* Si obtiene el permiso denegado en Linux/Mac:
*# Abre una terminal. (En MacOS, busque 'Terminal' en Spotlight.)
*# Escriba <code>chmod +x&nbsp;</code>, ''con un espacio al final ''. No presiones enter todavía.
*# Arrastrar el <samp>unpack.sh</samp> (Linux) o <samp>unpack.command</samp> (Mac) en el terminal para pegar su ruta.
*# Pulsa Enter. Si lo hizo correctamente, la terminal no mostrará ningún mensaje, pero el error de permiso debería desaparecer.
*# Repetir para <samp>pack.sh</samp> (Linux) o <samp>pack.command</samp> (Mac).
* Si obtiene un comando no reconocido en Windows:
*# Asegúrese de no descargar el código fuente zip por error. Si la ruta de la carpeta se refiere a "master", ¡es la incorrecta!

==Empaquetar archivos de juegos==
¡No hay necesidad de volver a empaquetar los archivos del juego si está utilizando [[Modding:Content Patcher|Content Patcher]]! solo usa el archivo <samp>.json</samp>, <samp>.png</samp>, o <samp>.tbin</samp> directamente en su <samp>content.json</samp>.

Si realmente desea volver a empaquetar los archivos, deberá usar [[#xnbcli|xnbcli]]:

# Busque el archivo que desea volver a empaquetar.
# Cópialo en xnbcli's la carpeta <samp>desempaquetado</samp>.
# Haga doble click <samp>pack.bat</samp> (Windows), <samp>pack.sh</samp> (Linux), o <samp>pack.command</samp> (Mac).
# Mover el archivo empaquetado <samp>.xnb</samp> de vuelta a la ubicación original.

==Haciendo cambios==
===Datos===
Cada XNB de datos tiene su propio formato. Consulte la documentación en [[Modding:Índice#Temas avanzados]].

===Imágenes===
[[File:Modding - creating an XNB mod - example tilesheet.png|thumb|Una hoja de baldosas de ejemplo, que consiste en una cuadrícula de baldosas como este:[[File:Modding - creating an XNB mod - example tile 1.png]]]]
Algunas definiciones:
* Una '''hoja de sprites (spritesheet )''' es un archivo PNG que contiene imágenes pequeñas (generalmente en un patrón de cuadrícula regular). Cada cuadrado en el patrón de cuadrícula del spritesheet (hoja de sprites) se llama '''sprite'''. Por ejemplo, cada objeto del juego tiene un sprite en <samp>Content\Maps\spring_objects.xnb</samp>.
* Una '''hoja de baldosas (tilesheet)''' es un sinónimo de hoja de sprites cuando se usa para mosaicos de mapas. En una hoja de baldosas (tilesheet), cada cuadrado se llama ''baldosa (tile )'' y tiene 16×16 píxeles.
* Un '''retrato''' es un sprite de la spritesheets (hoja de sprites) <samp>Content\Characters\*.xnb</samp>.

Las hojas de sprites son fáciles de editar:
# [[#unpacking|Descomprima]] el archivo que desea cambiar.
# Abra el archivo desempaquetado <samp>.png</samp> en un editor de imágenes (como [http://www.getpaint.net/download.html Paint.NET] en Windows, o [https://www.gimp.org/downloads/ GIMP] en Windows/Linux/Mac). ''Tenga en cuenta que es importante usar un editor de imágenes que pueda manejar la transparencia (también conocido como canal alfa), a diferencia de Microsoft Paint.''
# Realice cambios directamente en la imagen.
# Vuelva a [[#Empaquetar archivos de juegos|empaquetar ]] el archivo y cópielo de nuevo en la ubicación original.

¡Eso es! Puedes iniciar el juego para ver tus cambios.

===Mapas===
Ver en [[Modding:Mapas]].

===Edición de contenido===
Tenga en cuenta que los precios del software que se enumeran a continuación están sujetos a cambios.
====Software de Pixel Art====
{| class="wikitable"
|-
! Software
! Precio (USD)
! Sistema operativo
! Notas
|-
| [https://www.aseprite.org/ Aseprite]
| $19.99
| Windows, macOS, Linux
| Gratis si te compilas a partir del [https://github.com/aseprite/aseprite código fuente]
|-
| [https://www.adobe.com/products/photoshop.html Photoshop]
| $9.99/mes
| Windows, macOS
| Servicio basado en suscripción
|-
| [https://www.getpaint.net/ PAINT.NET]
| Gratis y $6.99 en Microsoft Store
| Windows
|
|-
| [https://www.gimp.org/ GIMP]
| Gratis
| Windows, macOS, Linux
|
|-
| [https://krita.org/en/ Krita]
| Gratis y $9.99 en Steam
| Windows, macOS, Linux
|
|-
| [https://pyxeledit.com/ Pyxel Edit]
| $9.00
| Windows
| Actualmente en versión beta, sujeto a un aumento de precio tras el lanzamiento completo
|-
| [https://play.google.com/store/apps/details?id=com.PixelStudio Pixel Studio Android] or [https://store.steampowered.com/app/1204050/Pixel_Studio_for_pixel_art/ Pixel Studio Steam]
| Gratis - Aplicación de compras en Android
| Android, Windows
|
|-
|}

====Software de edición de texto====
{| class="wikitable"
|-
! Software
! Precio (USD)
! Sistema operativo
! Notas
|-
| [https://www.sublimetext.com/ Sublime Text]
| $99.00
| Windows, macOS, Linux
| Prueba gratuita ilimitada
|-
| [https://notepad-plus-plus.org/downloads/ Notepad++]
| Gratis
| Windows
|
|-
| [https://code.visualstudio.com/ Visual Studio Code]
| Gratis
| Windows, macOS, Linux
|
|-
| [https://atom.io/ Atom]
| Gratis
| Windows, macOS, Linux
|
|-
|}

[[Category:Modding]]

[[en:Modding:Editing XNB files]]
[[ru:Модификации:Редактирование XNB файлов]]
[[zh:模组:编辑 XNB 文件]]
836

ediciones

Menú de navegación