Přeskočit na obsah
← Projekty

Open source (Skript / Minecraft komunita)

skJson — JSON & HTTP addon pro Skript

Výsledek Dlouhodobě udržovaný open-source nástroj s tisíci staženími.

Open-source addon skJson pro SkriptLang: nativní JSON/JSONC, asynchronní HTTP, cache, file watching a NBT serializace pro Paper/Spigot servery. Veřejný projekt s tisíci staženími a dlouhodobou údržbou.

Délka realizace: od 2022, aktivní údržba (aktuálně 6.x)

skJson — JSON & HTTP addon pro Skript

Výchozí situace

Skript komunita (Paper, Spigot, Purpur…) potřebuje v skriptech pracovat s JSON API, konfiguračními soubory a HTTP — bez psaní plnohodnotného Javového pluginu na každou integraci.

Existující řešení byla zastaralá, neúplná nebo bez spolehlivého HTTP a moderní Skript syntaxe. Od října 2022 vzniká skJson jako addon, který to řeší natrvalo.

Problém

Bez solidního JSON/HTTP addonů skripteři:

  • ohýbali textové parsování a křehké workarounds,

  • neměli spolehlivé async HTTP (GET/POST/PUT/PATCH/DELETE/HEAD),

  • bojovali s NBT a serializací Bukkit/Minecraft objektů,

  • naráželi na rozbití při upgradu Skriptu nebo Minecraft verze.

Nejtěžší část dlouhodobě není „umět Gson“, ale udržet kompatibilitu napříč Skript 2.x, Java 21+ a serverovými platformami — a zároveň držet dokumentaci a releasy.

Rozhodnutí

Postavit ostře zaměřený addon místo dalšího „univerzálního frameworku“. Veřejný open source, jasné releasy, wiki a dokumentace na Skript Hub.

Verze 6.0 přešla na moderní SyntaxRegistry, spolehlivější HTTP parametry a JSONC — s požadavkem Skript 2.15+ a Java 21+.

Řešení

skJson dnes nabízí:

  • nativní JSON a JSONC, JSON Path, čtení/zápis souborů,

  • asynchronní HTTP klienta se sdíleným clientem a timeouty,

  • in-memory cache a sledování změn JSON souborů,

  • NBT serializaci a převody Bukkit/Minecraft objektů,

  • dokumentaci, wiki a pravidelné GitHub releasy (JAR pro servery).

Podporované prostředí zahrnuje Paper / Spigot / Purpur (1.16.5+) a novější forky. Projekt žije na GitHubu pod cooffeeRequired/skJson.

Výsledek

Addon používá komunita serverů a skripterů v produkci. Stabilní releasy řady 5.x/6.x mají na GitHubu tisíce až desítky tisíc stažení JAR u jednotlivých buildů (ověřitelné na stránce Releases projektu).

  • Co drží GEREQ / autor: API, kompatibilita se Skript/Java, dokumentace, releasy a podpora issue trackeru.

  • Co drží komunita: skripty a servery v produkci, zpětná vazba z issue a diskusí.

Pro GEREQ je skJson důkaz dlouhodobé údržby: stejná disciplína releasů a dokumentace jako u klientských integrací — ne marketingový README bez follow-upu.

Ponaučení

Malý nástroj s jasným účelem a poctivou údržbou často přinese víc než velká platforma. U open source rozhoduje kompatibilita, dokumentace a tempo releasů — ne marketingový README.

Technologie

  • Java
  • SkriptLang
  • Gson
  • Paper/Spigot API
  • HTTP client

Repozitář

https://github.com/cooffeeRequired/skJson