World Editor Stats

📊 World Editor: Stats

🛠️ Part of the World Editor guide.

Stats are the numbers your world tracks: health, coin, reputation, or anything your world needs. Each stat has a value between a Min and a Max. The AI reads your stats on every turn. A stat on the Stats tab is a global stat: no one owns it. A persona or an entity can own stats of its own.

Why it exists

Prose alone changes from turn to turn. A stat is a fact the AI must write around. It can't narrate a sprint across a rooftop while your Stamina reads 4/100, because the number contradicts it.

The narrator's prompt tells it to let stats change how an action turns out. A low stat shows as effort and cost. A high stat shows as ease. The prompt also tells the narrator not to list the stats or report their changes. A separate step changes the numbers.

How the AI Tracks Stat Changes

After each narration, a separate request reads the turn and records which stats changed. The request shows the stats in blocks, one block for each owner. The global stats come first, so the persona's block is the most recent.

Block	Holds	Reply key
Global Stats	The global stats: stats that no entity owns. Global Traits lists the picked traits with no owner.	Global Stats
Player Character	The persona's traits and stats, and the stats of every entity you play as	Player Character
In Scene	Each present entity that owns stats, with its traits and stats	The entity's name

• Each owner's stats change for that owner only. A stat under Player Character or an entity changes for what that owner does, goes through or feels this turn.
• Global Stats has no owner rule. Its stats change for what happens in the world, such as a city's Destruction or a faction's Suspicion.
• Put a stat on its owner to make it theirs. Add it on the persona or entity. Leave it on the Stats tab to make it global.
• A persona with no stats has no block and no key. Global Stats still holds the global stats.
• An entity gets a block only when it is in the scene and owns stats.
• The reply is one object with one key for each block. Under each key, a stat has two entries: its name for the change in value, and its name plus max for the change in maximum.
• A stat that shares a name with an earlier stat reads as "name (2)". The global stats come first, then the persona's.

On an endpoint that can't take that format, the request falls back to stat-change lines. The fallback covers the persona's stats and the global stats. Stats of other entities don't update there. A custom preset is sent as written. A world's own Stats prompt is sent as written too, with your preset's user message.

💡 A saved world prompt for Stats or your own Stat Updates preset keeps its own layout. To get entity stats back in it, see How to Get Entity Stats Into a Custom Stat Prompt.

How to Add a Stat

1. Open the Stats tab.
2. Type the stat's name in the Filter Stats box.
3. Select the + button (Add to Stats). In Advanced mode, choose Add Stat from its menu. The new stat opens in the panel.
4. Set Base Value, Min and Max.
5. Write its Description.
6. Select Save.

💡 With the box empty, the new stat is named "New Stat". A new stat starts at 0 on a 0–100 range, with three descriptors: low, medium and high.

How to Make a Stat a Percentage

1. Select the stat.
2. On the Details tab, set Type to Percentage.
3. Set Base Value (%). Min and Max lock at 0 and 100.

How to Hide a Stat

Advanced mode only.

1. Select the stat.
2. On the Details tab, under Availability, check Hidden.

The player no longer sees the stat. The AI still reads it, and its Regen and code still run.

How to Group Stats

Advanced mode only.

1. Open the Stats tab.
2. Select the + button (Add to Stats), then Add Group.
3. Name the group. Add an AI-Facing Description if you want one.
4. Drag a stat onto the group. Drag a group right to nest it in the group above.

The same steps work on an entity's own Stats tab, for the stats that entity owns.

Groups only organize your stats. A group has no pick count, mode or gate. In the game, the stat panel shows each group as a heading that collapses. A group with no visible stat is left out.

To group stats only for yourself, clear Show Heading to AI on the group. The AI then reads the group's stats as if they had no group, and a group inside it moves up one level. The stat panel still shows the group.

💡 Delete on a group removes the group only. Its stats and subgroups move up one level.

How to Add a Stat Descriptor

Advanced mode only.

1. Select the stat, then open its Descriptors tab.
2. In the empty row at the bottom, type the top of the band in Up to.
3. Type the word or phrase in New Description.
4. Select the + button (Add Descriptor).

What the AI sees

Each stat's Name is always sent. The Stats chip in your prompt decides what is sent with it:

Piece	Adds
Range	The current value and its maximum: 62/100, or 62% for a percentage stat
Descriptor	The matching Stat Descriptor, a word for the current level
Description	The stat's Description

Each piece is a checkbox in the Stat Detail row of the chip's Chip Options. At least one stays checked. The Entities and Persona chips have the same row for the stats they send.

⚠️ Every active stat is sent on every turn. Stats use your context budget all the time. Three stats that matter are better than twelve that don't.

The panel

Select a stat to open its panel. In Advanced mode the panel has three tabs.

Tab	Holds	Mode
Details	The fields below	Simple and Advanced
Descriptors	Stat Descriptors	Advanced only
Code	Dynamic Value Calculation	Advanced only

In Simple mode the panel shows the basic fields with no tabs.

The fields

Field	What it does
Name	The AI uses this name for the stat. The game also uses it to match stat changes to the stat.
Type	Number has a range you set. Percentage is fixed at 0–100 and shows everywhere as N%. All other fields work the same for both.
Description	What the stat represents. Sent to the AI when the chip's Description piece is on. Takes placeholder chips.
Min / Max	The range. The value always stays in it. A percentage stat locks these at 0 and 100, so you set only its Base Value (%).
Base Value	Where the stat starts, before traits change it.
Regen	Added to the value as story time passes. Pick the span it counts per: Minute, Hour, Day or Week. Hour is the default. With Measured Clock off, each turn takes the player's Time Per Turn, one hour by default. A positive number heals over time, and a negative number drains. An inactive stat gets no Regen.
Body Sliders	Binds the Avatar's body sliders to this stat. The value, from Min to Max, sets each slider's position. Each slider belongs to one stat only.

Availability

Advanced mode only. Two checkboxes:

Checkbox	What it does
Enabled	Keeps the stat active. Uncheck it, and the stat stays inactive until a trait enables it. An inactive stat isn't shown to the player or sent to the AI. Its Regen and code don't run.
Hidden	Hides the stat from the player. The AI still reads it, and its Regen and code still run. Use it for dice rolls, cooldowns and other bookkeeping.

Prevent AI Changes

Advanced mode only. Four checkboxes stop the AI from changing a stat in one direction. Your world's own rules can still change it.

Checkbox	Stops the AI from
Don't Increase	Raising the value
Don't Decrease	Lowering the value
Don't Increase Max	Raising the Max
Don't Decrease Max	Lowering the Max

A percentage stat shows only the first two, because its Max is always 100.

Stat Descriptors

A descriptor turns a number into a word, such as Winded or Exhausted. The AI gets that word when the chip's Descriptor piece is on. A descriptor takes placeholder chips, so a band can name the rolled town or the rolled rival.

Each descriptor has a threshold and a Description. The coverage bar above the rows shows each band from Min to Max, and it marks where the stat starts. It shows when the stat has one descriptor at least. The range above your top band shows in red with the label "no status". In that range the AI gets no status. Each row says what it covers.

⚠️ A threshold is the top of its band, and the lowest band that fits the value wins. The game reads descriptors from low to high, in any list order. So 30 → Barren covers Min to 30, and a 60 row covers the values above 30, up to 60. Give your highest descriptor a threshold of your Max, or a value above it gets no descriptor.

Thresholds in: Raw or % of Max

Setting	A threshold of 3 on a 0–10 stat means	Raise Max to 20, and
Raw (default)	The value 3	The band still ends at 3
% of Max	3% of the range from Min to Max: the value 0.3	The band rescales to 0.6

• Raw is for counters: "3 rockets is low".
• % of Max is for proportions: "the bottom 30% is low".

When you switch, your numbers convert, so no band moves. The choice only changes what happens the next time you change the range. A percentage stat has no switch, because both settings give the same number on 0–100.

Pins on a descriptor

Advanced mode only. Each descriptor row has a pin button. A pin keeps a placeholder at one value while the stat is in that band.

Dynamic Value Calculation

The Code tab holds two code boxes. Each box takes JavaScript, and each has its own Test Code and Templates buttons. Templates opens a list of code shapes to insert.

Box	Runs
Before the AI	Before the prompt is built
After the AI	After the AI's stat changes and Regen apply

The turn order is: Before the AI, the AI's stat changes, Regen, After the AI. An empty box is skipped, and the manual value stays.

Code can do five things:

• Set this stat's value, Min, Max or Regen. A returned number sets the value.
• Write the value, Min, Max or Regen of another stat, global or owned by any entity
• Pin or unpin a placeholder
• Switch a trait on or off
• Read every active stat, every trait, every placeholder and the story clock

The code runs in an isolated sandbox with no page and no network. The editor suggests the names you can use as you type, and it underlines unknown names. Test Code runs one box and shows the result, the warnings and the errors.

⚠️ Code that sets the value overwrites the AI. The value is set again on every turn, so the AI's change to it is lost. The AI still reads the value and the description.

📘 Full reference: Stat Code Guide.