HyperScript
Docs
Version 1.7.71 is out See what is new

Scripting for Paper and Spigot

HyperScript

Write commands, events, GUIs and scoreboards in plain text files. Save the file and it is live.

~50'000'000 calculations a secondsimple additions, measured on an ordinary PC; /hyperscript speed measures your server

Install itTake the tutorialBrowse the Docs
scripts/hello.hs
on load:
    set {_url} to "https://hyperscript.monoforge.net/api/test"
    async:
        set {_data} to send get request to {_url}
        log "The website answered: %{_data}%"
Saved.
Server console
Minecraft 1.16.5 to 26.x Servers Paper and Spigot Java 8 or newer Last updated

Estimated range. HyperScript is built against the 1.16.5 server API and has been reported working on Paper 26.2; the versions in between are expected to work but have not each been tried.

How fast it is

~50'000'000calculations a secondSimple additions in a loop, on an ordinary PC. /hyperscript speed measures your own server.
~58'000lines of script read a secondAll 9 ready-made scripts (1'684 lines) were read in 29 ms when this page was made, on the PC that made it.
~0.5 sfrom saving to liveA script is read again about half a second after its file is saved. No restart, no command.
1.4 MBthe whole pluginOne jar in the plugins folder. This website's pages are inside it too.
New in 1.7.71

Particles that showed nothing on newer Minecraft, a command to try a particle, and a question before a script found with /hs search is installed.

Everything that changed

The language today

1018 things in all 96 events 75 conditions 266 effects 470 expressions 18 types 31 functions 62 structures

That is HyperScript itself. Its 17 addons add 367 more, which makes 1385 with all of them: HyperGuard 39, HyperCitizens 36, HyperPerms 33, HyperVelocity 26, HyperVoice 26, HyperEdit 25, HyperHolograms 24, HyperMobs 22, HyperModels 21, HyperVotes 21, HyperBedrock 20, HyperGrim 16, HyperPackets 16, HyperPlots 16, HyperLog 11, HyperEconomy 10, HyperSkin 5.

A lightweight scripting language for Paper and Spigot servers, 1.16.5 and newer (estimated up to 26.x). Drop a .hs file into a folder and you have custom commands, event handlers, GUIs, scoreboards and persistent player data, with no Java and no restart: scripts reload the moment you save them.

on player join:
    add 1 to {%player%.joins}
    send "&aWelcome back %player.name%! This is visit #%{%player%.joins}%."

Overview and architecture

What is in the box, how a script runs, and where everything lives on the server.

Installation

From the jar to your first loaded script, step by step.

Configuration

Hot reloading, storage and fallback, backups, files and web access.

Tutorial

Write a command, react to an event and store player data in five minutes.

Writing scripts

How a script is laid out, how to make one easy to change, and how to find mistakes.

Scripts

Ready-made scripts to set a server up with: a sidebar, a tab list, ranks and more. Copy or download one and it is live.

Addons

Separate plugins that add to the language, such as HyperVelocity for proxy networks.

Docs

Every statement, placeholder and event on one page, with filters and instant search.