Difference between revisions of "Modding:Using XNB mods"

From Stardew Valley Wiki
Jump to navigation Jump to search
(→‎Why are they discouraged?: link open-source for new mod authors)
(→‎Alternatives using Content Patcher: update for new Nexus profile pages)
 
(8 intermediate revisions by 3 users not shown)
Line 108: Line 108:
 
   |update url      = https://community.playstarbound.com/threads/migrating-xnb-mods-to-content-patcher-packs.141577/page-21#post-3284310
 
   |update url      = https://community.playstarbound.com/threads/migrating-xnb-mods-to-content-patcher-packs.141577/page-21#post-3284310
 
   |update author  = Allayna
 
   |update author  = Allayna
 +
  |update version  = 1.0
 +
}}
 +
{{/xnb
 +
  |original name  = 3D-Slime Hutch
 +
  |original author = anjarpsx
 +
  |original url    = {{nexus mod|737}}
 +
  |update name    = unofficial update
 +
  |update url      = https://community.playstarbound.com/threads/migrating-xnb-mods-to-content-patcher-packs.141577/page-91#post-3325452
 +
  |update author  = coldazrael
 
   |update version  = 1.0
 
   |update version  = 1.0
 
}}
 
}}
Line 394: Line 403:
 
   |original url    = {{nexus mod|688}}
 
   |original url    = {{nexus mod|688}}
 
   |update name    = unofficial update
 
   |update name    = unofficial update
   |update url      = http://forums.stardewvalley.net/threads/migrating-xnb-mods-to-content-patcher-packs.564/post-66222
+
   |update url      = https://forums.stardewvalley.net/threads/migrating-xnb-mods-to-content-patcher-packs.564/page-5#post-66222
 
   |update author  = NeutronPong
 
   |update author  = NeutronPong
 
   |update version  = 1.1.0
 
   |update version  = 1.1.0
Line 547: Line 556:
 
   |original url    = {{nexus mod|3218}}
 
   |original url    = {{nexus mod|3218}}
 
   |update name    = unofficial update
 
   |update name    = unofficial update
   |update url      = https://forums.stardewvalley.net/threads/migrating-xnb-mods-to-content-patcher-packs.564/#post-28452
+
  |update url      = {{nexus mod|8942}}
   |update author  = lorduc
+
  |update author  = orientalmelon
   |update version  = 2.0
+
  |update version  = 1.0.1
 +
}}
 +
{{/xnb
 +
  |original name  = Baechu's Portraits Seasonal SVO
 +
  |original author = Baechu
 +
  |original url    = {{nexus mod|3218}}
 +
  |update name    = unofficial update
 +
   |update url      = https://forums.stardewvalley.net/threads/unofficial-mod-updates.2096/page-84#post-55753
 +
   |update author  = bunwangji
 +
   |update version  = 1.0.0
 
}}
 
}}
 
{{/xnb
 
{{/xnb
Line 712: Line 730:
 
   |update author  = MouseyPounds
 
   |update author  = MouseyPounds
 
   |update version  = 1.1
 
   |update version  = 1.1
 +
}}
 +
{{/xnb
 +
  |original name  = Better Harvey Character Sprite
 +
  |original author = Plutey/Androxilogin
 +
  |original url    = {{nexus mod|363}}
 +
  |update name    = unofficial update
 +
  |update url      = https://forums.stardewvalley.net/threads/migrating-xnb-mods-to-content-patcher-packs.564/page-4#post-52324
 +
  |update author  = Kreeate
 +
  |update version  = 1.0
 
}}
 
}}
 
{{/xnb
 
{{/xnb
Line 1,071: Line 1,098:
 
   |update url      = https://community.playstarbound.com/threads/migrating-xnb-mods-to-content-patcher-packs.141577/page-2#post-3261364
 
   |update url      = https://community.playstarbound.com/threads/migrating-xnb-mods-to-content-patcher-packs.141577/page-2#post-3261364
 
   |update author  = arkoiris
 
   |update author  = arkoiris
 +
  |update version  = 1.0
 +
}}
 +
{{/xnb
 +
  |original name  = Catsine's Victorian Beehouses
 +
  |original author = Ernest/Catsine
 +
  |original url    = {{nexus mod|3297}}
 +
  |update name    = unofficial mod
 +
  |update url      = https://community.playstarbound.com/threads/migrating-xnb-mods-to-content-patcher-packs.141577/page-115#post-3345858
 +
  |update author  = xbukimina
 
   |update version  = 1.0
 
   |update version  = 1.0
 
}}
 
}}
Line 1,144: Line 1,180:
 
   |update author  = paradigmnomad
 
   |update author  = paradigmnomad
 
   |update version  = 1.0
 
   |update version  = 1.0
 +
}}
 +
{{/xnb
 +
  |original name  = Chickens to Parrots v2
 +
  |original author = gizomo
 +
  |original url    = https://community.playstarbound.com/threads/turns-all-your-chickens-into-parrots.135204/
 +
  |update name    = Tropical Birds
 +
  |update url      = https://forums.stardewvalley.net/threads/unofficial-mod-updates.2096/page-98#post-73844
 +
  |update author  = Allayna
 +
  |update version  = 1.2
 
}}
 
}}
 
{{/xnb
 
{{/xnb
Line 1,223: Line 1,268:
 
   |update name    = unofficial update
 
   |update name    = unofficial update
 
   |update url      = https://community.playstarbound.com/threads/migrating-xnb-mods-to-content-patcher-packs.141577/page-115#post-3345549
 
   |update url      = https://community.playstarbound.com/threads/migrating-xnb-mods-to-content-patcher-packs.141577/page-115#post-3345549
   |update author  = krissymarie
+
   |update author  = k10_ftw/krissymarie
 
   |update version  = 1.0
 
   |update version  = 1.0
 
}}
 
}}
Line 1,508: Line 1,553:
 
   |original name  = Dizor's Character Redraws
 
   |original name  = Dizor's Character Redraws
 
   |original author = Dizor
 
   |original author = Dizor
   |original url    = {{nexus author|947745}}
+
   |original url    = {{nexus author|Dizor}}
 
   |update name    = unofficial update
 
   |update name    = unofficial update
 
   |update url      = https://community.playstarbound.com/threads/migrating-xnb-mods-to-content-patcher-packs.141577/page-99#post-3331859
 
   |update url      = https://community.playstarbound.com/threads/migrating-xnb-mods-to-content-patcher-packs.141577/page-99#post-3331859
Line 1,575: Line 1,620:
 
   |update url      = https://community.playstarbound.com/threads/migrating-xnb-mods-to-content-patcher-packs.141577/page-10#post-3276212
 
   |update url      = https://community.playstarbound.com/threads/migrating-xnb-mods-to-content-patcher-packs.141577/page-10#post-3276212
 
   |update author  = waftwaffle
 
   |update author  = waftwaffle
 +
  |update version  = 1.0
 +
}}
 +
{{/xnb
 +
  |original name  = Dust Spirit Recolor- Susuwatari
 +
  |original author = FinalMantasyX
 +
  |original url    = https://community.playstarbound.com/threads/dust-spirit-recolor-susuwatari-soot-spirits-from-spirited-away.107820/
 +
  |update name    = unofficial update
 +
  |update url      = https://forums.stardewvalley.net/threads/migrating-xnb-mods-to-content-patcher-packs.564/page-4#post-52216
 +
  |update author  = Shaymin
 
   |update version  = 1.0
 
   |update version  = 1.0
 
}}
 
}}
Line 1,625: Line 1,679:
 
   |original name  = Eemie Animal Collection
 
   |original name  = Eemie Animal Collection
 
   |original author = Eemie
 
   |original author = Eemie
   |original url    = {{nexus author|34984615}}
+
   |original url    = {{nexus author|Eemiestardew}}
 
   |update name    = unofficial update
 
   |update name    = unofficial update
 
   |update url      = https://community.playstarbound.com/threads/migrating-xnb-mods-to-content-patcher-packs.141577/page-10#post-3277270
 
   |update url      = https://community.playstarbound.com/threads/migrating-xnb-mods-to-content-patcher-packs.141577/page-10#post-3277270
Line 1,736: Line 1,790:
 
   |update name    = unofficial update
 
   |update name    = unofficial update
 
   |update url      = https://community.playstarbound.com/threads/migrating-xnb-mods-to-content-patcher-packs.141577/#post-3261025
 
   |update url      = https://community.playstarbound.com/threads/migrating-xnb-mods-to-content-patcher-packs.141577/#post-3261025
   |update author  = .lavender.
+
   |update author  = .Lavender.
 
   |update version  = 1.1
 
   |update version  = 1.1
 
}}
 
}}
Line 2,482: Line 2,536:
 
   |original url    = {{nexus mod|1572}}
 
   |original url    = {{nexus mod|1572}}
 
   |update name    = unofficial update
 
   |update name    = unofficial update
   |update url      = https://community.playstarbound.com/threads/migrating-xnb-mods-to-content-patcher-packs.141577/page-115#post-3345522
+
   |update url      = https://forums.stardewvalley.net/threads/unofficial-mod-updates.2096/page-98#post-73276
   |update author  = krissymarie
+
   |update author  = Allayna
 
   |update version  = 1.1
 
   |update version  = 1.1
 
}}
 
}}
Line 2,725: Line 2,779:
 
   |update url      = https://community.playstarbound.com/threads/migrating-xnb-mods-to-content-patcher-packs.141577/page-11#post-3277868
 
   |update url      = https://community.playstarbound.com/threads/migrating-xnb-mods-to-content-patcher-packs.141577/page-11#post-3277868
 
   |update author  = paradigmnomad
 
   |update author  = paradigmnomad
 +
  |update version  = 1.0
 +
}}
 +
{{/xnb
 +
  |original name  = Horse to Vespa Scooter + Garage
 +
  |original author = Pi.Curious
 +
  |original url    = https://community.playstarbound.com/threads/horse-to-vespa-scooter-garage-joja-scooter-added.110212/
 +
  |update name    = unofficial update
 +
  |update url      = https://forums.stardewvalley.net/threads/migrating-xnb-mods-to-content-patcher-packs.564/page-6#post-75931
 +
  |update author  = phomaique
 
   |update version  = 1.0
 
   |update version  = 1.0
 
}}
 
}}
Line 3,075: Line 3,138:
 
   |update url      = https://community.playstarbound.com/threads/migrating-xnb-mods-to-content-patcher-packs.141577/page-6#post-3273575
 
   |update url      = https://community.playstarbound.com/threads/migrating-xnb-mods-to-content-patcher-packs.141577/page-6#post-3273575
 
   |update author  = D.Grey
 
   |update author  = D.Grey
 +
  |update version  = 1.0
 +
}}
 +
{{/xnb
 +
  |original name  = let 's cafe
 +
  |original author = momoki
 +
  |original url    = {{nexus mod|10546}}
 +
  |update name    = unofficial update
 +
  |update url      = https://forums.stardewvalley.net/threads/migrating-xnb-mods-to-content-patcher-packs.564/page-5#post-70199
 +
  |update author  = Allayna
 
   |update version  = 1.0
 
   |update version  = 1.0
 
}}
 
}}
Line 3,337: Line 3,409:
 
   |update author  = coldazrael
 
   |update author  = coldazrael
 
   |update version  = 2.0
 
   |update version  = 2.0
 +
}}
 +
{{/xnb
 +
  |original name  = Metal Worm Bin
 +
  |original author = vkunicorn
 +
  |original url    = {{nexus mod|2675}}
 +
  |update name    = unofficial update
 +
  |update url      = https://forums.stardewvalley.net/threads/migrating-xnb-mods-to-content-patcher-packs.564/page-6#post-75923
 +
  |update author  = phomaique
 +
  |update version  = 1.0
 
}}
 
}}
 
{{/xnb
 
{{/xnb
Line 3,418: Line 3,499:
 
   |update author  = hwayunhae
 
   |update author  = hwayunhae
 
   |update version  = 1.0
 
   |update version  = 1.0
 +
}}
 +
{{/xnb
 +
  |original name  = Mi's Elegant Victorian interior
 +
  |original author = Mi/Campanulamis
 +
  |original url    = {{nexus mod|1074}}
 +
  |update name    = unofficial update
 +
  |update url      = https://forums.stardewvalley.net/threads/migrating-xnb-mods-to-content-patcher-packs.564/page-4#post-51572
 +
  |update author  = mouse
 +
  |update version  = 1.3
 
}}
 
}}
 
{{/xnb
 
{{/xnb
Line 3,462: Line 3,552:
 
   |update url      = https://community.playstarbound.com/threads/migrating-xnb-mods-to-content-patcher-packs.141577/page-64#post-3305886
 
   |update url      = https://community.playstarbound.com/threads/migrating-xnb-mods-to-content-patcher-packs.141577/page-64#post-3305886
 
   |update author  = coldazrael
 
   |update author  = coldazrael
 +
  |update version  = 1.0
 +
}}
 +
{{/xnb
 +
  |original name  = Moon Meteor 달 운석 리텍스쳐
 +
  |original author =  이얏호 ssm4031
 +
  |original url    = https://blog.naver.com/ssm4031/221501552288
 +
  |update name    = unofficial update
 +
  |update url      = https://forums.stardewvalley.net/threads/migrating-xnb-mods-to-content-patcher-packs.564/page-5#post-70203
 +
  |update author  = Allayna
 
   |update version  = 1.0
 
   |update version  = 1.0
 
}}
 
}}
Line 3,499: Line 3,598:
 
   |update author  = Arkanto
 
   |update author  = Arkanto
 
   |update version  = 1.0
 
   |update version  = 1.0
 +
}}
 +
{{/xnb
 +
  |original name  = Morst-CERBERUS and SUPI
 +
  |original author = QuQii/songaoyuan
 +
  |original url    = {{nexus mod|9904}}
 +
  |update name    = unofficial update
 +
  |update url      = https://forums.stardewvalley.net/threads/migrating-xnb-mods-to-content-patcher-packs.564/page-5#post-56273
 +
  |update author  = marshallharck
 +
  |update version  = 1.5.4
 
}}
 
}}
 
{{/xnb
 
{{/xnb
Line 4,417: Line 4,525:
 
   |update author  = Seyph
 
   |update author  = Seyph
 
   |update version  = 1.0.1
 
   |update version  = 1.0.1
 +
}}
 +
{{/xnb
 +
  |original name  = Sam/Sebastian Romance Mod Sambastian
 +
  |original author = Pixelated Farmhouse
 +
  |original url    = https://pixelatedfarmhouse.tumblr.com/post/190537323066/samsebastian-romance-mod
 +
  |update name    = unofficial update
 +
  |update url      = https://forums.stardewvalley.net/threads/migrating-xnb-mods-to-content-patcher-packs.564/page-6#post-71693
 +
  |update author  = Allayna
 +
  |update version  = 1.4
 
}}
 
}}
 
{{/xnb
 
{{/xnb
Line 4,644: Line 4,761:
 
}}
 
}}
 
{{/xnb
 
{{/xnb
   |original name  = Slime Animals
+
   |original name  = Slime-Animals
 
   |original author = Sabishi1985
 
   |original author = Sabishi1985
 
   |original url    = https://community.playstarbound.com/threads/slime-animals-last-update-09-10-2016.110931/
 
   |original url    = https://community.playstarbound.com/threads/slime-animals-last-update-09-10-2016.110931/
   |update name    = unofficial update
+
   |update name    = Slime Rancher
   |update url      = https://community.playstarbound.com/threads/migrating-xnb-mods-to-content-patcher-packs.141577/#post-3258724
+
   |update url      = {{nexus mod|12654}}
   |update author  = paradigmnomad
+
   |update author  = Eldritchdraaks
 
   |update version  = 1.0
 
   |update version  = 1.0
 
}}
 
}}
Line 4,792: Line 4,909:
 
   |original url    = {{nexus mod|1875}}
 
   |original url    = {{nexus mod|1875}}
 
   |update name    = unofficial update
 
   |update name    = unofficial update
   |update url      = https://community.playstarbound.com/threads/migrating-xnb-mods-to-content-patcher-packs.141577/page-85#post-3322693
+
   |update url      = https://forums.stardewvalley.net/threads/migrating-xnb-mods-to-content-patcher-packs.564/page-6#post-72444
   |update author  = coldazrael
+
   |update author  = Allayna
 
   |update version  = 1.0
 
   |update version  = 1.0
 
}}
 
}}
Line 5,496: Line 5,613:
 
   |update url      = {{nexus mod|1853}}
 
   |update url      = {{nexus mod|1853}}
 
   |update author  = Marilyst
 
   |update author  = Marilyst
   |update version  = 1.0
+
   |update version  = 1.3.1
 
}}
 
}}
 
{{/xnb
 
{{/xnb
Line 5,595: Line 5,712:
 
[[de:Modding:XNB Mods]]
 
[[de:Modding:XNB Mods]]
 
[[es:Modding:Uso de mods XNB]]
 
[[es:Modding:Uso de mods XNB]]
 +
[[pt:Modificações:Usando mods XNB]]
 
[[ru:Модификации:Использование XNB модификаций]]
 
[[ru:Модификации:Использование XNB модификаций]]
 
[[zh:模组:使用 XNB 模组]]
 
[[zh:模组:使用 XNB 模组]]

Latest revision as of 18:38, 24 April 2024

Index

XNB mods are an older type of mod and are no longer recommended. SMAPI can't validate them for compatibility. Use XNB mods at your own risk, or see alternatives using Content Patcher.

An XNB mod replaces some of your game's .xnb files to change the game (unlike newer mods that go in your Mods folder).

FAQs

What are XNB mods?

XNB mods work by replacing your game's data files (which have a .xnb extension). For example, let's say you want to change Abigail's portraits; you can replace Content/Portraits/Abigail.xnb with a modded version to do it. (See editing XNB files for more info on the XNB format.)

Why are they discouraged?

XNB mods have a lot of limitations, often conflict with each other, usually break when the game updates, are hard to install and remove, etc.

Consider only using SMAPI mods and content packs. These have several benefits over XNB mods:

feature XNB mods SMAPI mods SMAPI content packs
ease of installation ✘ different for every mod ✓ drop into Mods
ease of uninstallation ✘ manually restore original files ✓ remove from Mods
update checks ✘ none ✓ automatic alert in SMAPI console
compatibility checks ✘ none ✓ incompatible mods are disabled before they cause problems
compatibility list is regularly updated with updates and workarounds
mod compatibility ✘ each file can only be replaced once ✓ almost universal ✓ high
translation support ✘ difficult to translate ✓ built-in translation API (depends on the content pack)
game compatibility ✘ broken by most game updates ✓ SMAPI automatically rewrites many mods for compatibility
open-source mods are updated quickly

Do they work on Linux, Mac, Windows, or consoles?

XNB mods work equally on Linux, Mac, Windows, and Android. Consoles aren't supported.

Can they corrupt my save?

Yes, but it's uncommon. Make sure you back up your save files occasionally, and remove any custom content before uninstalling an XNB mod. In most cases, you can fix save corruption by undoing the last save.

Do they disable Steam achievements?

Nope.

Alternatives using Content Patcher

Content Patcher is a SMAPI mod that makes XNB-like changes with all the benefits of SMAPI content packs. Many XNB mods have a Content Patcher equivalent, or have been updated unofficially to use it. Consider using these instead where available.

Modders:

  • When migrating XNB mods, only use Action: Load if you actually need to replace the whole file (e.g., portrait mods). Don't use Action: Load for dialogue mods or to change a small part of a file!
  • See Migrating XNB mods to Content Patcher packs on the official forums for more info about creating conversions.

Using XNB mods

Find mods

See Find mods on the Getting Started page.

Install mods

Installation is different for each mod; check its mod description for details. But in general:

  1. Download the XNB mod and unzip it somewhere (not in your game folder!).
  2. It should contain some .xnb files.
  3. Find your game folder.
  4. Replace the existing .xnb files under Content with the ones from the mod. Make sure you replace the correct files! There are different files with the same name (like Content/Data/hats.xnb and Content/Characters/hats.xnb), and replacing the wrong file will cause in-game errors or crashes.

Uninstall mods

Either restore the original files that mod replaced (hope you kept track!), or reset your game files.

Troubleshooting

Reset content files

If you know which mod caused the problem, uninstall it.

If you're not sure, the simplest option is:

  1. reset your game files;
  2. reinstall each XNB mod one by one;
  3. test after each install to make sure it didn't cause problems.

Other issues

See Modding:Player Guide/Troubleshooting for more suggestions.