VibeRPGSimulator

Expeditions quick guide

Expeditions shows your AI agent's work as a small pixel-art battle in a window on your computer. Your agent fights by working, so you have nothing to press while it runs. When the task is done, you say how it went and collect the rewards.

The pictures come from made-up example sessions. The gold numbers point at the parts explained under each picture.

Set it up once

  1. Install the plugin. In Claude Code, run these two commands. The steps for Codex, OMP and Gemini CLI are on the Expeditions page. You need Node 22 or newer.

    /plugin marketplace add Demonbane18/vibe-rpg-plugin

    /plugin install expeditions@viberpg

  2. Start a new session and ask your agent to “start my expedition”. The window opens in your browser. It runs on your own computer, not on this website. From then on, your first session each day opens it by itself, and you can ask your agent to “open the expedition window” whenever you closed it.

  3. Work the way you always do. The battle follows along, and the rest of this guide shows what you'll see.

What you see

The Expeditions window in an example session: three sessions in the island strip, a Hunter party fighting the Flaky Wisp Elite at wave 5, and Context at 88 of 100.
  1. The island lists every agent session that's open right now. The ones that need you come first.
  2. The Class, the kind of task your first prompt asked for. Here it's Hunter: testing and debugging. If it guessed wrong, open Change class under the battle.
  3. Your Hero (agent app), Weapon (model) and Charge (reasoning effort).
  4. The Foe stands for the problem this class fights. A Flaky Wisp is a failing or flaky test, and every fifth wave brings a tougher Elite.
  5. Your party. It strikes each time your agent finishes an action.
  6. A Scroll (skill) your agent opened. The spells it uses appear beside the battle.
  7. Context is the party's health bar. Foes wear it down, and every finished turn gives 10 back.
  8. Wave, Push and Strike: how far the party has come, which attempt this is and how hard each action hits.
  9. Guide opens this page. Pin keeps the island and the battle on top of your other windows.
The window during an example session.

The island

Each chip is one agent session: the agent, the project folder and what it's doing. The time in brackets is how long it has been doing that.

The island strip with three sessions: recipe-app needs approval to edit vercel.json, blog-app is waiting for you, and my-shop is running its tests.
  1. Gold means it needs your approval. Here the agent wants to edit vercel.json. Answer in your agent; the island only shows that it's waiting.
  2. Blue means it's waiting for you. The agent finished its turn and is ready for your next message.
  3. Green means it's working. Here my-shop is running its tests.
Three sessions at once.

Click a chip to watch that session's battle. When a session starts waiting for you, a short chime plays and the tab title counts the sessions that need you, such as “(2) Expeditions”. The chime needs one click anywhere in the window first, and you can turn it off in Settings.

An example session

Here is the session from the pictures, step by step.

What happens in the agent and what the window shows
In your agentIn the window
You type: “The checkout test fails sometimes. Find out why and fix it.”Expeditions picks Hunter (testing and debugging). It reads your prompt on your computer, then drops the text.
The agent opens the systematic-debugging skill.The Scroll (skill) joins the party. Trials found it helps on Hunter quests, so it's Buffed here and Strike goes from 10 to 15.
It reads files and searches the code.Each finished action strikes the foe.
A test run fails.A miss: no damage and nothing lost. Failing tests are part of good work.
The next action works.Rally: that strike hits 5 harder.
The party reaches wave 5.An Elite, a tougher foe. This Flaky Wisp dodges every other strike, like a flaky test that passes one run and fails the next. Beating it brings a choice.
The agent finishes its reply.The turn's last strike lands, Context goes up by 10 and “How did it go?” appears.
You end the session and press Cleared.A finale plays and the rewards go to your guild hall.

The choice every fifth wave

A choice at wave 5 with two buttons, Sharpen: +3 strike and Rest: +20 Context, and a note that the Steady stance takes Rest if you don't pick.
  1. Sharpen: +3 strike for the rest of this push.
  2. Rest: +20 Context.
  3. You don't have to answer. If you haven't picked when the turn ends, your Stance picks: Steady takes Rest, Press on takes Sharpen. You can change it in Settings.
The choice after the wave 5 Elite.

Choices stop after 3 Sharpens and past wave 20.

Copy what trials found

Under the battle, a card shows what the Proving Grounds measured for your class.

The card What trials say about Hunter, listing two spells with their measured clear-rate gains, each with a Copy button.
  1. Open the card to see the curator's trial results for this class.
  2. A spell that raised the clear rate in those trials, with the numbers behind it. Trials don't measure your own session.
  3. Copy puts the line on your clipboard, ready for your next prompt or setup. The card costs no tokens.
The card for Hunter, opened.

Classes without trials say “not measured yet” and list their spells without claims.

When you're done

The question How did it go? with four buttons: Cleared, Partly, Fizzled and Skip.
The question after each finished turn.
Cleared
The task worked. The finale plays and you can earn stars.
Partly
Some of it worked.
Fizzled
It didn't work. You lose nothing.
Skip
You'd rather not say.

Answer whenever you like. Once your agent's session ends, Expeditions waits about 15 minutes for an answer, then settles without one. Stars and badges need Cleared. Trophies, records and spell levels count whatever you answer.

The list under Expedition cleared: two stars, a Buffed here badge, three Trophies, a new record at wave 6, a spell reaching Level 2 and the First Scroll medal.
  1. Stars, up to three per class: one for Cleared, one for using one of the class's spells (or none at all where trials favour Wise Restraint) and one for a Combo, spells used in order.
  2. A badge: Buffed here, for clearing with a spell that trials found helpful in this class.
  3. A Trophy for each foe beaten in this class for the first time.
  4. A record: the deepest wave you've reached in this class.
  5. Spells your agent uses are Caught and level up across sessions; levels are only for show. Medals mark milestones such as First Scroll.
What the example session earned.

Your guild hall

The Collection tab keeps your progress across sessions, on your computer only.

The Collection screen's map of stars per class, with Hunter at 2 of 3 stars, deepest wave 6 and the Buffed here badge.
  1. The map has a row for each class.
  2. Stars earned in that class, out of 3.
  3. The deepest wave reached there.
  4. Badges earned there.
The map after one cleared session.

Below the map are your Trophies, Caught spells and medals. The export link sends Caught spells and medals to the Practice Grounds Spelldex.

Good to know

  • The battle costs no tokens. The hooks only watch what your agent does, and the game runs on your computer. Asking your agent to open the window is an ordinary request. Guide mode, off unless you turn it on, adds one short note to a session's first prompt in Claude Code and Codex.
  • Nothing rewards keeping an agent busy. Idle time earns nothing, failures cost nothing and waves past 20 pay nothing extra.
  • When the party falls, it rests at Camp. Your next prompt starts a new push from wave 1, and the session still earns its rewards once.
  • Your prompt is read on your computer to pick the class, then dropped. Folder and file names on the island stay in memory and are never saved or uploaded.
  • For an agent Expeditions can't follow, use Play by hand under the battle: pick the class, press Progress when a step lands and End when you're done.

Every game word and its plain meaning is listed on the Expeditions page.