How xmoezzz/siglus_rs works
siglus_rs is a multi-engine visual-novel game reimplementation, with SiglusEngine as its primary focus and UK2, AVG32, and RealLive also supported. The main user flow is to import or select a game, identify its engine, and launch the corresponding runtime to load game data, execute scenes, present graphics and audio, and persist progress. The graph combines README-documented capabilities with sampled runtime evidence; several subsystem connections are documented or implied by module roles but their internal wiring was not sampled.
Main entry points: vm.rs Scene Execution · mod.rs Runtime Selection · resource.rs Resource Loading · lib.rs Game Library
Components 20
Game Launcher
- Game Library
crates/game_launcher/src/lib.rs - Engine Detection
crates/engine-detect/src/lib.rs - Runtime Selection
crates/game_launcher/src/runtime/mod.rs
Siglus Runtime
- Siglus Player
crates/siglus_scene_vm/src/bin/siglus_engine.rs - Scene Execution
crates/siglus_scene_vm/src/vm.rs - Scene Loading
crates/siglus_scene_vm/src/scene_stream.rs - Resource Loading
crates/siglus_scene_vm/src/resource.rs - Image Management
crates/siglus_scene_vm/src/image_manager.rs - Rendering
crates/siglus_scene_vm/src/render/mod.rs - Audio Playback
crates/siglus_scene_vm/src/audio/engine.rs - Sound Effects
crates/siglus_scene_vm/src/audio/sfx_engine.rs - Game Saves
crates/siglus_scene_vm/src/original_save.rs
Other Game Runtimes
- UK2 Engine
crates/uk2/src/lib.rs - AVG32 Engine
crates/avg32/src/engine.rs - RealLive Engine
crates/reallive/src/engine.rs
Assets and Media
- Game Filesystem
crates/game_fs/src/lib.rs - Siglus Asset Formats
crates/siglus_assets/src/lib.rs - Media Decoders
crates/na_mpeg2_decoder/src/lib.rs
Other components
- Player
- Game Files
Connections 22
- Player → Game Library: selects game
- Game Library → Game Files: imports files
- Game Library → Engine Detection: identifies engine
- Engine Detection → Runtime Selection: selects runtime
- Runtime Selection → Siglus Player: starts Siglus
- Runtime Selection → UK2 Engine: starts UK2
- Runtime Selection → AVG32 Engine: starts AVG32
- Runtime Selection → RealLive Engine: starts RealLive
- Siglus Player → Scene Execution: runs scenes
- Siglus Player → Game Filesystem: reads game files
- Scene Execution → Scene Loading: loads scenes
- Scene Execution → Resource Loading: loads resources
- Scene Execution → Image Management: manages images
- Scene Execution → Audio Playback: controls music
- Scene Execution → Sound Effects: controls effects
- Scene Execution → Game Saves: saves progress
- Scene Execution → Rendering: renders scene
- Resource Loading → Siglus Asset Formats: decodes assets
- Resource Loading → Game Filesystem: reads files
- Audio Playback → Siglus Asset Formats: decodes audio
- Rendering → Image Management: uses images
- Resource Loading → Media Decoders: decodes video