MAAT-OS / MAAT-RPG · Version 0.2

MAAT RPG – Return of the Principles

MAAT RPG is a bilingual local AI-RPG with cinematic story scenes, guided learning fights, reactive boss encounters, a living journal, and a path profile that shapes how the world responds to Maatis. It can be played locally and installed directly from GitHub.

MAAT-OS / MAAT-RPG Version 0.2 - Return of the Principles Path Profile: Boundary Keeper of Truth Rank: Awakening Motive: Truth must not violate boundaries. Progress Level 4 | XP 688 | Potions 3 | Gold 72 Boss Victories 0 | Final Victories 0 | Principles 0/5 Journal Entries 6 | Combat Achievements 0 Choose Maatis' next step. [1] Awaken and start the game [2] Options and reset [3] Begin a new aeon [4] MAAT-OS info [5] Quit

Core Features

A terminal RPG that tries to feel like a world, not just a command set.

Reactive Story

Story scenes, interludes, reflections, and world reactions evolve with Maatis’ choices.

Boss Combat System

Boss HUD, aura cycles, charge bars, specials, phase 2 logic, codex entries, and analysis after battle.

Bilingual DE / EN

Loader, menu, title flow, story, quests, battle, TTS, and most system prompts adapt to German or English.

Path Profile

Maatis grows into a title, rank, and motive. Bosses and later scenes react to that identity.

Journal & Boss Codex

Choices, consequences, boss encounters, and restored principles are recorded as part of the journey.

Guide Battles

Safe demo fights teach mechanics without XP, gold, or permanent progression advantages.

Gameplay Flow

1

Awakening in the library

Maatis encounters MAAT KI and is drawn into a world structured by Harmony, Balance, Creation, Connectedness, and Respect.

2

Maat value and reflection

Early scenes teach the MAAT value through story and reflection rather than dry exposition alone.

3

Combat and pressure

Random fights, boss mechanics, resonance, weaknesses, focus, sigils, and escalating trials bring the system to life.

4

Consequences and identity

Quest rewards, boss reactions, journal entries, and later scenes build a persistent sense of who Maatis is becoming.

Intro + Title Screen (Battle Demo)

Gameplay Video (Alpha)

How to Play

MAAT RPG is a local AI-RPG that runs directly on your system. Follow these steps to begin your journey.

1

Download the game

Download the latest MAAT-RPG.zip package from the official MAAT Research website.

2

Extract the archive

Unzip the downloaded file so that the MAAT-RPG folder appears on your system.

3

Allow the app on macOS

Complete installation via Terminal. If macOS blocks the app, first remove the quarantine flag, then launch the application.

curl -L https://maat-research.com/data/downloads/MAAT-RPG.zip -o MAAT-RPG.zip unzip MAAT-RPG.zip cd MAAT-RPG xattr -dr com.apple.quarantine "MAAT RPG.app" open "MAAT RPG.app"
4

Begin your path

Start the game and choose Maatis' next step. Your path profile, journal, battles, and choices will shape the world.

5

Learn through play

Explore story scenes, guided demo battles, boss encounters, the journal, and the codex. MAAT RPG is designed to teach its own systems through play.

Installation

MAAT RPG can be installed either as a ready-to-run package or directly from GitHub. For macOS developers and Linux players or developers, the Git setup is recommended.

Option 1 — Ready-to-run package

Download the packaged version from the MAAT Research website and follow the setup steps above.

Option 2 — Git Clone (recommended)

Recommended for macOS developers and Linux players or developers.

git clone https://github.com/Chris4081/MAAT-RPG.git cd MAAT-RPG/maatos bash setup.sh

The installer automatically prefers:
python3.12
python3.11
and only then python3.

If your system uses Python 3.13 by default, install Python 3.11 or 3.12 and run:

MAAT_SETUP_PYTHON=python3.11 bash setup.sh

Option 3 — Linux (Ubuntu / Debian)

sudo apt update sudo apt install -y \ python3.11 python3.11-venv python3.11-dev \ build-essential cmake \ ffmpeg mpg123 alsa-utils \ speech-dispatcher espeak-ng git clone https://github.com/Chris4081/MAAT-RPG.git cd MAAT-RPG/maatos MAAT_SETUP_PYTHON=python3.11 bash setup.sh

Troubleshooting

If you see an installation error related to scipy, your system is most likely using an unsuitable Python version, often Python 3.13.

Recommended solution:

MAAT_SETUP_PYTHON=python3.11 bash setup.sh

Selected Systems

  • Local GGUF model loading with resume-capable downloads
  • English and German UI flow
  • Battle analysis and combat achievements
  • Quest system with path-based rewards
  • Relationship and journal layers

Project Direction

MAAT RPG is becoming a playable MAAT world where AI, mechanics, ethics, story, and symbolic structure reinforce each other.

MAAT RPG is an AI RPG game built for Linux and macOS using local LLM models. It is a text-based RPG with boss fights, storytelling, ethical systems, and dynamic gameplay. The game uses GGUF models and runs offline without internet. MAAT RPG combines philosophy, artificial intelligence, and gameplay into a unique indie RPG experience. It supports English and German, local model downloads, terminal gameplay, interactive story scenes, and reactive battles.