https://github.com/yuuka-dev/kspdeltavformods
Delta-V calculator for Kerbal Space Program 1 planet pack mods — parses Kopernicus configs and computes orbital mechanics with atmospheric modeling
https://github.com/yuuka-dev/kspdeltavformods
Last synced: 2 months ago
JSON representation
Delta-V calculator for Kerbal Space Program 1 planet pack mods — parses Kopernicus configs and computes orbital mechanics with atmospheric modeling
- Host: GitHub
- URL: https://github.com/yuuka-dev/kspdeltavformods
- Owner: yuuka-dev
- License: mit
- Created: 2026-03-25T19:28:09.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-04-03T04:32:19.000Z (3 months ago)
- Last Synced: 2026-04-03T11:23:33.813Z (3 months ago)
- Language: Python
- Size: 363 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 5
-
Metadata Files:
- Readme: README-id.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
[English](README.md) | [日本語](README-ja.md)
# KSPDeltaVForMods
[](https://opensource.org/licenses/MIT)
[](https://www.python.org/)
> Kalkulator delta-v untuk mod planet pack KSP1 berbasis Kopernicus
## Gambaran Umum
KSPDeltaVForMods mem-parsing file `.cfg` Kopernicus dan menghitung nilai delta-v mekanika orbital termasuk peluncuran ke orbit, transfer Hohmann, pembakaran lepas, dan rasio massa dengan pemodelan atmosfer lengkap.
### Mengapa dibuat?
Peta delta-v tersedia untuk KSP vanilla, tetapi tidak untuk mod planet pack. Jika Anda memasang planet pack seperti Celestial Harmony, tidak ada referensi berapa banyak delta-v yang dibutuhkan untuk mencapai orbit atau transfer antar planet. Alat ini membaca file konfigurasi Kopernicus dari mod dan menghitung semuanya secara otomatis.
## Fitur Utama
- **Parser Kopernicus ConfigNode** -- Menangani modifier, komentar, nested node, dan kunci AnimationCurve
- **Mesin Perhitungan Delta-V** -- Peluncuran ke orbit, transfer Hohmann, kecepatan lepas, persamaan roket Tsiolkovsky
- **Pemodelan Atmosfer** -- Interpolasi cubic Hermite spline yang kompatibel dengan AnimationCurve KSP
- **CLI Interaktif** -- Navigasi pohon benda langit dan hitung rute antar benda langit
- **Pemindai GameData** -- Memindai direktori GameData KSP secara rekursif dan menyimpan data yang di-parse sebagai JSON
- **Frontend GUI** -- SPA Vue 3 dengan 8 halaman dan visualisasi rute ΔV gaya peta subway interaktif menggunakan D3.js
- **Aplikasi Desktop** -- Executable Windows dari Tauri v2; tidak perlu menginstal toolchain frontend
## Tumpukan Teknologi
| Lapisan | Teknologi | Catatan |
|---------|-----------|---------|
| Library Inti | Python 3.10+ | Tanpa dependensi eksternal |
| CLI | Python standalone | `python run.py` -- tidak perlu pip install |
| Backend API | FastAPI + Uvicorn | Swagger UI tersedia di `/docs` |
| Frontend | Vue 3 + Vite + TypeScript | PrimeVue Aura Dark, vue-i18n (ja/en/id), D3.js |
| Desktop | Tauri v2 (Rust) | `.exe` Windows via GitHub Releases |
## Memulai
### Prasyarat
- Python 3.10 atau lebih baru (wajib untuk semua mode termasuk aplikasi desktop)
### Aplikasi Desktop
Unduh installer `.exe` Windows terbaru dari [GitHub Releases](https://github.com/yuuka-dev/KSPDeltaVForMods/releases). Python 3.10+ harus terinstal di mesin Anda -- aplikasi akan menjalankan backend Python secara otomatis.
### Penggunaan CLI
```bash
git clone https://github.com/yuuka-dev/KSPDeltaVForMods.git
cd KSPDeltaVForMods
python run.py --scan /path/to/KSP/GameData
python run.py --interactive
```
Anda juga dapat menghitung delta-v untuk satu file konfigurasi:
```bash
python run.py sample_configs/Sanctar.cfg
```
### Pengembangan Frontend
```bash
# Jalankan backend API
pip install -e ".[api,dev]"
uvicorn api:app --reload --port 8000
# Jalankan dev server frontend
cd frontend && pnpm install && pnpm dev
```
## Catatan KSP2
Alat ini hanya menargetkan KSP1 + Kopernicus. KSP2 tidak didukung dan tidak ada rencana untuk mendukungnya.
## Lisensi
[MIT](LICENSE)