Skip to main content

QuestScript documentation

QuestScript adds server-side JavaScript and Python scripts to Minecraft. Scripts receive safe Host Objects and can react to game events, schedule work, and interact with the world through public facades.

Getting started

  1. Create a script in config/questscript/scripts/.
  2. Subscribe to an event through world or schedule work through system.
  3. Load the script with a QuestScript command.

Continue with Your first script to see the same example in JavaScript and Python.

Before installing it on a server, read Security: the proxy-only sandbox closes direct JVM and server-process access, but gameplay authorization through operator-granted capabilities is not yet complete.

Two site areas

  • Documentation explains the mod's concepts, workflows, and constraints.
  • API reference is generated automatically from the public types.d.ts and types.pyi contracts, with separate JavaScript and Python sections.
Prototype status

QuestScript is in alpha. Its public API can still change without backward compatibility.