Field Manual

BasicsGetting started

RUMPUS ENGINE is a single-file browser game studio — build worlds, play them (FPS, racing, top-down, side-scroll), and share them. Nothing installs; the whole game is one page.

The home menu

• Deploy — play the current level (your autosaved work, a loaded file, or the default arena). Its equal twin Build / edit level opens the editor on the same level.
• Multiplayer — host or join a room (see Multiplayer). Community levels — browse and play what other creators have published.
• Play campaign / Load campaign — play a sequence of chained levels with carry-over loadout (in the footer strip).
• Instructions — a quick controls card. Help & tutorials — guided tutorials with loadable example projects. Field manual — this page. Credits — engine libraries plus the asset attributions collected for the current level.

BasicsControls

On foot

Driving (walk up to a vehicle, press E)

Editor

Gamepads and touch are supported: plug in a controller (press ] to switch between detected pads), or on a phone use the on-screen joysticks and drive cluster — pause → ✿ Customize controls to move or resize any on-screen button.

Rebinding: pause → ⌨ Keyboard bindings to remap movement and every action (click an action, press the new key; picking a key already in use swaps the two; Reset restores defaults). Weapon slots 1–5, Esc and the editor's own keys stay fixed, and on-screen prompts keep showing the default keys.

Controller menus: every menu is playable from the pad — D-pad or left stick moves the focus ring, A selects, B backs out, and left/right tunes sliders and dropdowns. The first press lands on Deploy.

Controller: Start pauses (solo) or opens the match menu (multiplayer). D-pad: up = inventory, down = map, left = melee, right = flashlight. In the supply cache, D-pad picks, A buys, B/Y closes; on the upgrade screen, bumpers or D-pad focus a card and A takes it (keyboard: press 1–3). Look sensitivity, aim sensitivity, stick deadzone and invert-Y live in the pause menu once a pad is connected.

Touch: besides the joysticks — CROUCH toggles, MELEE swings, BUILD opens the deploy radial (tap a slice to place), and hold USE to grab or drop a physics prop. LIGHT, BAG and CHAT appear automatically when a level has a flashlight, an inventory, or you're in a multiplayer room.

Editor referenceEditor overview

Open the editor with Build / edit level on the home menu, or press P during a solo game. The panel on the right is organized into eight tabs; the last tab you used is remembered.

Most sections start collapsed — click a header to expand it. The ? button on the editor toolbar opens this manual. Everything you do in the editor is undoable with Ctrl+Z, and the level autosaves in your browser while you edit (toggle on the Save tab).

Editor referenceBuild tab

Add shape

+ Box, + Sphere, + Cylinder, + Cone, + Ramp, + Stairs, + Dome, + Tube, + Ring drop a primitive in front of the camera. Every shape gets the full Material editor. The first four use exact box/sphere colliders; the construction shapes (Ramp/Stairs/Dome/Tube/Ring) collide with their real triangles, so you can walk and drive up a ramp or staircase, shelter under a dome (it's hollow — visible from inside), run through a tube, or hop through a ring. Like every primitive they're authored to a 1×1×1 footprint with the base at floor level, so scaling and floor-snapping behave exactly like the box: stretch a Ramp long and low for a drivable slope, or scale Stairs up for building-sized steps. A Pillar and the track pieces are also primitives under the hood.

Track builder

Snap-together race track pieces — covered in depth in Track builder & racing. With pieces placed, the Track appearance panel restyles the whole course at once: road colour, roughness and an optional road texture (with a tiles dial), painted-line colour, the kerb stripe pair, and the barrier colour. Saved with the level; Reset to stock returns the classic asphalt look.

Search free models

One search box finds free 3D models on Poly Pizza (no key needed) and Sketchfab (needs a free API token — enter it once, everywhere else shows “Token saved · change”). Click a result to place it. Every searched asset is recorded for the level's Credits screen automatically.

Object & selection

With something selected, this section shows: swap/replace model, and the eight folds that give a prop behaviour — animation, locks, signals, dialogue, vehicle, joints, mechanisms, physics & destruction.

Material

For shape primitives: colour, texture map with U/V tiling and rotation, shininess, metalness, emissive glow — and Opacity. Opacity below 1 makes the shape see-through: glass = low opacity + high shininess, frosted plastic = mid opacity + low shininess, and a faint pane at the minimum (0.15) reads as a force field. A transparent prop stays completely solid — you can stand on a glass floor and bullets still hit it. Opacity saves with the level and carries through share links and multiplayer like every other material setting. Imported models keep their own materials — the section says so instead of hiding.

Transform & Handles

Transform is the numeric version of the gizmo: exact position, rotation and scale fields. Handles pick the gizmo mode (move / rotate / scale — also 1/2/3) and proportional scaling (4).

Groups

Every prop's Tag now sits at the top of Object & selection (and stays in the Signals fold — they edit the same tag). Ctrl+Shift+C collapses every editor section at once.

Outliner (scene hierarchy)

Press O (or the list button on the editor toolbar) for the Outliner — the whole placed scene as one panel: props, lights, enemy spawns, turrets and pickups, each with its tag. As levels grow this is the fastest way around:

• Search matches names, tags and folder names; the tag dropdown narrows the list to one tag.
• Folders: select some props, then use the Move → dropdown in the Props group to file them into a folder (or create a new one) — or just drag a row onto a folder (drop on the Props header to un-file it). Folders save with the level. Double-click a folder to rename it; a folder's eye/padlock hides or locks everything inside at once.
• Eye hides an object while editing only — deploys and play always show everything. Great for getting a roof out of the way.
• Padlock locks an object: viewport clicks and marquee boxes pass straight through it, so a big backdrop stops stealing every click. A locked object can't be selected or moved at all until you click its padlock again.
• Select all of a type: the grid button on a type header (or a folder) selects everything it contains — filter first to select just that slice (e.g. every prop tagged door).
• Double-click a prop or light to name it; names save with the level and make search actually useful.

Select multiple props and press Ctrl+G to group them — the group moves, rotates, scales and duplicates as one. Ctrl+Shift+G ungroups.

Prefabs

Turn any configured selection into a reusable component — a door with its trigger, an elevator, a trap, a whole furnished room. Select the props, type a name in the Prefabs section and hit Save selection: the capture keeps everything — signals, mechanism animation, physics and joints, vehicle tuning, locks, dialogue, materials. Place drops a copy 8 m ahead of the camera; every copy arrives grouped (moves as one) and heights are terrain-relative, so a room built on flat ground sits correctly on a hillside.

Your prefab library lives in your browser and follows you across levels — and every level embeds the prefabs it uses, so a shared or community level brings its components along (they join the library of whoever opens it, never overwriting same-named prefabs of their own).

Editing a prefab: change any placed copy — move parts, retag, recolor, even add new props to its group — select it and press Update on that prefab's row. The definition rewrites and every other copy in the level follows. Parts you deliberately changed on one specific copy (a raised panel, a renamed tag) are detected as local overrides and left exactly as you authored them — the toast reports how many were kept. Moving a whole copy around the map never counts as an override. Detach disconnects a copy so future updates skip it; × removes a prefab from your library (placed copies stay in their levels).

Editor referenceObject folds — giving props behaviour

Select any prop on the Build tab and open Object & selection. Eight folds, in panel order. (Signals and Mechanism get their full treatment in Signals, locks & mechanisms; Vehicle in Vehicle tuning.)

Animation

Plays a model's built-in clips. Pick the clip (or all clips at once), then when it plays — Auto (from level load), E Activate (player interacts), or Signals only (waits to be targeted) — and how: ⟳ Loop, ⇄ Ping-pong, or → Once. Built-in shapes have no clips (use Mechanism to move those); for models without animations, the Sketchfab search has an "Animated only" filter.

Lock

Lock picks the required key (red / blue / gold / green); pressing E on the prop then needs that key in hand — place a matching key pickup pad somewhere findable. Consume key on unlock spends the key (for one-key-one-door puzzles; off = a master key). A prop unlocks once per deploy, for everyone in MP.

Dialogue (NPC)

Name (shown over the prompt) + one line of dialogue per row (up to 12 × 200 chars); the player presses E to advance. The first line also fires the prop's On E signals — so a conversation can set the objective, drop a checkpoint, or open a door as it starts.

Joint (physics)

Joints take effect on Deploy.

Physics & destruction

Editor referenceWorld tab

Sections: Environment · Auto-generate · Zones

Environment

Movement

Global player physics: Walk speed (4–60) · Run speed (4–100) · Crouch speed (1–40) · Jump (0–30) · Launch power (0.25–4, jump-pad multiplier) · Gravity (5–80) · Eye height (0.4–20).

Lighting — control by control

Tip: the day/night cycle can't dim an HDRI sky texture (only fog, lights and flat-color skies) — for convincing nights, use a plain sky. Sun direction still sets where dawn breaks when the cycle is on.

Camera & view

Field of view (50–110) · View distance (60–2000 — the hard cutoff where geometry stops drawing; raise it for big racing arenas) · Fog density (lower = see farther into the dark) & colour · ground grid toggle. Depth of field: Focus distance = how far away stays sharp, In-focus range = the depth kept sharp around it, Blur strength = how soft everything else goes. Post-processing: Bloom + Bloom threshold (how bright a surface must be before it glows), Motion blur (trail strength), Vignette, Film grain, Saturation, Contrast — they all compose, DoF included, and they save with the level (the on/off switch is each player's preference).

Sky

Browse Poly Haven HDRIs in-editor or paste any equirectangular .hdr/.jpg URL (an .hdr lights reflections too); presets Park / Mountain / Room / None (None = flat fog-colored sky). Reflection strength (0–3) sets how strongly the sky shows up on metallic floors and walls — 0 for fully matte scenes. Sky rotation° spins the panorama to aim its sun or horizon features.

Weather — control by control

The layer follows the camera and falls indoors too — keep sheltered scenes on None, or accept it as "atmosphere". Storm recipe: Rain, Amount 1, Size 1.4, Wind 2.5, day/night cycle parked at Dusk.

Floor & terrain

Floor colour / roughness / metalness, texture with tile W/H and rotation, and a texture search. Terrain: Height (0–18) and Detail (1–8) with Generate / Regenerate / Flatten, plus a terrain brush painted directly onto the ground — Raise / Lower / Smooth sculpt the height, Paint blends materials, and Scatter plants props. A colour-coded cursor ring follows your pointer showing the brush radius; in Paint mode the inner ring is where full strength ends and the soft edge begins, in Scatter mode it shows the planting spacing.

Material painting (the Paint brush mode)

Make the base floor your ground material (say, tiled grass), then paint up to three more textures straight onto it — a dirt path, a stone plaza, scorched earth. Pick a Layer, give it a texture (URL or the built-in free-texture search) and a Tiles count, then drag on the floor. It works on flat floors and sculpted terrain alike, and the result saves with the level (share links, gallery, multiplayer).

Path recipe: base floor = grass texture; Layer 1 = dirt, Tiles ≈ your floor tiling, Brush size 4–6, Soft edge 0.6, Flow 0.4 — then drag your route in two or three slow passes.

Landscape scatter (the Scatter brush mode)

Plant randomized props by dragging: trees, bushes, rocks — anything. Fill up to three slots, either from the free-model search (credited automatically) or with Use selected prop, which clones whatever's selected at its exact scale — including built-in shapes. Each slot has its own Size dial: for searched models it's the real-world size in metres (default 7 — tree height; crank it to 25 for giants), for cloned props it's a multiplier on their captured scale. Each pass drops Density (1–6) props at random spots inside the brush circle, each randomly rotated, varied by Size jitter (±0–60%), and sat on the terrain — a slow drag along a hillside plants a treeline.

Scattered props are normal props: marquee-select to move or delete them, undo works, and they save with the level. Budget note: each searched model adds a draw call — a few dozen trees is fine, hundreds will cost frames. Scattered primitives (rocks from spheres, fence posts from cylinders) are basically free thanks to instancing. Forest recipe: slot 1 = a tree, slot 2 = a second tree variety, slot 3 = a bush; Density 3, Size jitter 0.4, Brush size 15 — then wander the map edge in one slow pass.

Walls & arena

Show boundary walls (off = invisible but still solid), wall material/texture controls, and Arena size (15–2000) — half-width of the playable square. Racing levels usually want 300+.

Audio

A looping music track plus per-event sound rows: grenade explosion, coin pickup, powerup pickup, jump, hit marker, enemy kill (with per-enemy-type overrides), player hurt, and the car set — engine loop, brake, skid, boost. A built-in Freesound browser searches free sounds; each pick is credited automatically.

Auto-generate

Procedurally builds a starting layout (cover, buildings, scatter) you then edit by hand. There's also an AI scene builder — describe a scene in a sentence and it searches and places matching models (works best with a Poly Pizza or Sketchfab key).

Zones

Paintable volumes under World → Zones — pick a type at the top of the section, then + Add (at me) drops one where you stand. Audio zones (positional sound while inside a radius: URL, volume, loop), Death zones (instant kill between Base Y and Base Y + Height — lava, pits, out-of-bounds), Jump pads (launch on contact, scaled by the Movement fold's Launch power), Ladders (climbable volumes: W up, S down, jump to hop off; Facing sets which side you step off at the top), and Fire zones (damage per second inside, with a full particle look: density, size, hue, turbulence, wind, saturation, sparks, smoke mode — hue 30 is natural fire, 210 blue, 285 purple; saturation 0 turns it into grey smoke).

Water zones — control by control

Water is mechanical, not just visual: cars slow in it (light splash → 45% of top speed in the shallows → 18% in deep water) and throw bow spray; dynamic props bob to the surface and float; enemies and bots wade at roughly half pace — funneling hostiles through a river is a legitimate defensive design. One draw call per surface, so lakes are phone-friendly.

Waterfalls — control by control

They live inside the Water tool, below the zones list. Each fall is two layered sheets of streaming columns (the back layer runs slower and dimmer for depth) plus a churning foam pool.

Standing in the sheet pushes you down into the plunge pool — pour a fall into a deep water zone and the combination is safe to ride down; onto dry ground, the landing is on you.

Editor referencePlayer tab

Sections: Handles · Object & selection · Transform · Characters

• Player avatar — import any model as the third-person body; scroll in the preview to zoom.
• Player start — drag the blue marker to set where the run begins; Facing° (−180…180) sets the initial look direction.
• Characters — the roster of player & enemy character models, with animation-slot mapping (clips are grouped by taxonomy: locomotion, combat, hits, deaths…). Characters picked here appear in multiplayer's CHARACTER menu too.
• Slide on touch — tap CROUCH while sprint-running; a standing tap still toggles crouch. On a controller the bag and item inspector are fully navigable: stick/D-pad moves the ring, A opens/uses (including Use — hold & place), B backs out.
• First-run tutorial — your first solo deploy shows a small coach pill (Move, Look, Fire, Jump, Sprint, Build menu); each step ticks off when you do it, the wording matches your input device, and the ✕ dismisses it for good.
• Model loading bar — picking a Sketchfab or Poly Pizza model shows a live progress pill (percent and MB) while it downloads, so you know it's coming.
• Joint tweaks — models that import with bent wrists, A-pose arms or twisted forearms can be fixed in-app: pick a bone on the Player tab (Joint tweaks), nudge X/Y/Z in degrees, and the offset rides on top of every animation. Live in the preview, saved with the character.
• Auto-rigger — a static, unrigged humanoid model (T-pose or A-pose) becomes a fully animated character without leaving the game. Load the model on the Player tab or an Enemies-tab slot and press Auto-rig model (T-pose) (each enemy type keeps its own markers; roster characters inherit the Player tab's rig when you add or update them): a Mixamo-style modal shows the model front-on — click chin → wrists → elbows → knees → groin (with Use Symmetry on, one click per pair fills both sides; drag to turn, scroll to zoom, click a step row to re-place it). AUTO-RIG fits a full humanoid skeleton to your markers, computes skin weights automatically (weights blend smoothly across knees and elbows and are diffused along the mesh surface, so deep bends curve instead of creasing), and switches the animation library on — the model walks, runs, crouches and shoots immediately. The markers are a few numbers saved with the level, so the rig rebuilds on every load; works at any model scale and with any rest pose (T or A — library clips align to the model's rest automatically). Blocky/stylized models deform best — fine-tune joints afterwards with Joint tweaks if needed.
• Animation editor — author your own skeletal clips entirely in the browser (desktop only; no Blender or Mixamo needed). On the Player tab press 🎬 Animation editor: the model opens in a full-screen workspace with a bone tree (friendly names, search), an orbit viewport (click a joint to select it, drag the selected joint to rotate — hold X/Y/Z for a local axis, Shift-drag the hips to move them), an inspector (exact angles, reset, key buttons) and a timeline (scrub, play with Space, drag keys, snap-to-frame, K keys the selected bone, Shift+K keys the whole pose, Auto-key writes keys as you drag). Clips save into the level (share codes, multiplayer and campaigns carry them) and appear in every per-state clip picker next to built-in and library clips — or assign one directly from the editor's Assign panel (idle, walk, reload, death, any state). Because clips are stored against the engine's normalized skeleton, the same clip retargets onto any humanoid model. Ctrl+Z undoes inside the editor; deleting a clip warns where it's assigned. Edit an existing animation — the Edit existing… dropdown copies any clip already on the model (its own clips, or a retargeted Quaternius library clip) into a new editable custom clip: it samples the clip into keyframes (automatically thinned so it's hand-editable, not one key per frame), names it “<clip> (edit)” so the original is never touched, and drops you straight into tweaking it. Take the pack's walk, adjust the arm swing, save — your version plays in its place. Production tools: Mirror pose / Mirror clip (left↔right), Copy/Paste pose and Copy/Paste keys at the playhead, a per-clip Curve mode (smooth / linear / step), Ghosts (onion-skin skeletons at the previous and next keys), Export/Import of .rumpusanim files to share clips between levels and creators, and timeline events — fire a sound (footsteps, casings, reload clicks) or a → Logic event (melee hit-windows, scripted beats) at any moment of the clip; they show as orange ticks on the timeline and fire wherever the clip plays. The editor also opens from the Enemies tab to author clips on any enemy model (one shared clip library per level), keys multi-select with Shift-click or by dragging a box across the dope sheet — the band now spans every bone row it crosses, so you can grab a whole span of keys across many bones at once (Shift adds to the selection). Select all grabs every key on every bone in one click, Deselect clears it, and Delete keys (or the Delete key) removes the whole selection; dragging any selected key moves the entire set together. A Root path toggle draws the hips trajectory so authored root motion is visible at a glance. The timeline is a dope sheet — one labeled row per keyed bone; grab keys on any row, scrub on the ruler — and Flatten to in-place removes the hips X/Z drift so an authored walk loops on the spot.
• Built-in animation library — pick Standard (43 clips) or Pro (120 clips — every animation slot filled: 8-direction locomotion, climbs, turns, dodges, five hit reactions, two deaths) under Animation states and RUMPUS ENGINE retargets the CC0 clip pack (by Quaternius) onto your model's own skeleton. Any humanoid rig works: Mixamo-rigged, UE-style, Rigify and most others are recognized by bone name, and every slot stays overridable — the pack's clips just appear in the pickers alongside the model's own. No more exporting animations one at a time and converting them — and a model with no rig at all can be rigged right here (next item). Characters hold guns with both hands automatically — a per-frame arm IK plants the support hand on the forestock (tracking your aim) and pulls the trigger hand in only when the gun sits beyond its reach, so your tuned grip survives into play; the Player-tab preview shows the same hold, and a Two-handed weapon hold (IK) checkbox turns it off per character.

Editor referenceEnemies tab

Sections: Enemies · Object & selection · Transform · Enemy gunfire

• Type picker — choose an enemy type, import a model for it (⤢ Auto-fit size matches the collider), live preview.
• Collider radius / height — size the damage hit-cylinder only (0 = auto-fit). They no longer affect movement or spacing; toggle Show colliders to see the pink cylinders on live enemies. Offsets re-center off-pivot models.
• Spawn markers — place exact spawn points with patrol/hunt mode, patrol radius, detect radius, facing, a patrol route, and “Appears on wave N” (0 = every wave). No markers = classic random waves.
• Enemy gunfire — how enemy fire looks: bolt tip, streak, trail and muzzle flash.

The eight enemy types — how each one fights

Later waves bias toward the tougher and ranged types automatically in Random mode. Water slows all of them to about half pace — terrain is a weapon.

Editor referenceGameplay tab

Sections: Objectives & rules · Pickups · Loot · Inventory items · Build menu · Logic graph · Cutscenes

Objectives & rules is the heart of the level — the full reference is in Objectives & rules. The other sections:

• Pickups — pads that grant ammo, health, weapons, power-ups, keys and items. See Pickups & inventory.
• Loot — what enemies and loot boxes drop when destroyed; place loot boxes with a custom model, per-box contents, or random loot.
• Inventory items — define carryable items: name, type (3D object you can rotate/zoom in the inspector, or a Journal / note text page), description, model, scale, and what using the item does (use-type / key / amount / consume). Hand them out via pickup pads or signals-gated props.
• Build menu — the in-game radial Deploy menu (Tab): choose which shapes/models players can spawn while playing. All ten primitives (box, cylinder, sphere, cone, pillar, ramp, stairs, dome, tube, torus) or any custom model, each with colour/texture/scale plus Explosive, Unbreakable (shots can't shatter it) and Anchored (a static building block — no physics tumble).
• Build mode — picking a slot enters placement: a translucent ghost follows your aim and snaps flush to the face you point at (grid-aligned, Minecraft-style) or to a ground grid. Fire places and keeps building, and a misplaced block deletes just as fast — aim at it and press X / middle-click (desktop), LT (controller) or AIM (touch); only blocks placed this session delete, never the level itself. Rotate the ghost 90° with the scroll wheel or R (Shift+R rotates back), RB/LB on a controller, or the ROT chip on touch — the hint shows the current angle. Right-click toggles snap, Esc/Tab (or BUILD on touch) exits. On hilly terrain the ghost hugs the landscape and placements land exactly where it shows. Anchored + Unbreakable slots make true building blocks for forts and towers.
• Logic graph — node-based visual logic: variables, branches, timers, counters, loops, randomness and reusable functions, no code. See Visual logic — the Logic graph.
• Cutscenes — the camera-sequence editor. See Cutscenes.

Editor referenceWeapons tab

Sections: Object & selection · Transform · Effects

Per weapon you can import a replacement model (with framing/transform for both hip and aim view), set its shoot & reload sounds, override its damage, and disable the muzzle flash. Effects covers gunfire's look: Impacts (sparks, marks & debris where shots land), Tracer (the streak fire leaves in the air) and Bullet holes — decals stamped where shots hit walls, floors and props. Tune their size and lifetime or upload your own decal image (a soft-edged transparent PNG works best); it saves with the level so everyone sees it. Decals are pooled and fade out on their own, so long firefights never clutter the scene. In multiplayer, everyone's gunfire reads: joiners', bots' and enemies' tracers stop at the wall they hit and spark (and stamp) there, just like your own.

The arsenal — full stats

The economy: attachments, upgrades, shop

Attachments — bought once with credits at the Weapon loadout screen, one per slot per weapon:

Between-wave upgrade cards (solo, pick 1 of 3 after each cleared wave, if enabled in the rules): High-Velocity Rounds (+25% damage) · Trigger Job (+15% fire rate) · Reinforced Plating (+25 max HP, heals) · Combat Stims (+12% move speed) · Vampiric Rounds (heal 4/kill) · Scavenger (+30% credits) · Field Medic (heal 25 each wave) · Munitions Cache (+1 grenade now & each wave).

Supply chests spawn periodically (one purchase each, then consumed): Medkit ◆60 · Overshield ◆100 · Damage Core ◆120 · Speed Cell ◆80 · 3 Frags ◆90 · Ammo Crate ◆50 — plus one-time weapon unlocks (SMG ◆200, Shotgun ◆220, Rocket ◆320, Sniper ◆400, Crowbar ◆140). The Ammo Station (if enabled) refills your current weapon for its listed price.

Editor referenceHUD tab

Sections: HUD · Crosshair

• Custom widgets (logic-driven) — add your own on-screen elements: Text, Timer, or Bar. They are live views of the Logic tab's variables: write {score} inside a label and it shows that variable's value in real time; a Timer reads a seconds variable and shows it as M:SS; a Bar fills value/max (max can be a number or another variable). Show when hides a widget until a variable is non-zero — so a Set-variable node can pop a scoreboard or banner mid-match. Position with 8 anchors + pixel offsets, style with size/colour/panel. Recipes: scoreboard = On enemy killed → Change variable score +1, plus a Text widget "SCORE {score}"; countdown = On start → Set variable time 120, Every 1 sec → Change variable time −1 → Branch time ≤ 0 → lose, plus a Timer widget reading time. Widgets save with the level and sync to every player in multiplayer (the host's numbers are the truth).
• Colours — accent, health, score.
• Fonts — separate UI and display fonts from an 18-font set (Chakra Petch, Orbitron, Rajdhani, Press Start 2P, VT323, Russo One, Bungee, JetBrains Mono…).
• Panels — shape (Angular / Rounded / Square), background opacity, border.
• Show in play — toggle each element: minimap, score, wave counter, ammo, health, crosshair, kill feed, interact prompt, grab hint, objective banner, NPC dialogue.
• Per-element layout — pick an element, then: Size (0.4–2.5×), X/Y offset (±2000 px), Opacity, plus Font and Tint for the text elements. While the HUD tab is open you're in live preview: drag the dashed outlines to position elements directly. Reset per element or the whole HUD. These settings save with the level — everyone who plays it sees your HUD.
• Crosshair — style ✛ Classic · + Cross · • Dot · ◯ Circle · ⊤ T-shape · ∅ None, with size, thickness, gap, center dot and colour.

Editor referenceSave tab

Sections: Level file · Campaign

• 💾 Save / Clear save — browser save slot; Autosave while editing keeps it fresh.
• 🔗 Copy share link — the whole level compressed into a URL. See Saving & sharing.
• ⬇ Export / ⬆ Import — the level as a .breach file you can back up, edit or send (plain JSON inside; old .json exports still import).
• 🗑 Delete all objects — fresh scene (undoable).
• Issues panel — live validation that catches the classic mistakes before a playtest does: locks with no matching key pad (and orphaned keys), pickup spots placed while pickups are off, audio zones with no sound URL, cutscene shots with fewer than 2 waypoints, signals targeting a tag no prop carries, signals with no target (only Win level and Play cutscene work targetless), contact signals filtered to a tag that doesn't exist, signals playing a cutscene that doesn't exist, and Signals-only mechanisms that nothing can ever trigger.
• Autosave — saves every few seconds while editing (never mid-PvP-match); the status line shows the last save time, or a storage-full warning that means "export a backup now". Undo holds the last 60 snapshots.
• Campaign — chain levels into a solo campaign: build a level → ➕ Add current level → repeat → ▶ Play campaign. Each level ends on its own win condition and loads the next; weapons, health and inventory carry over. Per-level: rename, Edit (loads it back into the editor with a "Save changes" button), ▲/▼ reorder, ✕ remove; Export/Import campaign moves the whole sequence as one file.

SystemsTrack builder & racing

Laying track

On the Build tab, the Track builder places snap-together road pieces. Press T for top-down view (scroll to zoom), then click pieces — each snaps onto the exit of the selected piece (select any piece to branch from there), or the last one placed. Del removes the selected piece.

The road is 12 m wide. All lengths are multiples of 8, so closed circuits line up exactly — and when the two ends nearly meet, Close loop bridges the remaining gap — since build 896 it is a real solver (combinations of curves plus stretched straights), so heading mismatches and sideways misses close too, not just straight-ahead gaps.

🎲 Random track rolls a complete closed circuit in one click — banked corners and a ramp section onto an upper deck included — and you can restyle or hand-edit it from there. Keep clicking until you like the shape.

✏ Draw track is the fastest way to build a circuit: click it, sketch your track outline as one loop (it flips to top view while you draw), and release — the builder lays every piece to match your sketch, adds a start line and barrier walls, and the loop is closed by construction. It replaces the existing track (one undo step restores it), so you can redraw until the shape feels right, then restyle it under Track appearance.

Barrier walls

Per-piece (Barrier walls checkbox on the selected piece) or course-wide (Walls: whole track / Walls: remove all). Walls are a concrete base plus a clear catch-screen to car-body height; they follow banking and ramps.

The Race objective — setting by setting

On deploy you're auto-seated in your car, which is auto-gridded at pole position regardless of where it was parked in the editor. Throttle is locked through the 3-2-1 countdown and releases on GO. Every track piece is a checkpoint: cut the infield and the lap is voided with a toast (you need ~60% of pieces each lap). Losing rivals don't stop — if one finishes your remaining laps first, you get the RACE LOST screen with their name. Drive off the course (or off a ramp with no way back) and a red RETURN TO TRACK countdown appears — get back within 3 seconds or the car is placed back on the racing line at your last on-track spot, stopped and facing down the course.

• Race HUD — position (P n/N), lap counter, live lap time and session best, top-center.
• Checkpoints — every piece is a checkpoint; cutting the infield voids the lap with a toast.
• Ghost lap — your best lap replays as a translucent ghost; toggle with G while driving. It's stored per track shape, so editing the course retires the old ghost.
• Contact — cars collide: rear-end a rival to shunt them, side-swipe to knock them off line. They recover, and so can you.
• Results — per-lap times with the best starred; if a rival finishes first you'll see RACE LOST.
• Multiplayer racing — use Host race in the multiplayer menu: it checks the loaded level (objective Race, a start line, a car) before opening the room, and explains anything missing. One placed car is enough — on deploy the grid fills itself: every authored car lines up in a staggered two-abreast field, extra racers get an identical cloned car, and each player is auto-seated in their own (host takes pole). You see your rivals as their cars, live on track — not their characters — and anyone on foot again (exited, spectating) shows as their avatar as usual. Standings sync live and the first to finish wins on every screen. AI rivals sit multiplayer out — the humans are the field.

SystemsVehicle tuning — the deep dive

Any prop can be a car: select it → Object & selection → Vehicle (drivable) → tick Drivable vehicle (this also makes the prop non-dynamic — the car system owns its physics). A units toggle switches every speed field and the in-game speedometer between km/h and mph.

Performance

Handling

Fitting a model

Camera, lights, effects, wheels

SystemsSignals, locks & mechanisms

These three folds are RUMPUS ENGINE's wiring: Mechanism makes a prop move, Signals connect cause to effect, and Lock gates it all behind keys. Together they build doors, elevators, traps, switch puzzles and win conditions.

Mechanism (the “xa” system)

Enable Animated mechanism on a prop, then set what it does — Move X/Y/Z (m), Rotate X/Y/Z (°), Scale X/Y/Z, a Pivot offset, and Duration (s):

• Playback: ⟳ Loop · ⇄ Ping-pong · → Once.
• Trigger: Auto (runs on level start) · E Activate (player presses E) · Signals only (waits for a signal).
• Waypoint path — add waypoints and the prop travels through them (overrides the Move offset): patrol platforms, cable cars, roaming hazards.

Signals

Making a prop usable with E is one checkbox now: Interactable (E) sits beside the Tag at the top of Object & selection. Tick it and the prop prompts Activate and fires its On E signals — no mechanism required. And a signal's target can simply be this (the first entry in the target drop-down): the prop the signal lives on, no tag needed. So "press E on the door, the door opens" is: Interactable ✓ + one signal On E → Toggle → this.

On the Signals fold, give props a tag, then add rules — when something happens to this prop, do something to a tagged target (or to this, the prop itself):

The advanced gates

• Needs N different senders — the receiving prop only reacts once N different props have signalled it (the same sender firing twice counts once). Both pressure plates; all three generators.
• Needs item — a rule can require the player to be carrying an inventory item, with an optional consume: “On E, if carrying the fuse, do Open — and spend the fuse.” A locked prop without the item shows a LOCKED toast naming what's missing.
• On object placed extras — filter by a from tag (only the tagged object triggers it, blank = any physical prop), choose Touching it vs Inside it, and optionally consume the placed object (it vanishes when it lands — sacrificial offerings).

Locks & keys

The Lock fold requires a key (red / blue / gold / green) before E works on the prop, with optional Consume key on unlock. Keys are granted by key pickup pads (one-shot — they don't respawn), appear as HUD chips, and can carry a custom display name set on the pickup.

SystemsVisual logic — the Logic graph

The signal system wires one cause to one effect. The Logic graph (Gameplay tab ▸ Logic graph ▸ Open logic graph) is the layer above it: a full-screen node canvas where you build real game logic — counters, timers, branches, variables, randomness, loops and reusable functions — without writing code. Drag the board to pan, wheel to zoom, drag nodes by their headers, drag an output port onto an input port to wire them, click a wire to remove it. Tag, event-name, animation-clip and sound fields are drop-downs: they list every tag your props and lights already carry (with a count), every event name declared anywhere, every clip name your placed models ship, and every sound URL the level already uses — pick from the list or type a brand-new value.

Reusable functions are the On event / Send event pair: build a chain once behind a named event and call it from anywhere — the calling chain continues after the call. A classic graph: On start → Set score = 0; a pressure plate fires → Logic event "scored" → Change score +1 → Branch score ≥ 5 → Show message → Win level.

SystemsPickups & inventory

Pickup pads

Gameplay tab → Pickups. Toggle spawning, the base disc, and the bounce/rotate animation; then place pads with + Place ahead or edit each spot's kind, transform and (for items) which inventory item it grants. The kinds:

Inventory — the Use actions

Items defined under Inventory items land in the player's inventory (I): 3D objects open in a rotate/zoom inspector, journals open as text pages. Each item's Use action decides what the Use button does:

Consumed on use (default on) spends the item; off makes it reusable. Journal items get a text page; 3D items get a model + scale (1 ≈ 2 m across in the inspector). In campaigns, inventory carries between levels.

Loot & coins

Loot sets what enemies and loot boxes drop. Coins (spawned on kills) are the in-run currency for the shop and weapon attachments.

SystemsObjectives & rules

The eight objectives

Rules that shape the run

• Objective text — the goal banner (players re-read it with J; signals can rewrite it mid-run).
• Respawn at checkpoint (solo) — death returns you to the last checkpoint instead of ending the run.
• Wave mode — Random, or Pre-built from your spawn markers (optionally single-pass, no respawns); between-wave upgrade cards in solo.
• Fall damage — on/off for player and AI, with safe speed and damage scaling. Ragdoll on death. Crushing props — heavy movers deal damage, with min speed.
• Camera view — how players see your level: First person (the classic), Third-person, Top-down, or Side-scroller. Saved with the level, so it carries through share links, the community gallery and multiplayer.
  • Third-person — an over-the-shoulder chase camera that smoothly follows the player with damping (it eases after sprints, jumps and turns instead of being bolted rigid; aiming tightens it back to exact). Controls and aim stay first-person-style. Tune the framing and the Follow smoothing slider under Player tab → Third-person framing — smoothing is also a player preference, so it applies when anyone toggles third-person from the pause menu too.
  • Top-down — a fixed isometric-tilt camera follows the player; WASD moves on the map (screen-relative), and the mouse steers a cursor: your character faces it, shots hit whatever is under it, and grenades lob onto it (up to the grenade's throw-force range), twin-stick style. Cars keep their full handling — instant chase/racing levels. Camera distance sets the zoom (8–80).
  • Side-scroller — the camera locks to one side and players run along a single lane (pick east–west or north–south). A/D run, Space jumps, and the mouse aims anywhere within the plane (grenades arc to the cursor too). Players are held on the lane they deploy on, so build your level along it — ramps and stairs shine here.
  • Cutscenes, turret seats and the PvP killcam keep their own cameras; the editor always flies free. In both fixed views your character model is visible and enemies aim at it as normal.
• Hands / unarmed — start with fists only, optionally allow picking up weapons found in the level; the flashlight (brightness, cone, softness, range, colour).
• Hit numbers — floating damage numbers with font size and hit/kill colours.
• Multiplayer spawn area — confine MP spawns to a circle or drawn polygon.
• End-screen messages — custom victory and defeat text.

SystemsCutscenes — shot by shot

Gameplay tab → Cutscenes. A cutscene is a list of camera shots played back-to-back with hard cuts; each shot flies through its own waypoints. Cutscene #1 is the intro (toggle Play intro flythrough on deploy); every additional cutscene is named and fired by a signal's Play cutscene action. Any key or tap skips playback.

Waypoints: fly the editor camera to a spot, click + Add camera waypoint (current view), repeat — 2+ points move the camera; a single point is a held shot. Per point: Go to (jump the editor view there), Set (overwrite with the current view), 👁 (aim the editor at your subject, then click to store a look-target), ⊘ (clear it), ✕ (delete).

▶ Cutscene previews all shots, ▶ This shot just one, and the camera preview window shows live framing while you scrub. Show character at the player start puts your avatar in frame for intros.

SystemsMultiplayer

Peer-to-peer over WebRTC — no accounts, no servers to rent. One player hosts and shares the 5-character room code (or joiners pick from the Open games list); everyone else joins, and the host's level transfers automatically — including custom models and sounds. While a host waits in the pre-game lobby, the room is listed in everyone's Open games list automatically (a tiny lobby directory on rumpusengine.com) and drops off the moment the match starts or the host leaves.

Modes — the actual rules

Bot difficulty — what the presets actually change

PvP hosts pick bot count (0–7) and difficulty when hosting, or Fill with bots from the lobby. Bots fight like players now: they carry visible weapons, throw grenades (including flushing you out of cover), duck behind cover to reload, and wear random characters from the level's roster so no two look alike.

Match rules — when hosting, the host can restrict which weapons are allowed (melee always stays in) and set starting grenades (0–6) for everyone; the rules reach every joiner and bot automatically.

The lobby is a proper pre-game screen: a live 3D character select (models rotate, colours preview, CHARACTERS and COLORS read as separate groups), a MATCH INFO panel, rotating tips — and creators can attach a lobby backdrop image to a level (Save tab ▸ Title screen ▸ Multiplayer lobby backdrop) that every player sees, softly blurred, behind the lobby. Joiners watching the level transfer see a live LOADING WORLD % instead of a frozen screen. Matches end with a podium ceremony — standings, medals, and an MVP callout in team modes.

What syncs: player movement and state, enemies, kill credit, coins and pickups, prop animations and mechanisms, unlocks and keys, objective progress, race standings, chat, and the host's custom HUD/sounds.

SystemsSaving & sharing

• Browser save — one save slot plus autosave while editing.
• .breach export/import — the level (or a whole campaign) as a file. Everything serializes: props, track, vehicle tuning, rules, cutscenes, HUD, and the asset-credit list. The file is plain JSON inside, and old .json exports import forever.
• Share link — the entire level compressed into a URL. Anyone who opens it plays it instantly. Models re-download from Poly Pizza / Sketchfab on the recipient's machine (Sketchfab models need the recipient's own free token).
• Challenge links — from the end screen, share the level plus your score to beat.
• Campaigns — chain levels with carry-over loadout and inventory; share as one file.
• Credits — every searched model, texture, HDRI and sound is attributed automatically and travels with the level; the Credits screen shows the per-level list.

The community library

Community levels on the home menu is a gallery of player-built levels hosted alongside the game — browse, then Play one or Open in editor to see how it's built (and remix it; loading is undoable).

To publish your own: editor → Save tab → Submit to community library. That grabs a screenshot of your current view as the gallery thumbnail, asks for a level name and your author name, and sends the level straight in for review — no account of any kind needed. Once it's approved it appears in everyone's gallery, credited to you. (If the submission server can't be reached, the game falls back to the old GitHub submission form, which needs a free GitHub account.) Levels that use Sketchfab models get a needs Sketchfab token badge, since those download with each player's own free token.

ExtrasTips & troubleshooting

• Sketchfab search says it needs a token — it's a free API key: sketchfab.com → Settings → Password & API. Paste it once in any search box; every other box switches to “Token saved · change”.
• A shared level is missing models — Sketchfab downloads require each player's own token; Poly Pizza models need none. Prefer Poly Pizza for levels you plan to share widely.
• The game looks out of date — hard-refresh (Ctrl+Shift+R) and check the build number bottom-left of the home menu.
• Performance dips — post-FX sheds passes automatically under load, but the biggest wins are yours: fewer point lights, smaller textures, fewer high-poly Sketchfab models. Adaptive resolution (pause menu) trades sharpness for frame rate on sustained drops — turn it off if you'd rather keep full resolution and accept the dips.
• Edges look jagged / aliased — check Adaptive resolution in the pause menu: when the frame rate struggles it lowers the render resolution, which reads as shimmer on edges; untick it for full sharpness. (Since build 872, Visual effects keeps proper antialiasing — older builds lost it whenever effects were on.)
• My race rivals won't spawn — rivals need a closed track loop (use Close loop) and a placed drivable vehicle to clone. The Save tab's issues panel calls this out.
• A mechanism won't fire — check its Trigger: Signals only waits for a signal; E Activate may be gated by a Lock. The signal's target tag must match exactly.
• I can't find a setting — sections remember their collapsed state; expand the section headers. Selection folds (Vehicle, Signals…) only appear with a prop selected on the Build tab.