Changes

Jump to navigation Jump to search
1,983 bytes removed ,  23:01, 11 August 2018
switch fully to xnbcli
Line 28: Line 28:  
The Stardew Valley modding community is very welcoming. Feel free to [[Modding:Community|ask the community]] for help.
 
The Stardew Valley modding community is very welcoming. Feel free to [[Modding:Community|ask the community]] for help.
   −
==Getting started==
+
==Unpack & pack game files==
===First-time setup===
+
You can't edit an <tt>.xnb</tt> file itself, you need to edit the file that's inside it. Pulling out that inner file is called ''unpacking'', and putting it back is called ''packing''. You can do that using xnbcli, a tool for packing and unpacking XNB files. It's [https://github.com/LeonBlade/xnbcli open-source] and natively crossplatform.
Before you start, you should install these:
     −
:; on Windows
+
Here's how:
 
  −
::* '''[https://www.mediafire.com/?b86xecd27yti6f6 XNB Extract 0.2.2]''' to unpack and pack the game's XNB files. <small>(See [http://community.playstarbound.com/threads/beginners-guide-to-xnb-node-and-graphics-editing.110976/ forum post].)</small>
  −
::* '''[http://www.getpaint.net/download.html Paint.NET]''' to edit image files (or use your favourite image editor).
  −
 
  −
:; on Linux/Mac
  −
 
  −
::* '''[https://www.winehq.org/download Wine 1.7 or later]''' to run Windows programs like XNB Extract.
  −
::* '''[https://www.dropbox.com/s/oj5tch8np74nk4d/XNBExtract0.2.2.zip?dl=0 XNB Extract 0.2.2 for Linux/Mac]''' to unpack and pack the game's XNB files.
  −
::* '''[https://www.gimp.org/downloads/ GIMP]''' to edit image files (or use your favourite image editor).
  −
 
  −
You should also back up your game's <tt>Content</tt> folder, so you can recover the original files if you make a mistake.
  −
 
  −
===Unpack & pack game files===
  −
<span id="unpacking"></span>
  −
 
  −
You can't edit an <tt>.xnb</tt> file itself, you need to edit the file that's inside it. Pulling out that inner file is called ''unpacking'', and putting it back is called ''packing''. Here's how to do it:
  −
 
  −
# Download XNB Extract (see [[#First-time setup]]).
  −
# Unpack the file for editing:
  −
## Find the file you want to edit in the [[Modding:Game folder|game's <tt>Content</tt> folder]].
  −
## Copy it into XNB Extract's <tt>Packed</tt> folder.
  −
## Double-click <tt>UnpackFiles.bat</tt> (Windows) or <tt>UnpackFiles.sh</tt> (Linux/Mac).
  −
# Edit the unpacked file (see below).
  −
# Repack the file for the game:
  −
## Double-click <tt>PackFiles.bat</tt> (Windows) or <tt>PackFiles.sh</tt> (Linux/Mac).
  −
## Move the repacked <tt>.xnb</tt> file back to the original location.
  −
 
  −
==Getting started (experimental alternative)==
  −
xnbcli is a new tool for packing and unpacking XNB files. It's [https://github.com/LeonBlade/xnbcli open-source] and natively crossplatform, but still new. Try it out and [[Modding:Community#Discord|let us know]] how it goes!
  −
 
  −
<div style="border:2px solid gray; padding:0.5em;">
  −
===Unpack & pack game files===
  −
You can't edit an <tt>.xnb</tt> file itself, you need to edit the file that's inside it. Pulling out that inner file is called ''unpacking'', and putting it back is called ''packing''. Here's how to do it:
      
# Download [https://github.com/LeonBlade/xnbcli/releases xnbcli].
 
# Download [https://github.com/LeonBlade/xnbcli/releases xnbcli].
Line 76: Line 42:  
## Double-click <tt>pack.bat</tt> (Windows) or <tt>pack.sh</tt> (Linux/Mac).
 
## Double-click <tt>pack.bat</tt> (Windows) or <tt>pack.sh</tt> (Linux/Mac).
 
## Move the repacked <tt>.xnb</tt> file back to the original location.
 
## Move the repacked <tt>.xnb</tt> file back to the original location.
</div>
      
==Making changes==
 
==Making changes==
translators
8,411

edits

Navigation menu