Home

PotScript Wiki

Pot-sized programmable servers for Minecraft. A Server Pot is a block the size of a flower pot that runs your own programs, written in PotScript, a small language built for the job. Each pot has a terminal, a persistent disk, six redstone outputs and a wifi radio that reaches every other pot on the server.

Fabric · Minecraft 26.2 · Java 25

For installing the mod, building from source, and the project layout, see the README. This wiki covers the PotScript language and everything a pot can do.

What a pot can do

Terminal	Right-click the pot for a console with a command line and a built-in code editor.
PotScript	A complete little language: variables, functions, lists, strings, control flow, recursion — compiled to bytecode and run on a stack VM.
Redstone	Read the signal on any of the six sides, and emit 0–15 out of any of them.
Wifi	Pots reach each other by hostname, at any distance, across dimensions. Send, broadcast, receive with a timeout.
Disk	A key/value store that survives world reloads.
Sensors	Position, dimension, biome, weather, light level, game time, day number.
Players	List nearby players by name, message them in chat, play note-block tones.

Programs are metered: the VM executes at most 5,000 instructions per game tick and then yields. An infinite loop is completely harmless — it can never stall the server tick. See Execution Model for the details.

Pages

• Quickstart — place a pot, write your first program, and learn the terminal.
• Language Guide — lexical structure, values and types, variables, operators, control flow, functions.
• Execution Model — the metered VM, blocking calls, persistence and runtime limits.
• Standard Library — every builtin, grouped by category, with examples.
• Errors & Gotchas — how errors are reported, and the sharp edges to watch for.
• Examples — complete, worked programs.