Created
May 13, 2025 19:37
-
-
Save isXander/22227a025f9489e1ee0f0e5cd2762927 to your computer and use it in GitHub Desktop.
This is an example of how Minecraft Java might implement data-driven GUI screens.
This file contains hidden or 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
| ```json | |
| // minecraft/gui/components/server_list.json | |
| { | |
| "params": { | |
| "servers": { // `Type` | |
| "type": "minecraft:list", // `Type` | |
| "item_type": { // `Type` | |
| "type": "minecraft:compound", | |
| "components": { // `map<name, Type>` | |
| "name": "minecraft:component", | |
| "motd": "minecraft:component", | |
| "server_id": "minecraft:string" | |
| } | |
| } | |
| } | |
| }, | |
| "item": { | |
| "type": "minecraft:for_each", | |
| "with_params": { | |
| "list": "servers" | |
| }, | |
| "item_name": "server" // e.g. java (server) -> {}, adds server param to scope | |
| "iter": { | |
| "type": "minecraft:server_entry", | |
| "with_params": { | |
| "name": "server.name", | |
| "motd": "server.motd", | |
| "server_id": "sever.server_id" | |
| } | |
| } | |
| } | |
| } | |
| // minecraft/gui/components/server_entry.json | |
| { | |
| "params": { // params can dynamically change if they're provided from java, their state automatically triggers UI updates | |
| "name": "minecraft:component", | |
| "motd": "minecraft:component", // for example, the java backend could auto update the motd | |
| "server_id": "minecraft:string" | |
| }, | |
| "handler": { | |
| "join_server": { // this stub is implemented within java (could be a separate data file?) | |
| "server_id": "minecraft:string" | |
| } | |
| }, | |
| "item": { // root component | |
| "type": "minecraft:clickable", // this means minecraft:button can be composable with data as well | |
| "click": { | |
| "type": "minecraft:ref", | |
| "ref": { | |
| "id": "join_server", | |
| "params": { | |
| "with_params": { // an obj to put fields to obj from component params | |
| "server_id": "server_id" | |
| } | |
| } | |
| } | |
| } | |
| "item": { | |
| "type": "minecraft:padding", | |
| "x": 2, | |
| "y": 2, | |
| // padding (x and y), left, right, top, bottom could also be defined here | |
| "item": { | |
| "type": "minecraft:hstack", | |
| //"gap": 2, | |
| "alignment": "leading/centre/space-around/space-between/trailing" | |
| "items": [ | |
| { | |
| "type": "minecraft:image", | |
| "ref": "id registered from java", | |
| // OR | |
| "sprite": "gui sprite" | |
| }, | |
| { | |
| "type": "minecraft:vstack", | |
| "alignment": "space-around", | |
| "gap": 2, | |
| "items": [ | |
| { | |
| "type": "minecraft:text", | |
| "with_params": { | |
| "text": "name" // references params at the top | |
| } | |
| }, | |
| { | |
| "type": "minecraft:text", | |
| "with_params": { | |
| "text": "motd" | |
| } | |
| } | |
| ] | |
| } | |
| ] | |
| } | |
| } | |
| } | |
| } |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
At what point are you just re-implementing a whole programming language in JSON?
A better solution would be to instead rely on a scripting interpreted language, instead of JSON. Like Lua, or JS.