RimWorld Wiki - User contributions [en]

Modding Troubleshooting Tips and Guides

2022-05-07T05:07:40Z

Trisscar: List of troubleshooters woes that people keep doing even after reading everything above this addition. Lemme know if anything is problematic in any way please.

{| align=center
| {{Basics_Nav}}
|}
----

{{TOCright}}
== Basic Troubleshooting Things You Should Do ==

"My game broke/crashed/the UI is gone/froze, what do I do?"

'''''You should:'''''

- Verify with Steam (if you use it to run Rimworld).

- Clear your configs (instructions below).

- Check your mod order (instructions also below).

- Make sure no mods updated since you last played, if a game that was running fine suddenly broke the next time you loaded it.

-----------------

=== Basic Load Order Rules: ===

Mods must be loaded beneath any and all dependencies.

eg: most mods depend on Core to function and must load below it

Mods should not/cannot be loaded with other incompatible mods.

How do we know which mods are incompatible? Reading mod descriptions, asking people who know things, and trial/error

In the instance of multiple mods that change the same thing, whichever is loaded last will take precedent

There are some "ifs" and "buts" in this statement, but it's largely true

=== Local Mods: ===

Windows:
C:\Program Files (x86)\Steam\steamapps\common\RimWorld\Mods

or
C:\Program Files (x86)\RimWorld\Mods

Mac OS X:
Right-click the RimWorld application and show package contents
cd Library/Application\ Support/Steam/steamapps/common/RimWorld

Linux:
~/.steam/steam/steamapps/common/Rimworld/Mods;

=== Config Files: ===

--RimWorld configuration files and most mod settings are kept in this folder, and removing them will reset all settings to default.

--"Clearing configs" refers to deletion of old/all configs in the aforementioned folder

--Old mod config files are not automatically removed and may cause errors.

--Save the "ModsConfig.xml" as this is your mod load order, and if you remove it you will lose your modded load order.
%appdata%\..\LocalLow\Ludeon Studios\RimWorld by Ludeon Studios\Config

=== Steam Default Install Location: ===
C:\Program Files (x86)\Steam\steamapps\common

=== Steam Default Mod Install Folder: ===
C:\Program Files (x86)\Steam\steamapps\workshop\content\294100

=== Verify Game Files with Steam: ===

> Steam Library

> Right Click RimWorld

> Properties

> Local Files

> Verify Integrity of Game Files...

=== Change Game Version with Steam: ===

> Steam Library

> Right Click RimWorld

> Properties

> Betas

> "Select the beta you would like to opt into:"

=== Load Order: ===

Rimpy is a useful tool that works outside the game, to make it easier to sort your mods. It also has it's own auto-sort function if you want to see if that will help your issue:

https://steamcommunity.com/sharedfiles/filedetails/?id=1847679158&searchtext=rimpy

There are also a few mod managers out there, both as mods and as external programs.

Another option for sorting your mods is to follow this guide here:

https://rwom.fandom.com/wiki/Mod_Order_Guide

--------------------------

''
'''An explanation of how this works code wise;'''

"Keep in mind that not all mod conflicts will be solved by shuffling load order around. Sometimes mods are just incompatible until the mod authors put in effort to fix their mods.

Sometimes mods will just be incompatible.

As with most things, the truth is a bit more fine-grained. It's true that "Core, Mod 1, Mod 2, Mod 3" is the load order, and the last mod "wins", but the actual load order is a bit different.

- XML

- xpath

- C#

The game first loads all XML (defs, mostly) from Core, Mod 1, Mod 2, Mod 3

Then it applies all xpath patches from Mod 1, Mod 2, Mod 3

Then it loads the C# from Mod 1, Mod 2, Mod 3

Core doesn't use xpath or load any C#, so they're not in that list. The C# for RimWorld is already loaded by that point, roughly speaking.

So if Mod 3 overwrites something in XML, but Mod 2 overwrites it in xpath and Mod 1 overwrites it in C#, it's Mod 1 that wins -- even though Mod 3 and Mod 2 come after it in the load order.

There are a few things that matter with load order:

- Does the mod require a different mod? Examples of that are mods that require HugsLib, Proper Shotguns, Turret Extensions, Alien Races, JecsTools, whatever. If you are missing a dependency, you'll notice: You get a nice red error saying something like
Could not find type named TurretExtensions.CompProperties_Upgradable from node <A lot of XML> and missing a dependency like that will put the entire game in a corrupted and unplayable state.

And then there is another insidious thing some XML mods do: overwrite (abstract) bases. For that, I refer you to https://github.com/RimWorld-CCL-Reborn/AllYourBase. This is something that's still unfortunately very frequently done, and it can cause havoc.

The C# summary slightly diverts from the truth. It even depends on how they instantiate the mod; there are two or three possible hooks and they happen at different times. Most mods that mess about with Defs will all have to do it in the second or third hook.

There's inherit from mod, which happens before Defs are loaded. Generally mods can't screw around with Defs in there.

There's the staticconstructoronstartup annotation which happens after Defs are loaded. This is where mods would screw around with Defs, for the most part.

Finally there's Hugslibs' ondefsloaded, which is exactly like a staticconstructoronstartup, but it runs after the staticconstructoronstartup utility is done.

and fwiw: that's just the Defs side of the equation

I won't even mention the harmony conflicts (which are way harder to detect) or runtime conflicts (which sometimes get logged, but not nearly always)

take the world edit mod: I can't remember which page it was, but basically if you click next somewhere and from there on you get redirected to world edit's version of whatever the next screen would've been.

There's like.. almost zero chance of detecting that programmatically"''

--------------------------

''
=== Common things people do that they should be doing differently ===

'''''These are the opinions of one particular troubleshooting group, and not of the rest of the maintainers of this article. If you take offense, please direct your fury at the Unofficial Rimworld Discord server, thank you.'''''

-Do not run out of date mods. This means mods that are for a different version of the game than you are running. The only exception is Allyourbase at this time.

-If asked to add and use Allyourbase, do NOT turn on Verbose Logging till you are asked to do so.

-Do not run two copies of the same mod. This causes things to break horribly.

-Do not use modpacks. They are almost always partially out of date, almost always partially broken, and you will be told to make your own list if you present them to a troubleshooter.
Also Samuel Streamer needs to either stop editing around all the dev commands they use, or they need to stop giving people the packs without FIXING them first.

-Do not come into a troubleshooting area with "Can someone help?" and nothing else. Do not even come into such an area with that and a log. Come with a description of your problem, AND a log, so that troubleshooters do not have to spend multiple minutes asking for a description of your problem.

-If a troubleshooter asks you to do something that does not ACTUALLY BREAK LAWS OR PUT YOU IN HARMS WAY, do it. Even if you did it already. You're not being asked as a delaying tactic, or as a power trip; you are being asked to do that thing so that they can help you fix your game.

-If you come from modding Skyrim or Fallout and you are used to the LOOT filter: Guess what, Rimpy exists, it hasn't had enough time to get to where LOOT is (though the devs are working on it). Use it.

-Always provide a Hugslog if possible. Yes, even if it has to come from the main menu. Yes, even if it has to come from a restart before the error occurs. It will STILL be useful. (Hugslogs are acquired by adding the Hugslib mod, and then either pressing Ctrl+F12 while in game, or navigating to the dev mode console window and hitting the green "Share Logs" button.)

-It's (almost always) not Achtung or Rocketman.
~Both of these mods check what other mods are doing to try to make bugs easier to notice and fix. They are probably not the cause of whatever they catch.

=== -YOU NEED HARMONY. AND UNO. ===

[[Category:Modding]]

Modding Troubleshooting Tips and Guides

2020-12-30T09:01:49Z

Trisscar: Hokay hope this doesn't break horribly

Modding Tutorials

2020-12-30T08:55:44Z

Trisscar: adding page now, sorry for the wait

{| align=center
| {{Mods_Nav}}
|}
<hr>

This is the table of contents for the modding tutorial. Here, you'll learn step by step how to create mods of gradually increasing complexity.

In light of little official documentation, most of the knowledge here was gained by experience, trial-and-error, decompiling and learning from the source. Keep in mind that RimWorld is a big game that underwent substantial code changes during its alphas. While most of this wiki was updated for 1.0, some information you find may be outdated.

-----

==What's a mod?==
A mod is a folder containing data the game reads/loads. Mods can add, remove or alter the content of other mods (including the Core mod) in the broadest sense of the word. For more info, see also [[Modding]].

==Introduction to modding==
# [[Modding Tutorials/First Steps|First Steps and Some Links]]
# [[Modding Tutorials/Essence| Essence of Modding]]
# [[Modding Tutorials/Folder structure|Exploring the Folder Structure]]
# [[Modding Tutorials/Mod folder structure|Mod Folder Structure]]
#* [[Modding Tutorials/Mod folder structure#The About folder|About folder]]
#* [[Modding Tutorials/Mod folder structure#The Defs folder|Defs folder]]
#* [[Modding Tutorials/Mod folder structure#The Source and Assemblies folders|Assemblies folder]]
#* [[Modding Tutorials/Mod folder structure#The Languages folder|Languages folder]]
#* [[Modding Tutorials/Mod folder structure#The Textures and Sounds folders|Textures folder]]
#* [[Modding Tutorials/Mod folder structure#The Textures and Sounds folders|Sounds folder]]
#* [[Modding Tutorials/Mod folder structure#The Patches folder|Patches folder]]
# [[Modding Tutorials/Recommended software|Recommended Software]]
# [[Modding Troubleshooting Tips and Guides]]

==General modding==

* [[Modding Tutorials/Testing mods|Testing Mods]]
** [[Modding Tutorials/Testing mods#Development mode|Development Mode]]
* [[Modding Tutorials/Sounds|Adding and Testing Sounds]]
* [[Modding Tutorials/Assets|Decompiling Texture/Sound Assets]]
* [[Modding Tutorials/Compatibility|Compatibility]]
* [[Modding_Tutorials/Distribution|Distribution]]

==Must-knows==
* [[Modding_Tutorials/Modifying defs|Modifying Defs]]
* [[Modding_Tutorials/Troubleshooting|Troubleshooting mods]]

==XML tutorials==

# [[Modding Tutorials/XML file structure|XML File Structure]]
# [[Modding Tutorials/XML Defs|Introduction to XML Defs]]
#* [[Modding Tutorials/Compatibility with defs|XML Def Compatibility]]
# In-depth XML Def tutorials
#* [[Modding Tutorials/ThingDef|ThingDef explained]]
#* [[Modding Tutorials/Weapons Guns|Weapons_Guns.xml explained]]. Slightly dated.
# [[Modding Tutorials/PatchOperations|PatchOperations]], replace specific xml elements of core files while keeping the rest untampered. Uses xpath.

==C# tutorials==
# [[Modding_Tutorials/Setting up a solution|Setting up]]
# [[Modding_Tutorials/Hello World|Hello World]]
# [[Modding_Tutorials/Decompiling source code|Decompiling Source Code]]
# [[Modding_Tutorials/Writing custom code|Writing Custom Code]]
# [[Modding Tutorials/Linking XML and C#|Linking XML and C#]]
# [[Modding_Tutorials/Harmony | Alter Code at Runtime with Harmony]] - this is a best practice for modifying game code, replacing C# code injection to reduce Mod Conflicts
# The wonderful things you will want to do with C#
#* [[Modding_Tutorials/Modifying classes|Adding fields and methods to classes]]
# Useful things:
#* [[Modding Tutorials/ModSettings|Mod settings]] - Add settings to your mod
#* [[Modding Tutorials/DefModExtension|Def mod extensions]] - Add (custom) fields to Defs
#* [[Modding Tutorials/Custom Comp Classes|Custom Comp Classes]] - A quick overview of what types of Comps there are, and what they're suited for.
#** [[Modding_Tutorials/ThingComp|ThingComp]] - Learn all there is to know about ThingComps.
#** [[Modding Tutorials/GameComponent|Components]] - GameComponents, WorldComponents, and MapComponents
#* [[Modding_Tutorials/Def classes|Introduction to Def Classes]]
#* [[Modding_Tutorials/Compatibility_with_DLLs|Using Harmony to optionally patch other mods for the sake of compatibility]]
#* [[Modding Tutorials/TweakValue|TweakValues]] - Change values on the fly (handy for quick iteration!)
#* [[Modding Tutorials/ExposeData|ExposeData]] - Save stuff
#* [[Modding Tutorials/BigAssListOfUsefulClasses|The big ass list of useful classes]] - A non-exhaustive list of classes you'll use most
#* [[Modding Tutorials/GrammarResolver|Grammar Resolver]] - PAWN_objective, PAWN_possessive? Find out what it all means here.
#* [https://github.com/Mehni/ExampleJob/wiki ExampleJob] - Mehni's top to bottom breakdown of Jobs.

==Art Tutorials==
* [https://spdskatr.github.io/RWModdingResources/artstyle Artstyle] - Officially unofficial guide to RimWorld's Artstyle
* [https://www.reddit.com/r/RimWorld/comments/5tn1pi/rimworldstyle_sprite_tutorials/ Ekksu's guide to creating RimWorld animals]
* [https://steamcommunity.com/sharedfiles/filedetails/?id=1114369188 ChickenPlucker's guide to creating apparel]
* [https://github.com/seraphile/rimshare/wiki/Colouring-in-Images Seraphile's guide to masks]

 
==Examples==
* [[Modding Tutorials/Assembly Modding Example|Assembly Modding]]
* [[Plague Gun (1.1)|The Plague Gun]] tutorial originally by Jecrell, updated to 1.1+.

===Dangerously Outdated===
* https://rimworldwiki.com/wiki/Modding_Tutorials/Smelter
* https://rimworldwiki.com/wiki/Modding_Tutorials/Items
* https://rimworldwiki.com/wiki/Modding_Tutorials/Weapons
* [[Plague Gun/Introduction|The Plague Gun]] based on the Plague Gun tutorial by Jecrell, updated for 1.0. {{LudeonThread|33219}}.
# [[Plague Gun/Required Items|Required Items]]
# [[Plague Gun/XML Stage|XML Stage]]
# [[Plague Gun/Connecting XML and Csharp|Connecting XML and C#]]
# [[Plague Gun/Csharp Assembly Setup|C# Assembly Setup]]
# [[Plague Gun/Csharp Coding|C# Coding]]
# [[Plague Gun/Localisation|Localisation]]

==See also==
* [https://github.com/roxxploxx/RimWorldModGuide/wiki Roxxploxx's set of modding tutorials]
* [https://spdskatr.github.io/RWModdingResources/ RimWorld Modding Resources - A hub for guides, modders, practical tips]

[[Category:Modding]]
[[Category:Modding tutorials]]

User:Trisscar

2020-12-30T08:49:38Z

Trisscar: adding mod order reasons stuff

testing:

---Troubleshooting things---

"My game broke/crashed/the UI is gone/froze, what do I do?"

You should:

Verify with Steam (if you use it).

Clear your configs (instructions below).

Check your mod order (instructions also below).

Make sure no mods updated since you last played, if a game that was running fine suddenly broke the next time you loaded it.

-----------------

Basic Load Order Rules:

Mods must be loaded beneath any and all dependencies.

eg: most mods depend on Core to function and must load below it

Mods should not/cannot be loaded with other incompatible mods.

How do we know which mods are incompatible? Reading mod descriptions, asking people who know things, and trial/error

In the instance of multiple mods that change the same thing, whichever is loaded last will take precedent

There are some "ifs" and "buts" in this statement, but it's largely true

Local Mods:

Windows:
C:\Program Files (x86)\Steam\steamapps\common\RimWorld\Mods

or
C:\Program Files (x86)\RimWorld\Mods

Mac OS X:
Right-click the RimWorld application and show package contents
cd Library/Application\ Support/Steam/steamapps/common/RimWorld

Linux:
~/.steam/steam/steamapps/common/Rimworld/Mods;

Config Files:

--RimWorld configuration files and most mod settings are kept in this folder, and removing them will reset all settings to default.

--"Clearing configs" refers to deletion of old/all configs in the aforementioned folder

--Old mod config files are not automatically removed and may cause errors.

--Save the "ModsConfig.xml" as this is your mod load order, and if you remove it you will lose your modded load order.
%appdata%\..\LocalLow\Ludeon Studios\RimWorld by Ludeon Studios\Config

Steam Default Install Location:
C:\Program Files (x86)\Steam\steamapps\common

Steam Default Mod Install Folder:
C:\Program Files (x86)\Steam\steamapps\workshop\content\294100

Verify Game Files with Steam:

> Steam Library

> Right Click RimWorld

> Properties

> Local Files

> Verify Integrity of Game Files...

Change Game Version with Steam:

> Steam Library

> Right Click RimWorld

> Properties

> Betas

> "Select the beta you would like to opt into:"

Load Order:

Rimpy is a useful tool that works outside the game, to make it easier to sort your mods. It also has it's own auto-sort function if you want to see if that will help your issue:

https://steamcommunity.com/sharedfiles/filedetails/?id=1847679158&searchtext=rimpy

There are also a few mod managers out there, both as mods and as external programs.

Another option for sorting your mods is to follow this guide here:

https://rwom.fandom.com/wiki/Mod_Order_Guide

--------------------------

''
'''An explanation of how this works code wise;'''

"Keep in mind that not all mod conflicts will be solved by shuffling load order around. Sometimes mods are just incompatible until the mod authors put in effort to fix their mods.

Sometimes mods will just be incompatible.

As with most things, the truth is a bit more fine-grained. It's true that "Core, Mod 1, Mod 2, Mod 3" is the load order, and the last mod "wins", but the actual load order is a bit different.

- XML

- xpath

- C#

The game first loads all XML (defs, mostly) from Core, Mod 1, Mod 2, Mod 3

Then it applies all xpath patches from Mod 1, Mod 2, Mod 3

Then it loads the C# from Mod 1, Mod 2, Mod 3

Core doesn't use xpath or load any C#, so they're not in that list. The C# for RimWorld is already loaded by that point, roughly speaking.

So if Mod 3 overwrites something in XML, but Mod 2 overwrites it in xpath and Mod 1 overwrites it in C#, it's Mod 1 that wins -- even though Mod 3 and Mod 2 come after it in the load order.

There are a few things that matter with load order:

- Does the mod require a different mod? Examples of that are mods that require HugsLib, Proper Shotguns, Turret Extensions, Alien Races, JecsTools, whatever. If you are missing a dependency, you'll notice: You get a nice red error saying something like
Could not find type named TurretExtensions.CompProperties_Upgradable from node <A lot of XML> and missing a dependency like that will put the entire game in a corrupted and unplayable state.

And then there is another insidious thing some XML mods do: overwrite (abstract) bases. For that, I refer you to https://github.com/RimWorld-CCL-Reborn/AllYourBase. This is something that's still unfortunately very frequently done, and it can cause havoc.

The C# summary slightly diverts from the truth. It even depends on how they instantiate the mod; there are two or three possible hooks and they happen at different times. Most mods that mess about with Defs will all have to do it in the second or third hook.

There's inherit from mod, which happens before Defs are loaded. Generally mods can't screw around with Defs in there.

There's the staticconstructoronstartup annotation which happens after Defs are loaded. This is where mods would screw around with Defs, for the most part.

Finally there's Hugslibs' ondefsloaded, which is exactly like a staticconstructoronstartup, but it runs after the staticconstructoronstartup utility is done.

and fwiw: that's just the Defs side of the equation

I won't even mention the harmony conflicts (which are way harder to detect) or runtime conflicts (which sometimes get logged, but not nearly always)

take the world edit mod: I can't remember which page it was, but basically if you click next somewhere and from there on you get redirected to world edit's version of whatever the next screen would've been.

There's like.. almost zero chance of detecting that programmatically"''

User:Trisscar

2020-12-16T22:09:21Z

Trisscar:

User:Trisscar

2020-12-16T22:01:08Z

Trisscar:

Topic:Vzp43ssjnyxwz0r1

2020-12-16T20:00:52Z

Trisscar (talk | contribs) commented on "Hosting images" (Kk.)

User:Trisscar

2020-12-16T20:00:14Z

Trisscar:

testing:

---Troubleshooting things---

Basic Load Order Rules:

Mods must be loaded beneath any and all dependencies.

eg: most mods depend on Core to function and must load below it

Mods should not/cannot be loaded with other incompatible mods.

How do we know which mods are incompatible? Reading mod descriptions, asking people who know things, and trial/error

In the instance of multiple mods that change the same thing, whichever is loaded last will take precedent

There are some "ifs" and "buts" in this statement, but it's largely true

Saved Game Files:
%appdata%\..\LocalLow\Ludeon Studios\RimWorld by Ludeon Studios\Saves

Local Mods:
Windows:
C:\Program Files (x86)\Steam\steamapps\common\RimWorld\Mods

or
C:\Program Files (x86)\RimWorld\Mods

Mac OS X:
Right-click the RimWorld application and show package contents
cd Library/Application\ Support/Steam/steamapps/common/RimWorld

Linux:
~/.steam/steam/steamapps/common/Rimworld/Mods;

Config Files:

--RimWorld configuration files and most mod settings are kept in this folder, and removing them will reset all settings to default.

--"Clearing configs" refers to deletion of old/all configs in the aforementioned folder

--Old mod config files are not automatically removed and may cause errors.

--Save the "ModsConfig.xml" as this is your mod load order, and if you remove it you will lose your modded load order.
%appdata%\..\LocalLow\Ludeon Studios\RimWorld by Ludeon Studios\Config

Steam Default Install Location:
C:\Program Files (x86)\Steam\steamapps\common

Steam Default Mod Install Folder:
C:\Program Files (x86)\Steam\steamapps\workshop\content\294100

Verify Game Files with Steam:

> Steam Library

> Right Click RimWorld

> Properties

> Local Files

> Verify Integrity of Game Files...

Change Game Version with Steam:
https://gfycat.com/heartfeltdarlingboa

User:Trisscar

2020-12-16T19:59:06Z

Trisscar:

testing:

---Troubleshooting things---

Basic Load Order Rules:

Mods must be loaded beneath any and all dependencies.

eg: most mods depend on Core to function and must load below it

Mods should not/cannot be loaded with other incompatible mods.

How do we know which mods are incompatible? Reading mod descriptions, asking people who know things, and trial/error

In the instance of multiple mods that change the same thing, whichever is loaded last will take precedent

There are some "ifs" and "buts" in this statement, but it's largely true

Saved Game Files:
%appdata%\..\LocalLow\Ludeon Studios\RimWorld by Ludeon Studios\Saves

Local Mods:
Windows:
C:\Program Files (x86)\Steam\steamapps\common\RimWorld\Mods

or
C:\Program Files (x86)\RimWorld\Mods

Mac OS X:
Right-click the RimWorld application and show package contents
cd Library/Application\ Support/Steam/steamapps/common/RimWorld

Linux:
~/.steam/steam/steamapps/common/Rimworld/Mods;

Config Files:
--RimWorld configuration files and most mod settings are kept in this folder, and removing them will reset all settings to default.

--"Clearing configs" refers to deletion of old/all configs in the aforementioned folder

--Old mod config files are not automatically removed and may cause errors.

--Save the "ModsConfig.xml" as this is your mod load order, and if you remove it you will lose your modded load order.
%appdata%\..\LocalLow\Ludeon Studios\RimWorld by Ludeon Studios\Config

Steam Default Install Location:
C:\Program Files (x86)\Steam\steamapps\common

Steam Default Mod Install Folder:
C:\Program Files (x86)\Steam\steamapps\workshop\content\294100

Verify Game Files with Steam:

> Steam Library

> Right Click RimWorld

> Properties

> Local Files

> Verify Integrity of Game Files...

Change Game Version with Steam:
https://gfycat.com/heartfeltdarlingboa

User:Trisscar

2020-12-16T06:35:04Z

Trisscar:

testing:

---Troubleshooting things---

Basic Load Order Rules:
Mods must be loaded beneath any and all dependencies.
eg: most mods depend on Core to function and must load below it
Mods should not/cannot be loaded with other incompatible mods.
How do we know which mods are incompatible? Reading mod descriptions, asking people who know things, and trial/error
In the instance of multiple mods that change the same thing, whichever is loaded last will take precedent
There are some "ifs" and "buts" in this statement, but it's largely true

Saved Game Files:
%appdata%\..\LocalLow\Ludeon Studios\RimWorld by Ludeon Studios\Saves

Local Mods:
Windows:
C:\Program Files (x86)\Steam\steamapps\common\RimWorld\Mods

or
C:\Program Files (x86)\RimWorld\Mods

Mac OS X:
Right-click the RimWorld application and show package contents
cd Library/Application\ Support/Steam/steamapps/common/RimWorld

Linux:
~/.steam/steam/steamapps/common/Rimworld/Mods;

Config Files:
--RimWorld configuration files and most mod settings are kept in this folder, and removing them will reset all settings to default.
--"Clearing configs" refers to deletion of old/all configs in the aforementioned folder
--Old mod config files are not automatically removed and may cause errors.
--Save the "ModsConfig.xml" as this is your mod load order, and if you remove it you will lose your modded load order.
%appdata%\..\LocalLow\Ludeon Studios\RimWorld by Ludeon Studios\Config

Mac OS X:
/Users/[Username]/Library/Logs/Unity/Player.log

Linux:
Pass to the Rimworld binary. It generates a log at that location.
-logfile /tmp/rimworld_log
"Steam Information"

Steam Default Install Location:
C:\Program Files (x86)\Steam\steamapps\common

Steam Default Mod Install Folder:
C:\Program Files (x86)\Steam\steamapps\workshop\content\294100

Verify Game Files with Steam:
> Steam Library
> Right Click RimWorld
> Properties
> Local Files
> Verify Integrity of Game Files...

Change Game Version with Steam:
https://gfycat.com/heartfeltdarlingboa

User:Trisscar

2020-12-16T06:24:58Z

Trisscar:

testing:

---Troubleshooting things---

Basic Load Order Rules:
Mods must be loaded beneath any and all dependencies.
eg: most mods depend on Core to function and must load below it
Mods should not/cannot be loaded with other incompatible mods.
How do we know which mods are incompatible? Reading mod descriptions, asking people who know things, and trial/error
In the instance of multiple mods that change the same thing, whichever is loaded last will take precedent
There are some "ifs" and "buts" in this statement, but it's largely true

Saved Game Files:
%appdata%\..\LocalLow\Ludeon Studios\RimWorld by Ludeon Studios\Saves

Local Mods:
Windows:
C:\Program Files (x86)\Steam\steamapps\common\RimWorld\Mods

or
C:\Program Files (x86)\RimWorld\Mods

Mac OS X:
Right-click the RimWorld application and show package contents
cd Library/Application\ Support/Steam/steamapps/common/RimWorld

Linux:
~/.steam/steam/steamapps/common/Rimworld/Mods;

Config Files:
--RimWorld configuration files and most mod settings are kept in this folder, and removing them will reset all settings to default.
--"Clearing configs" refers to deletion of old/all configs in the aforementioned folder
--Old mod config files are not automatically removed and may cause errors.
--Save the "ModsConfig.xml" as this is your mod load order, and if you remove it you will lose your modded load order.
%appdata%\..\LocalLow\Ludeon Studios\RimWorld by Ludeon Studios\Config

Output Log:
Only supply this log if requested or if HugsLib and Pastebin options are not possible.
Windows:
%appdata%\..\LocalLow\Ludeon Studios\RimWorld by Ludeon Studios\Player.log

Mac OS X:
/Users/[Username]/Library/Logs/Unity/Player.log

Linux:
Pass to the Rimworld binary. It generates a log at that location.
-logfile /tmp/rimworld_log
"Steam Information"

Steam Default Install Location:
C:\Program Files (x86)\Steam\steamapps\common

Steam Default Mod Install Folder:
C:\Program Files (x86)\Steam\steamapps\workshop\content\294100

Verify Game Files with Steam:
> Steam Library
> Right Click RimWorld
> Properties
> Local Files
> Verify Integrity of Game Files...

Change Game Version with Steam:
https://gfycat.com/heartfeltdarlingboa

RimWorld Wiki talk:Community portal

2020-12-15T02:40:39Z

Trisscar:

== Page Creation Permissions ==
What does it take to get page creation permissions?
[[User:Lilwhitemouse|Lilwhitemouse]] ([[User talk:Lilwhitemouse|talk]]) 14:42, 29 November 2018 (UTC)
:Also interested in finding out this info, especially ''TALK'' pages. The "[[Community portal]]" says under '''Want to discuss stuff?''' "If you want to discuss anything specific to an article, you can use the Discussion page for that article.", but if an article's talk page is still empty that's not really possible: unregistered users are shown 🔒 You currently are not able to participate. You can try logging in. and newly-registered users are shown 🔒 You currently are not able to participate, because you do not have the required rights. -- so it's easier to just vandalize right away (editing articles) than to talk about what we want to improve. :-( -- [[User:Noob hoarder|Noob hoarder]] ([[User talk:Noob hoarder|talk]]) 22:09, 11 May 2019 (UTC)

::The answer is everywhere (it's the most FAQ):
::Under '''"How to help out"''' within this same page:
::*You can also create "New pages" for missing pages but your account must have at least 10 edits a priori, this is configuration to prevent vandal bots. If you don't meet the count yet, just perform any of the above mentioned tasks to rise your count.
::In [[:Help:Basics]]:
::*Under '''"Creating New Articles"''': With a brand new account, you will need at least 10 edits to be able to make a new article. This is an anti-spam bot measure.
::Check out the Special Pages area to see articles that could use links, pictures, categories, etc. Fixing up grammar and spelling on pages is always appreciated as well, and is also an easy way to get your 10 edits.
::...and also...
::*...in '''my talk page''': [[User talk:Yoshida Keiji]]. 15:55, 12 May 2019 (UTC)

:::I do get that vandal bots are a problem to public sites, but what good is it to allow a bot to vandalize actual, useful, important articles but not empty discussion pages?
:::New members can't even create their own(!) user page or user talk page.
:::Maybe pseudo-empty discussion page stubs (»Use this discussion page to discuss the article's content, propose changes etc.«) that auto-vivify along with every article could help? Coming from other wikis I also find it ''very'' strange that I'm required to edit the actual articles in order to be allowed to suggest edits to articles. It just feels wrong to trample all over someone's work instead of being able to add a section to the discussion page politely proposing a change along with a proper explanation on how this change would benefit the article. When editing the article right away any reasoning behind the change is lost, discussion is impossible. Previous authors just see their work »corrected«, maybe don't intuit the reason for the change, feel offended, revert it (also without proper discussion) and contribute to an atmosphere of mutual disrespect and hostility that was never intended and would have been prevented if only the discussion page had been doing its job: being open for discussion.
:::If auto-vivification is too hard to implement, maybe permissions could be fine-tuned to allow for creation of discussion pages and only need ten edits for actual articles?
:::If that, too, isn't an option, maybe long-standing users could give the wiki a once-over and create a discussion page for each and every article? I'd certainly volunteer to help with that once I have the edits to be allowed to. Except, of course, if discussion is explicitly not wanted, in which case I'd love to be pointed to the reasoning behind such sentiment.
:::Another idea involving manual labour: privileged users seeing the first edit of a new member could just upgrade them. Bots don't make meaningful changes to an article, so if the first edit seems well thought through it's likely its author is a human. [[User:Olfan|Olfan]] ([[User talk:Olfan|talk]]) 10:12, 5 June 2020 (UTC)

== Getting edit permissions for MediaWiki:Common.css ==
What's the process for getting permission to update the CSS? I've been playing around with trying a 300px width version of the default infobox and I think it looks significantly better:
[[File:Css update infobox comparison.png|thumb|center]]
[[User:FixSomeBugs|FixSomeBugs]] ([[User talk:FixSomeBugs|talk]]) 15:46, 26 April 2020 (UTC)

== Wooden foot ==
I'd like to create the page [[Wooden foot]] but I don't have the permissions to do so. Could someone create the page (and then ping me) or give me the permission? Thanks. --[[User:Nijin|Nijin]] ([[User talk:Nijin|talk]]) 19:17, 17 September 2018 (UTC)

: Just posting for future readers to say that this no longer needs doing. - [[User:AnnanFay|AnnanFay]] ([[User talk:AnnanFay|talk]]) 22:17, 28 November 2019 (UTC)

== Formatting guideline for "Weapon" pages ==

Version 1.0 is out and I'm not sure if more will be added as to evaluate the usefulness of this at the time, but since we are editing such pages, this is my draft and I would like everybody else's opinions to polish this layout and make it standard to all related articles.[[File:LongRangeMineralScanner.png|25px]][[User:Yoshida Keiji|'''Yoshida Keiji''']]([[User_talk:Yoshida_Keiji|Let's talk]][[File:beer b.png|25px]])[[File:LongRangeMineralScanner.png|25px]] 02:28, 3 November 2018 (UTC)

[[:User:Yoshida Keiji/Sandbox3]]

== Formatting guideline for Biome guides ==

Discuss what would you expect from Biome specific guides, the content, the parameters in which it shall be focused on, what it must have and what nots. How would you give points based on a score system to determine whether an article shall be part of the Community with members consentient by including it in mainspace or if it shall remain a user exclusive article that solely exposes the views of a single person rather everybody. [[File:LongRangeMineralScanner.png|25px]][[User:Yoshida Keiji|'''Yoshida Keiji''']]([[User_talk:Yoshida_Keiji|Let's talk]][[File:beer b.png|25px]])[[File:LongRangeMineralScanner.png|25px]] 12:43, 21 January 2019 (UTC)

== Thoughts for the future (frontpage, templates, SMW) ==

Since this wiki doesn't have an Admin noticeboard, this talk page appears to be the best spot to raise issues or thoughts.

=== Images ===
Recently I've uploaded ''a couple'' of pictures, extracted uncompressed from the game files. I tried to name them sensibly before uploading. Partly as a result of that, there are now de facto duplicates here and there, in various quality. We can try to deal with that, or just let it be. I've also started categorising images. It makes it easier to find them later, and use them in articles, if users can look through categories.

Because most "things" have 3-4 images now (east, north, south), the initial idea was to add them to a small gallery on pages. It helps to fill out some pages, and later we can add "live" shots of the animals and such as well. There is much I didn't upload, however, such as hair styles, body differences, and loads of interface images.

=== Frontpage ===
Yesterday [[User:PigeonGuru|PigeonGuru]] prompted me about the intent of the image uploads, and I touched on some more topics, including an idea for changing the frontpage. This is (probably) the page new users see first. Hope I don't step on any toes here, but I do think it could be improved. It's usually a good idea to have a brief intro or summary of the game, and those links to policy and consent and suchlike looks a little ''off'' for the frontpage, at least in such a prominent position. I see there have been quite some storms in here with edit wars, so that is probably why, but maybe it could be placed elsewhere?

My background is from Gamepedia, a wiki farm for gaming wikis, where I happened to take the lead in changing lots of stuff on the Pillars of Eternity wiki, including transitioning it from Semantic Mediawiki (SMW) to Cargo. Their sort-of default design for wikis is a dynamic setup that alters where segments are placed on the frontpage based on the width of the user's browser, using fairly simple Javascript in the .js file. I would like to try out something similar here as well -- if that is something that would be agreeable to the leadership. First in my own userspace of course. I'm not a design or CSS wizard, so it takes me time, but I'd like to try it out nevertheless. But I'd like to hear some feedback or ideas for how it can be done.

RimWorld is a dark-themed game with, suffice to say, some pretty darn dark behaviours at times (like the hats meme). I'm not sure how much extra work it would be, how badly if would affect tables and so on, but it might be fitting with a dark-coloured theme for the wiki as well, to better reflect the look in-game. Unfortunately the game doesn't really have much art assets to go on in terms of UI (it is very basic with boxes and suchlike), but otherwise we could have used some of that here, for infoboxes, stylised headings and the like. Any thoughts about this? Would it be a total no-go? I did look through the history of the frontpage a few weeks back, and it looked to have had basically the same design from the start. Have people sort of built brick by brick since then, or was it decided to have it like that, and we shouldn't change it?

:I don't think there was much of a "decision" regarding the frontpage, nobody just ever bothered changing it. I'm in favour of having a short description of the game on the frontpage. As far as the theme for RimWorld, it's as light or dark as the player wants to make it. Some colonies are all rainbows and kittens, others consist of nothing but organ-harvesting psychopaths. It reflects more on the player than on the game. --[[User:Mehni|Mehni]] ([[User talk:Mehni|talk]]) 18:06, 12 July 2019 (UTC) P.S. Welcome, and thank you for your additions.

=== Templates ===
Dear Cthulu... I've been sat here for ''hours'' trying to wrap my puny head around it, and it still doesn't make all that much sense. Like the main author [[User:Spdskatr|Spdskatr]] says in the Define/doc: <code>This template defines the stats for an item that, after a long and confusing chain of transclusions, will end up in Template:Infobox/Thing.</code>

There are loads of templates that do various things, including tiny stuff like closing a table, or making a heading. The chain-transclusions make it ''very'' hard to read and understand for regular users, or even quite experienced ones like myself. There are some errors here and there on pages, and many others still use the infobox main template instead, but given the above, it's hard to try to fix things. For all I know, it will break something else.

It is honestly tempting to start anew (and copying the relevant bits of code) instead of keep banging my head against the wall and not really getting anywhere. If we were to start over, I'd suggest to use one template for each thing instead of super-templates with loads of sub-templates and chaining. It's much easier to deal with both for users and staff -- because it's more easily understood. This is kind of a nightmare example, but imagine trying to wrap your head [https://tyranny.gamepedia.com/index.php?title=Template:Infobox&action=edit around this] as a new user :D

Another dark horse here, however, is the SMW. That too is hard to get a good grip on, because it appears to be dealt with in other templates as well. More chaining.

=== Cargo ===
That brings me to another possibility: Using [https://www.mediawiki.org/wiki/Extension:Cargo Cargo] instead of SMW. Especially on the management/overview side, it is much better to use than SMW. Essentially it's a MySQL database, so it's easy to get an overview of everything, instead of the complex setup of triplets from SMW, and no proper database or table where users or admins can look at the data, check it, and fix it. Managing both the templates and the data would be easier.

Usually SMW is also a drain on performance, though I don't know if that is the case here. As usual there are lots more property+query pages than content pages (and outdated entities), but we're not talking about millions here, so it may be manageable.

I'm hesitant to suggest it ofc, because it's not a small task. I did it for Pillars of Eternity, alone, and it almost broke me, sapped me of energy. But having done it, I can use much of that code base (it largely remains intact I see, although I've not been active there for a year or two, and resigned as a wiki guardian).

All in all this wouldn't be small matters of course, and a lot of work, but I do think it would benefit the wiki, and probably make it easier to update pages now that 1.0 is out, and there are likely to be fewer mass-changes going forward.

Would be grand to hear some feedback about these ideas from the staff, ideally including [[User:Zesty|Zesty]]. If it's not agreeable by others, either as a whole or the individual ideas, then say so and we can end the discussion here.

Thanks, [[User:Pangaea|Pangaea]] ([[User talk:Pangaea|talk]]) 11:40, 11 July 2019 (UTC)

:(Brief draft here that can be deleted later)

:Obviously needs a ton of changes as the colours are all messed up, but perhaps it gives a rough idea of what I had in mind? [https://i.imgur.com/JSPCqHT.jpg Imgur image of draft]. Wanted to test out using the background from the game as the background here (I seriously love that image, it really sets the mood for the game). The central content div is slightly transparent so the background image is visible, but without distorting the reading experience too much (Well, that's the end goal). Happy accident that the logo fits fairly well in the top left corner. Not sure what that gradient is about, but that should be altered as well so the whole logo shows. --[[User:Pangaea|Pangaea]] ([[User talk:Pangaea|talk]]) 19:06, 11 July 2019 (UTC)

:Interesting. Tried to check how quickly pages are generated by using ''Edit -> Show preview'' and looking at the parser stuff on the bottom. Pages that use the Define template is routinely about 1.0 to 1.2 seconds slower than pages that use the infobox main template. Yet both contain similar amounts of SMW data. So it seems like it's the template that slows thing down, and not necessarily SMW. See if you get similar results. It's a pretty big difference when one type of page generates in 0.3-ish seconds, and another type in 1.5 seconds. [[User:Pangaea|Pangaea]] ([[User talk:Pangaea|talk]]) 12:03, 12 July 2019 (UTC)

== Out of date content template ==

Is there an out-of-date template to put on sections or pages which contain old data? - [[User:AnnanFay|AnnanFay]] ([[User talk:AnnanFay|talk]]) 22:34, 28 November 2019 (UTC)
:The Obsolete template might work, use <nowiki>{{Obsolete}}</nowiki>. '''[[User:PigeonGuru|PigeonGuru]]''', Strategist ( [[User_talk:PigeonGuru|talk]] | [[Special:Contributions/PigeonGuru|contribs]] | [[Guides|assist]] ) 03:25, 29 November 2019 (UTC)

== Anyone know how to disable the spammy 'thanks for X' notifications? ==

[https://i.imgur.com/kywaGa4.png How do I disable these?] - [[User:AnnanFay|AnnanFay]] ([[User talk:AnnanFay|talk]]) 10:12, 9 December 2019 (UTC)

== Uploading images doesn't work even after 10 edits ==

Hi, y'all. I joined the wiki today because I saw a few missing images for buildings from the Royalty expansion, and wanted to upload the assets I found to help the community out. I saw there was a 10-page edit requirement before you can create new pages (which images are apparently included in). I've edited 10 pages (more than just changing a piece of punctuation for most of it (^: ) but still can't upload images.

:Unfortunately the upgrading of user privileges is automated and annoyingly slow. I think an administrator could do it manually, but by its likely to have resolved itself by the time they see and respond to this. Give it time and should allow you to do it. Personally I think the user account requirements are a little overbearing and act as disincentives to casual editors but there's not much I can do to fix them. In the mean time, if I can help let me know. Side note, don't forget to sign your posts with 4 ~'s like this:<nowiki>~~~~</nowiki> [[User:Harakoni|Harakoni]] ([[User talk:Harakoni|talk]]) 05:01, 27 September 2020 (UTC)

:: Roger that! Thank you [[User:Kfsass|Kfsass]] ([[User talk:Kfsass|talk]]) 05:57, 27 September 2020 (UTC)

:::Btw, good work on [[Body Parts]]. I've never had cause to look closely at it, and god it was a mess [[User:Harakoni|Harakoni]] ([[User talk:Harakoni|talk]]) 06:21, 27 September 2020 (UTC)
::::Aw, you're too kind! I was a copy-editor for my school's yearbook and currently am for my company's newsletter; god knows I've spent enough time benefiting from this wiki to give some of my skills back. I'm still working up the gumption to tackle the page on supported mods... which still references 1.1 😂😭 [[User:Kfsass|Kfsass]] ([[User talk:Kfsass|talk]]) 22:33, 28 September 2020 (UTC)

== Greetings, from the unofficial Rimworld Discord server! ==

We're currently experiencing an issue with troubleshooter burnout, due to people coming into the server and refusing to read any of the pins or FAQ information,
sometimes refusing to do as we ask to help figure out their issues, and just a general flood that is starting to overwhelm our volunteers.

It's been proposed during discussions about the issue, that we put something on the internet that is actually searchable, such as on a wiki or what have you,
to facilitate people potentially doing basic troubleshooting tasks themselves, before coming to us with the issue. We were hoping you'd be amenable to having
a page created on the official wiki, specifically for modding troubleshooting. The hope is that, with something people can actually look up themselves,
it would stem the tide a little, or at least give us something outside the Discord to point at. How say you all, if I may inquire?

Hope you're all safe and well.
Trisscar

Edit: I should mention we'd be the ones maintaining it, not expecting yall to take on more work outta the blue. Figured asking permission was an idea though. XD

:The wiki hosts a number of pages about modding (though some are admittedly outdated) and guides are common as well. I see no reason it shouldn't be on here, ultimately the wiki is meant to be an aid to the user base. Any pages will still be under the normal rules and moderation ofc and dedicated wikis like the SoS2 and Bestiary wikis are still better places for actual mod content, but what this proposes seems sound.
:You won't have page creation privileges yet because you're a new user (you need a min num of edits, can't change that on my end), so I've created your user page so you can experiment. If you have a specific page you'd like created, let me know by linking it here, or stickking something on my talk page. It should probably be the in [[Modding Tutorials]] namespace, for example [[Modding Tutorials/Example page name]]. :Lastly you can sign posts with 4 ~'s like this <nowiki>~~~~</nowiki> [[User:Harakoni|Harakoni]] ([[User talk:Harakoni|talk]]) 20:33, 13 December 2020 (UTC) Wiki Mod.

::Ahh aight, thanks much. I'll get the troubleshooters talking about what we want in there and get to editing shortly. [[User:Trisscar|Trisscar]] ([[User talk:Trisscar|talk]]) 02:40, 15 December 2020 (UTC)Trisscar

RimWorld Wiki talk:Community portal

2020-12-13T20:13:07Z

Trisscar: Request edit

RimWorld Wiki talk:Community portal

2020-12-13T19:09:05Z

Trisscar: Request