SkJson 5.6.0 — Back from archive · Skript 2.15 migration
After a long pause,
SkJson has been unarchived on GitHub and this release marks the return of the project.
Active development is resuming — bug reports, feature requests, and pull requests are welcome again.
This build is the first maintained release after
5.4.1 (August 2025). It brings the addon in line with
Skript 2.15, ships the
5.5 feature set that never received a stable tag, and includes a full round of
CI fixes so the custom test suite passes on current Paper builds.
Important: SkJson
5.6.0 requires Skript 2.15.0 or newer. It will
not load on Skript 2.14 or older (missing
SyntaxRegistry /
EventValueRegistry). Plan an upgrade of Skript before updating SkJson.
---
Why this release exists
Skript moved its registration APIs in 2.15. SkJson needed a proper migration away from legacy addon hooks, plus regression fixes for loops, English syntax aliases, virtual JSON cache, and converter registration. While the repository was archived, those changes were prepared but not published as a stable release —
5.6.0 closes that gap.
Going forward, the goal is to keep SkJson compatible with current
SkriptLang nightlies/stable builds and modern
Paper versions, with CI running on every push to
main.
---
Requirements
| | |
|---|---|
|
Java | 21+ |
|
Minecraft | 1.16.5+ (CI: Paper
26.1.1) |
|
Skript |
2.15.0+ (tested with
2.15.2) |
|
Optional | NBT-API (shaded in jar) |
Recommended stack for new servers: Paper 1.21.x+, Java 21+, Skript 2.15.2+.
---
What's new in 5.6.0
Skript 2.15 migration
- All syntax registered through
SyntaxRegistry; event values through
EventValueRegistry
- Clear startup behaviour: SkJson
disables itself if Skript 2.15 APIs are not present (no half-loaded state)
- Updated build dependencies: Paper API
1.21.11, Gson
2.14, Shadow
9.2.2, NBT-API
2.15.6
- GitHub Actions: tests run against
Skript 2.15.2 built from source on
JDK 25
Syntax & features (5.5 + 5.6)
-
Natural English aliases — read and write JSON in more intuitive Skript:
-
parse … as json,
value at path … in,
values at path … in
-
json cache,
create a virtual json cache named …
-
merge … into … /
merge … into … deeply
-
remove path /
delete path,
has path /
contains path
-
json size of,
path … of, compact/pretty JSON output
-
deep copy of {_json} — duplicate JSON trees without mutating the original
-
has path / contains path — check whether a dot-path exists before reading
-
Shallow & deep merge — patch objects into a base document (
deeply for nested merge)
-
JSON loops — iterate structure with custom loop types:
-
loop values of {_json}: →
%json-key-1%,
%json-value-1%
- Nested loops supported (
%json-key-2%, etc.)
-
HTTP module (unchanged scope) — still bundled for JSON-encoded requests/responses
Performance & reliability
-
Bounded path token cache — faster repeated access to the same paths
- Improved
resolve / resolveParsed and quieter path existence checks
-
Safer merge and navigation edge-case handling
-
Converter scope tightened —
JsonElement is no longer auto-converted to
World /
Chunk, which previously caused
save json cache to be parsed as
save worlds and similar conflicts with vanilla Skript
---
Examples
Code:
[SIZE=7]Parse and inspect[/SIZE]
set {_json} to parse "{""enabled"": true, ""count"": 3, ""tags"": [""a"", ""b""]}" as json
assert {_json} is a json object
assert {_json} has path "enabled"
assert value at path "enabled" in {_json} is true
[SIZE=7]Deep copy — original stays intact[/SIZE]
set {[i]copy} to deep copy of {[/i]json}
set value "count" of {_copy} to 99
assert value "count" of {_json} is 3
[SIZE=7]Merge configs[/SIZE]
set {_base} to json from "{nested: {x: 1, inner: {p: 1}}}"
set {_patch} to json from "{nested: {y: 2, inner: {q: 2}}}"
merge {[i]patch} into {[/i]base} deeply
[SIZE=7]Loop keys/values at root or nested path[/SIZE]
set {_data} to json from "{users: {alice: {score: 10}, bob: {score: 20}}}"
loop values of {_data}:
broadcast "key: %json-key-1%"
[SIZE=7]Virtual cache (in-memory)[/SIZE]
create a virtual json cache named "my-data"
assert json cache "my-data" exists
---
Bug fixes (since 5.4.1)
-
json is empty — correct behaviour for all registered empty-check patterns (including English aliases)
-
Deep merge —
deeply flag on
merge … into … is respected
-
File watcher — bind/unbind modes for storage watchers
-
loop values of {_json} — iterates object/array
entries, not a single wrapped value
-
save json cache — no longer clashes with Skript's
save worlds
-
Type conditions —
is a json array/object parses correctly on Skript 2.15
-
values vs value — plural patterns registered before singular ones; safe
init() with optional pattern slots
-
CI — full custom test suite green on Paper 26.1 + Skript 2.15.2
---
Upgrade guide (from 5.4.x)
1.
Upgrade Skript to 2.15+ first, then replace
skjson.jar with this release.
2. Reload or restart the server (full restart recommended after Skript major bump).
3. Re-test scripts that use:
-
loop values of …
-
save json cache / virtual cache syntax
-
size of on JSON → prefer
json size of {_json}
4. If you relied on automatic
JsonElement →
World conversion, use explicit Skript/API handling instead (that converter was removed intentionally).
---
Install
1. Download
skjson.jar from the assets below.
2. Place it in
plugins/ (
Skript 2.15+ must already be installed).
3. Restart the server and review
plugins/SkJson/config.yml if you use watchers or auto-update settings.
---
Project status & where to get help
| Resource | Link |
|----------|------|
|
Wiki |
https://github.com/cooffeeRequired/skJson/wiki |
|
Discord |
https://discord.gg/dsZq5Cs9fd |
|
Issues |
https://github.com/cooffeeRequired/skJson/issues |
|
Performance notes |
https://github.com/cooffeeRequired/skJson/blob/main/performance.md |
Active development is back. Upcoming work will focus on staying current with Skript releases, expanding tests, and addressing community feedback. If you depended on SkJson while the repo was archived — thank you for your patience; this release is meant to be a dependable baseline again.
---
Full Changelog: https://github.com/cooffeeRequired/skJson/compare/5.4.1...5.6.0
