Skip to content

the-tosh/boardless-open

Repository files navigation

boardless README

WHAT'S THIS ALL ABOUT

Boardless was started as a service where each user would be able to create his own rules for tabletop roleplaying games and play them with friends. Today it's somehow in beta-version and needs more people to move on. A lot of features have not been implemented yet: game cards, voice and video chats, characters' perks etc.

So now boardless is open and waiting for new collaborators to improve it.

Short-list of implemented features

  1. Skills and skills categories
  2. Items, items groups, inventory, equippable stuff
  3. XP and level settings
  4. Playfield with dices and characters table
  5. Tools for drawing on the canvas

SET UP AND RUN

FOR UBUNTU 14.04 (x64)

  1. virtualenv --no-site-packages venv
  2. source venv/bin/activate
  3. cp development.ini.example SETTINGS.ini (do not forget add SETTINGS.ini to your global ~/.gitignore)
  4. set up your SETTINGS.ini file

Install postgresql

  1. echo "deb http://apt.postgresql.org/pub/repos/apt/ trusty-pgdg main" | sudo tee -a /etc/apt/sources.list.d/pgdg.list
  2. wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo apt-key add -
  3. sudo apt-get update
  4. sudo apt-get install postgresql-9.5 postgresql-server-dev-9.5 libpq-dev
  5. set up your postgresql and create the necessary database, user etc

Dependencies and migrations

  1. pip install -e .
  2. pip install -r git_requirements.txt
  3. migrate SETTINGS.ini

Install frontend-related stuff

./boardless/scripts/install_node_stuff.sh

Start your DEV web server:

./run SETTINGS.ini

To run the playground (websockets-based gamesession server)

  1. cp server/dev.ini server/SETTINGS.ini
  2. cd server
  3. ./run SETTINGS.ini

NOTE: If is_dev=true is in SETTINGS.ini, settings.js will be generated automatically before starting the server

LICENSE

Oh yes, about the license.
It's ASL.