Home

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, hopper-like access to the inventories around it, 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, if/while/for, recursion — compiled to bytecode and run on a stack VM.
Redstone	Read the signal on any of the six sides, emit 0–15 out of any of them — or park on rs_wait() and wake only when an input changes.
Inventories	Inspect and move items in the chest, furnace, hopper or other container on any side, hopper-style.
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, real-world time.
Signs	Read or write the 4 lines (and color) of any adjacent sign.
Mobs	List nearby living entities by type, name and distance.
Players	List nearby players by name, message them in chat — and overhear what they say back with hear().
Hologram	Float live text above the pot with display(), visible to everyone.
Music	tone() plays every note-block instrument at any pitch; wire pots together for a band.

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.

Memory Card

The Memory Card (also in the PotScript creative tab) copies a program between pots without wifi. Sneak-right-click a pot to copy its program onto the card; right-click another pot to install it there, stopping whatever it was running. The tooltip shows which hostname the program came from and its size. The program is stored on the item itself, so it survives item frames, shulker boxes and hoppers — you can hand working code to another player, or mail it across the server.

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.