Difference between revisions of "Modding Tutorials"
(new list of helloworld-style tutorials) |
|||
| Line 13: | Line 13: | ||
==What's a mod?== | ==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]]. | 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]]. | ||
| + | |||
| + | ==Getting Started== | ||
| + | 1. [[Modding_Tutorials/Barebones_Mod|Setting up your first mod]] | ||
| + | 2. [[Modding_Tutorials/Change_Traits|Changing simple traits of things]] | ||
| + | 3. [[Modding_Tutorials/Create_new_thing|Creating a new thing (XML only)]] | ||
==Introduction to modding== | ==Introduction to modding== | ||
Revision as of 02:18, 26 July 2021
|
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.
Getting Started
1. Setting up your first mod 2. Changing simple traits of things 3. Creating a new thing (XML only)
Introduction to modding
- First Steps and Some Links
- Essence of Modding
- Exploring the Folder Structure
- Mod Folder Structure
- Recommended Software
- Modding Troubleshooting Tips and Guides
General modding
Must-knows
XML tutorials
- XML File Structure
- Introduction to XML Defs
- In-depth XML Def tutorials
- ThingDef explained
- Weapons_Guns.xml explained. Slightly dated.
- PatchOperations, replace specific xml elements of core files while keeping the rest untampered. Uses xpath.
C# tutorials
- Setting up
- Hello World
- Decompiling Source Code
- Writing Custom Code
- Linking XML and C#
- 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#
- Useful things:
- Mod settings - Add settings to your mod
- Def mod extensions - Add (custom) fields to Defs
- Custom Comp Classes - A quick overview of what types of Comps there are, and what they're suited for.
- ThingComp - Learn all there is to know about ThingComps.
- Components - GameComponents, WorldComponents, and MapComponents
- Introduction to Def Classes
- Using Harmony to optionally patch other mods for the sake of compatibility
- TweakValues - Change values on the fly (handy for quick iteration!)
- ExposeData - Save stuff
- The big ass list of useful classes - A non-exhaustive list of classes you'll use most
- Grammar Resolver - PAWN_objective, PAWN_possessive? Find out what it all means here.
- ExampleJob - Mehni's top to bottom breakdown of Jobs.
Art Tutorials
- Artstyle - Officially unofficial guide to RimWorld's Artstyle
- Ekksu's guide to creating RimWorld animals
- ChickenPlucker's guide to creating apparel
- Seraphile's guide to masks
Examples
- Assembly Modding
- 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
- The Plague Gun based on the Plague Gun tutorial by Jecrell, updated for 1.0. Thread.