WKMapLoader

WK Map Loader

Make your own White Knuckle maps in Blender and play them in the game.

• CUSTOM tab in the play menu, one card per map
• Climbing like the real game: top edges are grabbable, handholds anywhere
• Buttons, pads and zones that give items, set checkpoints, teleport, time runs and more. No code
• No rising mass, thin fog, falling sends you back to your checkpoint

Playing: install a map pack, then Play → CUSTOM.

Make a map

1. Model it in Blender (1 unit = 1 m).
2. Tag objects (below). No tag = solid block with grabbable top edges.
3. Add an empty named spawn.
4. File → Export → glTF 2.0, format .glb, into BepInEx/plugins/WKMapLoader/maps/.
5. Play it from CUSTOM. F8 reloads after each export.

maps/example.glb has one of every tag, in labelled rows (surfaces, places, triggers, items, movement, effects, text) plus a short timed course. Play it from CUSTOM and look at any object to see its tags, or import it into Blender to see how it's built.

Tags

Tags go in Blender and are part of the map. Console commands are typed in game and are only for you while testing.

Put tags in the object's name, separated by ;:

button; clear; give rebar 3; msg Ready!

Or keep the name free: parent empties to the object and name the empties after the tags. Empties on their own are places (spawn, lights, points).

` = required, [value] = optional. Text can go in quotes: msg 'Floor 1/2; go'`.

Surfaces

Tag — Does — Example

(none) — Solid, top edges grabbable — Floor

smooth — Solid, nothing grabbable — smooth

handhold — Grabbable all over — handhold

pass — With handhold: grab it, walk through it — handhold; pass

deco — Visible, no collision — deco

invisible — Solid, not drawn — invisible

enemywall — Invisible glass: stops you and denizens, shots fly through — enemywall

Places & settings

Tag — Does — Example

spawn — Start point, facing Blender's +Y — spawn

exit — End point (optional) — exit

point — Target for teleport — point top

light [range] [hex] — Invisible light here (default 12 m) — light 20 ffcc88

lamp [range] [hex] — Light shining from a visible mesh — lamp 8

note — Floor note, text from _.txt — note intro

godmode — Can't die in this map — godmode

fog — Fog strength (default 0.25) — fog 0

ambient — Base light everywhere, no lamps needed — ambient 0.3

Triggers

Tag — Runs its actions when you... — Example

button — Press the mesh — button; give flare 2

pad — Stand on top of it — pad; checkpoint

zone — Walk into it (invisible; add deco to show it) — zone; timer start

start — Start the map or fall back to spawn — button; clear; give rebar 3; start

Actions

Tag — Does — Example

give [n] — Item or trinket, part of the name is enough — give rebar 3

bind [n] — Give it and keep it through clear — bind buddy

unbind — Stop keeping it, take it away — unbind buddy

clear — Empty the inventory (runs first) — clear

checkpoint — Respawn here after a fall — pad; checkpoint

teleport [point] — To a point, spawn, or last checkpoint — teleport top

launch — Spring: throws you m metres up — pad; launch 10

msg — Big text on screen — msg Time {timer}

perk [s] — Perk, no time = until you leave — perk velocity 10

effect [s] — Effect, no time = until you leave — effect sticky_hands 10

timer start/stop/reset — Speedrun timer, stop saves best — zone; timer stop

set — Set a value — set floor 2

add [n] — Add to a counter — add presses

map — Load another map — pad; map level_2

win — Fireworks, then the win screen — button; win

Effect — Does

refill — Full stamina

infi_stamina [s] — Stamina stays full

sticky_hands [s] — Grab any surface

temp_jump — n extra air jumps

jump_boost [s] — Higher jumps

game buff id — That game buff

In msg text: {timer} {best} {falls} {map}, or any counter: button; add presses; msg Pressed {presses} times.

Labels

Tag — Does — Example

name — Bold name above it when you look at it — name Rebar Station

description — Small line under the name (add several for more lines) — description Gives 3 rebars

sign — Text written on a flat mesh — sign Shooting Range

Presets

Save a tag combo under a short name, then name objects after it. In the console use / between tags (the console uses ; itself):

setpreset rebarbtn button / clear / give rebar 3 / start

An object named rebarbtn now gets all four tags. Saved in BepInEx/config/WKMapLoader.presets.txt. When sharing a map, put its presets in _presets.txt next to it.

Console commands

Command — Does

maps — List map files

loadmap — Load a map now

F8 — Reload the current map

F9 / mapspawn — Back to spawn

mapinfo — What loaded, and unknown tags (typos)

mapfog — Fog, for testing

mapambient — Ambient light, for testing

dumptextures — Save game textures, to pick wk_ materials

presets — List presets

setpreset — Make or change a preset

removepreset — Delete a preset

Materials & sharing

• A material's Base Color tints the blockout texture. Name it wk_ to use a game texture.
• Share a map as a Thunderstore package: a maps folder with your .glb, plus optional .png (card image), _bg.png (background once the card is picked), .txt (first line title: My Map) an