battlebox.sceneModule
The BattleBox arena, after `design/references/arena_battlebox.png`: a 16 x 16 m gunmetal diamond-plate floor (one world-space `arena.arenaFloor` surface that paints the orange/blue start squares, hazard-stripe edging, plate seams, skid and scorch marks itself) tiled around real r…
arena.battlebox
The BattleBox arena, after design/references/arena_battlebox.png: a 16 x 16 m gunmetal diamond-plate floor (one world-space arena.arenaFloor surface that paints the orange/blue start squares, hazard-stripe edging, plate seams, skid and scorch marks itself) tiled around real recesses for the screw pit, two kill-saw slots and four floor-saw slits; scratched polycarbonate walls (arena.arenaGlass) on black steel posts and rails over a hazard-striped kick rail, with BATTLEBOX boards; four corner hydraulic pulverizers; floor saws, kill-saw blades and twin augers built as procedural meshes; raked stands with a crowd behind the glass; an overhead truss of hard white floods, magenta/cyan rim lights, volumetric haze and dark height fog.
The main scene places it once at the origin through a SceneModule component; editing this module rebuilds that placement. Positions come from game.rules. It attaches arena.HazardRunner to the BattleBox root, which animates the hazards and applies their damage in play. Input: lights (bring the light rig and haze; default on). Owned by the arena slice.
Interface
What this asset declares: the schema it conforms to, what it exposes, and the rendered structured payload.
conforms to
zero/source-extract/v2arena.battlebox — the BattleBox: floor, walls, hazards, lights and stands. OWNED BY THE ARENA SLICE. The scene (scenes/main.scene/build.luau) places this module once, at the world origin, through a SceneModule component; editing this file rebuilds that placement in place. Every position comes from game.rules (ARENA, STARTS, HAZARDS) so the hazard visuals line up with the damage zones the rules test, and arena.HazardRunner (attached to the root) animates the hazards and applies their damage in play. Layout matches design/references/arena_battlebox.png: a square diamond-plate floor (one world-space surface, arena.arenaFloor, that paints the start squares, hazard edging, seams and wear itself) tiled around REAL recesses for the screw pit, the two kill-saw slots and the four floor-saw slits; scratched polycarbonate walls on black steel frames over a hazard-striped kick rail; corner pulverizers; floodlit stands of crowd behind the glass; hard white overhead floods, magenta/cyan rim light and haze. Static geometry is merged into one mesh per material ("Static_<material>"), and each moving hazard assembly into one mesh per material, so the whole arena is a few dozen entities instead of hundreds.
mat(name: string, color: { number }, roughness: number, metallic: number, extra: { [string]: any }?) → void
| arg | type | description |
|---|---|---|
| name | string | |
| color | { number } | |
| roughness | number | |
| metallic | number | |
| extra | { [string]: any }? |
holeRects( ) → void
q(ax: number, ay: number, az: number, a: number) → Q
| arg | type | description |
|---|---|---|
| ax | number | |
| ay | number | |
| az | number | |
| a | number |
qmul(a: Q, b: Q) → Q
| arg | type | description |
|---|---|---|
| a | Q | |
| b | Q |
qrot(qq: Q, v: V) → V
| arg | type | description |
|---|---|---|
| Q | ||
| v | V |
sub(f: Frame, p: V, r: Q?) → Frame
| arg | type | description |
|---|---|---|
| f | Frame | |
| p | V | |
| r | Q? |
newSet(prefix: string) → Set
| arg | type | description |
|---|---|---|
| prefix | string |
batchOf(set: Set, matKey: string, material: any) → Batch
| arg | type | description |
|---|---|---|
| set | Set | |
| matKey | string | |
| material | any |
vert(b: Batch, f: Frame, lp: V, ln: V, u: number, w: number) → number
| arg | type | description |
|---|---|---|
| b | Batch | |
| f | Frame | |
| lp | V | |
| ln | V | |
| u | number | |
| w | number |
addBox(set: Set, matKey: string, material: any, f: Frame, p: V, s: V, r: Q?) → void
| arg | type | description |
|---|---|---|
| set | Set | |
| matKey | string | |
| material | any | |
| f | Frame | |
| p | V | |
| s | V | |
| r | Q? |
corner(su: number, sv: number) → V
| arg | type | description |
|---|---|---|
| su | number | |
| sv | number |
addTop(set: Set, matKey: string, material: any, x0: number, z0: number, x1: number, z1: number) → void
One upward-facing floor quad (y = 0) over [x0,x1] x [z0,z1]: the floor is a surface of tops only, so neighbouring tiles share edges and never faces.
| arg | type | description |
|---|---|---|
| set | Set | |
| matKey | string | |
| material | any | |
| x0 | number | |
| z0 | number | |
| x1 | number | |
| z1 | number |
addCyl(set: Set, matKey: string, material: any, f: Frame, p: V, radius: number, length: number, r: Q?) → void
A cylinder along its local Y, `radius` and `length`.
| arg | type | description |
|---|---|---|
| set | Set | |
| matKey | string | |
| material | any | |
| f | Frame | |
| p | V | |
| radius | number | |
| length | number | |
| r | Q? |
emit(set: Set, parent: any, castsShadows: boolean?) → void
Turn a set's batches into mesh assets and spawn one Model per material under `parent` (all at the parent's origin).
| arg | type | description |
|---|---|---|
| set | Set | |
| parent | any | |
| castsShadows | boolean? |
sawMesh(name: string, tipR: number, rootR: number, teeth: number, thick: number) → void
A flat toothed saw blade in the XY plane (axis +Z), the generated blade picture mapped across its face.
| arg | type | description |
|---|---|---|
| name | string | |
| tipR | number | |
| rootR | number | |
| teeth | number | |
| thick | number |
v(x: ?, y: ?, z: ?, nx: ?, ny: ?, nz: ?, u: ?, w: ?) → void
| arg | type | description |
|---|---|---|
| x | ? | |
| y | ? | |
| z | ? | |
| nx | ? | |
| ny | ? | |
| nz | ? | |
| u | ? | |
| w | ? |
uvOf(a: number, r: number) → void
| arg | type | description |
|---|---|---|
| a | number | |
| r | number |
killRowMesh(name: string, count: number, span: number, tipR: number, rootR: number, teeth: number, thick: number) → void
A row of kill-saw blades on one arbor along local Z, each blade in the YZ plane, all spinning together about X.
| arg | type | description |
|---|---|---|
| name | string | |
| count | number | |
| span | number | |
| tipR | number | |
| rootR | number | |
| teeth | number | |
| thick | number |
vtx(x: ?, y: ?, z: ?, nx: ?, ny: ?, nz: ?, a: ?, r: ?) → void
| arg | type | description |
|---|---|---|
| x | ? | |
| y | ? | |
| z | ? | |
| nx | ? | |
| ny | ? | |
| nz | ? | |
| a | ? | |
| r | ? |
augerMesh(name: string, length: number, innerR: number, outerR: number, turns: number, thick: number) → void
An auger's helical flight along +X: a thick helicoid band between the shaft and `outerR`, `turns` full turns over `length` metres.
| arg | type | description |
|---|---|---|
| name | string | |
| length | number | |
| innerR | number | |
| outerR | number | |
| turns | number | |
| thick | number |
idx(face: number, s: number, r: number) → void
| arg | type | description |
|---|---|---|
| face | number | |
| s | number | |
| r | number |
group(name: string, parent: any, p: V?, rot: Q?) → void
| arg | type | description |
|---|---|---|
| name | string | |
| parent | any | |
| p | V? | |
| rot | Q? |
model(name: string, parent: any, mesh: any, material: any, p: V?, s: V?, rot: Q?) → void
| arg | type | description |
|---|---|---|
| name | string | |
| parent | any | |
| mesh | any | |
| material | any | |
| p | V? | |
| s | V? | |
| rot | Q? |
collider(name: string, parent: any, p: V, s: V, rot: Q?) → void
| arg | type | description |
|---|---|---|
| name | string | |
| parent | any | |
| p | V | |
| s | V | |
| rot | Q? |
floorTiles(half: number, holes: { any }) → void
Split the floor square into rectangles that leave every hole open.
| arg | type | description |
|---|---|---|
| half | number | |
| holes | { any } |
uniq(t: ?) → void
| arg | type | description |
|---|---|---|
| t | ? |
isHole(x: number, z: number) → boolean
| arg | type | description |
|---|---|---|
| x | number | |
| z | number |
recess(set: Set, f: Frame, hx: number, hz: number, depth: number) → void
A recess under a floor hole: four liner walls and a floor, inset a hair so no face is coplanar with the floor tiles' own edges.
| arg | type | description |
|---|---|---|
| set | Set | |
| f | Frame | |
| hx | number | |
| hz | number | |
| depth | number |
pulverizerBase(set: Set, f: Frame) → void
| arg | type | description |
|---|---|---|
| set | Set | |
| f | Frame |
hammerSet( ) → Set
sz3(l: number, h: number, th: number) → V
| arg | type | description |
|---|---|---|
| l | number | |
| h | number | |
| th | number |
vtx(x: number, y: number, u: number, v: number) → number
| arg | type | description |
|---|---|---|
| x | number | |
| y | number | |
| u | number | |
| v | number |
trussRun(cx: number, cy: number, cz: number, alongX: boolean, len: number) → void
| arg | type | description |
|---|---|---|
| cx | number | |
| cy | number | |
| cz | number | |
| alongX | boolean | |
| len | number |
Sub-parts
Everything contained inside this part. Assets are composite children (clickable cards). Files are leaf payloads. Expand any row to view its source.
Showing the 199 items nearest this part. It holds more than this page lists.
Problems
Everything affecting this asset right now: its own problems, anything wrong inside it, and problems on its direct dependencies.
agent_score is exposed.+ quality × 0.35
+ performance × 0.25
± compat factor
Usability ratings
Did the part work as advertised when consumers tried to drop it in. Separate from upvotes: those are taste; this is "did it function".
Scoped to this part · feeds back into the world's score.