English · 简体中文
Kēne (/keːne/) is a native visual novel engine written in Rust. It uses Bevy and wgpu for rendering and supports directory-based development projects and self-contained desktop releases.
- Native rendering, audio, video, UI, saves, backlog, Auto, Skip, and rollback.
- Backgrounds, portraits, layers, transitions, filters, particles, and regional blur.
- Frame-rate-independent dialogue, animation, and timeline playback.
- WebGAL scripts and LetsGal projects through independent loader adapters.
- Encrypted incremental release packages powered by Hakutaku.
Kēne requires Rust 1.97.1.
git clone https://github.com/maincoretech/keine.git
cd keine
cargo validate projects/test-project
cargo dev projects/test-projectUse cargo run -- dev projects/test-project when FFmpeg development libraries
are unavailable. The visual acceptance checklist is in
projects/test-project/ACCEPTANCE.md.
| Command | Purpose |
|---|---|
cargo validate <project> |
Validate a project without opening a window |
cargo dev <project> |
Run a project with development tools and hot reload |
cargo dev <project> --sync |
Follow an open LetsGal project |
cargo bundle <project> |
Build a distributable game |
cargo bundle --remap-assets <project> <old=new>... |
Safely migrate converted asset references |
cargo adapters |
Configure built-in adapters |
cargo perf <project> |
Capture a runtime performance sample |
| Project type | Root entry |
|---|---|
| Native / WebGAL directory | config.yaml |
| LetsGal project | project.json |
| Packaged game | game.haku with sibling data/ |
Development runs read the editable project directory directly. A normal game workflow is:
- Edit the native/WebGAL directory or LetsGal project.
- Run
cargo validate <project>after script or configuration changes. - Iterate with
cargo dev <project>; add--syncfor an open LetsGal project. - Build the release with
cargo bundle <project>. - Run the generated release before distributing the complete output directory.
The default release is written to target/release-package/:
target/release-package/
├── keine[.exe]
├── game.haku
├── data/
│ └── <content-id>.taku
└── run.sh | run.bat
cargo bundle invokes Hakutaku automatically; game developers do not need to
run a separate packer. The first bundle creates
.keine/publisher.hakutaku-key. Back up this file and keep it outside the
distributed game. Later bundles reuse unchanged content segments when the
previous output is available.
Create a macOS application bundle with:
dev/scripts/bundle-macos.sh path/to/projectAfter converting audio or images offline, migrate their project references without adding a runtime fallback:
# Preview the path and size changes, then ask for confirmation.
cargo bundle --remap-assets path/to/project wav=opus png=webp
# Print the same preview and apply it without prompting.
cargo bundle --remap-assets path/to/project wav=opus png=webp -yEvery converted target must already exist beside its source. The preview shows
the old path in red, the new path in green, old size → new size, and the size
change percentage. Apply mode backs up every changed source below
.keine/asset-remap-backups/, replaces files atomically, and reopens the
project for validation. Failed validation restores the originals. The command
does not convert, rename, delete, or select fallback assets.
| Shortcut | Action |
|---|---|
Ctrl+A / Ctrl+K |
Auto / Skip |
Ctrl+B / Ctrl+R |
Backlog / replay voice |
Ctrl+H |
Hide or restore the textbox |
Ctrl+Q / Ctrl+L |
Quick save / quick load |
Ctrl+S / Ctrl+O |
Save / load |
Ctrl+, / Ctrl+T |
Settings / title |
hold Ctrl |
Fast-forward |
Esc |
Close or go back |
| Path | Contents |
|---|---|
src/ |
Runtime, rendering, UI, media, and storage |
crates/core/ |
Typed action model and execution state |
crates/loader/ |
Project, script, asset, and save adapters |
projects/test-project/ |
End-to-end acceptance project |
dev/ |
Architecture notes and platform scripts |
The runtime depends on keine-loader and keine-core; the core crate remains
independent from Bevy.
cargo build --release
cargo fmt --all --check
cargo clippy --workspace --all-targets -- -D warnings
cargo test --workspace
cargo validate projects/test-projectVideo builds require the relevant native media libraries. Ogg Opus is the recommended distributed audio format: project Opus assets use a reopenable, seekable incremental decoder, including bounded-memory loops. WAV, MP3, Ogg Vorbis, and FLAC remain memory-backed; their shared byte-length-aware decoder provides duration, bounded-memory loops, and random-access seeking in the Extra gallery without loading a second compressed copy.