Difference between revisions of "Gaining familiarity with mods on KeeperRL"

From KeeperRL Wiki
Jump to: navigation, search
m (Change an exchange rate for resources)
m (Change an conversion exchange rate for resources)
Line 38: Line 38:
===Change an conversion exchange rate for resources===
===Change the conversion exchange rate for resources===
In the
In the
  "LABORATORY" section
  "LABORATORY" section

Revision as of 12:40, 17 September 2020

Modding tutorial for KeeperRL

  • The first recommendation is to get familiar with the existing modding system on KeeperRL
  • There are two types of mod on KeeperRL
    • Local mods (Edit the official game files locally) - Can't be uploaded onto the Web. Easier to learn for beginners.
    • Web mods (Write new mod files that modify, replace or append to the official game files) - Slightly tougher but you can upload them for other players to use.
  • Make some simple changes to the vanilla files, that is the official files (Try some of the suggestions below) and test the changes. Vanilla configs are found under "KeeperRL\datafree\gamedata\*.txt"
Note, when changing vanilla configs you need to back them up in case you damage them
  • After learning to do local mods, install some existing Web Mods
  • Test them
  • Start writing your own Web mods

Suggestions for simple changes to workshops_menu.txt

Locate workshops_menu.txt. It should look like this linked file, which is found in the vanilla configs folder.

Remove wooden staffs from the workshop

Delete the line containing:


under the



Reduce the cost of golden staffs

In the line containing


under the

"basic" section under the
  "FORGE" subsection

change the numbers in that line.

Sell rings of invisibility instead of wakefulness

Change the line containing


in the

"JEWELER" sub section.

Change it to


Change the conversion exchange rate for resources

In the

"LABORATORY" section

experiment with changing the numbers (hint: look for the lines mentioning alchemical conversion).

Suggestions for simple changes to technology.txt

Locate technology.txt. It should like like this

Include a mention of heavy wooden clubs considering two-handed weapon tech

Change the line containing

two-handed weapons

and edit the description text.

Remove the requirement for researching advanced sorcery before demonology

Change the line containing:


and delete this:

{"advanced sorcery"}

Suggestions for simple changes to player_creatures.txt

Make it impossible for mages to get the archery technology

Change lines for evil keepers containing:


Remove the text


Remove female adventurers

In the

# Adventures

section at the bottom delete this text:


Suggestions for simple changes to immigration.txt

Locate immigration.txt. It should like like this

Allow recruitment of gnomes

Find the "Dark Keeper " section. Look at the block where:

ids = { GOBLIN }

Change it to:

ids = { GOBLIN GNOME }

Recruiting all goblins without any insanity

In that section, remove the text:

LastingEffect INSANITY

Suggestions for simple changes to campaign_villains.txt

Locate campaign_villains.txt. It should like like this

Remove green dragons from keeper campaigns

Delete the whole of the Line containing the text:


Remove red dragons from keeper campaigns

  1. Delete the whole of Line containing the text:

Suggestions for simple changes build_menu.txt

Locate build_menu.txt. It should like like this

Make it free to fill in stone blocks

On line filling in blocks change the text:




Allow building of iron training rooms without the iron working tech

On line for building iron dummies remove the text:

TechId "iron working"