Gaining familiarity with mods on KeeperRL

From KeeperRL Wiki
Revision as of 12:02, 17 September 2020 by Keeperman (Talk | contribs)

Jump to: navigation, search

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 linked file, which is found in the vanilla configs folder.

Remove wooden staffs from the workshop

Delete the line containing:


under the

# Workshop


Reduce the cost of golden staffs

In the line containing


on the

"# Forge"

section change the numbers in that line.

Sell rings of invisibility instead of wakefulness

Change the line containing


in the

# Jeweller section.

Change it to


Change an exchange rate for resources

In the

"# Lab section".

experiment with changing the numbers.

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"