Alpha 3

NOTICE: Following the past releases, skript-gui ONLY supports the latest version of Skript. Critical fixes may be backported for older versions if needed.

It has been a while since the last alpha, but there has been a lot of progress made since. Many bugs have been fixed, syntax has changed, and performance has hopefully improved. Please review the change log for details. However, there may have been some things I missed! Please feel free to ask questions here on GitHub and on Discord. You can join the official skript-gui support channel on Discord at https://discord.com/invite/aSTrApthYg

As always, please share your feedback and issues. It is invaluable to the addon's development :)
Issues can be opened at https://github.com/APickledWalrus/skript-gui/issues

Please note that you must be running Skript 2.6-beta3 for this alpha to work.

Additions

• GUIs may now be used as an inventory in Skript syntax (closes #17)
• Added an expression to get and change the ID of a GUI (closes #18)

Examples: send id of player's gui to player, set id of player's gui to "new id"

• Writing inventory is no longer required in some cases when creating a GUI inventory (closes #22)

The following inventories do not require you to add inventory onto the end:
crafting table/workbench, chest, anvil, hopper, dropper, and dispenser

• Added a GUI section to run code when the GUI is opened (closes #40)

Syntax:
run (when|while) open[ing] [[the] gui]
run (when|while) [the] gui opens
run on gui open[ing]

The backend of the addon has been completely rewritten. This should make it less sensitive to Skript updates (meaning it shouldn't break) and improve performance.

Fixes

• Blocked usage of some "illegal" inventories (closes #31)
• Fixed an issue where attempting to unformat a GUI slot caused an error (closes #32)
• Fixed a duplication glitch related to the recipe book (closes #33)

Please note that for the fix for #33 you MUST be running a Paper server. Just like Skript, skript-gui works best with Paper. You can download Paper at https://papermc.io/downloads

• Fixed an issue where skript-gui blocked Skript inventory events (closes #34)
• Fixed an issue where running code when a GUI item is clicked caused an error if no local variables were set (closes #35)
• Fixed an issue where unformatting GUI slots wouldn't work in some cases (closes #41)
• Fixed an error that could occur during GUI item clicks (closes #48)
• Fixed possible issues with changing the size of a GUI
• Block invalid usage of expressions where possible by using native Skript API features (e.g. using arguments in a GUI click section)

BREAKING CHANGES 🌟

• Fixed an issue where gui size returned the number of slots instead of rows (closes #44)

If you depended on this returning the number of slots, you will have to rework your code! Sorry for any trouble this causes

• The GUI properties expression has been completely rewritten, and the syntax has changed. It is now a property expression so that it may be used outside of editing sections. This was done to improve the syntax and usability.

New Syntax:
[the] (name[s]|(size[s]|rows)|shape[s]|lock status[es]) of %guis%
%guis%'[s] (name[s]|(size[s]|rows)|shape[s]|lock status[es]) of %guis%

• Reworked the syntax for the GUI values expression. This was done to improve syntax flow and usability.

New Syntax:
[the] gui slot
[the] gui raw slot
[the] gui hotbar slot
[the] gui inventory
[the] gui inventory action
[the] gui click (type|action)
[the] gui cursor [item]
[the] gui [(clicked|current)] item
[the] gui slot type
[the] gui player
[the] gui (viewer|player)s
[the] gui slot id
[the] gui

• The open gui effect was removed. Therefore, open gui is no longer valid syntax. You can use open the last gui to the player to open a GUI.