02 — Physics-to-Mechanics Mapping
Purpose
This document defines how real-world physics concepts map to Tao Baryon gameplay systems. This mapping is what makes the game thematically coherent and distinguishes it from generic arcade shooters. Every weapon, special ability, environmental hazard, and visual effect should be traceable to a real physics concept either rigorously or by clearly-marked extrapolation.
Design Principle
Players who know physics should recognize the references. Players who don't should still feel the consistency.
The game does not require physics knowledge to enjoy. But for the substantial audience that does care about hard science fiction — Kurzgesagt viewers, PBS Space Time subscribers, hard-SF readers — every concept they look up should check out.
The Core Mapping Table
| Real Physics Concept |
In-Game Mechanic |
Category |
| Baryonic matter |
Player ship; all human/Veiled tech |
Player identity |
| False vacuum decay |
The Apparatus; end-game threat |
Narrative / boss |
| Penrose process |
C-Series energy weapons; ergosphere ammo |
Weapon |
| Hawking radiation |
Evaporating projectiles; micro-singularity weapons |
Weapon |
| Gravitational lensing |
Visual distortion near heavy enemies |
Visual flavor |
| Time dilation |
Slow-mo special; tempo-altered sectors |
Special / environment |
| Krasnikov drive |
Sector transition animation |
Visual flavor |
| Cosmic strings |
Sector 5 environmental hazard |
Hazard |
| Ergosphere |
Final boss arena (Halen) |
Boss arena |
| Roche limit |
Asteroid-field hazard |
Hazard |
| Quantum tunneling |
Phase-shift special; V-Series passive |
Special / passive |
| Cherenkov radiation |
Speed-boost special visual |
Visual flavor + special |
| Magnetic confinement |
Shield mechanic visualization |
Visual flavor |
| Spaghettification |
Death animation near gravity wells |
Visual flavor |
| Boltzmann brain |
Hidden rare enemy type |
Enemy type |
| Varying fundamental constants |
Anomaly Field weapon |
Weapon |
The Player Ship as Doctrine
The player's ship visually embodies the Tao of the Baryon:
- Solid. Matter is sacred. The ship has visual weight, presence, mass.
- Lime-green (
#c8f542) — in-lore, the color of stable baryonic matter under our current vacuum. Out-of-lore, the CDL Production signature.
- Weapons are coherent, focused, geometric — order over chaos.
- Movement is responsive but never twitchy — grounded.
This is the visual argument for the doctrine: the player's ship is the position.
Telos Ships as Counter-Doctrine
Telos enemies visually embody the Quantum Rise:
- Liturgical. They fight in formations, never alone.
- Warm religious colors — orange, gold, magenta. Sacrament colors.
- Weapons are wide, ornate, beautiful — like cathedral architecture made of light.
- Movement is choreographed — every formation is a performance.
- High-tier hulls bear procedurally-generated prayer scripts in the Telos liturgical writing system.
This visual contrast is the language of the war: matter vs. doctrine, substance vs. ritual.
Weapon Catalog (Full Identity)
Eight primary weapon categories. Full upgrade tier stats are defined in Tier 2 (05_weapons.md); here we lock identity, physics, doctrine, and visual.
W1 — Pulse Cannon
- Tier: H-Series default (starter weapon)
- Mechanic: Straight-line plasma projectiles, moderate fire rate, moderate damage
- Physics: Magnetically confined plasma. Real-world cognate: magnetoplasmadynamic thrusters; pulsed-fusion plasma cannon research.
- Doctrinal voice: "We made the simplest thing that works."
- Visual: Lime-green pulses, short and bright, crisp impacts
- Doctrinal flavor: The Coalition workhorse. Every cadet trains on it. It is not elegant. It is reliable. It is what humanity built before the Veiled arrived.
W2 — Inertial Lance
- Tier: H-Series mid
- Mechanic: High-velocity kinetic projectiles. Slower fire rate, higher per-shot damage, real travel time, slight gravity drop in low-grav sectors.
- Physics: Pure kinetic. Coilgun-accelerated tungsten slugs. Real-world cognate: railguns and coilguns in current military R&D.
- Doctrinal voice: "Matter, moved."
- Visual: White-hot streaks; audible kinetic thump on impact
- Doctrinal flavor: Many Coalition engineers prefer this because it does not lie. No exotic physics to misunderstand. Only mass and velocity.
W3 — Coherence Beam
- Tier: V-Series mid
- Mechanic: Continuous laser beam fired while held. Damage scales up with sustained fire; overheats if held too long, forcing cooldown.
- Physics: Quantum-coherent photon emission — free-electron laser tuned to coherent state across multiple wavelengths. Real-world cognate: FEL weapon research; proposed coherent X-ray weapons. Veiled refinement: maintaining coherence across the beam path through plasma.
- Doctrinal voice: "We finally let them teach us."
- Visual: Thin sustained beam, white core with magenta fringe (Veiled cosmetic heritage)
- Doctrinal flavor: The first Veiled weapon humanity could safely manufacture. The schematics were considered shockingly simple by Telos standards. "You did not know this? You were children with sticks."
W4 — Hawking Bolt
- Tier: V-Series specialist
- Mechanic: Projectiles evaporate as they travel. Start large, shrink over distance. Damage inversely scales with size — bigger early shot = low damage; smaller late shot = high damage and explosion radius.
- Physics: Each projectile contains a contained micro-singularity radiating Hawking radiation (Stephen Hawking, 1974, Nature 248). Smaller black holes evaporate faster and end in a violent burst — the hottest, smallest black holes deliver the most energy at their endpoint.
- Doctrinal voice: "Their physics can be ours."
- Visual: Dark sphere with bright aura, visibly shrinking; ends in white-flash burst
- Doctrinal flavor: Mathematically beautiful, operationally terrifying. Demands timing the player learns to feel. Veiled engineers were uncomfortable with humanity adopting it.
W5 — Penrose Lance
- Tier: C-Series high
- Mechanic: Energy beam whose damage scales with distance traveled. Short-range it is weak. Long-range it is devastating. Forces deliberate positioning.
- Physics: Penrose process extracts rotational energy from a spinning black hole's ergosphere (Roger Penrose, 1969, Riv. Nuovo Cim.). Real proposed applications: civilizational energy harvesting from rotating black holes. The Coalition weapon contains a miniature rotating singularity that the beam draws from progressively — longer beam = more energy extracted.
- Doctrinal voice: "Their weapon, turned."
- Visual: Continuous beam visibly growing in intensity and width with sustain. Bright gold-magenta at peak.
- Doctrinal flavor: Architect-Veth designed this. The same physics the Apparatus uses, miniaturized. Veth: "Appropriate justice — the technique that would end us turned into the technique that defends us."
W6 — Anomaly Field
- Tier: C-Series area denial
- Mechanic: Deployed stationary projectile creating a region of altered physics. Enemies inside take continuous damage; their projectiles destabilize. Field lasts ~3 seconds then collapses cleanly back to normal physics.
- Physics: A contained region of locally modified physical constants — fine-structure constant, strong nuclear force strength, electromagnetic permittivity all briefly shifted within a bound volume. Inside the field, matter cannot maintain its configuration: atoms cannot hold electrons in their familiar orbits, molecular bonds destabilize, ships passing through experience cascading material failure. Critically: this is not vacuum decay. The Anomaly Field does not change the underlying vacuum state. It manipulates local laws through Coalition field generators that impose alternative constants within a containment boundary. When the field collapses, normal physics resumes immediately. Nothing propagates. Nothing changes permanently.
- Physics cognate: Varying-fundamental-constants research (Dirac large numbers hypothesis; Webb et al. measurements of possible alpha variation in quasar light). Real physicists study whether constants might differ across regions of spacetime.
- Doctrinal voice: "We will bend. We will not tear."
- Visual: Spherical field of shimmering distortion. Colors inside shift toward blue. Geometry of enemy ships appears subtly wrong — stretching, compressing, pixel-decohering. On collapse: clean snap back to normal.
- Audio: Low dissonant hum while active; sharp clean snap on collapse.
- Doctrinal flavor: The Tao of the Baryon's hardest philosophical question. Initial proposals included weapons deploying actual micro-vacuum-decay regions — humanity rejected these unanimously: "We will not use their crime against them." Architect-Veth proposed the Anomaly Field as the alternative — disrupts matter without replacing the vacuum. Alters physics; does not replace the universe. Sira-Vel, upon approval: "There is a difference between bending a law and tearing up the book. We will bend. We will not tear." The phrase became a Coalition slogan.
W7 — Cosmic String Spear
- Tier: C-Series precision unique
- Mechanic: Extremely thin, extremely long single-line projectile. Pierces every enemy in its path. Very low fire rate. Very high damage. Almost no area effect. Precision aiming required.
- Physics: Simulated cosmic string — hypothetical one-dimensional topological defects from the early universe with immense linear energy density (Tom Kibble, 1976). Real cosmic strings would have gravity strong enough to bend light visibly along their length. Ongoing astrophysical searches for primordial cosmic string signatures continue. The Coalition weapon manifests a brief field approximating this geometry.
- Doctrinal voice: "The thread that does not bend."
- Visual: Thin perfectly-straight white line crossing the playfield instantly; slight gravitational shimmer along its length
- Doctrinal flavor: One of the rarest weapons. The Choir of Names gave it a Veiled liturgical name translating as "the thread that does not bend." Unlocking it is a late-game milestone.
W8 — Boltzmann Cascade
- Tier: V-Series chaotic
- Mechanic: Fires unpredictable projectile patterns — sometimes a narrow stream, sometimes a spread, sometimes a single massive shot. Average damage high; distribution chaotic.
- Physics: Boltzmann brains — statistical-mechanics thought experiment where random thermal fluctuations in a high-entropy universe could spontaneously produce ordered structures with vanishing probability (Boltzmann's late cosmology; modern revival in eternal inflation and de Sitter space cosmology). Weapon projectiles generated by a quantum-random source tuned to occasionally produce coherent patterns.
- Doctrinal voice: "The universe is stranger than reliability."
- Visual: Wildly varying — thin red darts, wide magenta sweeps, single massive purple slugs. Unpredictability is deliberate.
- Doctrinal flavor: When Coalition leadership asked the designing Veiled engineer for "more reliable fire patterns," he is reported to have laughed: "Reliability is the desire of children who do not yet understand the universe."
Special Abilities Catalog
Eight special abilities. Deployed via the dedicated special button. Limited charges or cooldown. Identity locked here; full balance numbers in Tier 2.
S1 — Singularity Pull
- Mechanic: Deploy gravity well at target point. Pulls enemies and enemy projectiles toward well center for 2 seconds.
- Physics: Gravitational attraction (general relativity, or Newtonian for player intuition)
- Use case: Crowd-clear, bullet management
- Visual: Visible accretion-disc-style distortion around the well
S2 — Phase Shift
- Mechanic: Brief invulnerability (1.5 seconds). Pass through bullets without damage.
- Physics: Quantum tunneling — passing through a barrier with non-zero probability
- Use case: Emergency dodge through dense bullet patterns
- Visual: Ship becomes translucent, edges fade, sparkle of probability-amplitude
S3 — Time Dilation Field
- Mechanic: Deploy stationary slow-time bubble at target point. 4 second duration. Enemies and projectiles inside move at 30% speed. Player unaffected.
- Physics: Time dilation near gravity wells (general relativity)
- Use case: Slow boss attacks, manage incoming barrages
- Visual: Hazy spherical region; particles inside visibly drift slowly
S4 — Cherenkov Burst
- Mechanic: 2-second speed boost. Ship damages anything it touches during boost.
- Physics: Cherenkov radiation — charged particles exceeding local speed of light in a medium emit characteristic blue light. (Hand-wave: ship briefly exceeds plasma medium's local lightspeed.)
- Use case: Aggressive repositioning + ramming damage
- Visual: Blue Cherenkov glow trail; speed lines
S5 — Vacuum Pulse
- Mechanic: Radial AoE around player ship. Briefly destabilizes all enemy projectiles in range, clearing them. 30-second cooldown.
- Physics: Localized vacuum field disruption (Coalition-developed; conceptually adjacent to the Anomaly Field)
- Use case: Panic button — clear a wave of incoming fire
- Visual: Expanding ring of light; projectiles in radius dissolve into sparks
S6 — Penrose Charge
- Mechanic: Sacrifice all current ammunition of equipped primary weapon to fire one massive concentrated shot. Damage scales with ammo sacrificed.
- Physics: Penrose energy extraction — concentrating extracted rotational energy into a single discharge
- Use case: Burst damage on heavy enemies / boss phases
- Visual: Ship gathers energy visibly (1-second wind-up), then a single massive bright beam
S7 — Coherence Field
- Mechanic: 3-second shield around player; absorbs incoming damage entirely
- Physics: Magnetic confinement + quantum coherence — same physics defending stable matter
- Use case: Tank a known-dangerous attack
- Visual: Shimmering geometric shield, hexagonal field lines, lime-tinted
S8 — Vacuum Bloom
- Mechanic: Unlocked only after Sector 5. Deploy controlled altered-physics field that consumes enemies in small radius for 1 second. Player must move out of the radius or be consumed. Highest risk/reward in the game.
- Physics: Tightest, most aggressive use of the Anomaly Field principle — the smallest possible altered-physics zone with strongest effect
- Use case: End-game burst clearing; risky but devastating
- Visual: Intense distortion sphere; enemies inside visibly decohere; player must visibly escape the boundary
Environmental Hazards
Sector-specific dangers that exist independently of enemies.
H1 — Asteroid Debris Fields
- Sectors: 2, 4
- Mechanic: Inert asteroids that block movement and projectiles. Some break apart unpredictably when shot.
- Physics: Conventional astronomical debris
H2 — Roche-Limit Debris
- Sectors: 4, 5
- Mechanic: Asteroid fields too close to a gravity source. Rocks visibly tear apart in real-time, becoming smaller dangerous fragments.
- Physics: Roche limit — distance within which tidal forces exceed an object's gravitational self-binding
H3 — Gravitational Lensing Regions
- Sectors: 4, 5
- Mechanic: Visual distortion only (no gameplay effect) — but warns the player that something massive is nearby
- Physics: General relativity light bending
H4 — Time-Dilated Zones
- Sectors: 4, 5
- Mechanic: Regions of altered tempo. Inside, enemy AND player movement slows. Bullets slow. Risk: getting trapped; reward: clean shots at slowed enemies.
- Physics: Gravitational time dilation
H5 — Cosmic Strings
- Sectors: 5 only
- Mechanic: Thin scars across the playfield. Instant-kill if touched. Visually telegraphed clearly. Move slowly across the screen.
- Physics: Hypothetical 1D topological defects with immense linear energy density
H6 — Exotic Matter Clouds
- Sectors: 4, 5
- Mechanic: Visible cloud regions. Player projectiles passing through curve unpredictably. Enemy projectiles do not curve (Telos technology compensates).
- Physics: Hypothetical exotic matter with negative mass / unusual properties
Visual-Only Physics Effects
These have no gameplay impact but maintain consistency:
- Krasnikov drive transitions — sector loading animation; ship distorts space behind it
- Cherenkov glow — on boosted player ships (during Cherenkov Burst)
- Spaghettification death — ship visibly stretches if killed by gravitational hazards
- Magnetic confinement — shield visualized as geometric field lines, not bubble
- Prayer scripts — procedurally generated symbol patterns on high-tier Telos ship hulls
Doctrinal Identity Summary
| Weapon |
Origin |
Doctrinal Voice |
| Pulse Cannon |
Human |
"We made the simplest thing that works." |
| Inertial Lance |
Human |
"Matter, moved." |
| Coherence Beam |
Veiled |
"We finally let them teach us." |
| Hawking Bolt |
Veiled |
"Their physics can be ours." |
| Penrose Lance |
Coalition |
"Their weapon, turned." |
| Anomaly Field |
Coalition |
"We will bend. We will not tear." |
| Cosmic String Spear |
Coalition |
"The thread that does not bend." |
| Boltzmann Cascade |
Veiled |
"The universe is stranger than reliability." |
Every weapon argues for the Tao of the Baryon while using physics the Telos invented. The deeper the player goes, the more the toolkit reflects the alliance.
Document version: 1.0 (locked)
Part of: Tao Baryon GDD — Tier 1 Foundation