- Production: https://rpgkeeper.com
- Beta: https://beta.rpgkeeper.com
RPGKeeper is a digital character manager. While there are many others out there that are targeted to one or two systems, RPGKeeper aims to be a universal character management system. It can support any TTRPG system ever created, as long as that system is added into it's codebase. Building a system is a time-consuming process, but it's possible to get the basics going in just a few hours. With support for a 'generic' system, RPGKeeper allows you to get down to playing quickly even if it doesn't support your game with a dedicated system.
Don't get us wrong, Roll20 certainly has a lot of features, and a dedicated fanbase. But Role20 is a map first, and a character/campaign manager second. Often, character sheets are built based off the official paper sheets from games; which often don't translate well to a digital format. RPGKeeper takes a different approach: we focus on building user experiences centered around playing your character, without worrying about keeping the sheet the same as the paper version. Characters are a first class citizen.
Currently, there are no limits on number of characters.
Well, are you a developer? RPGKeeper is written in VueJS, TypeScript, and NodeJS. If you know (or are willing to learn) those technologies, then fork the code, and start adding a system. If, instead, you're just a gamer and want us to do the work, then Request a System.
You can! Simply copy the url from your browser, and send that link to someone else. They will see a read-only version of your character.
RPGKeeper is, and always will be an open source project. We want to encourage developers to help improve it, and add new features that we haven't even considered before. As such, we want to keep how to contribute front and center in this readme. All contributions are welcome!
Before getting started you will need the following installed:
- NodeJS >= v16
You will also need to add a .env file to the root of the project. This file should contain the following:
# Defaults for local development
SESSION_SECRET='etched municipality unconscionably fribble *&^%$## 88'
CLIENT_ID='712153107187-8e00g8d18nbk5esiffhkrbtr12vktlvq.apps.googleusercontent.com'
CLIENT_SECRET='hOsFjUL-f_yky8djy1OSuvmp'
SERVER_PORT=5678You will want to replace these with your own values (especially SECRET_SESSION and MAILGUN_KEY). You can get a
CLIENT_ID and CLIENT_SECRET by creating a new project in the
Google Developer Console.
The first thing you will want to do is to install dependencies:
npm
Finally, you will need to start the dev server:
npm run dev
It should create a new database file: <project_root>/db/rpgk.db. You should now be able to access the running client
at http://localhost:5678/.
Before you are allowed to push, the project will force you to run through the linter. If the linter doesn't pass, you don't get to push. To check on your own, I recommend you run: npm run lint. If this passes then you know you're good to go.
Note: Merge requests will not be accepted without passing linting.
