A Ruby toolkit to create your own text based DnD 5th Edition RPG games or to quickly test drive certain creature encounters if you are a DM.
- Accurate DnD 5e ruleset implementation using the Open Game License
- Line of Sight computation with Lighting simulation (dim, dark areas)
- Simulation of doors, traps, treasure chests and cover
- Rudimentary AI and pathfinding
- Text based UI
- Support for automatic and manual dice rolling
- Easily extensible to incorporate in your own games
- More to come
- More to come
- Install ruby 2.5 or later
Add this line to your application's Gemfile if you plan to use the game engine in an adventure of your own otherwise you can just clone this repository locally using git clone:
And then execute:
$ bundle install
Or install it yourself as:
$ gem install natural_20
To quickly try this out, clone this repository, in the working folder start the game engine it will load the default adventure included in this repository:
See below for a description of the adventure
The default adventure in this story is meant to showcase the game engine, it contains a small dungeon with doors and traps as well as goblins and a dangerous owlbear. you are to lead a party of 2 to steal the treasure behind one of those doors.
You can find the adventure specific files in the following locations:
char_classes/ characters/ items/ npcs/ races/ maps/game_map.yml game.yml
These are all text readable for you to customize to your liking.
Creating your own adventures
You can generate a skeleton adventure using:
A prompt based system will launch for you to create your own game.
The end result will be a folder containing a bunch of YAML files describing your game
Map making guide
A map is a YAML file that consists of the following:
- Base Layer - contains terrain information like ground, grass, walls, doors, traps and various obstacles
- Meta Layer - contains information about dynamic objects like player tokens, NPCs
- Light Layer - contains information about static lights in the map
- Legend - A mapping from the layers to details about the terrain and tokens
- Map Triggers - A map level trigger
After checking out the repo, run
bin/setup to install dependencies. Then, run
rake spec to run the tests. You can also run
bin/console for an interactive prompt that will allow you to experiment.
To install this gem onto your local machine, run
bundle exec rake install. To release a new version, update the version number in
version.rb, and then run
bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the
.gem file to rubygems.org.
Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/natural_20. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the code of conduct.
The gem is available as open source under the terms of the MIT License.
Code of Conduct
Everyone interacting in the Natural20 project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the code of conduct.