A downloadable, online companion for Star Citizen Alpha 4.9 — mining, ships, crafting and getting around, in a single HTML file.
An apsis is the point where an orbit reverses direction — the turn that sets up everything after it.
Live: hosted on GitHub Pages — link in the repo sidebar.
Or download apsis.html and open it locally. That's the whole installation. No server, no build step, no backend — the data is baked in, so it works on a second monitor while the game has your GPU, and it works with the network off.
The file is 1.5 MB but compresses to 254 KB over HTTP, so it loads like a normal page and then never talks to a server again.
| 307 ships and vehicles | every variant, with real hardpoints |
| 7,602 hardpoints | including nested slots (mounts → guns, lasers → modules) |
| 956 components | weapons, shields, power plants, coolers, quantum drives, mining gear |
| 1,588 blueprints | crafting recipes across 25 item types |
| 39 materials | signatures, instability, resistance, prices |
| 33 locations | across Stanton (17), Pyro (12) and Nyx (4) |
| 13 mining lasers · 27 modules · 6 gadgets | with their real modifier values |
| 5 cities · 31 shops | transit routes and what's sold where |
| 10 languages | 689 dictionary entries, 6,201 translations |
| 254 KB gzipped | loads once, then works offline |
Seven tabs covering the whole loop:
- Scanner — type the RS value your ship reads and get the mineral plus how many nodes are in the cluster. Handles ambiguous readings and mixed clusters.
- Signatures — a multiplier grid of every mineral × node count, searchable live. Built to sit on a second screen. Flags the 12 readings where two materials produce the identical number and tells you how to tell them apart.
- Where — pick one or several materials and see every location that has them, with each material's abundance shown per result. Sorts by coverage, total abundance, or expected rock value.
- Profitability — locations ranked by what the average rock you scan there is actually worth, and a per-location cheat sheet of which signatures are worth stopping for.
- Rocks — full composition of all 26 rock types including inert material, the filler the game never shows you. Plus a live evaluator: move the sliders to the percentages on your HUD and see how much of your hold is gravel.
- Loadout — pick a target material and get the laser + module combination that suits its instability and resistance, with alternatives ranked and trade-offs visible.
- Refinery — the nine refining methods compared, plus all 19 refinery locations.
Full configurator for all 307 hulls. Compatibility comes straight from the game files: if a component doesn't appear in a slot, it doesn't fit there. Nested slots work properly — gimbal mounts open to weapons, mining lasers open to their module bays, quantum drives open to jump drives.
Each slot opens a sortable comparison table with the stats that matter for that component type, showing the delta against what you have equipped. Shields display their per-damage-type resistances, weapons show sustained DPS alongside burst.
Every ship gets a scale schematic with hardpoint positions, a hangar class badge (S/M/L/XL), and a shareable build code you can paste to someone else.
1,588 recipes searchable in both directions: from an item to what it needs, or from a material to everything it goes into. Every ingredient drills down to price per SCU and where it's mined. Material cost is computed from refined averages; market prices are included where available, with automatic flags on the listings that are obviously junk.
Up to four ships side by side across 26 rows, with the best value in each row highlighted and rows where everything is equal left neutral.
The part nobody documents well: how to get from your bed to your ship. Lorville, Area18, New Babbage, Orison and the space stations, each with its transit network drawn out and a step-by-step route colour-coded by transport type.
The details that actually trip people up are in there — at the bottom of the Metro Center stairs in Lorville you turn right, at New Babbage you turn left, and you get off at the first stop. Plus what to do when the elevator won't respond or the train never comes.
Ctrl+K from anywhere. Searches ships, components, materials, recipes, locations and cities at once, and jumps you to the right panel with the right thing already selected.
This matters more than feature lists, so it's stated in the app too.
| Layer | Source | Confidence |
|---|---|---|
| Ships, hardpoints, compatibility, components, crafting recipes | Game files, build 4.9.0-LIVE.12232306 (StarCitizenWiki/scunpacked-data dump, 16 Jul 2026) |
Exact. No estimation. |
| RS signatures | Game2.dcb datamine |
Exact. |
| Location abundances | SCMINER, patch 4.9 | Community-sourced. May drift from live. |
| Refining methods, hangar specs | Star Citizen Wiki | Community-sourced, verified. |
| Material prices | UEX via SC DataHub, read 3 Aug 2026 | Refined sell averages. Stable enough for comparison. |
| Marketplace prices | UEX Marketplace snapshot, 1 Aug 2026 | A photograph, not a feed. Player classifieds with bait listings. |
| Loadout advisor scoring | Mine | A formula I wrote. Documented in the app. |
| Ship silhouettes | Mine | 18 hand-drawn archetypes by role, scaled to real dimensions. Not traced hull profiles. |
- No live prices. Shop inventories aren't in the game files, and UEX's item API needs a personal token. If you have one, the price layer drops in on top of what's already here.
- No hull geometry. The game files don't contain it, and tracing official renders would be reproducing CIG's artwork. The silhouettes are archetypes — you'll tell a fighter from a hauler, not a Cutlass from a Freelancer.
- Two ships have no dimensions (Javelin, Argo MOTH). Sources disagree, so rather than invent them the schematic is disabled for those two and everything else still works.
- Ice pricing is uncertain. The source only lists "Pressurized Ice" and the mapping isn't confirmed, so the conservative figure was kept.
- Long-form documentation stays in Italian when you switch language. The interface, labels, results, city routes and shop entries are all translated; the methodology essays inside the collapsible blocks are not, and the app says so.
Using the tool needs nothing. Rebuilding it needs Python 3.10+ and Node (for the test suites).
scdata/
├── extract2.py # game dump → dataset.json (ships, components, hardpoints)
├── shapes.py # 18 role silhouettes + role→family mapping
├── city.py # transit routes and shops
├── build_tool4.py # ship configurator
├── build_mining.py # mining terminal
├── build_craft.py # crafting terminal
└── build_app.py # merges everything into apsis.html
python3 extract2.py # needs ships.json + ship-items.json from the dump
python3 build_tool4.py
python3 build_mining.py
python3 build_craft.py
python3 build_app.py # → apsis.htmlThe merge step namespaces each tool into an isolated module — they were written independently and share global names — then injects the shared datasets once instead of three times.
Everything is static. Drop apsis.html (rename to index.html if you want a bare URL), preview.png and README.md in the repo and GitHub Pages serves it as-is.
One thing to set: SITE_URL at the top of build_app.py. It fills og:url, the canonical link and the absolute path to the preview image. Twitter/X and Facebook require absolute URLs for preview images; Discord and Slack resolve relative ones fine.
SITE_URL = 'https://<user>.github.io/<repo>/'Thirteen suites run against a real DOM (jsdom) plus a browser pass (Playwright) for layout and interaction. They've caught real bugs: labels that lost their input association, a function scoped out of reach of its own click handlers, a greedy regex eating half a file, IDs generated inside JS strings that never got prefixed.
node audit.js # cross-dataset integrity
node final_test.js # navigation and section bridges
node i18n_test.js # translation across all 10 languages
node check.py # browser layout and interactionTen languages: Italian (source), English, German, French, Spanish, Portuguese, Russian, Chinese, Japanese, Polish.
Translation happens after rendering, in the DOM, via a MutationObserver per section. The modules keep emitting Italian and the text gets swapped — which meant no rewrite of hundreds of concatenated strings across three independently-built tools.
Three things make it work beyond a flat dictionary:
- Segment translation. Labels like
Ship weapons · G1 · 3 ingredients · 28 minare assembled piece by piece; the combinations run into the thousands. Each segment is translated on its own and the string reassembled. - 39 dynamic patterns for anything with a number in it, since plurals differ per language.
- Normalisation of source line breaks and typographic apostrophes, both of which silently broke exact matches.
In-game terms the community uses in English stay in English: hardpoint, blueprint, loadout, quantum drive, SCU, aUEC, RS.
Corrections to the data are the most useful thing — especially abundance figures, shop inventories, and anything that shifts between patches. Feature ideas welcome too. Open an issue or a PR.
MIT. APSIS is an unofficial tool, not affiliated with Cloud Imperium Games. Star Citizen® is a trademark of Cloud Imperium Rights LLC.
gnmrclss