How typeguja/alkash3d-engine works
AlKAsH3D is a Windows-focused Rust game engine for open-world simulation, accompanied by a standalone scene editor and runtime plugins. The principal runtime path is engine startup and scene/world loading, followed by simulation and rendering; the editor offers a parallel authoring path that imports or edits assets and presents them in a GPU viewport. The README documents the major engine capabilities and plugin roles; sampled source supports selected editor and DirectX 12 internals. Unsampled connections are omitted rather than inferred from module names.
Main entry points: lib.rs Engine Runtime · app.rs Editor Application · engine Render Passes · manager.rs Plugin Manager
Components 27
Engine Runtime
- Engine Runtime
alkash3d-rust/src/lib.rs - ECS Scene
alkash3d-rust/src/scene.rs - World Streaming
alkash3d-rust/src/engine/world_streaming.rs - Car and Physics
alkash3d-rust/src/car_physics.rs - Task Scheduler
alkash3d-rust/src/scheduler - Audio
alkash3d-rust/src/audio.rs - Scripting
alkash3d-rust/src/engine/scripting.rs - Standalone OBJ Viewer
alkash3d-execfile/src/main.rs
Rendering
- DirectX Renderer
alkash3d-rust/src/render.rs - Render Passes
alkash3d-rust/src/engine - Shader Compilation
alkash3d-rust/src/shader.rs - GPU Buffers
alkash3d-rust/src/buffer.rs - Descriptor Heaps
alkash3d-rust/src/heap.rs - Constant Buffers
alkash3d-rust/src/constant_buffer.rs
Runtime Plugins
- Plugin Manager
alkash3d-rust/src/plugin/manager.rs - Inertial Physics Plugin
alkash3d-inertial/src/lib.rs - FirstFires Culling
alkash3d-FirstFires/src/lib.rs - Lua Plugin
alkash3d-luascript/src/lib.rs
Editor
- Editor Startup
alkash3d-editorapp/src/main.rs - Editor Application
alkash3d-editorapp/src/app.rs - Mesh Editing
alkash3d-editorapp/src/editor/mesh_edit.rs - Editor Panels
alkash3d-editorapp/src/ui - Editor GPU Renderer
alkash3d-editorapp/src/gpu/renderer.rs - Editor Pipelines
alkash3d-editorapp/src/gpu/pipeline.rs
Assets and Formats
- Format Converters
alkash3d-editorapp/src/converters - Engine File Formats
alkash3d-rust/src/altex_format.rs
Other components
- Player or Developer
Connections 27
- Player or Developer → Engine Runtime: runs
- Engine Runtime → ECS Scene: maintains
alkash3d-rust/src/lib.rs - Engine Runtime → World Streaming: streams worlds
- Engine Runtime → Car and Physics: simulates
alkash3d-rust/src/lib.rs - Engine Runtime → Task Scheduler: schedules tasks
alkash3d-rust/src/lib.rs - Engine Runtime → Audio: plays audio
alkash3d-rust/src/lib.rs - Engine Runtime → Scripting: runs scripts
- Engine Runtime → Plugin Manager: loads plugins
- Plugin Manager → Inertial Physics Plugin: loads physics
- Plugin Manager → FirstFires Culling: loads culling
- Plugin Manager → Lua Plugin: loads scripting
- Engine Runtime → DirectX Renderer: renders frames
alkash3d-rust/src/lib.rs - DirectX Renderer → Render Passes: uses passes
alkash3d-rust/src/engine/pipeline_shadow.rs - Render Passes → Shader Compilation: compiles shaders
alkash3d-rust/src/engine/pipeline_shadow.rs - DirectX Renderer → GPU Buffers: uses buffers
alkash3d-rust/src/render.rs - Render Passes → Descriptor Heaps: creates descriptors
alkash3d-rust/src/engine/pipeline_shadow.rs - Render Passes → Constant Buffers: uses constants
alkash3d-rust/src/engine/pipeline_shadow.rs - Player or Developer → Editor Startup: starts editor
alkash3d-editorapp/src/main.rs - Editor Startup → Editor Application: creates app
alkash3d-editorapp/src/main.rs - Editor Application → Editor Panels: presents panels
alkash3d-editorapp/src/app.rs - Editor Application → Mesh Editing: edits meshes
alkash3d-editorapp/src/app.rs - Editor Application → Editor GPU Renderer: renders viewport
alkash3d-editorapp/src/app.rs - Editor GPU Renderer → Editor Pipelines: uses pipeline
- Editor Application → Format Converters: imports and exports
alkash3d-editorapp/src/app.rs - Format Converters → Engine File Formats: handles native formats
- Player or Developer → Standalone OBJ Viewer: opens OBJ viewer
- Standalone OBJ Viewer → Engine Runtime: uses C ABI