Quickstart

Placing a pot

1. Place a Server Pot (creative tab PotScript, or break/craft the block item).
2. Right-click it to open the terminal.
3. Type edit (or click Edit) to open the code editor.
4. Paste a program and click Save & Run.

# blink a redstone lamp above the pot, once a second
let on = false
while true {
    on = not on
    if on { rs_set("up", 15) } else { rs_set("up", 0) }
    print("lamp is " + str(on))
    sleep(20)
}

Type stop in the console to halt it. Type help for shell commands, help lang for the built-in cheat sheet.

---

The terminal

The terminal has two views: a console with a command line, and a code editor.

• Console — scrollback of the last 200 lines. White lines are echoes of what you typed, yellow lines are status ([running], [saved], [net] ...), red lines are errors, green is program output.
• Editor — a plain text area with Save, Save & Run and Console buttons. Programs are capped at 100,000 characters.

The terminal only stays connected while you are within 16 blocks of the pot.

Shell commands (when no program is running)

Command	Effect
help	List commands
help lang	Print the PotScript cheat sheet
run	Compile and run the stored program
stop	(no-op when idle)
edit	Open the code editor
cat	Print the program source
hostname	Show this pot's hostname
hostname <name>	Rename the pot on the wifi network
scan	List every reachable host
ping <host>	Check whether a host is online
ls	List disk keys and abbreviated values
rm <key>	Delete a disk key
df	Show disk usage
clear	Clear the console
reboot	Stop the program, reset redstone, clear console, take down the hologram

While a program is running

Every line you type is queued and handed to the next read() call — except:

• stop halts the program instead of being delivered.
• edit is intercepted by the client and opens the editor; it never reaches the pot.

The input queue holds 16 lines; extra lines are rejected with [error] input queue full. Lines are stripped of surrounding whitespace, truncated to 256 characters, and empty lines are dropped.

---

Next: Language Guide — syntax, types, variables, operators, control flow and functions.