Getting Started

Stonescript is a minimalistic scripting language built into the Mind Stone in Stone Story RPG. It runs 30 times per second and lets you automate your equipment choices, abilities, and UI.

New to Stonescript?

Start with the Introduction to the Mind Stone interactive tutorial, then come back here for the full reference.

A Full Example

This script demonstrates most of what Stonescript can do in just a few lines:

// Equips the Shovel for Rocky Plateau.
// In Caves of Fear it equips loadout 1,
// except against the boss, where the
// Grappling Hook and a 7 star War Hammer are used.
// For Haunted Halls it uses two Wands.
// Potion activates if hitpoints fall below 10.

?loc=rocky
  equip shovel
?loc=cave
  loadout 1
  ?foe=bolesh
    equip grap
    equip hammer *7 D
?loc=halls
  equipL poison wand
  equipR vigor wand
  ?loc.stars > 5
    equip vigor staff +13
?hp < 10
  activate potion

How It Works

The script runs every frame (30fps). Each ? line evaluates a condition — if true, the indented lines below it execute. This makes it easy to build layered logic:

?loc = caves       // if in Caves of Fear...
  loadout 1        //   use loadout 1

See the Basics page for a full breakdown of conditions, branching, and indentation rules.

Key Concepts

Concept	Where to learn
? : :? conditions	Basics
var variables	Variables
func functions	Functions
for loops	Loops
Arrays []	Arrays
import / new	Importing Scripts
equip, activate, >	Commands
loc, foe, hp	Game State

The Mind Stone

• The script can be edited mid-run by pressing M
• The power button in the top-right turns the script ON/OFF
• Holding Tab in-game shows game state values and recent errors
• Common shortcuts like Ctrl+A, Ctrl+C, Ctrl+V work in the editor