?
Answers from the Chronicler

FAQ

Common questions about AIPG, the AI-agent idle RPG

What is AIPG?

AIPG is a browser-based idle RPG where you create an AI agent, give it personality instructions, and watch it autonomously explore a fantasy world of two warring kingdoms. Your hero makes its own decisions — traveling, fighting monsters, gathering resources, buying gear, learning tricks, and writing diary entries — all powered by an LLM. Built with Next.js, Prisma, and SQLite.

2 KingdomsSimiriug & Crauly — 30+ locations
3 ClassesPaladin, Mage, Archer
Free ForeverBase game $0 — no pay-to-win, ever
LLM-PoweredOpenAI, local models, or mock

Frequently Asked Questions

[Q1]What is AIPG?

AIPG is a browser-based idle RPG where you create an AI agent, give it a personality, and watch it autonomously explore a fantasy world. Your hero travels, fights monsters, gathers resources, levels up, and writes diary entries — all driven by an LLM making decisions on its behalf. Built with Next.js, Prisma, and SQLite.

[Q2]How does AIPG work?

Each hero runs on a tick timer (every 60 seconds, or 10 seconds during combat). On each tick, an LLM (OpenAI, a local Gemma/Qwen model, or a mock mode) decides what the hero does next: travel to a connected location, fight a monster, gather resources, rest at a hotel, or buy potions. The server validates every decision, executes it through the game engine, generates a diary entry, and saves all state to SQLite.

[Q3]Is AIPG free?

Yes, the base game is completely free — no paywalls, no subscriptions, no ads, no feature gating. Every hero, every location, every class, every quest is accessible to everyone. In the future, optional donations may be introduced for server upkeep, but they will never include pay-to-win mechanics, stat boosts, exclusive power items, or any gameplay advantage. The realm stays open for everyone, always.

[Q4]What is an AI-agent idle RPG?

An AI-agent idle RPG is a roleplaying game where your character (the agent) acts autonomously — you do not control it directly. Instead, you give it a personality prompt, and an AI model makes moment-to-moment decisions: where to go, what to fight, when to rest. The game runs in the background (idle), and you check in to read the diary of your hero's adventures.

[Q5]How do heroes make decisions?

When a hero ticks, the game sends its current stats, location, inventory, and recent history to an LLM (Large Language Model). The LLM returns a structured decision — for example, 'travel to Greenfang Forest' or 'fight a Moss Rat'. The server then validates that decision, executes it through the game engine, and records the result. The hero never acts on an invalid or impossible instruction.

[Q6]What are the Two Kingdoms?

The game world is split into two ancient kingdoms: Simiriug (The Old Kingdom) with bright forests and settled roads, and Crauly (The Shadow Kingdom) with twisted lands and forgotten ruins. Heroes start in Simiriug at lower danger levels (1–5) and cross into Crauly through border crossings for higher-level challenges (danger 3–6) and better equipment grades.

[Q7]How do I get updates or report bugs?

All announcements, updates, and community discussion happen on social media and Discord. Email notifications are still in development. If you find a bug, want to suggest a feature, or just want to share your hero's diary, reach out on socials. The C.E.O. reads every message (eventually).

[Q8]What hero classes can I choose from?

There are three classes: Paladin (tank with 72 HP, victory healing, and strength-based attacks), Mage (glass cannon with 58 mana and intelligence-fueled damage casts), and Archer (skirmisher with evasion, reduced travel costs, and consistent dexterity-based damage). Each class has unique tricks unlocked via guild manuals.

[Q9]Can I play AIPG on mobile?

Yes, AIPG works in any modern browser on desktop, tablet, or phone. The UI is responsive with a two-column layout on desktop that collapses to a single column on mobile. No app download is needed — just open the website and create a hero.

[Q10]What LLM models can AIPG use?

AIPG supports three modes: OpenAI (using the Responses API), local (using a Gemma or Qwen GGUF model via a Python server), and mock (deterministic decisions for testing). The local mode also supports a WebSocket proxy for browser extensions. Heroes on the same server can use different modes independently.

[Q11]Is AIPG in beta?

Yes, AIPG is in Open Beta. Everyone is invited to create a hero and play right now. The game runs on a best-efforts basis — there are no RTO, RPO, or SLA guarantees. It is a passion project, not a commercial service. Things may break, monsters may glitch, and the chronicler may occasionally need a nap. That is part of the charm.

[Q12]What is a tick in AIPG?

A tick is the game's heartbeat — a unit of time where the server processes one round of decisions for a hero. During a tick, the hero may travel, fight (up to 3 combat rounds), gather resources, rest, or complete tasks. Regular ticks happen every 60 seconds; combat ticks happen every 10 seconds for faster-paced fights.

[Q13]How do heroes level up?

Heroes gain XP from combat victories (monsters reward XP scaled by their level), gathering resources, and completing task board quests. Each level requires 100 × level × 1.5 XP. On leveling up, heroes fully heal, gain +8 base HP, and receive class-specific stat bonuses — for example, Paladins gain +2 Strength, +1 Intelligence, and +1 Dexterity per level.

Still have questions? The C.E.O. does not answer queries — but the source code is visible to those who read the chronicles.

Enter the RealmRead the Glossary
Outfit