​

11 — VESSEL FITTING UX (ekstraksi pola Pyfa → model ARCLUX)

Status: DESIGN REFERENCE — pola boleh, kode tidak. Tanggal: 2026-10-05. Induk: 05-vessel-design-dashboard.md (Vessel Design Dashboard), decisions-mmo.md (K1, D-007), MMO-CONTRACT.md §4.2. Referensi: github.com/pyfa-org/Pyfa — Python Fitting Assistant for EVE Online (1.8k★, 466 fork, 9.788 commit, aktif 2026-10-05). Ekosistem referensi EVE lain (Pathfinder, EveVision, Z-S Overview Pack): lihat §9.

​

0. Apa yang sebenarnya ditemukan di repo itu

​

1. Arsitektur Pyfa (4 lapis — bersih, dipetakan ke ARCLUX)

staticdata/   SQLite dogma EVE (item, attribute, effect)
     ↓
eos/          ENGINE: calc.py · capSim.py · effects.py ·
              eqBase.py · gamedata.py · modifiedAttributeDict.py
              saveddata/: fit · ship · module · drone · fighter ·
              cargo · character · implant · implantSet · booster ·
              damagePattern · targetProfile · mode · mutator ·
              override · citadel · price
     ↓
service/      fit · attribute · damagePattern · market · price ·
              targetProfile · prereqsCheck · esi · settings
              port/: dna · eft · efs · esi · multibuy · muta ·
              xml · shipstats  (import/export format!)
     ↓
gui/          mainFrame · fittingView · shipBrowser ·
              marketBrowser · statsViews · itemStatsViews ·
              patternEditor · propertyEditor · setEditor ·
              characterEditor · attribute_gauge · pyfa_gauge ·
              multiSwitch · chrome_tabs · esiFittings
graphs/       calc · events · data · gui · style (proyeksi
              kapasitor/DPS seiring waktu)

​

2. Pola yang diekstrak (the jackpot)

1. Slot model — kapal punya slot terstruktur (high/mid/ low/rig + drone bay + fighter + implant + booster). Setiap slot: tipe terbatas, constraint, satu module per slot.
2. Stat projection real-time — pasang/lepas module → semua stat dihitung ulang instan (eos/effects.py pipeline attribute modification, modifiedAttributeDict.py).
3. Capacitor simulation (eos/capSim.py) — simulasi konsumsi/regen kapasitor seiring waktu, bukan angka statis.
4. Damage patterns (saveddata/damagePattern.py + gui/patternEditor.py) — profil damage (EM/thermal/kinetic /explosive) → resistensi kapal dihitung terhadap profil.
5. Target profiles (saveddata/targetProfile.py) — lawan punya profil (ukuran, kecepatan) → akurasi/tracking dihitung.
6. Fit browser + tabs (fitBrowserLite, multiSwitch, chrome_tabs) — banyak fitting dibandingkan berdampingan.
7. Gauges (attribute_gauge, pyfa_gauge) — stat divisualisasikan gauge, bukan tabel mentah.
8. Fit code (service/port/: EFT, DNA, MUTA, XML, multibuy) — fitting = string terkompresi yang bisa diekspor/diimpor/dibagikan.
9. ESI integration (gui/esiFittings.py) — export fitting langsung ke game (in-game).
10. Mutator/override (saveddata/mutator.py, override.py) — varian module (mutaplasmid) dengan stat berubah.
11. Prereq check (service/prereqsCheck.py) — skill requirement sebelum module bisa dipakai.
12. Implant set / booster — buff set (implantSet) + booster dengan side-effect (boosterSideEffect.py).
13. Citadel (saveddata/citadel.py) — struktur pemain sebagai entitas fitting tersendiri.

​

3. Mapping 1:1 Pyfa → ARCLUX

​

4. Yang DILARANG (non-negotiable)

1. DILARANG copy kode Pyfa — GPL-3.0. Turunan Pyfa wajib GPL-3.0 → menginfeksi engine ARCLUX (Apache-2.0, live di npm) dan game (MMO License). Clean-room reimplementasi saja: baca polanya, tulis kode sendiri di TS.
2. DILARANG ship data EVE — seluruh staticdata/ Pyfa = dogma CCP (item name, attribute, effect). ARCLUX tidak boleh pakai data EVE; stat kapal ARCLUX di-derive dari analisis repo user (analyzeRepository → buildVesselModel), bukan dari dogma.
3. DILARANG pakai aset Pyfa (imgs/, logo) — bagian dari repo GPL + CCP copyright notice.
4. Pola desain (UX, arsitektur, algoritma concept) = boleh, itu tujuan dokumen ini.

​

5. Rencana eksekusi

Tidak menabrak blueprint 01–10 (larangan duplikasi): desain visual vessel/dashboard = 05 (11 hanya referensi, tidak re-spec visual); aplikasi damage = 03/combat.ts (11 punya proyeksi murni saja, tidak mutate); capabilities = 07 (fitCalc sudah integrasi via requiresCapability); client polish = 09 (fitting panel mengikuti penempatan client 09); validator = 03 (Fase 3 extend validator.ts, bukan duplikat).

​

Fase 1 — Engine calc (packages/universe, TS) ✅ SELESAI (PR #767)

• fitCalc.ts — component-effect pipeline: pasang/lepas ComponentBinding → hitung ulang SystemState.health
  • VesselModel stats (deterministic, pure function).
• capSim.ts — simulasi kapasitor per tick (konsumsi vs regen, depletion warning) — referensi capSim.py, implementasi sendiri.
• Slot constraint engine — tiap subsystem punya slot capacity; validator menolak overflow.
• Damage profile — incoming damage type → resistensi subsystem (referensi damagePattern.py).
• Regresi test: same input → same output (determinism law) — 40 test (tests/fit-calc.test.ts + tests/cap-sim.test.ts).

​

Fase 2 — Fitting panel IN-GAME (client) — D-027

UI fitting hidup di dalam game, bukan alat luar-game. Target final: UE5 (UMG, Fase 4). S/d UE5 ready: apps/game (Electron demo — penempatan client mengikuti blueprint 09: semua client work di apps/game/src/renderer/). apps/web BUKAN permukaan MMO (D-027) — tidak ada dashboard MMO di sana. Prioritas: setelah Fase 3 (fokus utama = game server); opsional sebagai demo.

• Slot grid UI (6 subsystem + component slots).
• Stat projection real-time (Fase 1 dipanggil per perubahan).
• Cap gauge + gauge widget (referensi pyfa_gauge).
• Fit browser + diff (bandingkan 2 vessel — pakai packages/semantic-diff).
• Export/import vessel definition (DSL .arclux).
• Prereq check UI (component requirement).

​

Fase 3 — Wire ke gameserver (PRIORITAS UTAMA — fokus game server) ✅ SELESAI (PR #772 + #773)

• Extend validator.ts (bukan duplikat — validator existing = move/dock/attack; tambah fit intents: equip/unequip dengan slot constraint + component prerequisite). — fitting.ts::validateFitIntent
• capSim server-side (authoritative — client hanya render proyeksi). — stepCapacitor per tick (formula capStep dari universe) + gate activate_capability saat kapasitor 0 (PR #773)
• Damage profile masuk combat.ts. — resist dari computeResists(fitted), cap MAX_RESIST, impact.resisted (PR #773)
• Persist vessel definition + verifikasi fitHash (server rekomputasi, tolak mismatch — anti-cheat). — stateHash = fitHash, persist via RegionSnapshot

​

Fase 4 — UE5 slice (eksekusi kode di UE5 dengan referensi ini)

• UMG Fitting Window: slot grid + stat projection + cap gauge (kontrak UI baru, mirror UE5Types.h: FUE5Component, FUE5Fit, FUE5CapState).
• Import/export fit code (DSL) via UUE5Transport.
• Server tetap TS authoritative — UE5 hanya render + kirim intent (D-008). Tidak ada calc di UE5.
• Acceptance: screenshot parity dashboard TS vs UE5 (banded, per 04-graphics.md).

​

6. Acceptance criteria

1. fitCalc deterministic: 2× run, hash identik (test CI).
2. Dashboard: pasang/lepas component → stat update <16ms (60fps interaction).
3. Validator menolak slot overflow + prerequisite tidak terpenuhi.
4. Export DSL → arclux connect → vessel termuat di region (e2e).
5. (Fase 4) Screenshot parity TS vs UE5 per tier.

​

7. Checklist verifikasi PR

[x] npx tsc --noEmit — bersih (universe, --strict)
[x] Regresi test determinism fitCalc — PASS (40/40, PR #767)
[x] Tidak ada kode/data Pyfa yang di-copy (GPL audit) — clean-room
[x] Tidak ada string/data EVE di kode (CCP audit) — bersih
[x] MMO-IMPLEMENTATION.md §2 + §3 di-update — Fase 3 (fitting.ts + kapasitor + combat resist — PR #772 + #773)
[x] decisions-mmo.md entry baru — D-026 (penempatan dashboard)
[x] docs/ di-add pakai git add -f

​

8. Referensi

• Pyfa: https://github.com/pyfa-org/Pyfa (GPL-3.0)
• eos/capSim.py, eos/effects.py, eos/saveddata/fit.py, service/port/eft.py, gui/builtinViews/fittingView.py
• Blueprint ARCLUX: 05-vessel-design-dashboard.md, 07-special-capabilities.md (V4), 06-community-social-ownership.md
• ARCLUX: packages/universe/stats.ts, packages/gameserver/capability.ts

​

9. Referensi ekosistem EVE (tambahan — pola saja)

1. DILARANG copy kode/data keempat repo — GPL-3.0 menginfeksi lisensi ARCLUX, dan isi datanya = dogma CCP (typeID EVE, nama kapal, faction). Clean-room reimplementasi saja.
2. DILARANG pakai teknik injection EveVision (minhook, DX hook, DLL inject) — ARCLUX adalah gamenya sendiri (apps/game Electron + apps/ue5 render sendiri), bukan overlay di game orang lain.
3. Plugin system EveVision = vaporware — README menjanjikannya sejak 2020, tidak ada di kode. Jangan dijadikan acuan; ARCLUX sudah punya registry-driven DSL (packages/dsl) sebagai basis plugin masa depan.
4. Pathfinder & Z-S bukan subjek blueprint 11 — hanya referensi silang; fitting (subjek dokumen ini) tetap mengacu ke Pyfa.