andy-huang / doryen-rs

ascii roguelike library in rust with native and wasm support

doryen-rs

Ascii roguelike library in rust with native and wasm support. Uses the uni-gl and uni-app crates from the unrust game engine.

features

+ [x] GLSL renderer
+ [x] RGBA, RGB and greyscale fonts
+ [x] mouse input
+ [x] keyboard input
+ [x] subcell resolution
+ [x] PNG image blitting
+ [x] unicode support
+ [x] screenshots

demos

Visual demo	Basic real-time walking @
Performance test	Fonts demo
Unicode demo	Console blitting demo
Image blitting demo	Subcell resolution demo
Transparent console demo	Text input demo

usage

• add dependency to Cargo.toml :

[dependencies]
doryen-rs="*"

Check the examples and documentation for more information.

compilation

• native compilation

cd www && cargo run --example basic

• web compilation Install wasm32 target :

rustup target install wasm32-unknown-unknown

Install wasm-pack and npm

Change the path variable in examples/Cargo.toml to select an example.

Compile the demo with

wasm-pack build examples

This creates a wasm package in examples/pkg

Run the demo with

cd www
npm install
npm run start

Open your browser at http://localhost:8080/

license

This code is released under the MIT license.

contributions

You can contribute to this library through pull requests. If you do so, please update the CHANGELOG.md and CREDITS.md files. If you provide a new feature, consider adding an example as a tutorial/showcase.