CultTweaker

Changelog

Every CultTweaker release, newest first - the 2.0 Worldshaper pre-releases, then the 1.x and 0.x history.

2.0.0 - World Shaper, pre-release 6

Package version 2.0.5. Built for Cult of the Lamb 1.5.26; earlier versions of the game are not supported.

Custom weapons

  • A player spine can now add weapons to the game, declared in the spine's own config.json under weapons. Each is built on a vanilla weapon, keeping its heavy attack, sounds, hit shapes and pickup card while swapping in your look, your combo and your numbers
  • Every hit of a combo is yours to set: animation, damage, swing speed, range, hit box size, knockback, lunge speed and length, camera shake, attack type, whether the next hit can be queued, whether you can turn mid-swing, and when in the animation the hit lands and the swing can be broken out of
  • Any spine can wield any spine's weapon. The art is transplanted into whichever player skin is worn, and a swing with no animation of its own falls back to the base weapon's
  • Chain weapons are supported in full: sweep shapes, hook motion patterns, up to two chains swung at once with a delay between them, and your own hook art and size at the end of the chain
  • Added preloadWeapons to load a spine's weapon art at startup rather than at the moment a weapon is picked up
  • Added a Debug / WeaponHitboxes config that draws the hit shape of every swing, and the chain hook's own collider as it flies
  • The Podium tool now has a dropdown to pin which weapon a podium hands out

Custom NPC quests

  • A custom NPC can now hand out quests, shown in the game's own objectives panel with the same headings, tick boxes, counters and countdown wheels
  • Quests finish on the same kinds of criteria the game's own do: gathering items, killing enemies, building, growing the flock, clearing a dungeon (custom ones included), performing a ritual, speaking to another custom NPC, a flag another mod raises, or any of the game's own story beats
  • Dialogue drives them: a node or an answer can hand a quest out, take it in, or give it up
  • An NPC greets you differently depending on where a quest stands - untaken, under way, ready to hand in, finished or failed
  • Quests can pay out items, be repeatable, run on a timer, and take the items they asked for when they are handed in
  • Progress is kept in CultTweaker's own file, one per save slot; the game's save file is left untouched

Whiteboard

The pre-release 6 notes restate the pre-release 5 entries for this section and add the refinements listed below.
  • Added a Whiteboard tool: a Show whiteboard toggle, Draw with a size slider and nine colours, Erase with its own size, and Clear all
  • Strokes are never selectable and never part of the room; they show only while the editor is open, are saved with the map, and travel to the other player live
  • One drag is one stroke and one undo; an erase drag is one undo too, and Clear all wipes the board in one undoable step
  • The chosen colour shows a white border instead of being covered, and the brush lands exactly under the cursor

Multiplayer

The pre-release 6 notes restate the pre-release 5 entries for this section and add the refinements listed below.
  • Added editing together over COTL MP Steam: either player can open the map editor in the base and both see every change as it happens
  • Added a shared pause, and a chat line inviting the other player to press F4
  • Added two selection colours: yours cyan, theirs amber, on the object, its outline, their cursor and in the layer list
  • Added locking: an object the other player has selected or is dragging cannot be taken until they let go
  • Added live drags: moves, resizes and reshapes show on the other screen while the mouse is still down; cursors no longer flicker, dragged objects glide instead of jittering, and lighting changes fade in
  • Saving from either side saves on the host's machine; the guest receives the files
  • Custom dungeon levels work in a session, and both players can edit the rooms together
  • Added a Resync button, a MapEditor / NetVerbose config and a "Sync self-test" button for tracking down a desync
  • Every saved object now carries an id in its map file; maps saved by pre-release 5 still open

For mod authors

  • Added a small code contract, CultTweakerApi, which lists and finds every kind of custom content this install has - dungeons, NPCs, enemies, items, meals, tarots, structures, weapons, skins, rooms, levels, world maps, menus, cutscenes and quests - and can enter a custom dungeon, spawn a custom NPC, drive a quest and locate content on disk
  • Shipping content through CultTweaker still needs no code at all
  • Documented the load-order trap and why the numbers the game gives custom content must never be saved or sent to another machine

Fixes

  • Fixed door pads growing across the whole room when the room's centre is a hole (a pit, a tree)
  • Fixed placed enemies waking up and attacking while the editor was open with multiplayer enabled, even when hosting alone
  • Fixed the guest being stuck on the summoning screen when the host entered a custom dungeon level
  • Fixed a move or resize received from the other player sometimes respawning the object instead of moving it, which left enemy bodies behind on the guest's screen

2.0.0 - World Shaper, pre-release 5

Layers

  • Added a Layers panel at the left edge of the map editor: every object in the room listed by what placed it - Shapes, Podiums, Enemies, NPCs, Structures, Props and Triggers
  • Click a row to select that object; the tree follows your selection and scrolls to it, and section headers stay pinned
  • Shift-click two rows to select the run between them
  • Built for big rooms: a base town of six hundred objects scrolls and highlights without lag

Multi-selection and groups

  • Added multi-selection to the Select tool: Shift-click adds or removes; move and depth drags move everything together, one undo puts the whole drag back, and Delete removes the lot
  • Added groups with Ctrl+G; Ctrl+G on a whole group dissolves it, and both are undoable
  • Groups are saved with the map and come back on load; the Layers panel shows each group as a folder

Whiteboard

  • Added a Whiteboard tool with Show, Draw (size slider, nine colours), Erase and Clear all
  • Strokes are never selectable, show only while the editor is open, are saved with the map, and travel to the other player live
  • One drag is one stroke and one undo

Structures

  • Added the DLC dungeons' dressing to the structure browser: DLC Dungeon / Ewefall and DLC Dungeon / Rot, with the whole decoration plots beside them as ... Plots
  • Added the Art groups (cave biome pieces, the base's weeds, some boss and shop room dressing) and Tile Decorations
  • The old Placement Objects / DLC and VFX / DLC folders are now ... / Misc

Multiplayer

  • Added editing together over COTL MP Steam, a shared pause, two selection colours, locking, live drags, host-side saving, custom dungeon levels in a session, a Resync button, a MapEditor / NetVerbose config and a "Sync self-test" button
  • Every saved object now carries an id in its map file; maps saved by pre-release 4 still open

Fixes

  • Fixed door pads growing across the whole room when the room's centre is a hole

2.0.0 - World Shaper, pre-release 4

Follower skin editor

  • Added a follower skin editor on F8, editing the same FollowerSkins/ folders the mod loads
  • Added a left panel: skin and variant picking, new skins and variants, colour set, base skin, animation preview, and the list of overridden slots
  • Added an Outfit picker to the preview, for looking only - never saved with the skin
  • Added a right panel for the selected layer: slot, image, hide, placement sliders and colour
  • Added skin/variant naming, so one prompt saves either a new variant or a whole new skin
  • Added live reload: a saved skin can be worn by followers without restarting
  • Adding a colour set is now an entry at the top of the Colour set list

Player skins

  • Custom player spines now show on the player tab of the inventory, in Knucklebones and in Flockade, for both players and on the Flockade result card

Structures

  • Added an "Affected by wind" checkbox, armed for the next placement or set on anything already placed
  • Added wind to structures built from several sprites
  • Added shadows to custom structures, which previously cast none
  • Improved see-through so it can be worn together with wind
  • Added "HideFromBuildMenu": true to a custom structure's config.json
  • Added a Custom group to the structure tool, holding every custom structure, hidden ones included

Triggers

  • Added a "Blocking volume" checkbox: the trigger becomes an invisible wall to players and enemies, drawn in red
  • Added enemy pathfinding around blocking volumes, updated as they are moved and resized
  • Added a "Play animation on object" action, with a choice of what happens when that animation ends

Loading

  • Custom follower skins are now baked once and kept: roughly 10 seconds off the startup and about 2 GB less memory while it loads
  • A skin is rebuilt only when you change it, and the kept copy can be shipped with a skin

Compatibility

  • Built for Cult of the Lamb 1.5.26; earlier versions are no longer supported

Fixes

  • Fixed F5 starting the test dungeon from the title screen and during scene changes
  • Fixed a structure's own sprites, added as it is placed, missing the look it was given
  • Fixed naming a skin confirming a name the editor would not accept
  • Fixed the skin editor claiming to get a skin ready to edit while doing nothing

2.0.0 - World Shaper, pre-release 3

Base editor

  • Added editing of your own base town: move and place structures, terrain and paths with the F4 tools
  • Added save protection - changes live in the mod's own files, and the game's save is never written to
  • Added protection so bought buildings can be moved but never deleted
  • Added see-through for structures that block the camera while editing
  • Improved the Select, Shape and Structure tools for base work

Hub building

  • Added a build totem for hubs: build the game's own structures through the game's own build menu
  • Added building costs and refunds, kept in the hub rather than the save
  • Added a placement region so hub building cannot reach your real town
  • Added a "Customize Menu" button on the title screen
  • Added named menu presets, kept as folders with their art; one applies on every launch
  • Added a Look tool: palette pick and blend, background colour, hue / saturation / brightness, dither, grain, the glitch effect, and a negative effect
  • Added a Centrepiece tool: skin, animation, position, scale and rotation for the lamb, or a custom spine
  • Added a Title tool: replace the logo with any png, move, resize or hide it, and set, move, recolour or hide the edition line

Follower skin editor

  • Added a follower skin editor on F8 with left and right panels, skin/variant naming and live reload

Editor look

  • Improved every editor panel with the game's own artwork, toggles, sliders, section dividers, buttons, dropdowns and confirm prompt

Weather

  • Added per-room weather to the Lighting tool, for dungeons and hubs
  • Added every strength of every weather, including ones the game never shows (extreme wind)
  • Added protection so the game cannot clear a room's chosen weather early

Triggers

  • Added a Camera shake action

Fixes

  • Fixed the room editor's status bar going quiet after using the world editor
  • Fixed dragging an editor slider stuttering the menu's lamb animation
  • Fixed the menu editor's panels vanishing after loading a preset
  • Fixed the editor buttons having no ribbon until a save had been entered
  • Fixed preset art changed on disk not being picked up until restart

2.0.0 - World Shaper, pre-release 2

Dungeon Builder

  • Improved the dungeon map into a full screen, using the game's own artwork
  • Added free node placement, Ctrl+click to place, right-click to link or cut, Del to delete
  • Added auto linking when you place beside a selected node
  • Improved dragging so links follow the node, and linking so any node can lead to any other
  • Added Preview Map and live checking of whether the map will play
  • Improved compatibility with maps saved in pre-release 1
  • Improved closing with Esc, the X button or F4

Level tool

  • Added hand-built floor layouts ("custom walk") and a visual layout screen
  • Added auto connecting doors, a random walk tickbox, fixed entrance and exit rooms, and a choice of vanilla podium entrance and exit rooms
  • Added a pool of maps per room, one picked at random
  • Added Combat and Reward room markers
  • Added right-click to turn a room's doors on and off
  • Improved the door labels to Up / Down / Left / Right
  • Removed the Done button, the second menu, Rename Level and Delete Room
  • Fixed a 2-room floor generating 4 rooms

Room editor

  • Added move, resize and depth handles, Ctrl-drag copying, a preview picture of the selection, and right-click to deselect
  • Improved flip into a tickbox and terrain ordering into a list with - and +
  • Added Ctrl-drag copying of whole triggers and colours to trigger boxes
  • Improved Clear All Triggers into the Clear tool, and long trigger lists to scroll
  • Fixed older rooms having their terrain order changed

Editor panels

  • Added an unsaved changes prompt, search by name to the Structure, Enemy, NPC and Level tools, a "Bosses (inside rooms)" list, and a bigger hover preview
  • Improved the icon lists to scroll on their own and the scrollbars into a thin rail
  • Improved the Load Map browser into a full screen, with a picture and details of the map you pick and click to enlarge
  • Improved the Lighting tool to capture the room's lighting on open
  • Fixed typing pressing the button under the mouse, the game's menus stealing the keyboard while naming, Reset To Biome leaving the sliders where they were, the Load Map browser stuttering, picking a room in the Level tool pausing each time, blurry map pictures, and character previews not drawing after a game update

Door tool

  • Improved the floor padding beside doors to be invisible but walkable

F7 CultTweaker panel

  • Added a player panel in the bottom-left corner, a moving character preview and a preview animation dropdown
  • Added saving of your chosen skin
  • Improved fleece transmog to be per player
  • Improved the layout into Go and Extras sections, and the text sizes to match the editor

Custom dungeons

  • Fixed doors not locking with monsters in the room
  • Fixed a boss statue room replacing the weapon podium

v1.1.1

  • Added hide slot for follower skins to hide specific slots
  • Removed test code for custom dungeons to prevent errors

v1.1.0

  • Added Custom Dungeons
  • Fixed an issue with Custom Structures not loading fully (use new custom structure template)

v1.0.7 / v1.0.8

  • Added Scale setting (1x to 5x) to followers
  • Player Spine loader now supports co-op separate spine loading
  • Re-added Intro fleece to the fleece transmogs
  • Player Spines now load in instantly instead of loading it when entering the base for the first time, which allows custom lamb skins to be used in the Intro

v1.0.6

  • Fixed an issue where fleece cycling did not include parts of certain fleeces

v1.0.5

  • Fixed an issue where fleece cycling was going over array bounds
  • Fixed an issue where fleece cycling caused a softlock
  • Added Custom Player Spine Fleece Cycling support
  • Added a toggle to turn on or off fleece cycling (F9)
  • Added Custom Follower Form + Variant support
  • Added a config to dump follower spine slots

v1.0.4

  • Fixed an issue where red overlays are present on custom player spines

v1.0.3

  • Fix an issue where Fleece Cycling did not override some extra parts of the fleece
  • Full Follower Customization Support

v1.0.2

  • Fix an issue where picking up weapons caused an error

v1.0.1

  • Fleece Cycling for all player skins

v1.0.0

  • Name Changed to CultTweaker
  • Support for Woolhaven
  • Custom Data Loader - create your own custom stuff!
    • Custom Items
    • Custom Food WIP
    • Custom Structure
    • Custom Tarot Cards

v0.0.5

  • Add Structure Overrides

v0.0.3

  • Add Custom Follower Color Control

v0.0.2

  • Added Multi-skin support per Spine skeleton

v0.0.1

  • Initial Release

Mods and site by InfernoDragon0

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