> ## Documentation Index > Fetch the complete documentation index at: https://arclux-os.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # ๐ŸŒŒ ARCLUX โ€” Spatial Universe & Navigation UX > Blueprint detail โ€” ARCLUX Repository War Universe # ๐ŸŒŒ ARCLUX โ€” Spatial Universe & Navigation UX > The repository is the vessel. The universe is the interface. Desain spatial universe & navigasi โ€” mengubah camera menjadi metode navigasi arsitektur software. Bagian dari blueprint ARCLUX (Repository War Universe). *** ## 1. Design Philosophy ARCLUX terasa seperti persistent software universe, bukan game konvensional dengan tema coding. **Core principle:** > "The repository is the source of truth. ARCLUX is the spatial canvas and > simulation layer." Tiga perspektif yang terhubung: ``` ARCLUX WORLD โ”‚ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ†“ โ†“ โ†“ UNIVERSE VESSEL DEVELOPER VIEW VIEW VIEW โ”‚ โ”‚ โ”‚ ๐ŸŒŒ ๐Ÿช ๐Ÿ›ฐ๏ธ ๐Ÿš€ โš™๏ธ ๐Ÿ›ก๏ธ ๐Ÿ”— ๐Ÿ“ฆ ๐Ÿ“„ ``` User berpindah antar perspektif tanpa merasa membuka aplikasi terpisah. *** ## 2. Spatial Universe โ€” Living Cosmic Environment Canvas utama = persistent 3D spatial environment. > **ARCLUX bukan papan statis.** Universe hidup: tata surya bergerak, orbit > nyata, benda langit berinteraksi, dang bang. Suasana dunia terus berubah. Objek yang mungkin: * stars / planets / moons / asteroids * stations * jump gates * vessels * fleets * wreckage * historical locations * tactical markers * cosmic events (meteor shower, badai bintang, aurora) ``` โœฆ ยท โœฆ ๐Ÿช โ”‚ ๐Ÿš€ Vessel โ”‚ โœฆโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โœฆ โ”‚ ๐Ÿ›ฐ Station โ”‚ ๐Ÿš€ Vessel B ยท โœฆ ``` Visual terinspirasi space simulator skala besar, namun ARCLUX mempertahankan identitas visualnya sendiri โ€” *cinematic, spatial, data-dense*, bukan dashboard. ### 2.1 Sistem Bintang per Region **Setiap region = satu sistem bintang** (sinkron arsitektur "shard = region = system"); jump gate = pindah ke sistem bintang lain (lihat ยง14). ``` REGION (SYSTEM) โ”œโ”€โ”€ โ˜‰ Star (matahari) โ€” sumber cahaya/energi, pusat gravitasi visual โ”œโ”€โ”€ Planet(s) โ€” orbit elips nyata โ”œโ”€โ”€ Moon(s) โ€” mengorbit planet besar โ”œโ”€โ”€ Asteroid belt โ€” orbit, hazard nyata โ””โ”€โ”€ Cosmic event โ€” meteor, badai bintang, dsb ``` ### 2.2 Tiga Lapis Objek Bedakan objek agar render & interaksi benar: ``` LAYER CONTOH INTERAKSI COLLIDABLE asteroid, meteor, planet fisik โ€” vessel bisa nabrak โ†’ damage ATMOSPHERIC meteor lewat, aurora, debu drama visual, kejadian acak BACKDROP planet super-jauh hanya terlihat, tak bisa dijangkau ``` * **COLLIDABLE** โ†’ masuk world validator + damage (lihat [03-combat.md](https://github.com/GSF-001/ARCLUX/blob/main/03-combat.md)), tabrakan cukup parah โ†’ wreckage ([04-wreckage-history.md](https://github.com/GSF-001/ARCLUX/blob/main/04-wreckage-history.md)). * **BACKDROP** โ†’ planet yang tampak sangat jauh, tak bisa digapai โ€” memberi sense of scale ala film, membangun impian eksplorasi tanpa perlu reachable. * **ATMOSPHERIC** โ†’ drama kosmik yang membuat dunia terasa hidup. ### 2.3 Orbit & Fase Lunar (realisme astronomis) Tata surya menggunakan **simulasi orbit nyata**: posisi benda langit adalah fungsi deterministik dari parameter orbit & tick dunia (bukan state acak). ``` POSISI_BODY(tick) = f(parameter orbit, tick) โ†’ deterministik, semua lihat sama ``` Konsekuensi alami dari orbit (tidak perlu state terpisah, ia lahir dari orbit): ``` FASE_BULAN = f(posisi bulan, posisi planet, arah matahari) PURNAMA โ†’ bulan di sisi berlawanan matahari (terang penuh) SABIT โ†’ bulan dekat arah matahari (tipis) BULAN BARU โ†’ bulan di antara planet & matahari (gelap) ``` * **Gerak tata surya & fase bulan** hidup terus (D-013 persistent: posisi valid pada tick itu, tidak reset seenaknya). * **Deterministik per tick** menjaga server-authoritative (D-008) โ€” semua klien & replica region menghitung posisi yang sama; anti-cheat tidak terganggu. ### 2.4 Cosmic Events (acak, tidak menempel di satu titik) Drama kosmik muncul **secara acak & bergerak**, bukan di titik itu-itu saja: ``` COSMIC EVENT โ†’ posisi & waktu acak (seed / state version) โ†’ masuk event + replay โ”œโ”€โ”€ Meteor shower (acak, bisa jadi hazard) โ”œโ”€โ”€ Badai bintang / flare (periodik relatif terhadap orbit, analog "musim") โ”œโ”€โ”€ Aurora / rasi terang (atmosferik, kosmetik) โ””โ”€โ”€ Puing anomali lewat (bisa diselidiki โ†’ gameplay) ``` Musim analog di bumi: ketika planet berada di fase orbit tertentu (mis. mendekati matahari), kondisi sistem berubah ("badai bintang") โ€” periodik nyata berbasis orbit, bukan kaku di koordinat tetap. > Implementasi orbit & event hidup di `packages/gameserver/environs.ts` + > `cosmic-event.ts` (lihat progres arsitektur & MMO-IMPLEMENTATION). ### 2.5 Dua Skala Koordinat (jangan dicampur) Koordinat **tata surya** dan koordinat **kapal/lokal** adalah dua konteks yang berbeda dan TIDAK dicampur: ``` SKALA SYSTEM (kerangka dev) SKALA LOKAL (buat pemain) โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€ โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€ Posisi benda langit (orbit) Posisi kapal (x,y,z) instruksi Skala raksasa (sistem bintang) Skala medan/combat Dipakai untuk mengatur & menghitung Dipakai untuk pergerakan, jarak, benda langit combat, interaksi pemain kerangka internal (implementasi) kerangka operasional pemain ``` * Benda langit ditaruh & dihitung pada skala system (juga jadi landasan gravitasi & termal, ยง2.6). * Kapal bergerak pada skala lokal; server tetap otoritas posisi (D-008). * Keduanya hidup dalam satu region (D-015), tapi representasi & skala-nya terpisah, agar tidak rancu antara "orbit sebuah planet" dan "kapal yang di sini". ### 2.6 Fisika Tata Surya (nama ilmiah, bukan istilah buatan) Tata surya disimulasikan dengan **hukum fisika nyata** agar konsisten & bisa diprediksi. Yang digunakan ARCLUX (nomenklatur fisika, supaya pembaca paham arti sebenarnya): ``` NEWTONIAN GRAVITY (gravitasi Newton) massa(m) โ†’ gaya gravitasi F = Gยทmโ‚ยทmโ‚‚ / rยฒ โ†’ memengaruhi benda langit satu sama lain di skala system KEPLER ORBITS (hukum Kepler) orbit elips benda langit mengikuti lintasan yang deterministik terhadap waktu RADIATION / THERMAL ENERGY (radiasi & energi termal) matahari memancarkan radiasi; energi termal yang diterima kapal โˆ 1/rยฒ (jarak) โ†’ suhu benda/materi naik saat mendekat MATERIAL LIMIT / MELTING (batas material & pelelehan) tiap material/subsystem punya batas ketahanan suhu (thermal tolerance) โ†’ melewatinya = thermal damage / melting (masuk damage lingkungan, lihat [03](https://github.com/GSF-001/ARCLUX/blob/main/03-combat.md) I.9) ``` Contoh peta konsekuensi (bukan statis `damage=100/sec`): ``` STAR ACTIVITY โ†“ ENERGY / PLASMA EVENT (solar wind ยท coronal mass ejection ยท flare) โ†“ PROPAGATES THROUGH SYSTEM (merambat lewat ruang) โ†“ SHIP DETECTS / IS EXPOSED (kapal bisa melihat datangnya & bereaksi) โ†“ SYSTEMS & MATERIALS AFFECTED (termal โ†’ material limit โ†’ melt) โ†“ PLAYER MUST REACT (ubah rute ยท berlindung ยท atau memanfaatkan kondisi) ``` > **Kapal imun terhadap gravitasi Newton** (skala system): gravitasi benda langit > dipakai untuk posisi/orbit benda langit (skala system, ยง2.5), TAPI tidak > "menarik" kapal di skala lokal. Kapal bergerak bebas/manuver. Sumber imunitas > ini dijamin oleh **ARCLUX Universal Baseline** (lihat > [05](https://github.com/GSF-001/ARCLUX/blob/main/05-vessel-design-dashboard.md) ยง7) โ€” bukan state acak. Pemisahan ini dibuat > agar kapal tidak terseret orbit (ribet), sementara lingkungan tetap > disimulasikan dengan fisika penuh. > Istilah ilmiah dipakai (gravitasi Newton, hukum Kepler, radiasi termal, solar > wind, coronal mass ejection) supaya desain bisa dibaca & diverifikasi dengan > benar, bukan nama-nama fantasi. Penerapannya tetap *gameplay-first* dan > deterministik per tick (D-008, D-016). *** ## 3. Abstraction Zoom System Zoom bukan sekadar memperbesar objek โ€” zoom mengubah **level abstraksi software** yang ditampilkan. ``` ๐ŸŒŒ UNIVERSE โ†“ ๐Ÿ—บ๏ธ SECTOR โ†“ โ˜€๏ธ SYSTEM โ†“ โš”๏ธ BATTLEFIELD โ†“ ๐Ÿš€ VESSEL โ†“ โš™๏ธ SUBSYSTEM โ†“ ๐Ÿ“ฆ COMPONENT โ†“ ๐Ÿ”— MODULE / GRAPH โ†“ ๐Ÿ“„ FILE โ†“ ๐Ÿ’ป CODE ``` Contoh: ``` Universe โ†“ zoom System โ†“ zoom Project Aurora โ†“ zoom Engine โ†“ zoom engine.ts โ†“ zoom initialize() ``` **Camera itu sendiri menjadi metode navigasi arsitektur software.** *** ## 4. Spatial Navigation **Free Camera:** * Mouse โ€” camera orientation * WASD โ€” movement * Q/E โ€” vertical movement * Shift โ€” boost * Space โ€” brake/stop * Scroll โ€” zoom **Navigation:** * M โ€” universe map * J โ€” jump/navigation * F โ€” follow selected object * T โ€” target/lock * C โ€” scan * D โ€” dock/interact * Esc โ€” exit current interaction *(Usulan kontrol, bukan kontrol ARCLUX yang sudah ada.)* *** ## 5. Semantic Navigation ARCLUX mendukung navigasi antara representasi spatial dan software. ``` ๐Ÿš€ Vessel โ†“ โš™๏ธ Engine โ†“ ๐Ÿ“ฆ Component โ†“ ๐Ÿ”— Dependency โ†“ ๐Ÿ“„ File โ†“ ๐Ÿ’ป Code ``` Dan sebaliknya: ``` ๐Ÿ’ป Code โ†“ ๐Ÿ“„ File โ†“ ๐Ÿ“ฆ Component โ†“ โš™๏ธ Subsystem โ†“ ๐Ÿš€ Vessel โ†“ ๐ŸŒŒ Universe ``` User yang sedang menginspeksi fungsi dapat memilih **"Show in Universe"** dan kamera berjalan ke vessel/component terkait. *** ## 6. Vessel Control Model penerbangan spatial dasar: ``` W Forward S Reverse A/D Strafe Q/E Vertical movement Shift Boost Space Brake Mouse Look ``` Model penerbangan dapat disesuaikan dengan aturan simulation. Client mengontrol presentasi/input sementara world-state yang authoritative menentukan hasil valid. *** ## 7. Tactical Overview Overview taktis khusus: ``` TARGET โ•ญโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ•ฎ โ”‚ ๐Ÿš€ โ”‚ โ•ฐโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ•ฏ 12.4 km [LOCK] [FOLLOW] [SCAN] ๐Ÿš€ A ๐Ÿš€ B \ / \ / \ / โ”€โ”€ battlefield โ”€โ”€ ``` Overview menyediakan: * daftar target * jarak * kecepatan/arah * status subsystem * anggota fleet * objek terdekat * world events yang relevan *** ## 8. Combat Interaction Combat memisahkan intent user, simulation, dan visualisasi. ``` USER INPUT โ†“ ATTACK REQUEST โ†“ WORLD VALIDATION โ†“ SIMULATION โ†“ DAMAGE EVENT โ†“ CLIENT A โ”€โ”€โ†’ RENDER CLIENT B โ”€โ”€โ†’ RENDER ``` Client **tidak pernah** menjadi otoritas penentu apakah attack benar terjadi. *** ## 9. Weapon Interaction Weapon/component mengekspos capability. ``` 1 2 3 4 5 6 โ”‚ โ”‚ โ”‚ โ”‚ โ”‚ โ”‚ W1 W2 W3 W4 W5 W6 ``` *(Usulan kontrol:)* * 1โ€“6 โ€” weapon/component slots * Tab โ€” cycle targets * T โ€” lock target * C โ€” scan * R โ€” reload/cooldown action * G โ€” tactical overview Input ini hanya mewakili **intent**. Perilaku weapon aktual ditentukan oleh validated simulation rules (lihat [03-combat.md](https://github.com/GSF-001/ARCLUX/blob/main/03-combat.md)). *** ## 10. Combat Visual Language User mendefinisikan capability/component. ARCLUX menentukan **archetype visual** yang terstandardisasi: ``` CAPABILITY โ†“ COMBAT RENDERER โ”œโ”€โ”€ Projectile โ”œโ”€โ”€ Beam โ”œโ”€โ”€ Missile โ”œโ”€โ”€ Drone โ””โ”€โ”€ Area Effect ``` Visual merepresentasikan hasil simulation โ€” ia tidak menentukan hasil. Efek impact yang mungkin: * shield flash * sparks * electrical effects * smoke * subsystem shutdown * directional impact * debris * controlled explosion Visual layer tetap cinematic sementara simulation tetap deterministic. *** ## 11. Subsystem Visualization Bukan cuma satu HP bar: ``` ENGINE 82% NAVIGATION 91% WEAPONS 64% DEFENSE 48% REACTOR 77% ``` Subsystem damage memengaruhi: 1. world-state 2. representasi visual ``` DEFENSE 48% โ†“ shield instability โ†“ visual flicker โ†“ component/module impact โ†“ developer inspection ``` *** ## 12. Developer Inspection Mode World yang sama bisa berpindah ke interface developer-oriented. ``` VESSEL โ†“ SUBSYSTEM โ†“ COMPONENT โ†“ MODULE โ†“ DEPENDENCY GRAPH โ†“ FILE โ†“ CODE ``` *(Usulan shortcut:)* * H โ€” health/subsystem view * G โ€” dependency graph * I โ€” vessel information * P โ€” provenance * L โ€” license/component information * O โ€” module/file inspection * B โ€” battle/history *(Usulan UX controls.)* *** ## 13. Focus / Dive Navigation Aksi Focus/Dive masuk semakin dalam ke lapisan abstraksi. ``` ๐Ÿš€ Vessel โ†“ โš™๏ธ Engine โ†“ ๐Ÿ“ฆ Component โ†“ ๐Ÿ”— Dependency โ†“ ๐Ÿ“„ File ``` Aksi yang sama digunakan sebaliknya untuk zoom out. Ini bisa menjadi **signature ARCLUX interaction**. *** ## 14. Jump / Teleport System Teleportasi ada sebagai navigasi spatial dan semantik. **Spatial Jump:** ``` SYSTEM A โ†“ JUMP GATE โ†“ SYSTEM B ``` Termasuk: destination selection, jump preparation, transition, arrival, world-state synchronization. **Semantic Jump:** ``` File โ†“ Component โ†“ Vessel โ†“ System ``` User dapat langsung mencari representasi fisik dari software yang sedang diinspeksi. > **Tipe teleport lain โ€” Mobilisasi Konflik (bukan navigasi):** selain jump gate > (navigasi antar system) dan semantic jump, ada **teleport mobilisasi** untuk > merespon konflik (2-teleport: ke titik + balik titik asal, lihat > [06](https://github.com/GSF-001/ARCLUX/blob/main/06-community-social-ownership.md) ยง18.8). Ia beda kategori: bukan > pindah-pindah bebas, punya cooldown panjang, dan menampilkan animasi portal. *** ## 15. Stations Station = persistent social/developer hub. ``` ๐Ÿ›ฐ ARCLUX STATION โ”‚ โ”œโ”€โ”€ ๐Ÿงฉ Component Exchange โ”œโ”€โ”€ ๐Ÿ›  Maintenance / Repair โ”œโ”€โ”€ ๐Ÿ‘ฅ Community Hub โ”œโ”€โ”€ ๐Ÿ“œ History Archive โ”œโ”€โ”€ ๐Ÿ› Hall of Fame โ”œโ”€โ”€ ๐Ÿš€ Fleet Dock โ”œโ”€โ”€ ๐Ÿ”ฌ Analysis Lab โ””โ”€โ”€ ๐ŸŒŒ Observatory ``` Station bukan sekadar menu โ€” ia adalah lokasi fisik di universe. *(Detail selengkapnya di [02-station-infrastructure.md](https://github.com/GSF-001/ARCLUX/blob/main/02-station-infrastructure.md).)* *** ## 16. Analysis Lab Station mengekspos repository intelligence sebagai in-world interface. ``` PROJECT AURORA Architecture 94% Health 87% Security 91% Dependencies 2,481 Impact Radius 17 ``` User dapat menginspeksi architecture langsung dari station โ€” jembatan antara developer tooling dan spatial world. *** ## 17. Fleet & Community Spaces Komunitas memiliki shared space. ``` COMMUNITY โ†“ FLEET โ†“ STATION โ†“ VESSELS โ†“ COMPONENTS ``` Station merepresentasikan aktivitas & sejarah komunitas tanpa ARCLUX membuat kontennya secara manual. *** ## 18. Wreckage Visualization Kapal hancur meninggalkan wreckage historis yang persisten. ``` BATTLE โ†“ VESSEL DESTROYED โ†“ WRECKAGE โ†“ RECOVERY โ†“ HISTORICAL ARCHIVE ``` ``` ๐Ÿงฉ WRECKAGE Project Aurora Destroyed: Battle #182 Recovered Components: 17 Historical Events: 4 Last State: Commit a83f91 ``` Wreckage tetap dapat ditemukan secara fisik di universe. *(Detail di [04-wreckage-history.md](https://github.com/GSF-001/ARCLUX/blob/main/04-wreckage-history.md).)* *** ## 19. Hall of Fame Hall of Fame = museum sejarah, bukan hanya leaderboard. Kategori: * legendary vessels * major battles * historic components * recovered components * retired vessels * famous communities * important events * notable wreckage Tujuan: sejarah itu sendiri menjadi bagian dari persistent universe. *** ## 20. Universal Cockpit HUD & Adaptive Context > **Cockpit tetap universal. Kapal tetap unik.** (Extension V5, varian API-first) ARCLUX memisahkan **kontrol universal** dari **kemampuan kapal**: ``` KONTROL UNIVERSAL โ‰  KEMAMPUAN KAPAL ``` Semua kapal memakai bahasa kontrol yang sama; kemampuan tambahan ditentukan oleh kapal & komponennya. ### 20.1 Standard Control API Kontrol dasar direpresentasikan sebagai intent standar: ``` move ยท target ยท scan ยท dock ยท activate ยท navigate ยท manage ``` ``` PLAYER โ†’ CONTROL โ†’ PLAYER INTENT โ†’ WORLD VALIDATOR โ†’ ACCEPT | REJECT โ†’ SIMULATION ``` Client tidak menentukan apakah tindakan berhasil. ### 20.2 Ship Capability Registry Setiap kapal mengekspos daftar capability-nya. Client membangun interface dari registry ini, bukan hard-code tiap tombol: ``` GET SHIP STATE โ†’ { vessel, capabilities: ["targeting","scan","phase_shift","emergency_repair"] } ``` Kapal berbeda punya capability berbeda, tapi kontrol dasar tetap sama. ### 20.3 Three-Layer Model ``` Layer 1 โ€” Control : apa yang pemain minta (MOVE/ATTACK/SCAN/ACTIVATE) Layer 2 โ€” Capability: apa yang kapal mampu (weapon/shield/scanner/custom/special) Layer 3 โ€” World Rules: apa yang dunia izinkan (auth/cooldown/range/damage/ component/ownership/safe zone/state version) ``` ``` PLAYER INTENT โ†’ CAPABILITY โ†’ WORLD VALIDATOR โ†’ SIMULATION โ†’ WORLD STATE ``` ### 20.4 Dynamic & Standard Slots Posisi kontrol dasar konsisten di semua kapal; isi slot berubah per kapal: ``` VESSEL A: [Laser] [Shield] [Scan] [Repair] VESSEL B: [Missile][ECM] [Boost] [Special] ``` Capability state tampil di slot (pola sama): `AVAILABLE ยท ACTIVE ยท COOLDOWN ยท DISABLED ยท DAMAGED ยท DEPLETED` ### 20.5 UI Bukan Sumber Kebenaran Kemunculan tombol โ‰  aksi pasti berhasil. Saat tombol `SPECIAL` ditekan: ``` ACTIVATE_CAPABILITY โ†’ VALIDATOR (exists? authorized? cooldown? uses? component condition? ship state? world rules?) โ†’ ACCEPT | REJECT ``` Client mengirim **REQUEST** (bukan "berhasil"); server menentukan hasil. ### 20.6 Capability Terhubung Dunia & Provenance Capability yang melekat pada komponen mewarisi sistem provenance (V4/07): component โ†’ capability โ†’ vessel โ†’ battle โ†’ wreckage โ†’ recovery โ†’ vessel baru. Damage pada komponen โ†’ degradation/disable capability (lihat ยง11 subsystem viz di bawah & 07). ### 20.7 Adaptive Context (tetap berlaku) HUD berubah sesuai konteks โ€” exploration, combat, developer inspection: **Exploration:** ``` [MAP] [SCAN] [JUMP] ``` **Combat:** ``` [TARGET] [LOCK] [WEAPONS] [DEFENSE] [TACTICAL] ``` **Developer Inspection:** ``` [GRAPH] [IMPACT] [FILES] [HISTORY] [PROVENANCE] [CODE] ``` Mencegah interface menjadi overload permanen โ€” pemain tidak belajar ulang HUD tiap ganti kapal; ia hanya mempelajari capability baru yang tampil di layout universal. ### 20.8 Identitas Sosial di HUD Overlay menampilkan identitas sosial setiap kapal agar kawan vs lawan langsung terbaca (data authoritative server, label = representasi client): ``` [KOMUNITAS A] [GSF-xxxx] [username] โ—„ faksi prefix pilot ``` Detail: [06 ยง18.6](https://github.com/GSF-001/ARCLUX/blob/main/06-community-social-ownership.md). Label tidak menandakan pemenang/loser โ€” murni penanda identitas. ### 20.9 Titik & Intel di HUD Pemain dapat melihat & membagikan **titik (koordinat/waypoint/titik kumpul)** serta menerima peringatan konflik (mobilisasi armada). Lihat [06 ยง18.7](https://github.com/GSF-001/ARCLUX/blob/main/06-community-social-ownership.md). Tampil sebagai tactical marker di ruang (01 ยง2) + info panel yang ber-label nama kapal/org pengirim. Aturan tetap: client mengirim **request**; server menentukan validitas & hasil (01 ยง20.5) โ€” koordinat/pergerakan bukan keputusan client. *** ## 21. Camera Modes Mode kamera yang disarankan: * **Free Camera** โ€” eksplorasi spatial penuh * **Follow Camera** โ€” mengikuti vessel/object * **Tactical Camera** โ€” kesadaran battlefield * **Cinematic Camera** โ€” untuk event combat besar * **Developer Camera** โ€” dioptimalkan untuk inspeksi arsitektur/component * **Map Camera** โ€” navigasi universe/system tingkat tinggi *** ## 22. Level of Detail Rendering beradaptasi sesuai jarak & konteks. ``` FAR ๐ŸŒŒ simplified universe objects โ†“ MID ๐Ÿช system + vessels โ†“ NEAR ๐Ÿš€ detailed vessel โ†“ INSPECTION โš™๏ธ subsystem/component โ†“ DEVELOPER ๐Ÿ”— graph + code ``` Kekompleksan rendering bisa berubah tanpa mengubah kebenaran simulation. Berlaku juga untuk benda langit (ยง2): pada `FAR`/`MID`, planet & backdrop body dirender simplified (mesh/lightness rendah); posisi orbit tetap milik state dunia yang sama (ยง2.3) โ€” detail visual โ‰  otoritas posisi. *** ## 23. Input Philosophy Kontrol selalu mewakili **intent**, bukan **authority**. ``` PRESS "1" โ†“ activate weapon #1 โ†“ server/world validator โ†“ valid? โ”œโ”€โ”€ YES โ†’ event โ””โ”€โ”€ NO โ†’ rejected ``` Mempertahankan arsitektur combat server-authoritative (lihat [03-combat.md](https://github.com/GSF-001/ARCLUX/blob/main/03-combat.md)). *** ## 24. Unified World Architecture Seluruh UX direpresentasikan sebagai: ``` ARCLUX WORLD โ”‚ WORLD MODEL โ”‚ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ†“ โ†“ โ†“ SPATIAL VESSEL SOFTWARE LAYER STATE GRAPH โ”‚ โ”‚ โ”‚ ๐ŸŒŒ ๐Ÿช ๐Ÿ›ฐ ๐Ÿš€ ๐Ÿš€ โš™๏ธ ๐Ÿ›ก๏ธ ๐Ÿ”— ๐Ÿ“ฆ ๐Ÿ“„ ๐Ÿ’ป โ”‚ โ”‚ โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ†“ DEVELOPER โ†” WORLD ``` State yang sama menggerakkan: * visualisasi universe * vessel state * combat * component state * dependency inspection * damage analysis * history * provenance * **cosmic environment** (orbit benda langit & fase bulan adalah state dunia yang sama โ€” deterministik per tick seperti combat; lihat ยง2.3) *** ## 25. Core UX Principle > **"Every navigation action should preserve context."** Moving dari: ``` Universe โ†’ System โ†’ Vessel โ†’ Component โ†’ Code ``` harus terasa seperti bergerak melalui satu dunia yang kontinu. Demikian juga: ``` Code โ†’ Component โ†’ Vessel โ†’ System โ†’ Universe ``` harus mengembalikan developer ke representasi spatial dari software yang sama. *** ## 26. Proposed Experience Loop ``` BUILD โ†“ CONNECT REPOSITORY โ†“ VESSEL GENERATED โ†“ EXPLORE โ†“ DEVELOP โ†“ COMMIT โ†“ VESSEL EVOLVES โ†“ COLLABORATE โ†“ TRADE / TRANSFER โ†“ COMPETE โ†“ BATTLE โ†“ DAMAGE โ†“ DEBUG โ†“ COMMIT REPAIR โ†“ VESSEL RECOVERS โ†“ HISTORY โ†บ ``` Distingsi penting: **software development itu sendiri menjadi bagian dari progression.** *** ## 27. Design Identity Tujuan bukan: > "Make ARCLUX look exactly like EVE Online." Melainkan: > "Use established spatial/tactical space-sim conventions as UX inspiration, > while making software architecture the native language of ARCLUX." Game space konvensional bertanya: > "Where is my ship?" ARCLUX juga harus bisa bertanya: > "Where is this code in my universe?" Distingsi ini menjadi fondasi identitas visual ARCLUX sendiri. *** ## 28. UI Command-Interface (EVE-level, bukan web dashboard) > *"The interface should feel like operating an engineering system, not browsing > a website."* โ€” prinsip kunci UI ARCLUX. ARCLUX adalah **game desktop MMO**, bukan aplikasi web. UI diarahkan ke **command interface / operational console** yang cinematic & data-dense, terinspirasi benchmark EVE Online โ€” bukan "modern dashboard" klasik. **Bahasa desain yang TEPAT (jangan diterjemahkan sebagai kartu SaaS):** * Cinematic Sci-Fi Command Interface * Spatial Data Visualization โ€” informasi hidup dalam ruang (bukan kotak kartu) * Tactical / Operational HUD โ€” data-dense tanpa berbentuk dashboard card * Industrial / Technical visual language โ€” hindari glassmorphism & plastik * Layered visualization: environment ยท system state ยท graph ยท telemetry ยท controls * Cinematic depth: lighting, atmospheric effects, motion, depth * Adaptive information density (sederhana saat idle, padat saat beroperasi) ``` ARCLUX INTERFACE ARCHITECTURE โ”œโ”€โ”€ Spatial UI โ”œโ”€โ”€ Data-Dense HUD โ”œโ”€โ”€ Command-Centric Interaction โ”œโ”€โ”€ Layered Visualization โ”œโ”€โ”€ Cinematic Depth โ”œโ”€โ”€ Technical / Industrial Material โ””โ”€โ”€ Adaptive Information Density ``` > Benchmark visual = EVE Online (bukan web app). Desktop penuh, data-dense, tanpa > batasan "komponen ringan ala mobile". Bukan "poster tempelan" โ€” environment > & depth yang memberi sense of scale, hierarchy, dan interaksi. *** ## Final Concept ``` ๐ŸŒŒ ARCLUX UNIVERSE โ”‚ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ โ”‚ SPATIAL SOFTWARE WORLD WORLD โ”‚ โ”‚ ๐Ÿš€ VESSEL โ†โ†’ ๐Ÿ”— CODE โ”‚ โ”‚ โš”๏ธ COMBAT โ†โ†’ ๐Ÿ’ฅ IMPACT โ”‚ โ”‚ ๐Ÿงฉ COMPONENT โ†โ†’ ๐Ÿ“ฆ MODULE โ”‚ โ”‚ ๐Ÿ› HISTORY โ†โ†’ ๐Ÿ“œ GIT ``` **One world. Two perspectives. One source of truth.** > Users create the software. > ARCLUX gives it form. > The universe gives it history. ``` ``` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.