-
Notifications
You must be signed in to change notification settings - Fork 3
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
8dea53f
commit 95d38c8
Showing
1 changed file
with
156 additions
and
37 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,5 +1,3 @@ | ||
| # SkJson 4.1 (WIP) | ||
|
|
||
|  | ||
|  | ||
|  | ||
|
|
@@ -9,6 +7,8 @@ | |
| [](https://www.codefactor.io/repository/github/cooffeerequired/skjson) | ||
| [](https://github.com/SkJsonTeam/skJson/actions/workflows/maven.yml) | ||
|
|
||
|
|
||
|
|
||
| <br /> | ||
|
|
||
| [//]: # (<- Header ->) | ||
|
|
@@ -17,53 +17,172 @@ | |
| </p> | ||
| <h1 align="center">SkJson <img align="center" style="border-radius: 20px;" alt="SkJson" width="5%" src="https://i.ibb.co/zV3Pxht/New-Project-4.png"></h1> | ||
|
|
||
| <h3 align="center">The modern way how to handle JSON in Skript</h3> | ||
| <h6 align="center">The addon uses GSON (Google JSON) for work with JSON in Skript</h6> | ||
| <h3 align="center">The modern way how to handle JSON in the Skript</h3> | ||
| <h6 align="center">The addon uses GSON (Google JSON) for work with JSON in Skript</h6> | ||
| <hr> | ||
|
|
||
| ## 📑 Requirements | ||
| ### 📑 Requirements | ||
|
|
||
| * **Java 21+** | ||
| * **Java 17+** | ||
| * **Minecraft 1.16.5+** | ||
| * **Skript 2.9.2+** | ||
| * **Skript 2.8.0 +** | ||
|
|
||
| ## 🔑 Recommended Tools | ||
| ### 🔑 Recommended | ||
|
|
||
| * **[Visual Studio Code](https://code.visualstudio.com/download)** | ||
| * **[Skript Extension](https://marketplace.visualstudio.com/items?itemName=JohnHeikens.skript)** | ||
| * **[**Visual Studio Code**](https://code-visualstudio-com.translate.goog/download?_x_tr_sl=en&_x_tr_tl=cs&_x_tr_hl=cs&_x_tr_pto=sc)** | ||
| * **_[**Extension**](https://marketplace.visualstudio.com/items?itemName=JohnHeikens.skript)_** | ||
|
|
||
| ## 🆘 Where Can I Get Help? | ||
| ### 🆘 Where can I get help? | ||
|
|
||
| * **[Discord](https://discord.gg/dsZq5Cs9fd)** | ||
| * **[SkUnity](https://skunity.com/)** | ||
| * **[Email](mailto:[email protected])** (Only for major issues and projects) | ||
|
|
||
| ## 💡 What's New in SkJson? | ||
|
|
||
| The new version of SkJson is currently a **Work in Progress (WIP)**. Our goal is to make JSON handling in Skript easier and more efficient than ever before. This release will feature major improvements in terms of performance, usability, and compatibility, providing you with a seamless experience for all your scripting needs. | ||
|
|
||
| ### Key Improvements: | ||
|
|
||
| - **Java 21+ Compatibility**: SkJson now requires Java 21 or higher, ensuring that the addon takes full advantage of the latest performance improvements and language features. | ||
| - **Skript 2.9.2+ Compatibility**: Updated compatibility to require Skript 2.9.2+, providing better support and additional features that enhance your scripting workflow. | ||
| - **Enhanced JSON Parsing**: The new version significantly optimizes JSON parsing using GSON, resulting in faster and more reliable JSON handling. | ||
| - **Modular Architecture**: SkJson has been redesigned to offer a more modular architecture, making it easier to extend functionalities and customize the addon to fit your needs. | ||
| - **Improved Error Handling**: Added detailed error messages and handling mechanisms to make debugging easier and to provide more insight into what might go wrong during JSON operations. | ||
| - **Better Performance**: With the new Java version requirements, SkJson utilizes improved garbage collection and other JVM enhancements to boost performance, especially when dealing with large JSON structures. | ||
| - **Streamlined API**: The API has been simplified to reduce complexity. Many methods have been refined to provide a more intuitive experience for developers. | ||
|
|
||
| ### Upcoming Features: | ||
|
|
||
| - **File Handling Improvements**: Expect better integration for reading, writing, and updating JSON files with more control and options. | ||
| - **Skript/Bukkit Object Serialization**: Enhanced capabilities for converting Bukkit and Skript objects directly into JSON and vice versa, making it even easier to work with in-game data. | ||
| - **Advanced Request Handling**: Improved support for HTTP requests, including additional methods (POST, PUT, DELETE) with simplified syntax and more customization options. | ||
| - **Async JSON Operations**: Support for asynchronous JSON processing to prevent lag during heavy JSON operations and to improve server responsiveness. | ||
|
|
||
| Stay tuned for the upcoming features and examples that will make working with JSON more powerful and intuitive! | ||
| * **[Email](mailto:[email protected])** (Only the biggest projects) | ||
|
|
||
| ### 💡 How can I start with SkJson? | ||
|
|
||
| #### All tutorials are based on the latest version **`2.9`** | ||
|
|
||
| for the first time and recommend working with [SkJson Documentation](https://skjson.xyz/) | ||
|
|
||
| #### 🗝️ Create json object/array from sources. | ||
|
|
||
| ```shell | ||
| on script load: | ||
| # From String | ||
| # We can use escape sequences so two double quotes, or we can use single quote | ||
| # Or we can define only KEYS without any quotes | ||
| set {_json} to json from text "{""A"": false}" | ||
| set {_json} to json from text "{'A': false}" | ||
| set {_json} to json from text "{A: false}" | ||
|
|
||
| # From file (json/yaml) | ||
| # YAML: you can your old yaml file and SkJson will convert that to JSON file | ||
| set {_json} to json from json file "plugins/SkJson/Files/test.json" | ||
| set {_json} to json from yaml file "plugins/SkJson/Files/test.yaml" | ||
|
|
||
| # From website | ||
| # That will work only for GET! If you want to use other methods you should use requests | ||
| set {_json} to json from website "https://dummyjson.com/products/1" | ||
|
|
||
| # From any Skript/Bukkit object | ||
| set {_json} to json from location(10, 20, 30, world("world")) | ||
| ``` | ||
|
|
||
| This depends on what you want to do in SkJson, if you just want to work with JSON you can just use `Map/From` but if you | ||
| want for example `Request's` or work with files we have a small guide here. | ||
|
|
||
| #### 🗝️ Example for requests. | ||
|
|
||
| Suppose we have some API and we want to use Skript to work with that API and get JSON responses from that API (server), | ||
| SkJson offers [Request's](https://skjson.xyz/documentation/beta#section-Request) according to its own. | ||
|
|
||
| ```sh | ||
| on script load: | ||
| async make POST request to "https://dummyjson.com/carts/add": | ||
| header: "Content-Type: application/json" | ||
| content: json from text "{userId: 1, products: [{id: 1, quantity: 1}, {id: 50, quantity: 2}]}" | ||
| save incorrect response: true | ||
| lenient: true | ||
| save: | ||
| content: {-content} | ||
| headers: {-header} | ||
| status code: {-code} | ||
| url: {-url} | ||
| command response: | ||
| trigger: | ||
| send {-content} with pretty print | ||
| ``` | ||
|
|
||
| What does mean `lenient` ? | ||
| **__`lenient`__** means attempting to repair corrupted JSON from a server response. (thanks to `@mnight4`) | ||
| <br /> | ||
|
|
||
| <hr> | ||
| #### 🗝️ Example for handling JSON file /wo cache. | ||
|
|
||
| SkJson can work with files whether it is writing, editing or appending. See | ||
| also [Write](https://skjson.xyz/documentation/beta#effect-Write), [New](https://skjson.xyz/documentation/beta#effect-New), [Edit](https://skjson.xyz/documentation/beta#effect-Edit) | ||
|
|
||
| ```sh | ||
| # here we will create a new file | ||
| options: | ||
| file_path: "plugins/SkJson/jsons/test.json" | ||
|
|
||
| on script load: | ||
| new json file {@file_path} if json file {@file_path} does not exist | ||
|
|
||
| # here we will work with the json file | ||
|
|
||
| set {_json} to json from file {@file_path} | ||
|
|
||
| # writing to file | ||
| set {_data} to json from location(10, 20, 30, world("world")) | ||
| write {_data} to json file {@file_path} | ||
|
|
||
| # editing directly file | ||
| edit value "world" of json file {@file_path} to "New World" | ||
|
|
||
| # editing file with step over | ||
|
|
||
| # getting the json file as Json object | ||
| set {_json} to json from file {@file_path} | ||
| set value of json object "world" in {_json} to "New World(By rewrote)" | ||
|
|
||
| # write file back to JSON | ||
| write {_json} to json file {@file_path} | ||
| ``` | ||
| #### 🗝️ Example for handling JSON file /w cache. | ||
| What is `cache`? Cache is known for storing JSON in memory instead of SkJson having to open and close the file it puts | ||
| its reference in memory, and you are working with memory all the time and if you would like to save the file from memory | ||
| to a real file. you can do it at any time with `save <json-id>` | ||
| Check out this | ||
| documentation.: [Write](https://skjson.xyz/documentation/beta#effect-Write), [New](https://skjson.xyz/documentation/beta#effect-New), [Edit](https://skjson.xyz/documentation/beta#effect-Edit), [Link File](https://skjson.xyz/documentation/beta#effect-LinkFile), [Save File](https://skjson.xyz/documentation/beta#effect-SaveCache), [Unlink File](https://skjson.xyz/documentation/beta#effect-UnlinkFile), [Get Cached JSON](https://skjson.xyz/documentation/beta#expression-GetCachedJson) | ||
| ```sh | ||
| options: | ||
| file_path: "plugins/SkJson/jsons/test.json" | ||
| on script load: | ||
| # here we will create a new file | ||
| new json file {@file_path} if json file {@file_path} does not exist | ||
| # here we will linked our file to our memory. | ||
| link json file {@file_path} as "your_specified_value" if json file {@file_path} exists | ||
| # here we will set value to memory reference of your file. | ||
| set value of json objct "location" in (json "your_specified_value") to location(10, 20, 30, world("world")) | ||
| # here we will get location of memory | ||
| set {_location} to value "location" of (json "your_specified_value") | ||
| # that will return {"==":"org.bukkit.Location","yaw":0.0,"world":"world","x":10.0,"y":20.0,"z":30.0,"pitch":0.0} | ||
| # here we will save memory reference back to file | ||
| save json "your_specified_value" | ||
| ``` | ||
| #### 🗝️ Now we'll look at is how SkJson works with `Skript/Bukkit` objects | ||
| ```sh | ||
| # let's say we have a command test and we work with Player Location. | ||
| command test: | ||
| trigger: | ||
| set {_json_location} to json from location of player | ||
| teleport player to {_json_location} | ||
| # that will teleport player to location converted from JSON object to location | ||
| set {_item} to diamond sword named "Test" | ||
| set lore of {_item} to "&6Gold" and "&7Silver" | ||
| enchant {_item} with Sharpness 5 | ||
| set {_json_item} to json from {_item} | ||
| give {_json_item} to player | ||
| ``` | ||
| So conclusion, if the Json object contains the correct object key `Skript/SkJson` will try to parse the JSON as a real | ||
| object. | ||
| <hr /> | ||
| [<img style="width: 20%" src="https://skripthub.net/static/addon/ViewTheDocsButton.png">](https://skripthub.net/docs/?addon=skJson) | ||
| [<img style="width: 22%" src="https://skunity.com/branding/buttons/get_on_docs_4.png">](https://docs.skunity.com/syntax/search/addon:skjson) | ||
| [<img style="width: 10%" src="https://static.spigotmc.org/img/spigot.png">](https://www.spigotmc.org/resources/skjson.106019/) | ||
|
|
||