neoskript-cli 0.1.0

The first release of neoskript-cli. It shows what NeoSkript makes of your Skript scripts before you switch.

java -jar neoskript-cli-0.1.0.jar check plugins/Skript/scripts

It starts a throwaway headless Paper server and loads your scripts there without running them. The server is downloaded once into ~/.neoskript/cache and checked against its pinned SHA-256. For each script it lists:

• error: lines NeoSkript won't load, with Skript's message;
• warning: Skript's warnings;
• folia: what may behave differently on Folia:
  • global events;
  • reads of entities or blocks in another region (use run on);
  • changes sent to another region;
  • read-modify-write of a global variable;
• performance: what's likely to cost a lot of server time:
  • fast every loops over players or entities;
  • all entities;
  • busy while loops.

Options: --json <file>, --hints-only, --quiet, --minecraft 26.3|1.21.4, --verbose, --version.

Exit codes: 0 when every script loads, 1 when some don't, 2 when the check couldn't run.

Needs: Java 21, or Java 25 to check against Minecraft 26.3, which is the default when your Java runs it.

Checked against: NeoSkript as of 2ba9b7c. It runs Skript 2.17's whole test suite (862/862) and matches a real Skript 2.17.0 server on 98.8% of the differential's 1,613 units.

The NeoSkript plugin itself isn't released yet. This is the CLI only.

SHA256SUMS has the jar's checksum.