介绍
How to use
Valid IDs
The ID can generally be any character although using special characters is not recommended as this can lead to unpredictable behavior
Loading a Layout
This can be done by running iss:functions/load/ {id:<your id>}
If the player doesn’t have a saved Layout tied to the ID it will try to run the defined fallback function(see “Defining a fallback function“) if there is no fallback function defined for that ID it will fail
You can also load the defined fallback function directly by running iss:functions/load/fallback {id:<your id>}
Saving
You can save a Layout by running iss:functions/save {id:<your id>}, this will save the Inventory of the player who is executing it to the specified id
Deleting Layouts
To delete a Layout of a spesific player run iss:functions/delete/ {id:<your id>} as the player.
To delete _All_ Layouts associated with a certain id run iss:functions/delete/all {id:<your id>}
Defining a fallback function
To add a fallback function to an id run data modify storage iss data.<your id>.fallback set value "<your function path>"
I Would Highly Recommend that you put the command in your load function as deleting _All_ Layouts will also remove the fallback function data(subject to change)
How to use [old pre 2.0.0]
Inventory Types
Global Inventories
Global inventories serve as a backup for personal inventories, operating independently from individual player data.
Personal Inventories
Personal inventories are linked to individual players. They were originally designed for those who wanted to customize their kits differently from the default options, but they can be used for any purpose. If a player attempts to load a personal inventory that hasn’t been saved yet, the corresponding global inventory will be loaded instead.
Saving and Loading Inventories
Inventory Ids
To save or load an inventory, you must always provide the inventory’s ID. Note that certain characters are not allowed in the inventory ID, including:
- Spaces
- Periods (
.) - Square brackets (
[]) - Parentheses (
())
Saving & Loading
These commands are designed to store and restore the inventory of the player who executes them.
Saving
- Global Inventory Use the
save_defaultfunction to save a global inventory, including the desired ID as an argument.
Example:
/function iss:functions/save_default {id:"starter_kit"}- Personal Inventory To save a personal inventory, use the
save_custom_layoutfunction with the ID argument.
Example:
/function iss:functions/save_custom_layout {id:"starter_kit"}Loading
Loading commands replace the player’s entire inventory.
- Global Inventory Use the
load_defaultfunction to load a global inventory, specifying the ID.
Example:
/function iss:functions/load_default {id:"starter_kit"}- Personal Inventory To load a personal inventory, use the
load_custom_layoutfunction with the ID argument.
Example:
/function iss:functions/load_custom_layout {id:"starter_kit"}Resetting Personal Inventories
- To reset a player’s personal inventory, use the
reset_custom_layoutfunction. This will clear and reset the personal inventory of the executing player.
Example:
/function iss:functions/reset_custom_layout {id:"starter_kit"}常见问题
ISS 支持哪些 Minecraft 版本？
ISS 支持 Minecraft Java 版 1.20.2–1.21.8，共 14 个版本。下载时注意选择和你游戏版本一致的文件。
ISS 怎么安装？
新建世界时在「数据包」里把下载的 .zip 拖进去；已有的存档，把文件放进存档目录下的 datapacks 文件夹，进游戏输入 /reload 即可生效。服务器同样放在世界目录的 datapacks 里。
评论
登录后评论和评分