sjlehtin/aesheet

Combat sheet for the Advanced Engine Role-playing game system

What is this?

Features

Calculates effects from stats, edges, flaws, encumbrance, armor and wounding to skill and weapon checks.

See new features from the Changelog.

Implementation

The most intensive page or the character sheet, is pretty much completely written with the React JS framework, allowing for a fairly responsive page. The backend for the sheet are REST APIs written with Django Rest Framework.

Rules

The ruleset is pretty much fully homegrown fork of the Amazing Engine. Nowadays only thing left is the stat names and some concepts, with skills being brought into the system either from house rules or or the d20 system, adapted here. Licensing situation of the rules is not entirely clear, but the data should be ok to use for non-commercial purposes.

In the roadmap

Full list of all todo items in the TODO.

Installing

In production use

Deploying

On build host

tox
npm test
npm run build -- --mode=production
python setup.py bdist_wheel
python manage.py collectstatic --noinput --clear
gtar zcvf aesheet-0.11-full.tar.xz static/ dist/aesheet-0.11-py3-none-any.whl

On application server

Take a backup of your database, e.g.,

sudo -i -u postgres pg_dump -F c -b -v sheetdb > dump.dump

Check settings.py for need of changes due to upgrades or configuration changes.

Update outdated python packages pip list --outdated

sudo cp -a ~/aesheet-0.11.0/static .
sudo ve/bin/pip install -U ~sjl/aesheet-0.11.0/aesheet-0.11.0-py3-none-any.whl
sudo -u www-data bash -c "source ./env && django-admin migrate"

sudo systemctl restart aesheet.<env>

Using the Docker images

Create containers

docker-compose build
docker-compose up -d

Create the superuser

docker-compose -f docker-compose.yml exec web python manage.py createsuperuser

Add standard rules package

docker-compose -f docker-compose.yml exec web python manage.py loaddata basedata

Alternately, setup database from a previous dump

docker compose exec -T db pg_restore -c --no-owner -d $POSTGRES_DB --role $POSTGRES_USER -U $POSTGRES_USER -v <  dump.dump

Run migrations manually

docker compose exec -e DJANGO_SETTINGS_MODULE=settings -e PYTHONPATH=/opt/aesheet web  django-admin migrate

The sheet is now usable in http://localhost:8001/.

Starting over

docker-compose down -v

Running tests

 % python manage.py test
 % npm test
 % cd sheet/tests && pybot tests.robot  # not functional yet.

aesheet's Issues

Highlight chosen range and detection level clearer

Near skill checks for firearms, at least.

Add natural weapons

Natural weapons should use Toughness and Hardened Skin edges to calculate durability and lethality.

The Durability of natural weapons (for example, fists or bear paws) is calculated as follows: Attack base lethality + Hardened Skin LR + Toughness L/2. When natural weapons are damaged, their owner takes non-lethal damage.

Firearm add-ons

Add firearms in CC

Current campaign would really benefit.

Instinctive fire

Level of instinctive fire should be displayed and effect indicated near weapons that can take advantage of the skill.

Use weight as a penalty

Accumulated weight for the character should penalize skill checks.

If possible, the effects on the stats should be itemized somehow to make it easier to troubleshoot and modify the characters loadout.

Fix wound effects (bleeding etc) for wounds over threshold

Currently does not show the bleeding or slug in effects.

Firearm ranges

Instead of fixed ranges, the ranges should be calculated from weapon and ammunition base statistics.

Allow setting up the sheet in Docker

It would be much easier to demo and develop if the system could be orchestrated to be setup to docker containers.

Endurance/run display

Display effects of endurance/run on movement.

Make damage display more prominent in sheet set

Change spell effects to transient effects

This allows different tech levels to have different transient effects, such as drunkenness, potions, hormone boosts etc.

Allow assigning damage to the character

Both stamina and lethal.

Deleting last sheet for a character in a sheet set should require confirmation

Now it is too easy to nuke the last sheet for, e.g., a PC.

Penalty for shooting to a specific range

Allow specifying current target range, for which the penalties would be automatically calculated, taking into account current lighting conditions, weapon ranges and weapon addons.