HyperScript 1.7.8

The plugin now tells the HyperScript website that a server is running it, so the project can count its servers. It is on by default and one line in config.yml turns it off.

Changed (check your server)

• HyperScript now sends anonymous usage numbers to hyperscript.monoforge.net: once when the server starts, every ten minutes while it runs, and once when it stops. To send nothing, set send-analytics: false, the first setting in config.yml. A config.yml from an older version has no such line, which counts as on; add the line to turn it off. The console says at every start that the numbers are being sent and how to stop it.

What is sent

• a random id made for the server, kept in plugins/HyperScript/analytics-id.txt; it is not made from anything about the server;
• the versions of HyperScript, Minecraft, the server software (Paper, Spigot ...) and Java;
• how many players are online and how many fit; how many scripts are loaded;
• the names of installed HyperScript addons.

What is never sent: player names, addresses, script contents, world names, or anything typed by a player. The website does not keep the address a message came from either.

Added

Website

• POST /api/analytics takes those messages. The numbers are held in memory only: they start again when the site restarts and fill up as servers send their next message. A server that has not been heard from for 25 minutes no longer counts as online.
• GET /api/analytics?code=<code> gives the totals: servers and players online, scripts loaded, which versions of the plugin, of Minecraft, of Java and which server software, which addons, the peaks, and since when it has been counting. The code is 25 letters, made new every time the site starts, printed in the site's console and written to analytics-code.txt beside app.py (a file the site does not serve). Without the right code the answer is a refusal.
• GET /api/test answers with the plain text Yup works: somewhere real to try a first web request from a script. The Docs example that fetched https://api.example.com/stats now uses it.

Ready-made script

• Analytics.hs: /analytics <code> shows those totals in game. It is for whoever runs the website; with a wrong code it only says so. That makes 38 scripts.

Logos

• A logo for each addon, in the family of the HyperScript one: HyperVelocity, HyperPerms, HyperGuard and HyperCitizens, plus HyperScript itself for the organization. Each as an SVG and as 512 and 256 pixel PNGs, in the Logos folder beside the site.