ISS

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)

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

1. Global Inventory
   Use the save_default function to save a global inventory, including the desired ID as an argument.

   Example:

   /function iss:functions/save_default {id:"starter_kit"}
   

2. Personal Inventory
   To save a personal inventory, use the save_custom_layout function with the ID argument.

   Example:

   /function iss:functions/save_custom_layout {id:"starter_kit"}
   

Loading

Loading commands replace the player's entire inventory.

1. Global Inventory
   Use the load_default function to load a global inventory, specifying the ID.

   Example:

   /function iss:functions/load_default {id:"starter_kit"}
   

2. Personal Inventory
   To load a personal inventory, use the load_custom_layout function 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_layout function. This will clear and reset the personal inventory of the executing player.

  Example:

  /function iss:functions/reset_custom_layout {id:"starter_kit"}