# crowd_hype_loop
This sound clip is a seamless loop of a huge, excited crowd in a stone arena continuously cheering, chanting, stomping, and clapping rhythmically, like a roaring wrestling audience. It is designed to create an intense and energetic atmosphere for in-game events such as wrestling matches or other high-energy spectacles.
# monk
Builds one monk's body (who = bicep | flex) under his Wrestler root. Owned by the monks slice.
See `/zero/source/design/spec.md` for the interface and ownership.
# match
Builds the match's own entities (Director, screens). Placed once by the scene build. Owned by the match slice.
See `/zero/source/design/spec.md` for the interface and ownership.
# game.rules
The constants and rules of MMW: ring size, start spots, wrestler names, move frame data,
stamina, knockdown/pin/kickout numbers, match length, phases and palette.
`require("game.rules")`. Owned by the skeleton; slices read it, tune it only by agreement.
# PlayerControls
Activates the `game.wrestling` input map and turns the player's controls into calls on the Wrestler beside it. Owned by the wrestling slice.
Controls: move (camera-relative), punch J, kick K, grapple L, block Space (held), taunt T, finisher F, pin P. While Bicep is pinned, punch, kick, grapple, pin and finisher all mash for the kickout. Confirm (Enter) belongs to the MatchDirector.
# arena
Builds the ring, courtyard, crowd and lighting. Placed once by the scene build at the origin. Owned by the arena slice.
See `/zero/source/design/spec.md` for the interface and ownership.
# FriarAI
Drives Friar Flex's Wrestler through the same methods the player's controls reach. Owned by the wrestling slice.
- Approaches while circling, and taunts from range to build hype.
- Picks punch, kick or grapple on a 0.55–1.05 s cadence. Grapples more eagerly when Bicep is tired, stunned or taunting.
- Blocks a strike it sees winding up, with a 0.12 s reaction and 45% odds.
- Backs off to breathe when tired. Fires THE HOLY ROLLER at full hype in grab range.
- Walks over and pins a downed Bicep after a short beat.
- When pinned, mashes at `mashRate × (0.45 + 0.55 × health)`, so a healthy Flex kicks out and a beaten one does not.
- Tune it with the public fields: `minThink`, `maxThink`, `blockChance`, `reaction`, `mashRate`, `aggression`. `intent` shows the current decision.
# Wrestler
One monk in the ring: health, stamina, hype, state and every move. Sits on the Bicep/Flex roots; driven by PlayerControls or FriarAI through the same methods. Numbers come from `game.rules`. Owned by the wrestling slice.
- **Verbs:** `moveInput(x, z)`, `punch()`, `kick()`, `grapple()`, `finisher()`, `setBlock(on)`, `taunt()`, `pin()`, `mash()`, `breakPin()`, `celebrate()`, `defeat()`, `resetForMatch()`, `kickoutNeeded()`, `canAct()`.
- **Strikes** resolve once at the end of `startup` against `reach + 0.3 m` (centre to centre). A blocked strike does `BLOCK_DAMAGE_SCALE` damage and earns the attacker 35% hype. A landed one stuns the victim (`hit`) for the move's `stun`.
- **Grapple** connects on a standing target in reach, giving attacker `slamming` and victim `thrown`. The victim's root rises onto the attacker's shoulders (+1.95 m), holds, and is slammed down 1.15 m in front, landing at 78% of `slam`. Impact emits `slam` and `knockdown`; the victim is then `down` for `KNOCKDOWN_TIME`, `getup` for 0.7 s, then `idle`.
- **THE HOLY ROLLER** (full hype, grab range) does the same with a two-turn spin and a head-first drop, followed by `FINISHER_DOWN_TIME` down. It empties hype.
- **Stamina** drains with each attack and while blocking, then regenerates after `STAMINA_REGEN_DELAY`. At 0 the wrestler is `tired` until he recovers to 25: slow, unable to attack or block, and grapples on him deal the tired bonus.
- **Pin:** `pin()` beside a downed opponent sets `pinning`/`pinned` and emits `pinStart`. `mash()` adds `KICKOUT_PER_MASH`, and the bar decays 0.12/s. While the MatchDirector counts (phase `pin`), it sees `kickout >= kickoutNeeded()`, emits `kickout` and calls `breakPin()`. With nobody counting, the wrestler kicks out himself.
- **Root transform:** owned here, including the throw arc. The pose under `Body` belongs to the monks slice.
# audio
Builds every sound source of MMW: `AudioRig` carrying the `AudioDirector`, and one
non-autoplaying `Snd_<key>_<n>` Audio child per voice in `game.audio.sounds` (music, ambient,
sfx and voice channels). The ears are the AudioListener on `BroadcastCam`. Placed once by the
scene build; owned by the audio slice. Clips live beside it in `music/`, `crowd/`, `sfx/`, `voice/`.
See `/zero/source/design/spec.md` for the interface and ownership.
# BroadcastCamera
WWE-style elevated three-quarter shot that frames both wrestlers. Sits beside a Camera on BroadcastCam. Owned by the match slice (adds close-up cuts).
See `/zero/source/design/spec.md` for the interface and ownership.
# slam
This sound clip features a huge body slamming onto a wooden wrestling ring, with the boom of heavy oak planks and canvas, a deep thud, wood creak, and dust. It is suitable for use in a game to signify a powerful body slam or a character being thrown onto the ring.
# pop
This sound clip features an explosive, massive crowd roar, with thousands erupting into screams and cheers at a huge wrestling moment, creating a stadium 'pop'. It is ideal for climactic moments in a game, such as a major victory or a dramatic turn of events in an arena setting.
# crowd_bed
This sound clip provides a seamless loop of a large medieval crowd murmuring and chattering in an open stone courtyard at dusk. It creates a steady ambient background of peasants waiting for a fight, with occasional distant whistles. This sound is suitable for establishing atmosphere in game environments like marketplaces, arenas, or public gatherings.
# whiff
This sound clip features a fast swing whoosh through the air missing, like a fist swishing past, characteristic of a fighting game whiff. It is suitable for use in a game when a character's attack misses its target.
# mat_slap
This sound clip features a referee's hand slapping a canvas wrestling mat on wooden planks, producing a sharp single slap. It is suitable for use in a game to signify a count, a pin attempt, or other referee actions in a wrestling match.
# MonkPose
Poses one monk body built by `game/monks/monk.sceneModule` from its Wrestler's `state` and
`stateTime`. The sceneModule attaches it to `MonkBody` (under `Bicep/Body` or `Flex/Body`) with
`who = bicep | flex`; it finds that side's Wrestler through `game.bus` (`bicep` → player, `flex` →
cpu) and needs no sibling components.
It writes only the local transforms of the named joints under `MonkBody` — `Pelvis`, `Spine`,
`Head`, `ShoulderL/R`, `ElbowL/R`, `HandL/R`, `HipL/R`, `KneeL/R`, `FootL/R` — never the Wrestler
root. Every state in `design/spec.md` has a pose: idle stance (and a hunched tired idle), walk
cycle driven by ground travel, alternating jabs, front kick, high guard block, hit recoil, grapple
reach, body-slam lift/hold/slam, Holy Roller hoist and sit-out drop, thrown (on his back, or
upside-down for the finisher), down/defeated flat on the mat, pinned struggle scaled by kickout,
kneeling pin cover, getup, double-biceps / most-muscular taunt, and celebration.
# match_theme
This sound clip is a seamless loop of driving medieval battle music, perfect for a wrestling match. It features pounding war drums and taiko-like toms, a hurdy-gurdy and droning bagpipe riff, and fast lute strumming, creating an energetic and rowdy instrumental track at 132 bpm. This music is suitable for in-game combat sequences or arena events.
# title_theme
This sound clip is a seamless loop of a medieval festive title theme. It features a plucked lute melody over a booming frame drum and tambourine, with recorder flourishes, creating a proud, triumphant tavern-fanfare mood at 100 bpm. This instrumental music is ideal for game title screens, menus, or celebratory in-game moments.
# ann_finisher
This sound clip features an announcer exclaiming "THE HOLY ROLLER! Heaven help him!". It is suitable for use in a game to announce a character's powerful finishing move.
# hype_full
This sound clip features a short heavenly choir chord stinger with a shimmering bell chime, conveying a sense of full power and triumph. It is suitable for use in a game to indicate a character reaching maximum power or achieving a significant milestone.
# ann_name_bicep
This sound clip features an announcer introducing a character: "In this corner... BROTHER BICEP!". It is suitable for use in a game to introduce a specific character before a match.
# boo
This sound clip features a large crowd booing and jeering a villain in a stone courtyard. It is suitable for moments in a game where a character is being met with disapproval or hostility from an audience.
# ArenaLife
Makes the MMW courtyard react to the match. Attached to the `Arena` root by `arena.sceneModule`.
Reads both wrestlers' hype from `game.bus` into the crowd's excitement, spikes a decaying "pop"
on slams, the finisher, hits, taunts, knockdowns, pins, kickouts, the bell and the match end, and
pushes them into the shared `CrowdFolk` material (`excite`, `pop`) and the `Flame` material
(`heat`). Flickers every `FireLight*` point light under the arena, flaring with the pop.
Exposes `excitement` and `popLevel` (0..1). Needs no sibling components.
# ref_one
This sound clip announces the word "ONE!" It is intended for use as a referee's count in a game, likely during a wrestling match or similar competitive event.
# ann_intro_flex
This sound clip features an announcer introducing a character: "And his rival... the smug and sinful... FRIAR FLEX!". It is suitable for use in a game to introduce a specific character before a match.
# ann_win_bicep
This sound clip announces "Your winner... BROTHER BICEP! Glory be!" It is intended for use as an announcer's voice-over in a game, likely to declare the winner of a match or event.
# ui_confirm
This sound clip is a short medieval UI confirm sound, featuring a struck small brass bell with a wooden knock. It is suitable for use in a game's user interface to provide audio feedback for confirming selections or actions.
# punch
This sound clip features a meaty fist punch impact on a muscular body, characteristic of a cartoon fighting game hit. It is suitable for use in a game when a character lands a punch on an opponent.
# grapple
This sound clip features two large wrestlers grabbing each other, with wool robes rustling, grunting effort, and a slap of hands. It is suitable for use in a game to signify the initiation of a grapple or close-quarters combat.
# ann_intro_bicep
This sound clip features an announcer introducing a character: "In this corner... the people's champion... BROTHER BICEP!". It is suitable for use in a game to introduce a specific character before a match.
# gasp
This sound clip features a large crowd collectively gasping in surprise, followed by an excited murmur. It is suitable for moments in a game where an unexpected event occurs, eliciting a shocked reaction from an audience.
# ann_ring_bell
This sound clip announces "Ring the bell! Let the holy war begin!" It is intended for use as an announcer's voice-over in a game, likely to signal the start of a significant event or match.
# victory_sting
This sound clip is a short, triumphant medieval victory fanfare. It features brass sackbut and natural trumpet fanfare with a timpani roll and lute, culminating in a glorious ending. This sound is ideal for marking successful completion of a level, winning a match, or celebrating an achievement in a game.
# ref_two
This sound clip announces the word "TWO!" It is intended for use as a referee's count in a game, likely during a wrestling match or similar competitive event.
# finisher_impact
This sound clip features an enormous cinematic impact: a body piledriven into a wooden ring, accompanied by a thunderous boom with wood cracking, deep sub-bass, and a church bell-like ring-out. It is designed for use in a game to signify a powerful finishing move or a major impact event.
# ann_pin
This sound clip announces "He's going for the pin!" It is intended for use as an announcer's voice-over in a game, likely during a wrestling match or similar competitive event.
# ann_hype
This sound clip features an announcer exclaiming "The crowd is on fire! He's ready for the finisher!". It is suitable for use in a game to build excitement and indicate that a character is about to perform a finishing move.
# ann_decision
This sound clip features an announcer saying "Time has run out! The judges have decided!". It is suitable for use in a game to signal the end of a timed match and the transition to a decision phase.
# bell_end
This sound clip features a bronze bell rung rapidly three times, 'ding ding ding', with a long ring-out, mimicking the end of a boxing match. It is suitable for signaling the conclusion of a round or event in a game.
# ooh
This sound clip captures a large crowd reacting with a sympathetic, wincing 'ooooh!' after a painful hit in a stone courtyard. It is suitable for moments in a game where a character experiences a significant impact or injury, eliciting an empathetic response from an audience.
# finisher_whoosh
This sound clip features a rising, spinning whoosh with a holy choir 'aaah' swelling, creating a magical power-up flash before a huge move. It is suitable for use in a game to indicate a character activating a special ability or preparing for a powerful attack.
# MatchScreens
Draws every screen of the match from `Bus.match()` and the two Wrestlers: title (PRESS START),
entrance name cards, the fight HUD (parchment name plates with portraits, red health + blue
stamina bars, clock, golden HYPE meter), announcer callouts (`announce` events), the pin count
with the kickout bar, the Holy Roller flash and the result screen with rematch. Adapts to
portrait phone screens. Attach beside `MatchDirector` on the Director entity (a tap on PRESS
START calls its `confirm()`); placed by `game/match/match.sceneModule`.
# ann_name_flex
This sound clip announces "And his rival... FRIAR FLEX!" It is intended for use as an announcer's voice-over in a game, likely introducing a character or event.
# getup
This sound clip features a big man grunting and getting up from a wooden floor, accompanied by wool cloth rustling and wood creaking. It is suitable for use in a game when a character recovers from being knocked down or gets back on their feet.
# ann_welcome
This sound clip announces "Welcome, good people, to Medieval Monk Wrestling!" It is intended for use as an announcer's voice-over in a game, likely as an introductory welcome to the game or an event within it.
# MatchDirector
Runs the match flow and is the only writer of `Bus.match()`: title (waits for `confirm`) →
entrance (name cards, close-ups) → bell → fight with the 3:00 clock ⇄ pin (referee 1-2-3,
kickout when the pinned wrestler's bar reaches `KICKOUT_BASE + (1 − health/MAX) × KICKOUT_SCALE`)
→ result (pin or decision) → rematch on confirm. Emits `phase`, `bell`, `pinCount`, `kickout`,
`matchEnd` and `announce` callouts; sets `camera`/`closeupSide` for the finisher, pin and result.
See `/zero/source/design/spec.md`.
# ann_win_flex
This sound clip announces "Your winner... FRIAR FLEX! Shame upon us all!" It is intended for use as an announcer's voice-over in a game, likely to declare the winner of a match or event.
# block
This sound clip represents a blocked strike, specifically a fist hitting forearms with leather wrist wraps, resulting in a dull, muffled thud with a leather creak. It is suitable for use in a game when a player successfully defends against an attack.
# kick
This sound clip features a heavy bare-foot kick impact to the chest, with a thump and slap, characteristic of a fighting game heavy hit. It is suitable for use in a game when a character lands a powerful kick on an opponent.
# ann_bell_short
This sound clip features an announcer saying "Ring the bell!". It is suitable for use in a game to signal the start of a match or round.
# ref_three
This sound clip announces the word "THREE!" It is intended for use as a referee's count in a game, likely during a wrestling match or similar competitive event.
# ann_taunt
This sound clip announces "Look at those muscles!" It is intended for use as an announcer's voice-over in a game, likely as a taunt or commentary on a character's physique.
# ann_kickout
This sound clip features an announcer exclaiming "He kicked out! Unbelievable!". It is suitable for use in a game to indicate a dramatic moment where a character narrowly escapes defeat.
# ann_slam
This sound clip announces "By the saints! A BODY SLAM!" It is intended for use as an announcer's voice-over in a game, likely to highlight a specific action or move in a wrestling match.
# cheer
This sound clip captures the sound of a big crowd cheering, swelling and fading, with hundreds of people shouting 'hooray' in a stone courtyard. It is ideal for moments in a game where a character achieves success or is met with widespread approval.
# bell
This sound clip features a single bronze monastery bell struck hard, ringing out with a long, resonant decay. It is intended to serve as a match bell in a game, signaling the start or end of a round or event.
# AudioDirector
Plays MMW. Lives on `Audio/AudioRig`, which `audio.sceneModule` builds together with one
`Snd_<key>_<n>` child per voice of `game.audio.sounds` (non-autoplaying `Audio` sources).
- Music: lute-and-drum title theme in `title`, driving match track from the entrance on, ducked
under the announcer and during pins; a victory sting on `matchEnd`.
- Crowd: murmur bed + cheering loop whose level follows the wrestlers' hype and a transient
excitement kicked up by big moments; cheers, oohs, boos, gasps and pops on events.
- Fight SFX on `hit`/`whiff`/`slam`/`wrestlerState`/`getup`/`finisher`, bronze bell on `bell`
(start vs end by phase), referee ONE/TWO/THREE on `pinCount`.
- Announcer: a one-at-a-time queue fed by Bus events and by the match slice's `announce` text.
Reads only `game.bus` (events, `Bus.match().phase`, wrestler hype) and `game.rules`.
Check it from `audio.voices()`: every cue is a `Snd_<key>_<n>` entity, so a playing voice names its sound.