WK Map Loader

Play custom maps in White Knuckle - built in Blender (or any 3D tool) and exported as a plain .obj file.

• A CUSTOM tab in the play menu with one card per map. Pick a card, press Play.
• Climbing works like the real game: the top edges of every surface are grabbable ledges, and parts named handhold are grabbable everywhere.
• Lights, coloured parts, the game's own textures, checkpoint buttons that hand out items, and falling off the map sends you back to the start instead of killing you.
• No rising mass in custom maps, and fog is thinned so you can see your build.

Playing maps

Install map packs (they depend on this mod), then: Play → CUSTOM → pick a map → Play.

Making maps

1. Model in Blender. 1 unit = 1 metre.
2. Name each object - the name decides what it becomes:

1. Materials: a Blender material's Base Color tints the part. A material named wk_<game material> uses that texture from the game (dumptextures lists them).
2. File → Export → Wavefront (.obj), Materials on, into BepInEx/plugins/<this mod folder>/maps/.
3. In game: the map shows up as a card. While playing, loadmap <name> loads it directly and F8 reloads it after you re-export.

Optional next to mymap.obj: mymap.png (card art) and mymap.txt (card description).

The full guide is MAPPING_GUIDE.md in the mod folder.

Console commands

Making a map pack

Make a Thunderstore package with your .obj/.mtl (and optional .png/.txt) inside a maps folder, and add laki_sa-WKMapLoader-1.0.0 to its dependencies.

Notes

• Custom maps disable achievements and leaderboards for that run.
• Built for White Knuckle 0.61. Game updates may break it - report issues and I'll update.

Changelog

1.0.5

• Card title from the map's .txt: first line title: <name> (otherwise the file name)

1.0.4

• Glow-wall game: computer (tutorial board as monitor with a black screen and GAME / POWER-UPS tabs, crane arrow keys); single player or multiplayer (Comp: a wall each or one shared wall with a colour per player, Co-op: one wall, team score); btn lifespan, light-up interval, duration; the game's button stand starts a wall (3-2-1-GO, invisible wall drops; same light-up order for the same settings); floating power-ups (stamina, speed, air jumps, elastic limbs, grab anything); game-over stats
• Glow maps: parts tagged _flat / _cyl only show on that map; _cyl parts spin around their lane's ..._cyl_body_laneN axis (one turn per 15 s)
• prop:<GameMesh> objects: use the game's own meshes (board, buttons) in your map
• handhold_pass: grabbable holds your body walks through
• godmode marker object: no dying in that map
• Button items can be several words: checkpoint_3_rebar_explosive gives 3 explosive rebars
• Win sequence flying 30% slower (4.2x)
• Blast logger (boomreport, boom_log.csv) and boomcourse, which sizes the Boom Course from your attempts with leeway

1.0.3

• Fix: maps from map packs installed with the Thunderstore mod manager now show up in CUSTOM
• Win sequence: much faster flying, winseq console command

1.0.2

• New map parts: buddy button, save pads, floor notes, win sequence buttons (win / *win_seq*: title, noclip, 5x speed, flare machine gun, game win screen after 10 s)

1.0.1

• Fixed broken arrow characters on the README page.

1.0.0

• First release: .obj map loading, CUSTOM menu tab with map cards, ledges, handholds, lights, materials, checkpoints, fall reset, map fog control, rebar course generator.