explaingit

rukkanova/aevum-realm-architect

Analysis updated 2026-05-18

2Audience · generalComplexity · 1/5LicenseSetup · easy

TLDR

A free two-file AI role playing game you paste into ChatGPT, Claude, or Gemini to play a deterministic serf-to-sovereign kingdom builder.

Mindmap

mindmap
  root((repo))
    What it does
      Two-file AI RPG
      Deterministic combat
      Tag-based kingdom economy
    Tech stack
      Text prompt file
      Word atlas document
      ChatGPT Claude Gemini
    Use cases
      Play as a Custom GPT
      Play as a Claude Project
      Play as a Gemini Gem
    Audience
      RPG players
      AI chatbot users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Set up the game as a Custom GPT in ChatGPT and start playing as a serf.

USE CASE 2

Upload the realm atlas and master prompt into a Claude Project to play the kingdom-builder RPG.

USE CASE 3

Set it up as a Gemini Gem to play through diplomacy, trade, and war toward the throne.

USE CASE 4

Read the design notes on the Deference Engine to understand how the social hierarchy mechanic works.

What is it built with?

ChatGPT Custom GPTClaude ProjectGemini Gem

How does it compare?

rukkanova/aevum-realm-architect0-bingwu-0/live-interpreter010zx00x1/faresnipe
Stars222
LanguagePythonPython
Setup difficultyeasymoderateeasy
Complexity1/52/52/5
Audiencegeneralgeneralgeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires access to a platform that supports custom instructions and file uploads, such as a ChatGPT Custom GPT, Claude Project, or Gemini Gem.

The repository is public to read and play for free, but no license is granted to redistribute, resell, or publish modified copies of it.

In plain English

Aevum Realm Architect is a free role playing game you play by pasting two files into an AI chatbot, ChatGPT, Claude, or Gemini, rather than a piece of software you install and run. Made by a site called Arcanum RPGs, it casts you as a serf with a single copper coin who tries to climb, through trade, war, diplomacy, and scheming, all the way up to ruling a kingdom. The repository contains exactly two files. One is a master prompt, a text file of rules, hidden state tracking, and behavior instructions that you paste into the instructions field of a Custom GPT, a Claude Project, or a Gemini Gem. The other is a Word document called the realm atlas, a roughly 30,000 word encyclopedia describing five nations inspired by different historical cultures, their trade routes, economies, and social structures, which you upload as a knowledge file alongside the prompt. Once both are set up, you simply start chatting to play. A few design choices set the game apart from typical AI powered role play. Combat and other outcomes are meant to be decided by your preparation and planning rather than random dice rolls, resolved instead through a table based on the strength of your forces and the quality of your plan. Your domain, treasury, and military are tracked through a tag based system so your standing in the world stays consistent and legible turn to turn. A mechanic called the Deference Engine enforces a strict medieval social hierarchy, so speaking or acting above your station as a low born character carries real consequences, and the five nations continue advancing their own goals in the background as the game progresses. The README is direct about rights: the repository is public so anyone can read, download, and play the game for free, but no license is granted to redistribute it, resell it, or publish modified copies. Anyone wanting to build on top of the system is asked to contact the creators directly instead.

Copy-paste prompts

Prompt 1
Walk me through setting up Aevum Realm Architect as a Custom GPT using aevum-master-prompt.txt and aevum-realm-atlas.docx.
Prompt 2
Set up Aevum Realm Architect as a Claude Project and start my game as a serf in Al'thoria.
Prompt 3
Explain how the Deference Engine and deterministic combat work in Aevum Realm Architect before I start playing.
Prompt 4
Start a new Aevum Realm Architect game for me set in the Viking-inspired nation of Njordheim.
Prompt 5
Summarize the five starting nations in Aevum Realm Architect so I can pick where to begin.

Frequently asked questions

What is aevum-realm-architect?

A free two-file AI role playing game you paste into ChatGPT, Claude, or Gemini to play a deterministic serf-to-sovereign kingdom builder.

What license does aevum-realm-architect use?

The repository is public to read and play for free, but no license is granted to redistribute, resell, or publish modified copies of it.

How hard is aevum-realm-architect to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is aevum-realm-architect for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.