Difference between revisions of "User:Dninemfive"

From RimWorld Wiki
Jump to navigation Jump to search
Line 18: Line 18:
 
=== Other ===
 
=== Other ===
 
D9 Framework: <code>PatchOperationFindPackage</code> or <code>PatchOperationRoyaltyInstalled</code>
 
D9 Framework: <code>PatchOperationFindPackage</code> or <code>PatchOperationRoyaltyInstalled</code>
 +
 +
== Framework Mods ==
 +
''intended to be a comprehensive list of mods which add features for XML users''
 +
* BiomesKit
 +
* D9 Framework
 +
* HugsLib ''(I think)''
 +
* JecsTools
  
 
== Version Control Intro ==
 
== Version Control Intro ==

Revision as of 22:29, 5 July 2020

Hello! I'm a modder who's trying to clean up the modding tutorials pages, which are quite out-of-date. So far, I've rewritten the classic Plague Gun tutorial.

If you've been helped by my contributions on this site please check out my mods on Github and Steam.

Sandbox

Royalty compatibility

After the release of Royalty, mods are governed by rules 13b and c of the Ludeon community rules. Unfortunately, these are inconsistently applied and end up being vaguer than intended, but a good TL;DR to follow would be:

  1. Don't use any code flagged as Royalty only. They will throw errors when loaded for people without Royalty, so these are easy to tell.
    • The page lists explicit exceptions; at the time of writing, only gendered apparel and Sketches are exempt.
  2. Avoid using features added in 1.1 or later. Unfortunately, not all Royalty-specific code is flagged and it's ambiguous whether some features are permitted.
  3. Avoid making anything included in Royalty, broadly defined. Another unfortunate ambiguity is the nuance in this rule - it's currently unclear whether some Royalty features, like shield projectors, count as "royalty features" for this purpose as old mods which included them have not been banned but no new ones have yet been made.
  4. If in doubt, set your mod to require Royalty to install on Steam, and you'll be fine.

MayRequire

You can use the MayRequire annotation on XML nodes to disable Royalty-specific features when Royalty is not installed.

ModLister.RoyaltyInstalled

In C#, the canonical check for whether Royalty is installed is ModLister.RoyaltyInstalled. Notably, this check whether the Steam user owns Royalty, rather than whether it's enabled in the load order.

Other

D9 Framework: PatchOperationFindPackage or PatchOperationRoyaltyInstalled

Framework Mods

intended to be a comprehensive list of mods which add features for XML users

  • BiomesKit
  • D9 Framework
  • HugsLib (I think)
  • JecsTools

Version Control Intro

An introduction to using Github for version control, with an eye toward Rimworld modding. Will go through my particular setup, and various tips and tricks, like:

  • Having a separate dev folder from the Rimworld mods folder
  • Build events copying from the dev folder into the build folder
  • .gitignore settings

&c

Example Comp Project

This project will teach players how to use ThingComps, load textures in C#, and make gizmos.

Introduction to core mods

This project will teach players how to use basic Harmony patches and demonstrate the use of MapComponents (or maybe game/world ones, idk)