​

Blueprint 09 — ARCLUX CLIENT POLISH (Gameplay Immersion)

Status: PLAN — belum diimplementasikan. File ini adalah satu-satunya referensi untuk semua fitur polish client game ARCLUX. Update setelah tiap fase selesai (beri tanda ✅ pada item yang selesai). JANGAN dihapus. Branch target: feat/mmo-blueprint-full (base origin/ARCLUX.main) Env: Termux (gak ada /tmp, pakai ~). Package manager: pnpm. Build: node scripts/build-game.mjs. Tipe check: npx tsc --noEmit -p apps/game/tsconfig.json ThreatCrush: grep -rn "innerHTML.*+" apps/game/src/renderer/ (harus 0 match) ⚠️ JANGAN PERNAH commit: packages/environment/ArcluxEnvironment.ts dan file stray ARCLUX.

​

TUJUAN UTAMA

• Kapal ARCLUX (Ark-Librarieschip) adalah kapal ENGINEER yang dipiloti langsung — BUKAN background object.
• “Stadion luar angkasa” = ring sections yang mengelilingi hull, tampak seperti arena/stadion raksasa saat dilihat dari luar.
• Pemilik adalah pembuat game sekaligus pemain — kapal harus ada, detail, beranimasi, dan bisa dirasakan.
• Musik: user sendiri yang upload file (gak mau tersangkut pihak ketiga / lisensi). Support MP3/OGG/WAV/FLAC.
• Efek suara (api, ledakan, pesawat) harus ada — disintesis via WebAudio, gak perlu file eksternal.

​

FILE YANG DIUBAH

​

FASE 1 — ENVIRONMENT MAP REFLECTION (PMREMGenerator)

​

Status: ✅ Selesai (commit implementasi Fase 1 — scene3d.ts pmrem)

​

Tujuan

​

Approach

• Option B (FULL): THREE.PMREMGenerator generate cubemap dari scene, di-set ke scene.environment biar semua MeshStandardMaterial otomatis reflect tiap frame.
• Regenerate tiap 10 frame (PMREM mahal, jangan tiap frame).

​

Detail implementasi

// Di init, setelah renderer dibuat:
const pmrem = new THREE.PMREMGenerator(renderer);
pmrem.compileEquirectangular();          // compile shader dulu
let envMap: THREE.Texture | null = null;

// Di dalam frame loop:
if (frameCount % 10 === 0) {
  envMap = pmrem.fromScene(scene, 0, 0.1, 100).texture;
  scene.environment = envMap;            // auto-apply ke semua material
}

​

Acceptance

• Ship hull memantulkan warna sun/planet saat berputar (scene.environment PMREM)
• Metalness 0.7 + envMap tetap performa (regenerate tiap 10 frame, dispose target lama)
• Gak ngerusak bloom composer (EffectComposer tetap)

​

FASE 2 — MODEL KAPAL PEMAIN UPGRADE

​

Status: ✅ Selesai (AAA+ studio — fuselage+canopy+delta wings+nacelles+weapons) — commit Fase 2

​

Tujuan

​

Komponen buildVessel() baru

• Main hull: tapered box/cylinder (kurang lebih 50x12x80)
• Cockpit canopy: SphereGeometry di depan-atas, MeshPhysicalMaterial (transmission 0.8), transparan
• Wings: swept-back delta shape
• Engine nacelles: 2 cylinder di belakang + glow sprite
• Weapon mounts: 2 box kecil di wing tips

​

Material

• Hull: metalness 0.75, roughness 0.3 (shiny, pantul env map)
• Cockpit: metalness 0.1, roughness 0.1, transmission 0.8
• Engines: emissive + cylinder
• Weapons: metalness 0.8, roughness 0.2

​

Acceptance

• Kapal player terlihat detail dari dekat (AAA+ fuselage+canopy+delta wings+canard+fin)
• Cockpit transparan (kaca MeshPhysicalMaterial transmission 0.82, frame torus)
• Engine ada glow (2 nacelle cylinder + 2 sprite + afterburner torus)
• Refleksi (Fase 1) kelihatan di hull (MeshStandardMaterial 0.78/0.28 + scene.environment)

​

FASE 3 — ARK-LIBRARIESCHIP DETAIL (Kapal Utama ARCLUX)

​

Status: ✅ Selesai (AAA+ stadium megastructure 12 komponen — scene3d.ts 760+)

​

PENTING (dari pemilik)

​

Saat ini (yang ada di buildArkLibrary → scene3d.ts:760-807)

• Keel: CylinderGeometry(320, 380, 4200, 48) — spine utama
• Prow: ConeGeometry(200, 1100, 40) — depan
• Stern: SphereGeometry(360, 40, 40) — belakang
• Spire: CylinderGeometry(90, 220, 1100, 36) + ConeGeometry(120, 260) cap
• 4 Rings: TorusGeometry(640-760, 26, 16, 72) + glow sprite
• 6 Spars: BoxGeometry(140, 30, 1200)

​

Komponen detail yang HARUS ditambah

​

1. KEEL (hull spine) — detail panel

• 12 hull panel lines (box tipis, raised sedikit, emissive tech)
• 8 window strips (rectangles emissive kecil di sepanjang hull)

​

2. PROW (depan) + COCKPIT DOME

• Cockpit dome: SphereGeometry(40, 24, 24) depan-atas, MeshPhysicalMaterial (transmission 0.8)
• Sensor array: 3 cylinder kecil di depan cone

​

3. STERN (belakang) + ENGINE HOUSING

• Engine housing: 4 x CylinderGeometry(60, 80, 200, 24)
• Engine glow: 4 sprite (additive, orange-red #ff6a00)
• Exhaust ports: 8 cone kecil di permukaan sphere

​

4. SPIRE (command tower) + OBSERVATION

• Observation deck: TorusGeometry(160, 20, 12, 36) di tengah spire
• Antenna array: 4 cylinder tipis (height 200-400)
• Comms dish: SphereGeometry(30, 16, 16) di salah satu antenna
• Light strip: cylinder tipis sepanjang spire, emissive amber

​

5. RINGS (4x — “STADIUM MEGASTRUCTURE”) + DETAIL (FULL)

KONSEP (dari pemilik — prompt desain): “A colossal engineer flagship… gigantic orbital stadium-shaped megastructure. Four massive rotating industrial rings surround a central armored spine hull. The rings contain docking bays, habitat modules, maintenance platforms and glowing windows — NOT a sports arena. Heavy sci-fi engineering, EVE Online scale, Star Citizen capital ship, realistic hard-surface spacecraft.”

• Main torus (existing TorusGeometry(640-760, 26, 16, 72))
• 8 support struts (box tipis connecting ring ke hull)
• Ring glow sprite existing + 1 ambient light per ring

​

5a. HABITAT MODULES (baru, 24/ring)

• BoxGeometry(30, 18, 26) kecil, menempel di permukaan dalam ring
• 24 instance per ring, tersebar merata (setiap 15°)
• Material: steel + sedikit emissive amber (jalur hidup)
• Pakai InstancedMesh (24×4 ring = 96 mesh, tapi 1 draw call)

​

5b. DOCKING BAY PORTS (baru, 12/ring)

• Opening gelap di tepi luar ring (arch-shaped, TorusGeometry kecil atau BoxGeometry hollow dengan interior hitam)
• 12 instance per ring
• Amber frame + marker light di tiap port
• Bay door: 2 panel box tipis yang bisa “buka” (animasi scale saat docking)

​

5c. MAINTENANCE PLATFORMS (baru, 4/ring)

• Flat deck (BoxGeometry(80, 3, 40)) menempel horizontal di beberapa ring
• “Walkable” walkway, sedikit protruding dari permukaan
• 4 platform per ring, sudut 90° terpisah
• Detail: guard rail (2 box tipis) + hazard stripe (emissive amber strip)

​

5d. GLOWING WINDOWS (baru, banyak — pakai instancing)

• Rectangle kecil emissive warm (#ffd9a0) tersebar di seluruh permukaan ring
• 96 windows per ring via InstancedMesh (single draw call)
• Ditambah window clusters di habitat modules (tiap module 2-3 jendela)
• Windows jadi sumber cahaya “life” di ring — terlihat dari jauh

​

5e. ANIMASI ROTASI (4 ring, arah beda)

• Ring 1: rotation.z += 0.001/frame (clockwise)
• Ring 2: rotation.z -= 0.0015/frame (counter)
• Ring 3: rotation.z += 0.002/frame (clockwise)
• Ring 4: rotation.z -= 0.0008/frame (counter)

​

WINDOW/INSTANCE MATERIAL NOTES

• Semua InstancedMesh di-animate via instanceMatrix.setMatrixAt(i, m), instanceMatrix.needsUpdate = true — di-update bersamaan rotasi ring.
• Material windows pakai emissive (tidak butuh light), jadi murah.
• Windows warm (#ffd9a0) vs habitat amber (#ffb36b) vs hull tech cyan (#52c8ff) — contrast warna biar ring terlihat hidup dari jauh.

​

Ring section total per ring: ~156 instance + torus + struts + glow

• 24 habitat + 12 docking + 4 platform + 96 windows + 8 struts = 144 instance
• Semua dalam 1 InstancedMesh class / beberapa group — minim draw call.
• Implementasi: helper buildRingSection(radius, opts) dipanggil 4x (bedah radius 640-760 + kecepatan rotasi). ~120 baris.

​

6. SPARS (6x) + DETAIL

• Light strips: cylinder tipis di setiap spar (emissive)
• Cross-bracing: 2 box tipis per spar (X pattern)

​

7. WEAPON MOUNTS (NEW — 4x)

• BoxGeometry(15, 8, 40) kiri/kanan hull (2 atas, 2 bawah)
• Material: steelHigh + amber accent
• Barrel: CylinderGeometry(3, 3, 60, 8)

​

8. DOCKING BAY (NEW)

• BoxGeometry(120, 80, 200) — opening di hull tengah
• Interior gelap + amber frame
• Bay door lines (box tipis di tepi opening)

​

9. CARGO PODS (NEW — 4x)

• BoxGeometry(50, 40, 80) — di bawah hull
• Material: steel
• Attachment struts (cylinder tipis connecting ke hull)

​

10. ANTENNA ARRAYS (NEW — 6x)

• CylinderGeometry(2, 2, 200-400, 6) — di atas spire + hull
• Material: steelHigh
• Comms dish di 2 antenna

​

11. SHIELD GENERATORS (NEW — 6x)

• SphereGeometry(15, 12, 12) — perimeter hull (3 kiri, 3 kanan)
• Material: tech (emissive cyan glow) + glow sprite per generator
• ANIMASI: opacity pulse 0.4-0.8, sin(time * 2 + i)

​

12. OBSERVATORY DOME (NEW)

• SphereGeometry(50, 24, 24) — atas hull tengah
• MeshPhysicalMaterial (transmission 0.7, metalness 0.1)
• Rotating internal structure (box kecil di dalam, terlihat via kaca)

​

Material reference

​

Animasi keseluruhan

​

Integrasi (PENTING)

• Ark position di-set ke anchor (position player), BUKAN (-32000, -2000, 3000)
• Camera mode “follow” = player vessel depan, Ark terlihat di belakang (radius 3000)
• buildArkLibrary() return: { group, rings: Mesh[], engines: Sprite[], shields: Sprite[], ringInstances: { group, habitats: InstancedMesh, windows: InstancedMesh }[] } buat keperluan animasi per-frame (rotasi ring + update instanceMatrix windows).

​

Acceptance

• Ark jadi kapal utama player, bukan background (stadium megastructure AAA+)
• Detail parah (12 komponen): keel panel+windows, cockpit dome+sensors, stern 4 nacelles+exhaust, spire deck+antenna+dish+strip, 4 rings stadium (24 habitat+12 docking+4 platform+96 windows per ring InstancedMesh), spars strip+X, weapon mounts, docking bay, cargo pods, antenna arrays, shield gens+glow, observatory
• Ring jadi stadium megastructure: 24 habitat + 12 docking port + 4 maintenance platform + 96 glowing windows per ring (via InstancedMesh, 1 draw call per type)
• Ring berputar (animasi stadium/arena) + windows ikut berputar (ringGroups rotation.y beda arah 0.001/0.0015/0.002/0.0008, engine pulse sin 0.003, shield pulse sin 0.002, antenna sway sin 0.0005)

​

FASE 4 — EKSPLOSION VISUAL (Full Particle System)

​

Status: ✅ Selesai (AAA+ 5 burst + 12 debris + 30 sparks + flash — scene3d.ts)

​

Tujuan

• shield flash + sparks.

​

Components (ketika vessel dihapus dari scene)

1. Main Burst — 5 sprite additive (orange #ff6a00 → red #ff2a00 → dark #3a0a00), scale 20→200→0, opacity 1.0→0.0, durasi 0.8s
2. Debris Fragments — 12 BoxGeometry (2x2x2 s/d 5x5x5), random velocity keluar dari pusat, gravity tarik turun, fade + dispose setelah 2s
3. Sparks — 30 Line (BufferGeometry 2 point), random direction, high velocity, fade 0.3s
4. Shield Flash — 1 sprite putih additive, scale 50→150→0, 0.2s, hanya kalau shield > 0

​

Trigger

• Dalam renderRegion(), deteksi vessel ada di prev tapi hilang di cur → panggil spawnExplosion(position).

​

Detail

function spawnExplosion(pos: THREE.Vector3) {
  // 5 sprites burst
  // 12 debris meshes
  // 30 spark lines
  // shield flash (jika ada)
}

​

Acceptance

• Ledakan terlihat (burst 5 sprites 0.8s scale 20→200 + debris 12 Box gravity 2s + sparks 30 Lines 0.3s + flash 0.2s)
• Shield flash muncul pas vessel hilang (flash putih 50→150)
• Setelah 2s semua mesh disposen (gak bocor memory — Set dedup + disposeGroup + explosions cleanup)

​

FASE 5 — SOUND EFFECTS (SEMUA 5, full)

​

Status: ✅ Selesai (5 SFX synthesized + wired — audio.ts + scene3d + input + renderer)

​

Tujuan

​

5 sound effects

​

1. EXPLOSION (ledakan)

• Noise burst + lowpass sweep (2000→100Hz) + exponential decay, 0.8s

sfxExplosion() {
  const c = ensure();
  const noise = c.createBufferSource();
  noise.buffer = makeNoiseBuffer(c, 1);
  const filter = c.createBiquadFilter();
  filter.type = "lowpass";
  filter.frequency.setValueAtTime(2000, c.currentTime);
  filter.frequency.exponentialRampToValueAtTime(100, c.currentTime + 0.8);
  const gain = c.createGain();
  gain.gain.setValueAtTime(0.5, c.currentTime);
  gain.gain.exponentialRampToValueAtTime(0.001, c.currentTime + 0.8);
  noise.connect(filter).connect(gain).connect(sfxGain);
  noise.start(); noise.stop(c.currentTime + 0.8);
}

​

2. WEAPON FIRE

• Square wave (800→200Hz) + highpass + fast decay, 0.15s

sfxWeapon() {
  const c = ensure();
  const osc = c.createOscillator();
  osc.type = "square";
  osc.frequency.setValueAtTime(800, c.currentTime);
  osc.frequency.exponentialRampToValueAtTime(200, c.currentTime + 0.15);
  const gain = c.createGain();
  gain.gain.setValueAtTime(0.3, c.currentTime);
  gain.gain.exponentialRampToValueAtTime(0.001, c.currentTime + 0.15);
  osc.connect(gain).connect(sfxGain);
  osc.start(); osc.stop(c.currentTime + 0.15);
}

​

3. SHIELD HIT

• Triangle wave (440Hz) + bandpass + medium decay, 0.3s

sfxShieldHit() {
  const c = ensure();
  const osc = c.createOscillator();
  osc.type = "triangle";
  osc.frequency.value = 440;
  const filter = c.createBiquadFilter();
  filter.type = "bandpass";
  filter.frequency.value = 600;
  const gain = c.createGain();
  gain.gain.setValueAtTime(0.4, c.currentTime);
  gain.gain.exponentialRampToValueAtTime(0.001, c.currentTime + 0.3);
  osc.connect(filter).connect(gain).connect(sfxGain);
  osc.start(); osc.stop(c.currentTime + 0.3);
}

​

4. AMBIENT SHIP HUM (low rumble, continuous)

• Sawtooth 38Hz + lowpass + gain kecil 0.08, terus jalan

sfxAmbientHum() {
  const c = ensure();
  const osc = c.createOscillator();
  osc.type = "sawtooth";
  osc.frequency.value = 38;
  const filter = c.createBiquadFilter();
  filter.type = "lowpass";
  filter.frequency.value = 120;
  const gain = c.createGain();
  gain.gain.value = 0.08;
  osc.connect(filter).connect(gain).connect(musicGain);
  osc.start();
  return { osc, gain };
}

​

5. DEBRIS/COLLISION

• 3 short noise bursts (0.05s tiap) + random pitch (200-800Hz), 0.2s

sfxDebris() {
  const c = ensure();
  for (let i = 0; i < 3; i++) {
    const noise = c.createBufferSource();
    noise.buffer = makeNoiseBuffer(c, 0.1);
    const gain = c.createGain();
    const t = c.currentTime + i * 0.05;
    gain.gain.setValueAtTime(0.2, t);
    gain.gain.exponentialRampToValueAtTime(0.001, t + 0.1);
    noise.connect(gain).connect(sfxGain);
    noise.start(t); noise.stop(t + 0.1);
  }
}

​

Integrasi (trigger dari mana)

​

Acceptance

• Kelima suara ada & berfungsi (sfxExplosion 0.8s lowpass, sfxWeapon 0.15s square 800→200, sfxShieldHit 0.3s triangle bandpass, sfxAmbientHum saw 38Hz continuous musicGain, sfxDebris 3× noise bursts)
• Volume dikontrol sfxVolume (s0.sfxVolume) + musicVolume terpisah
• Music volume terpisah (musicGain), sfx volume terpisah (sfxGain) + master bus

​

FASE 6 — CUSTOM MUSIC UPLOAD

​

Status: ✅ Selesai (custom music MP3/OGG/WAV/FLAC decode + playlist + controls — audio.ts + menu.ts)

​

Tujuan

​

Implementation

• <input type="file" accept=".mp3,.ogg,.wav,.flac,audio/*" multiple> (CSP-safe, gak ada external URL)
• file.arrayBuffer() → ctx.decodeAudioData(buffer) → AudioBuffer
• Store dalam Map<string, AudioBuffer> (playlist)
• Playback AudioBufferSourceNode → connect musicGain bus
• Controls: play/pause/stop/next
• Volume dari musicVolume slider
• Queue: ketika track selesai, lanjut ke track berikutnya

​

Menu UI (di tab AUDIO)

┌─────────────────────────────────┐
│ CUSTOM MUSIC                    │
│ [Choose File] No file chosen    │
│ Accept: .mp3 .ogg .wav .flac    │
│ Now Playing: —                  │
│ [▶ Play] [⏸ Pause] [⏹ Stop]   │
│ Volume: ████████░░ 80%          │
│                                 │
│ PLAYLIST:                       │
│ 1. my_song.mp3    [×]          │
│ 2. ambient.ogg    [×]          │
└─────────────────────────────────┘

​

ThreatCrush IMPORTANT

• Semua pakai DOM API + textContent. GAK BOLEH dynamic innerHTML.
• File name ditampilkan via textContent bukan innerHTML (XSS-safe).

​

Acceptance

• Upload .mp3/.ogg/.wav/.flac berfungsi (loadCustomMusic file.arrayBuffer → decodeAudioData → Map)
• Play/pause/stop/next jalan (playCustom/pauseCustom/stopCustom/nextCustom, auto next onended)
• Volume dikontrol musicVolume (musicGain)
• Gak ada innerHTML (ThreatCrush safe — DOM textContent + input file)

​

FASE 7 — UI EFFECTS POLISH

​

Status: ✅ Selesai

​

HUD polish (hud.ts)

• Panel opacity transition (data berubah → fade in 0.2s)
• Active target panel glow (text-shadow pulse)
• Scanline animation refine (tweak speed/opacity)
• Typography hierarchy (font-weight 700 titles, 400 data)
• Panel borders: gradient edges (subtle industrial)

​

Menu polish (menu.ts)

• Tab transitions (smooth color fade on switch)
• Slider glow on hover (accent-color pulse)
• Button hover effects (border color transition)
• Panel slide-in animation (dari kanan, 0.3s)

​

Contoh CSS-like transitions (JS)

// Panel fade
panel.style.transition = "opacity 0.2s ease";
panel.style.opacity = "0";
requestAnimationFrame(() => { panel.style.opacity = "1"; });

// Button hover glow
btn.addEventListener("mouseenter", () => {
  btn.style.boxShadow = `0 0 8px ${colors.tech}`;
  btn.style.transition = "box-shadow 0.15s ease";
});
btn.addEventListener("mouseleave", () => {
  btn.style.boxShadow = "none";
});

​

Acceptance

• HUD panel fade on data change
• Target panel glow
• Menu tab/slider/button hover effects jalan

​

PART B — STADIUM INTERIOR WORLD (FULL AAA MMORPG, wire ke gameserver)

PRINSIP Part B: Stadium/kapal luar angkasa BUKAN background. Tiap stadium = StationEntity/VesselEntity hidup di packages/gameserver/types.ts:29 (D-008 server-authoritative). 1 repo = 1 vessel (06 §18.1:842, decisions-mmo.md:87 D-007) — repo = repo user sendiri (VesselModel.source.org/repo packages/universe/types.ts:75), owner = VesselEntity.owner types.ts:32 di-set WorldRegion.spawnVessel({owner:playerId}) world.ts:96 / server.ts:218 spawnPlayerVessel. Damage kapal = code kapal di repo ikut rusak — itu udah ada di gameserver (component.ts, collision.ts:92 KE=½mv²×angle×penetration, thermics.ts:28 ∝1/r²→>1200K→health-2/tick, combat.ts:39 DAMAGE_CEILING=12 per-subsystem), Part B cuma polish UI biar selevel engine gila yang udah lu bikin — FULL FPS AAA, gak ada versi murah, tinggal wire.

Repo siapa? Jawab jebakan: repo user sendiri — user bikin repo baru di akun dia (github.com/dia/my-stadium isinya arclux.stadium.json + vessel.json universe), game kirim repoUrl → gameserver world.ts:96 spawn jadi StationEntity/VesselEntity/CharacterEntity. Validasi validator.ts:53 entity.owner===playerId + 3-tier license universe/license.ts:10 open/shared/private. engine/pipeline.ts:1 TIDAK dipakai game — itu buat analisis codebase workspace.

​

FASE 8 — FPS WALKABLE INTERIOR WORLD (Genshin-like, FULL)

​

Status: ✅ Selesai — 6 iris (PR #664-669) — corridor+promenade+plaza+96 habitat+lighting+FPS+CharacterEntity+DockingState+HUD deck+camera

​

Tujuan

​

Konsep

​

File

• NEW apps/game/src/renderer/interior.ts ~480 baris — buildArkInterior(), promenade, plaza, corridor, hangar bay geometry
• apps/game/src/renderer/renderer.ts +60 — DockingState + switch scene
• apps/game/src/renderer/input.ts +80 — mode FPS_INTERIOR
• apps/game/src/renderer/scene3d.ts — reuse tokens.ts D-025 palette

​

Detail implementasi

​

8a. FPS Controller (FULL, bukan click)

// interior.ts — FPS interior, pointer-lock kayak game AAA
type InteriorMode = "EXTERIOR" | "FPS_INTERIOR";
let mode: InteriorMode = "EXTERIOR";
let yaw = 0, pitch = 0, vel = new THREE.Vector3();

// input.ts — extend, bukan ganti
// WASD + Shift sprint + Space jump + Ctrl crouch + mouse look
// pointer-lock: canvas.requestPointerLock() → mousemove → yaw/pitch
// collision: THREE.Box3 per corridor/promenade + raycast lantai
// clamp pitch ±85°, sprint 1.6×, jump impulse 4m/s, gravity 9.8

​

8b. Interior Geometry (FULL detail, bukan placeholder)

• Corridor spine — BoxGeometry(4200, 80, 80) sepanjang keel, panel lines + emissive strip kayak exterior 12 hull panel (Fase 3.1), 8 window strips
• Promenade 4 ring — walkway melingkar di tiap ring (reuse radius 640-760 Fase 3.5), guard rail + hazard stripe, 96 windows warm #ffd9a0 tetap kelihatan dari dalam
• Plaza central — CylinderGeometry(400, 400, 20, 48) di tengah hull, tempat kumpul, StationEntity.safeZoneRadius:58 = 1000m
• Habitat deck — 24 habitat Box(30,18,26) per ring jadi ruangan beneran (bisa masuk), bukan cuma InstancedMesh luar
• Lighting — AmbientLight + PointLight per deck + emissive window, PMREMGenerator reuse Fase 1 (scene.environment tetap)

​

8c. Wire ke gameserver (authoritative D-008)

// packages/gameserver/types.ts — tambah (server authoritative)
export interface CharacterEntity extends GameEntity {
  kind: "character"; // baru, selain "vessel"|"station" types.ts:26
  vesselId: string;  // vessel induk yang dimiliki
  deck: "hangar"|"promenade"|"plaza"|"habitat";
}
// RegionSnapshot:79 tambah entities: (WorldEntity|CharacterEntity)[]
// WorldRegion: world.ts:96 spawnCharacter(opts) mirip spawnVessel
// Simulation: simulation.ts:85 step() sync CharacterEntity 25Hz bareng VesselEntity
// Persistence: persistence.ts:120 saveRegion/loadRegion ikut simpan CharacterEntity

​

8d. Multiplayer

• WorldRegion:65 entities: Map<string, WorldEntity|CharacterEntity> — semua karakter sync kayak vessel
• governance.ts:31 isInSafeZone — di dalam stadium = safe zone, combat.ts gak bisa hit
• observability.ts + intel.ts — presence CharacterEntity kelihatan di overlay [KOMUNITAS A] [GSF-xxxx] [username] 01:806

​

Performance

• Lazy-load: buildArkInterior() cuma dipanggil pas DockingState.entering
• InstancedMesh habitat/windows tetap 1 draw call
• Exterior scene visible=false pas di dalam

​

Acceptance

• FPS beneran (WASD+Shift+Space+mouse look, pointer-lock) — bukan click (iris 4 FPS controller 60Hz)
• Collision jalan gak tembus dinding/lantai (iris 4 Box3 + floor clamp, iris 1 walkBounds)
• Interior detail full (corridor+promenade+plaza+96 habitat) — bukan kotak kosong (iris 1-2, 353+139 lines)
• Karakter player lain kelihatan & sync (2+ player di plaza) — server CharacterEntity iris 5
• Lazy-load — orbit tetap 60fps, interior load pas docking aja (iris 5 DockingState ENTERING→INTERIOR, addGroup/removeGroup)
• buildArkInterior() ~350 baris + lighting 23 + habitats 139, input.ts +80, renderer.ts +60, hud.ts HUD deck + scene3d interior camera

​

FASE 9 — KARAKTER ENGINEER (bikin kayak bikin kapal di repo)

​

Status: ✅ Selesai — CharacterCustom 4 preset + spawnCharacter (PR #671)

​

Tujuan

​

Konsep — Repo = Karakter

• Kapal → repo dengan VesselModel (packages/universe/types.ts:75 source.org/repo) → world.ts:96 spawnVessel({owner:playerId})
• Stadium → repo dengan arclux.stadium.json + VesselModel → world.ts:115 spawnStation({owner, communityId})
• Karakter → repo karakter (repo kecil isinya character.json: body, armorColor, emblemRepo) → world.ts:96 spawnCharacter / spawnVessel mini owner=playerId → CharacterEntity di dalam stadium
• Semua repo user sendiri (github.com/dia/my-character), game kirim repoUrl → gameserver clone/validasi → spawn. Bukan repo ARCLUX pusat.

​

File

• apps/game/src/renderer/menu.ts +80 — CharacterCustom UI
• packages/gameserver/types.ts +15 — CharacterEntity
• packages/gameserver/world.ts +25 — spawnCharacter()
• packages/gameserver/persistence.ts +10 — simpan karakter
• packages/gameserver/lineage.ts:22 recordCreation — provenance karakter

​

Detail implementasi

​

9a. CharacterCustom UI (pertama masuk stadium)

┌─────────────────────────────────┐
│ CREATE CHARACTER (repo = karakter)│
│ Body: [A] [B] [C] [D] preset    │
│ Armor: [██] color picker         │
│ Emblem: repo GSF-001/my-emblem   │
│ Nama: GSF-xxxx (prefix user)    │
│ [Spawn di Plaza]                │
└─────────────────────────────────┘

• DOM textContent ThreatCrush-safe (kayak hud.ts esc())
• Pilih 4 body preset dulu (box+capsule, bukan skeletal — AAA feel awal)
• emblemRepo = repo yang jadi emblem (bisa repo vessel dia sendiri)
• Simpan: PlayerIntent { type:"spawn_character", payload:{characterJson} } → simulation.ts:167 applyIntent → validator.ts:45 cek playerId → world.ts spawn

​

9b. Karakter di world

• CharacterEntity: types.ts id = char:${playerId}, kind="character", vesselId = vessel.id (kapal miliknya), deck="plaza" awal
• server.ts:218 spawnPlayerVessel sudah idempotent — karakter reuse pola itu
• lineage.ts:22 recordCreation(characterId, vesselId, owner, tick) — provenance karakter tetap walau ganti baju

​

9c. Animasi

• THREE.AnimationMixer idle/walk/run/sprint (box rig simpel, bukan skeletal dulu — tetap AAA feel karena FPS + interior detail)
• Third-person follow cam + first-person toggle (V key)

​

Wire ke gameserver

• validator.ts:45 playerId===ctx.playerId + 53 owner check
• persistence.ts:120 saveRegion/loadRegion ikut karakter (restart ≠ reset V6 08:6)
• bridge.ts:102 token = v:${vesselId}:${owner}:${target} — karakter ikut pindah shard bareng vessel

​

Acceptance

• Bikin karakter kayak bikin kapal (repo → spawn) — bukan form doang
• 4 preset + armor color + emblem repo
• Karakter spawn di plaza stadium, bisa jalan FPS
• CharacterEntity sync antar player & persist restart

​

FASE 10 — HANGAR GARASI + ANIMASI DOCKING SINEMATIK FILM (FULL)

​

Status: ✅ Selesai — hangar 32 slot + bay door + docking film 3s 2-phase (PR #676)

​

Tujuan

​

Konsep

• Garasi = bagian dari stadium StationEntity safeZoneRadius:58 1000m
• 12 docking port di tiap ring (48 total, dari Fase 3.5b) → tiap port = gate ke hangar
• Hangar = BoxGeometry(400x200x600) di hull, 32 slot InstancedMesh

​

File

• apps/game/src/renderer/interior.ts +120 — hangar bay geometry + 32 slot
• apps/game/src/renderer/scene3d.ts +40 — bay door anim di ring
• apps/game/src/renderer/renderer.ts +40 — DockingState
• apps/game/src/renderer/audio.ts +20 — docking siren + clamp sfx
• packages/gameserver/gate.ts:34 GateLink — sudah ada, tinggal pakai
• packages/gameserver/bridge.ts:75 createGameBridge — sudah transactional

​

Detail implementasi

​

10a. Hangar Bay Geometry

// interior.ts — hangar di hull tengah
const hangar = new THREE.Mesh(new THREE.BoxGeometry(400, 200, 600),
  new THREE.MeshStandardMaterial({ color: threeColor(colors.struct), metalness:0.7 }));
// 32 slot InstancedMesh — tiap slot Box(60,20,80) + marker light amber
// Vessel yang parkir = InstancedMesh instance, pos = slotPos[i]
// Exterior kapal tetap visible di slot (scale 0.6 biar muat)

​

10b. Animasi Docking Film 3 Detik (FULL, controllable)

APPROACH (<800m dari port, tekan F)
  → validate: validator.ts:45 + gate.ts:151 dist < activationRadius
  → request: gate.ts:185 log gate.transit.start + persistence.ts:146 savePendingHandoff (BEFORE remove)
  → anim exterior: kapal lerp dari approach vector → port (1s)
  → bay door: 2 panel Box scale 1→0 (0.5s) + light sweep PointLight 0→1.4
  → kamera: lerp lewat koridor (1s), BISA lihat kanan-kiri (controllable, bukan lock total)
  → commit: bridge.ts:134 coordinator.requestHandoff → await ACK
  → phase2: gate.ts:242 region.remove(vesselId) di source, interior.ts switch ke FPS
  → auto-clamp: kapal lerp ke slot kosong, gear down, clamp FX Sprite
  → persist: gate.ts:245 deletePendingHandoff
  → log gate.transit.complete

• Total 3 detik, THREE.AnimationMixer + lerp, bukan cutscene lock total
• Kalau ack.ok===false → gate.ts:224 rollback deletePendingHandoff, tetap di orbit
• Crash mid-transit → gate.ts:264 recoverPendingHandoffs() re-deliver (crash-safe persistence.ts:120)

​

10c. Parkir Luar vs Dalam

• Luar: vessel tetap VesselEntity di WorldRegion orbit, position dekat port
• Dalam: CharacterEntity di interior + vessel InstancedMesh di slot (visual), VesselEntity tetap di RegionState tapi position = hangarSlotPos + velocity=0
• Semua kapal kelihatan di garasi (32 slot, InstancedMesh 1 draw call)

​

10d. Audio

• audio.ts sfxDocking() — low hum + siren sweep, sfxClamp() — metal clamp
• setSpeed(0) pas docking biar engine hum pelan

​

Wire ke gameserver (udah ada, tinggal pakai)

• gate.ts:127 createGateRouter — transit(req) sudah 2-phase commit + federation check directory.getServer
• bridge.ts:92 deliver — target.region.spawnVessel dari vesselModels Map (token anti-clone, bukan kirim source code)
• simulation.ts:201 dock intent — position=station.position, zero velocity

​

Acceptance

• 32 slot garasi kelihatan di hangar (InstancedMesh)
• Parkir luar & dalam bisa
• Animasi masuk 3 detik kayak film, controllable, door buka + light sweep
• Crash-safe (pending handoff survive restart)
• Semua kapal di garasi kelihatan (32)

​

FASE 11 — BAZAAR KOMPONEN (jual SOURCE code vessel beneran, FULL)

​

Status: ✅ Selesai — 16 stall + marketplace + trade authoritative (PR #678)

​

Tujuan

​

Konsep — Komponen = Code Vessel

• Tiap VesselModel di packages/universe/types.ts:75 + packages/gameserver/component.ts:10 punya ComponentCondition { componentId, vesselId, health 0..100, usageCount, maxUsage, depleted }
• 16 lapak di promenade ring (4 per ring), tiap lapak = stall BoxGeometry(40,30,40) + signage
• Listing = komponen beneran dari WorldRegion snapshot, bukan ModuleInfo engine

​

File

• apps/game/src/renderer/interior.ts +80 — 16 stall geometry di promenade
• apps/game/src/renderer/menu.ts +120 — marketplace overlay (filter, preview, trade)
• packages/gameserver/component.ts:30 useComponent — sudah ada
• packages/gameserver/validator.ts:169 checkComponent — sudah ada
• packages/gameserver/simulation.ts:167 applyIntent — sudah ada

​

Detail implementasi

​

11a. Stall Geometry

// interior.ts — 16 stall di promenade (4 per ring × 4 ring)
for (let r=0; r<4; r++) for (let s=0; s<4; s++) {
  const stall = new THREE.Mesh(new THREE.BoxGeometry(40,30,40),
    new THREE.MeshStandardMaterial({ color: threeColor(colors.structHigh), emissive: threeColor(colors.tactical) }));
  stall.position.set(promenadePos(r,s));
  // signage: Sprite textContent "LAPAK 1" (DOM overlay, bukan innerHTML)
  // proximity trigger: distance(player, stall) < 30 → show [E] Interact
}

​

11b. Marketplace Overlay (FULL)

┌──────────────────────────────────────────┐
│ BAZAAR — LAPAK 7 (Promenade Ring 2)     │
│ Filter: [All][Engine][Shield][Weapon]   │
│ ┌─────────────────────────────────────┐ │
│ │ Component: Thruster Mk3             │ │
│ │ Vessel: GSF-001/my-vessel           │ │
│ │ Health: 87%  Usage: 3/10            │ │
│ │ Price: 500 cr  Seller: GSF-002      │ │
│ │ [Preview Stats] [Graph] [Beli]      │ │
│ └─────────────────────────────────────┘ │
│ Preview: VesselModel.systems[engine]=87%│
│ Graph: mini GraphCanvas kapal seller   │
└──────────────────────────────────────────┘

• menu.ts DOM textContent + esc() kayak hud.ts (ThreatCrush-safe, innerHTML 0)
• Filter by componentId (engine/shield/weapon/reactor), search by vesselId
• Preview: VesselModel.systems health + lineage.ts:44 getLineage provenance
• Trade button cuma aktif kalau component.ts:30 useComponent !depleted + validator.ts:169 checkComponent pass

​

11c. Trade Flow (authoritative D-008)

// client: PlayerIntent { playerId, entityId: characterId, type:"trade_component", payload:{ listingId, componentId }, seq }
// server: simulation.ts:167 applyIntent → validator.ts:45 playerId check → component.ts:30 useComponent → lineage.ts:37 transferOwnership → log GameEvent type:"trade"
// result: RegionState.entities update, buyer vessel dapat component, seller vessel kehilangan
// damage check: kalau komponen rusak (health 0) → component.ts:30 return depleted → validator reject

​

11d. Damage → Code Mapping (bener — gameserver, bukan engine)

• combat.ts:39 applyCombatIntent → SystemState.health -= damage (12 max) → komponen rusak
• collision.ts:92 checkCollisions → KE×angle×penetration → semua SystemState.health -= damage → destroyed = damage >= integrity(80) → region.remove
• thermics.ts:28 computeThermal → >1200K → health-=2/tick
• lineage.ts:28 recordDestruction — provenance tetap walau hancur (04:22 wreckage archive)

​

Acceptance

• 16 lapak kelihatan di promenade (bisa jalan ke lapak, [E] interact)
• Bisa jual/beli source code komponen vessel beneran (bukan dummy)
• Validasi gameserver (cuma komponen hidup yang bisa dijual)
• Preview stats + graph + lineage
• Trade update RegionState langsung, damage mapping bener

​

FASE 12 — USER BEBAS BIKIN STADIUM + LIVING WORLD INTERAKSI (FULL)

​

Status: ✅ Selesai — arclux.stadium.json + buildStadiumFromConfig + gate living world (PR #679) — 09 COMPLETE 12/12

​

Tujuan

​

Konsep — Stadium = StationEntity dari Repo

• User bebas bikin stadium via repo — push repo dengan arclux.stadium.json (isinya ringCount, habitatDensity, dockingCount, plus VesselModel config universe). Contoh:
  // arclux.stadium.json di github.com/dia/my-stadium
  { "name": "Stadion Dia", "rings": 4, "habitatsPerRing": 24, "dockingPerRing": 12, "communityId": "dia-faction" }
  
• scene3d.ts:760 buildArkLibrary() → buildStadiumFromConfig(config) di scene3d.ts/interior.ts generate StationEntity baru (bukan background). world.ts:115 spawnStation({id, name, owner:playerId, communityId, safeZoneRadius:1000})
• Stadium muncul di world, gate.ts:34 GateLink bikin gate antar stadium

​

File

• apps/game/src/renderer/scene3d.ts +60 — buildStadiumFromConfig()
• apps/game/src/renderer/interior.ts +60 — interior stadium user
• packages/gameserver/world.ts:115 spawnStation — sudah ada
• packages/gameserver/gate.ts:34 GateLink — sudah ada
• packages/gameserver/governance.ts:31 isInSafeZone — sudah ada
• packages/gameserver/persistence.ts:120 — simpan stadium

​

Detail implementasi

​

12a. Build Stadium dari Repo

// scene3d.ts — extend buildArkLibrary
function buildStadiumFromConfig(cfg: StadiumConfig): THREE.Group {
  // reuse Fase 3.5 ring logic: buildRingSection(radius, {habitats: cfg.habitatsPerRing, docking: cfg.dockingPerRing})
  // habitat/docking/windows InstancedMesh kayak Ark, tapi param dari cfg
  // return group + ringInstances kayak Fase 3 integration
}
// client kirim: PlayerIntent { type:"spawn_station", payload:{ stadiumJson, repoUrl } }
// server: validator cek repoUrl valid → world.spawnStation → persistence.saveRegion

​

12b. Living World Interaksi

• Di dalam stadium: semua CharacterEntity bisa proximity chat/interact (wire governance.ts + intel.ts addIntel/getIntel untuk presence & cockpit.ts HUD faction [KOMUNITAS A] [GSF-xxxx] 01:806)
• Antar stadium: gate.ts:127 createGateRouter + bridge.ts:75 createGameBridge transactional ACK + teleport.ts 2-teleport mobilisasi (MAX 50000, cooldown 300 ticks teleport.ts)
• Damage stadium: combat.ts/collision.ts hit stadium → governance.ts isInSafeZone cek — di dalam safe zone 02:160 BLOCKED, di luar → SystemState.health turun kayak vessel

​

12c. Wire Community (06 §13, §15-16)

• 02:190 Station permissions PUBLIC/COMMUNITY/FLEET/PRIVATE via GateLink.allowedCommunityIds:43
• 06:540 Access ≠ Ownership — OWNER→OPERATOR→MAINTAINER→AUTHORIZED→TEMPORARY→COMMUNITY_ADMIN 06:554
• 06:728 multi-sig REQUEST→LEADER+COUNCIL→ACTION buat ganti safe-zone

​

Acceptance

• User bisa bikin stadium baru via repo (arclux.stadium.json) — muncul di world
• Stadium punya interior FPS + 16 lapak + 32 garasi kayak Ark
• Bisa interaksi sesama player di dalam (proximity, chat, trade)
• Gate antar stadium jalan (transactional, crash-safe)
• Damage stadium ngaruh ke code repo itu (health turun)

​

ESTIMASI TOTAL (Part A + Part B)

​

File additions

• scene3d.ts: +735 baris (Part A 675 + Part B 60 stadium config)
• interior.ts: +620 baris NEW (Fase 8 480 + 10 120 + 11 80 + 12 60, lazy-load)
• renderer.ts: +60 baris (Part B DockingState switch)
• input.ts: +80 baris (Part B FPS mode)
• audio.ts: +270 baris (Part A 250 + Part B 20 docking/hangar sfx)
• menu.ts: +280 baris (Part A 110 + Part B 170 bazaar+character)
• hud.ts: +40 baris (Part A 30 + Part B 10 interior HUD)

​

Grand total lines: ~2085 baris, 7 file (1 baru interior.ts), 0 breaking change.

Part A = polish exterior (ship, Ark stadium, ledakan, sfx, musik, UI) Part B = polish interior living world (FPS, karakter repo, hangar film, bazaar code, stadium bebas) Semua wire ke packages/gameserver yang udah ada (D-008 authoritative), gak sentuh packages/engine.

​

EXECUTION CHECKLIST (per fase — centang saat selesai)

​

Fase 1 — Env map ✅

• pmrem generator dibuat (PMREMGenerator + compileEquirectangularShader)
• scene.environment di-set tiap 10 frame (pmrem.fromScene(scene,0.04) + dispose target lama)
• Verify build + tsc (build-game.mjs ✓, tsc -p apps/game ✓, ThreatCrush 0)

​

Fase 2 — Ship model ✅

• buildVessel() detail baru AAA+ (fuselage+canopy+delta wings+canard+fin+nacelles+glow+afterburner+weapon mounts+barrels, disposeGroup dedup Set)
• Verify build + tsc (build-game.mjs 1.3mb ✓, tsc -p apps/game ✓, ThreatCrush 0)

​

Fase 3 — Ark detail (stadium megastructure) ✅

• 12 komponen detail AAA+ (keel panel+windows, cockpit dome, stern 4 nacelles, spire deck+antenna+dish, rings stadium, spars, weapons, bay, cargo, antenna, shield gens, observatory)
• Ring = stadium megastructure: 24 habitat + 12 docking + 4 platform + 96 windows per ring (InstancedMesh, 1 draw call)
• Ring animation (rotasi ringGroups y 0.001/0.0015/0.002/0.0008 + engine pulse + shield pulse + antenna sway)
• Ark position masih (-32000, -2000, 3000) background vessel-world, anchor wiring deferred Fase 8 (interior)
• buildArkLibrary return { group, rings, ringGroups, engines, shields, antennas, habitatMeshes, windowMeshes }
• Verify build + tsc (build-game.mjs 1.3mb ✓, tsc -p apps/game ✓)

​

Fase 4 — Explosion ✅

• spawnExplosion() full particle (5 burst sprites 0.8s + 12 debris Box gravity 2s + 30 sparks Lines 0.3s + shield flash 0.2s, spawnExplosion(pos))
• Trigger saat vessel dihapus (renderRegion live Set → cur.get(id) → spawnExplosion)
• Memory dispose setelah 2s (Set dedup disposeGroup + explosions splice, dispose target & mats)
• Verify build + tsc (build-game.mjs 1.3mb ✓, tsc -p apps/game ✓, ThreatCrush 0)

​

Fase 5 — Sound effects ✅

• 5 sfx methods (sfxExplosion, sfxWeapon, sfxShieldHit, sfxDebris, sfxAmbientHum — audio.ts + ambientOsc)
• Trigger wiring (scene3d sfxHandler explosion→sfxExplosion, input KeyF/J + mousedown → sfxWeapon, renderer ambient hum via speed, shield/debris via handler)
• sfxVolume/musicGain terpisah (sfxGain 0.7, musicGain 0.35, masterBus, muted)
• Verify build + tsc (build-game.mjs 1.4mb ✓, tsc -p apps/game ✓, ThreatCrush 0)

​

Fase 6 — Custom music ✅

• File input di menu (AUDIO tab CUSTOM MUSIC, accept .mp3/.ogg/.wav/.flac,audio/* multiple)
• decodeAudioData + playlist Map (customBuffers Map + customOrder + onended auto next)
• play/pause/stop/next (playCustom/pauseCustom/stopCustom/nextCustom + now playing label)
• ThreatCrush safe (no innerHTML — DOM textContent + input file)
• Verify build + tsc (build-game.mjs 1.4mb ✓, tsc -p apps/game ✓)

​

Fase 7 — UI polish ✅

• HUD panel fade + glow (fadeOnChange hash-guard 0.2s, target text-shadow pulse, scanline drift+opacity, hierarchy 700/400, gradient panel edges — hud.ts)
• Menu hover effects (wireHover box-shadow+border, wireSliderGlow tactical, tab color-fade transition, panel slide-in 0.3s — menu.ts)
• Verify build + tsc (build-game.mjs ✓, ThreatCrush 0 innerHTML.*+ ✓; 3 error TS2307 scene3d/cosmic|planets|textures pre-existing di base, bukan dari Fase 7 — terbukti via stash)

​

Fase 8 — FPS interior ✅

• interior.ts buildArkInterior() (corridor+promenade+plaza+habitat — iris 1-2, 353 lines)
• FPS controller WASD+Shift+pointer-lock + Box3 collision (iris 4, input.ts 80 lines, pitch ±85°, sprint 1.6×, jump 4 m/s, gravity 9.8)
• Lazy-load pas docking, exterior visible=false (iris 5 DockingState, scene.addGroup/removeGroup, walkBounds)
• CharacterEntity sync 25Hz (iris 5 types.ts/world.ts CharacterEntity + spawnCharacter, persistence otomatis)
• Lighting ambient+point PMREM reuse (iris 3) + HUD deck + camera FPS follow (iris 6 hud.ts + scene3d setInteriorCamera + renderer poll 30Hz)
• Verify build + tsc (build-game.mjs ✓, tsc ✓, ThreatCrush 0, 6 iris PR #664-669)

​

Fase 9 — Karakter repo ✅

• CharacterEntity + spawnCharacter() (types.ts/world.ts CharacterEntity kind “character”, vesselId, deck, spawnCharacter, persistence otomatis)
• CharacterCustom UI 4 preset + emblem repo (menu.ts overlay A-D, armor color, emblemRepo, name GSF-xxxx, ThreatCrush textContent)
• lineage + persistence (simulation.ts spawn_character → lineage recordCreation, validator accept, world spawn)
• Verify build + tsc (PR #671)

​

Fase 10 — Hangar + docking film ✅

• Hangar 32 slot InstancedMesh (interior.ts Box 400×200×600 BackSide + 2 bay door + 32 slot 4×8 + marker glow)
• Animasi 3 detik controllable + bay door + light sweep (renderer.ts dockToHangar 3s door scale + light sin, controllable look)
• 2-phase commit gate.ts + bridge.ts (gate.ts:242 savePendingHandoff → remove → delete, simulation dock intent, validator)
• Parkir luar & dalam (VesselEntity orbit vs CharacterEntity + InstancedMesh slot, 1 draw)
• Verify build + tsc (PR #676)

​

Fase 11 — Bazaar ✅

• 16 stall promenade + proximity [E] (interior.ts 4×4 Box 40×30×40 + glow, walkBounds promenade)
• Marketplace overlay filter + preview graph/lineage (menu.ts bazaarOverlay All/Engine/Shield/Weapon, preview health/lineage, textContent)
• Trade via PlayerIntent + validator + component (validator trade_component, simulation transferOwnership, lineage, log trade)
• Validasi health/usage (health 0 → depleted reject, validator check)
• Verify build + tsc (PR #678)

​

Fase 12 — Stadium bebas + living world ✅

• arclux.stadium.json → buildStadiumFromConfig() (interior.ts StadiumConfig rings/habitats/docking, InstancedMesh param, preview 5s)
• spawnStation + GateLink + governance (validator spawn_station, simulation spawnStation near vessel, safeZone 1000)
• Interaksi proximity + trade antar stadium (gate.ts GateLink transactional, bridge ACK, N key overlay)
• Damage stadium → health (combat/collision → governance isInSafeZone, health via StationEntity)
• Verify build + tsc (PR #679) — 09 COMPLETE 12/12

​

FINAL VERIFICATION (SEBELUM COMMIT)

1. node scripts/build-game.mjs — bundle success (gak error)
2. npx tsc --noEmit -p apps/game/tsconfig.json — type check clean
3. grep -rn "innerHTML.*+" apps/game/src/renderer/ — 0 match (ThreatCrush)
4. npx tsc --noEmit -p packages/gameserver/tsconfig.json — gameserver type check (CharacterEntity, GateLink)
5. Manual test di game client (Electron / browser):
   • Part A: Ark detail, ring berputar, engine glow, ship detail + refleksi, ledakan + sfx, musik upload
   • Part B: FPS jalan di interior (WASD+mouse), bikin karakter via repo, parkir 32 slot + animasi docking 3 detik, 16 lapak bazaar trade, bikin stadium baru via arclux.stadium.json
6. Gak ada stray files ke-commit (ArcluxEnvironment.ts, ARCLUX)
7. Konfirmasi kepemilikan sebelum push (jangan force push)
8. Committed ke branch feat/mmo-blueprint-full
9. Push + buka/update PR

​

PR / COMMIT STYLE

• Author: GSF-001 <230616882+GSF-001@users.noreply.github.com>
• Jangan pernah commit packages/environment/ArcluxEnvironment.ts atau stray ARCLUX
• Commit message singkat, deskriptif: feat(game): ark detail + explosions + custom music
• push ke feat/mmo-blueprint-full aja (jangan ke main langsung)