Ars Magica Python Implementation
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.
Features
- 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
Installation
You can install the package from PyPI:
pip install ars-magica
Usage
To use the CLI, run ars in your terminal. You can see the available commands by running ars --help.
Quick Start
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.
Development
Clone the repository:
git clone https://github.com/bjornaer/ars.git
Install poetry if you haven't already:
curl -sSL https://install.python-poetry.org | python3 -
Install the dependencies:
poetry install
Running tests
poetry run pytest
Use the makefile for ease of use:
make test
Project Structure
TBD
License
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
Metadata
Release files for ars-magica 0.1.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| ars_magica-0.1.3.tar.gz | 61.7 kB | Without provenance | Details for ars_magica-0.1.3.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| ars_magica-0.1.3-py3-none-any.whl | Python 3 | none | any | Details for ars_magica-0.1.3-py3-none-any.whl |
Total release size: 141.9 kB
Release files / ars_magica-0.1.3.tar.gz
| Download URL | ars_magica-0.1.3.tar.gz |
|---|---|
| Size | 61.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
73df43142203c45ed6556e286a3d55016ab84adbb452048bcaade6891d0466e0
|
|
BLAKE2b-256 checksum How to use checksums |
c615c30aba310555cf1ebadb1ace8decaf5191b95505ac0f1acebbd2dcf33e23
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/1.7.1 CPython/3.12.7 Linux/6.5.0-1025-azure
|
Release files / ars_magica-0.1.3-py3-none-any.whl
| Download URL | ars_magica-0.1.3-py3-none-any.whl |
|---|---|
| Size | 80.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
94b20556f42dac9692d3521d2442c988ee94047b8fad81b72ea2aa0c8ae87784
|
|
BLAKE2b-256 checksum How to use checksums |
7d2c327a55e2c3777673155ff0d6b1a1d6bc410bab4b3b32684443e923b0844a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/1.7.1 CPython/3.12.7 Linux/6.5.0-1025-azure
|
Security for ars-magica 0.1.3
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.