QuestScript Guide
QuestScript adds server-side JavaScript and Python scripting to Minecraft. Scripts receive controlled Host Objects and can react to game events, schedule work, and interact with the world through public facades.
Get started
- Install QuestScript on a Fabric server.
- Create your first Script Bundle in
config/questscript/scripts/. - Load it with a QuestScript operator command.
Before loading third-party code, read the security model. The proxy-only sandbox closes direct JVM and server-process access, while gameplay operations enforce the current Script Run's operator-granted capabilities and typed scopes. Command execution remains fail-closed for now.
Learn the runtime
- Editor setup configures JavaScript and Python completion.
- Step-by-step world changes demonstrates scheduled work across multiple ticks.
- Script lifecycle explains loading, unloading, reload, cleanup, imports, and exports.
- Events and scheduling covers Before Events, After Events, Script Events, queues, and server-thread budgets.
- Host Objects and public facades describes the boundary between Scripts and Minecraft.
Server operators should also read operator commands, QuestPack deployment, and the Trace Viewer guide. The generated API Reference documents the JavaScript and Python contracts.
Alpha status. QuestScript is alpha software. Public APIs may change without backward compatibility until the first public release.