Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!
Minecraft plugins in JS/TS — GraalJS (1.18-1.21) + Nashorn legacy (1.12.2/1.16.5), typed API, hot reload.
PaperScript
Write Minecraft server plugins in JavaScript/TypeScript. A host plugin embeds a JS engine and loads scripts from a folder, exposing a small typed API (ps) with hot reload.
Two lines, one API
| Minecraft | Java | Engine | Jar |
|---|---|---|---|
| Paper 1.18 - 1.21 | 17 / 21 | GraalJS | paperscript-host |
| Paper 1.12.2 / 1.16.5 | 8 / 11 | Nashorn | paperscript-legacy |
Example
ps.onEnable(() => {
ps.commands.register('hello', (ctx) => {
ctx.sender.sendMessage('<green>Hello, ' + ctx.sender.name + '!</green>');
});
ps.events.onPlayerJoin((e) => e.player.sendMessage('<gold>Welcome!</gold>'));
});
- Typed SDK:
npm i -D @paperscript/sdk, scaffold withnpx paperscript init - MiniMessage chat (modern) / legacy &-codes (legacy)
- Hot reload via
/ps reload <name>— no server restart - Sandboxed scripts: no Java.type, no host IO, main-thread only
Full docs: https://darkpix.ru/paperscript/docs
Pinned Versions
Pages
Members
Owner