Run the program from sources

Getting the sources

First of all, clone the repo

git clone https://github.com/OpenNingia/l5r-character-manager-3.git
cd ./l5r-character-manager-3/
git switch master

Create a virtual environment

Install python3-venv and create a new virtual environment for python.

apt install python3-venv
python3 -m venv .venv
source .venv/bin/activate

Installing the dependencies

Before running the program you need to install the dependencies. An editable install pulls in every runtime dependency declared in pyproject.toml (including the git-only l5rdal data-access layer and the forked pypdf):

pip install -e .

Note for Windows users

You will need Visual Studio or Visual Studio Build tools in order to build some of the dependencies (mainly lxml).

You will also need to install Python from here (latest version should be fine):

https://www.python.org/downloads/

Finally you launch the program

python3 ./main.py

Getting the Datapacks

The software alone is not useful. You need game data in order to create and manage your characters.

Game data is provided through packages named "datapacks" that are downloadable from the project website:

https://github.com/OpenNingia/l5rcm-data-packs/releases/latest

however you might want to compile the datapack yourself; in order to do so follow these simple instructions.

Clone the datapack repository

The data pack sources are hosted in a different repo, to get them run:

git clone https://github.com/OpenNingia/l5rcm-data-packs.git
git switch master

Build the datapacks

In the repo there is a convenience script that builds all the datapacks

cd scripts
python make_all_packs.py

Installing the datapacks

The preferred way to install datapacks is from the application menu. Click on Gear menu -> Import datapack... and select the files to import. Typically datapacks have the .l5rcmpack extension. This operation is only needed the first time and on each datapack update.

If the program was installed using the setup and/or debian file then you can also doubleclick the datapack files.

CONTRIBUTE

If you make a modification to the software or datapack that add value to the application don't hesitate to share it!

Please submit a pull request to the relative repository.