CultTweaker

CultTweaker

An in-game world editor and content loader for Cult of the Lamb - custom spines, weapons, NPCs, quests, enemies, structures, items and whole dungeons.

CultTweaker is a mod that lets players add their own custom content to Cult of the Lamb. It began as a Spine loader for custom lamb skins and has grown into a full content toolkit: an in-game editor called the Worldshaper, custom dungeons, weapons, NPCs with quests, enemies, structures, items, meals, tarot cards, follower forms and a modding API other mods can build on.

CultTweaker 2.0 is an experimental pre-release. Bugs may corrupt or lose save data. Back up your game saves (AppData/LocalLow/Massive Monster/Cult Of The Lamb/saves)
  • ideally play on a spare slot - and back up your creations in BepInEx/plugins/CultTweaker/: CustomNodeBlueprints, CustomLevelBlueprints, CustomDungeonMaps, CustomWorldMaps, CustomBaseMaps, CustomMainMenus, CustomShapeProfiles, LightingProfiles.json, QuestProgress.

Where to start

Installation

BepInEx, COTL_API, the folder layout, the config file and every hotkey.

The Worldshaper

The F4 editor: tools, layers, triggers, dungeons, hubs, world maps and co-editing.

Player spines

Export a Spine skeleton, load it as the Lamb, and control fleece transmog.

Follower forms

Per-part overrides, colour sets, the F8 live editor and the web builder.

Custom weapons

Combos, hit boxes, timings and chain weapons declared in a spine's config.

Custom NPC quests

Dialogue that hands out quests tracked in the game's own objectives panel.

Custom enemies

Mimic a vanilla enemy's AI, then tune its numbers by name.

Custom structures

Sprite and Spine structures, plus overrides for the game's own building art.

Items and meals

Inventory items, refining, fuel, and meals with recipes and effects.

Tarot cards

Custom tarots with the full set of run modifiers.

Modding API

Ship content with no code, or call CultTweakerApi from your own plugin.

Changelog

Every pre-release of 2.0, then the 1.x stable history.

Features

  • Load custom player spines, with multiple skins per skeleton and a separate spine per player in co-op
  • Fleece transmog and fleece cycling across every player skin, custom ones included
  • Custom follower forms with variants, per-part placement and colour sets, plus full follower colour control
  • Custom weapons declared inside a player spine, built on a vanilla weapon
  • Custom NPCs with branching dialogue and quests that appear in the game's own objectives panel
  • Custom enemies that mimic a vanilla enemy's AI and re-tune its numbers
  • Custom structures as sprites or animated Spine skeletons, and overrides for the game's existing structure art
  • Custom inventory items, meals and tarot cards
  • The Worldshaper: an in-game room, base, hub, dungeon, world map and main menu editor
  • Custom dungeons built from room blueprints, level blueprints and dungeon maps
  • Editing together over COTL MP Steam
  • A no-code content path and a code contract for other mods

Version facts

FactValue
Plugin version2.0.0, with PreRelease set to true
Pre-release 6 package version2.0.5
Built forCult of the Lamb 1.5.26 (earlier versions are not supported)
Plugin GUIDInfernoDragon0.cotl.CustomSpineLoader
Plugin nameCultTweaker
Hard dependencyCOTL_API (io.github.xhayper.COTL_API)

Download

Compatibility with saved work

Maps, levels, worlds, hubs, base edits and menu presets saved in pre-release 5 still open in pre-release 6. Maps saved by pre-release 6 carry an id on every object, which older builds ignore.

Quest progress is kept in CultTweaker's own per-save-slot file rather than the game's save, so it travels with the CultTweaker folder. Copy both when moving a save.

Mods and site by InfernoDragon0

Cult of the Lamb is a trademark of Massive Monster and Devolver Digital. This is an unofficial fan project.