A Python implementation of the Ars Magica 5th Edition mechanics. This project provides a framework for managing Ars Magica sagas, characters, covenants, and magical activities.
Note: This is a fan-made implementation of the game mechanics and is not affiliated with or endorsed by Atlas Games. Ars Magica is a trademark of Trident, Inc. d/b/a Atlas Games.
- Character creation and management
- Covenant management
- Laboratory activities
- Spell research system
- Seasonal activities
- Vis and aura management
- Magic item creation
- Command-line interface for all features
You can install the package from PyPI:
pip install ars-magicaTo use the CLI, run ars in your terminal. You can see the available commands by running ars --help.
To get started quickly, you can use the following commands:
- Create a character:
ars character create "Bonisagus Wizardus" --house Bonisagus --player "Your Name"
- Create a covenant:
ars covenant create "The Order of Hermes" --size small --aura 1- Start a seasonal activity:
ars season schedule "Bonisagus Wizardus" --activity research --subject "Arcane Lore"For more detailed usage and examples, see the CLI Usage documentation.
Clone the repository:
git clone https://github.com/bjornaer/ars.gitInstall poetry if you haven't already:
curl -sSL https://install.python-poetry.org | python3 -Install the dependencies:
poetry installpoetry run pytestUse the makefile for ease of use:
make testTBD
This project is licensed under the MIT License. See the LICENSE file for details.
Note about Ars Magica: Ars Magica is a trademark of Trident, Inc. d/b/a Atlas Games. This software is not affiliated with or endorsed by Atlas Games. This is a fan-made implementation of the game mechanics and does not include any copyrighted content from the Ars Magica books.
"We are the ancient shapeshifters, guardians of the old ways. Our magic flows from the heart-beast within."
- A common saying among House Bjornaer magi