The more translations, the better--they are a great contribution to the mod community. However, while it is appreciated that people take the time to translate the mod to other languages, it's difficult to keep up with those contributions. Every addition or change to a translation requires a new release of the mod, and taking on that additional effort is not possible.
Therefore, translation pull requests will not be merged into the project. Instead, please consider creating a standalone translation mod for your language. These mods don't include any code--they simply include the translation resources for a given language. With this approach, you can make changes and additions at your own pace, and you can take on the responsibility of releases for the translation.
The solution file was created using Xamarin Studio/MonoDevelop, but it should also work in Visual Studio. Note that the project targets the older 3.5 version of the .NET framework used by the Unity engine on top of which RimWorld is built.
Note that the solution has dependencies on the following RimWorld DLLs:
- Assembly-CSharp.dll
- UnityEngine.CoreModule.dll
- UnityEngine.IMGUIModule
- UnityEngine.InputLegacyModule
- UnityEngine.TextRenderingModule
Copy those dependencies from the RimWorld game directory into the "Libraries" directory. Be sure to make copies of the originals--don't accidentally move/delete them from the original game directory.
The solution also has a dependency on the following third-party DLL:
- 0Harmony.dll
The Harmony DLL is available from https://github.com/pardeike/Harmony/releases and should also be placed in the "Libraries" directory. Prepare Carefully uses version 2.0.0.8 of Harmony. When you download Harmony, you'll see multiple versions of the DLL organized into various directories. Be sure to use the one in the "Release/net472" directory.
Only if you must create a build that also supports RimWorld 1.0, you will need to get the DLL from the latest Prepare Carefully release for 1.0, along with the DLL for Harmony 1.2. Place these DLLs into the Resources/Assemblies
directory.
The result of the build will be the following DLL:
- EdBPrepareCarefully.dll
This DLL must be packaged alongside the contents of the Resources
directory to create a working mod. The DLL built by the project should be placed inside a 1.1/Assemblies
directory along with the Harmony DLL. The directory structure should look like this:
+ EdBPrepareCarefully
+ 1.1
+ Assemblies
- 0Harmony.dll
- EdBPrepareCarefully.dll
+ About
+ Assemblies
+ Defs
+ Languages
+ Textures
- CHANGLELOG.txt
- LICENSE
- LoadFolders.xml
If Windows is the OS on which you're developing, you don't need to manually create the mod directory. Instead, you can automatically package up the mod by running the dist.bat
script. This will copy all of the mod resources and the DLL into a dist/EdBPrepareCarefully
directory. Copy this EdBPrepareCarefully
directory into your RimWorld Mods
folder to use the mod in your game.
Prepare Carefully uses a versioning scheme inspired by semantic versioning that combines the major/minor version of RimWorld with the major/minor version of the mod to end up with the following format:
{RimWorld major version}.{RimWorld minor version}.{mod version for this RimWorld version}
Other conventions used to determine the mod version numbers:
- Mod version numbers always start at
1
and never start at0
Some examples:
- 0.18.2: The second release of the mod for the Beta 18 version of RimWorld
- 1.0.11: The eleventh release of the mod for RimWorld 1.0
- 1.1.1: The first release of the mod for RimWorld 1.1