translators
8,404
edits
Changes
→Unpack & pack game files: cover unpacking/repacking for Content Patcher
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.
==<span id="unpacking">Unpack & pack game files</span>==
==<span id="unpacking">Unpack game files</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''. 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.
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.
Here's how:
Here's how:
<ol>
<li>Download [https://github.com/LeonBlade/xnbcli/releases xnbcli].</li>
<li>Unpack the file for editing:
# Find the file you want to edit in the [[Modding:Player Guide/Getting Started#Find your game folder|game's <tt>Content</tt> folder]].
# Copy it into xnbcli's <tt>packed</tt> folder.
# Double-click <tt>unpack.bat</tt> (Windows), <tt>unpack.sh</tt> (Linux), or <tt>unpack.command</tt> (Mac).
</li>
<li>Edit the unpacked file (see below).</li>
<li>If this is a data file (not an image or map), there's one more step if you want to replace the file with {{nexus mod|1915|Content Patcher}}'s <tt>Action: Load</tt>: removing the XNB metadata. Your current JSON file should look something like this:
<source 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."
}
}
</source>
Just remove everything except the content field, so it looks like this:
<source lang="js">
{
"0": "Weeds/0/-1/Basic/Weeds/A bunch of obnoxious weeds."
}
</source></li>
</ol>
'''Troubleshooting:'''
'''Troubleshooting:'''
*# Hit enter. If you did it correctly, the terminal won't show any message but the permission error should be gone.
*# Hit enter. If you did it correctly, the terminal won't show any message but the permission error should be gone.
*# Repeat for <tt>pack.sh</tt> (Linux) or <tt>pack.command</tt> (Mac).
*# Repeat for <tt>pack.sh</tt> (Linux) or <tt>pack.command</tt> (Mac).
==Pack game files==
There's no need to repack game files if you're using {{nexus mod|1915|Content Patcher}}! Just use the <tt>.json</tt>, <tt>.png</tt>, or <tt>.tbin</tt> file directly in your <tt>content.json</tt>.
If you really want to repack the files:
# Find the file you want to repack.
# Copy it into xnbcli's <tt>unpacked</tt> folder.
# Double-click <tt>pack.bat</tt> (Windows), <tt>pack.sh</tt> (Linux), or <tt>pack.command</tt> (Mac).
# Move the repacked <tt>.xnb</tt> file back to the original location.
==Making changes==
==Making changes==