DungeonRS is a cross-platform map editor for tabletop RPG sessions, inspired by DungeonDraft. Built with Rust and the Bevy game engine, it provides an efficient and responsive tool for creating detailed dungeon maps with asset management, layered editing, and project serialisation capabilities.

• Visual Map Editor: Intuitive interface for creating and editing dungeon maps
• Asset Management: Organised system for managing tiles, textures, and map elements
• Layer-based Editing: Multiple layers for organising different map components
• Cross-platform: Native support for Windows, macOS, and Linux
• Modular Architecture: Plugin-based system with separate crates for different functionality

• Rust 1.89.0 or later (managed via rust-toolchain.toml)
• System graphics drivers supporting OpenGL or Vulkan
• Developer mode enabled (Windows only, see CONTRIBUTING).

1. Clone the repository:

   git clone https://github.com/dungeon-rs/dungeon-rs.git
   cd dungeon-rs

2. Install Rust toolchain:

   rustup show

3. Build and run the development editor:

   BEVY_ASSET_ROOT=. cargo run -p drs-editor -F drs-editor/dev

For production use without debug features:

cargo build --release --locked --workspace

The project includes a justfile for common development tasks:

cargo install just
just setup    # Install development dependencies
just run      # Run the development editor
just test     # Run test suite
just lint     # Run linting checks
just ci       # Run all checks a PR would run on GitHub Actions

DungeonRS uses a workspace-based architecture with the following crates:

• drs-assets: Asset loading, management, and scripting system
• drs-cli: Command-line interface for project management and asset management
• drs-config: Configuration management and settings
• drs-data: Core data structures for projects, levels, and layers
• drs-editor: Main application binary and UI integration
• drs-i18n: Internationalisation support
• drs-core: Project serialisation and file operations
• drs-logging: Logging and error handling
• drs-serialization: Serialisation and deserialization of project data
• drs-ui: User interface components and layout management
• drs-utils: Shared utilities and helper functions

DungeonRS supports custom configuration files. Specify a config file when launching:

cargo run -p drs-editor -- --config-file path/to/config.toml

Configuration options include logging levels, language settings, and editor preferences.

Contributions are welcome! Please see CONTRIBUTING for development setup instructions and guidelines.

This project is licensed under the terms specified in the LICENSE file.