### Placeholder Item Slot Example

Source: https://github.com/rockinchaos/itemjoin/wiki/Creating-Items

Example of using PlaceholderAPI for item slots. Ensure PlaceholderAPI is installed and configured.

```yaml
placeholder-item:
  id: EMERALD
  slot: %player_health%
```

--------------------------------

### Example Item with All Itemflags

Source: https://github.com/rockinchaos/itemjoin/wiki/Creating-Items

This example demonstrates how to configure an item with a comprehensive set of itemflags. It shows the structure for defining an item, its ID, slot, a list of enabled worlds, and a wide array of itemflags.

```yaml
items:
  ultra-item:
    id: DIAMOND_SWORD
    slot: 0
    itemflags: first-join, unbreakable, hide-attributes, hide-durability, placement, inventory-modify, cancel-events, count-lock, death-drops, self-drops, disposable, AllowOpBypass, CreativeBypass
    enabled-worlds: world
```

--------------------------------

### Example run_command JSON Event

Source: https://github.com/rockinchaos/itemjoin/wiki/Creating-Items

Provides an example of a run_command JSON event for books. This event allows for creating clickable text that executes a server command when clicked.

```text
<run_command:/say ItemJoin is so AMAZING!>
```

--------------------------------

### Example Item with Custom Permission Node

Source: https://github.com/rockinchaos/itemjoin/wiki/Creating-Items

Demonstrates how to configure an item to use a custom permission node for access.

```yaml
items:
  example-item:
    id: DIAMOND_SWORD
    slot: 0
    permission-node: 'itemjoin.specialty'
```

--------------------------------

### ItemJoin API Usage Example

Source: https://github.com/rockinchaos/itemjoin/wiki/API-&-Dependencies

Demonstrates how to get custom items for a player and check if an item is custom using ItemJoin's API.

```java
ItemJoinAPI itemAPI = new ItemJoinAPI();
itemAPI.getItems(player);
itemAPI.isCustom(item);
itemAPI.isCustom(item, world);
```

--------------------------------

### Advanced Item Configuration

Source: https://github.com/rockinchaos/itemjoin/wiki/Creating-Items

Provides a comprehensive example of an item with numerous advanced properties including interactions, enchantments, commands, cooldowns, and item flags. Use this as a template for complex item setups.

```yaml
items:
  ultra-item:
    id: DIAMOND_SWORD
    slot: 0
    name: '&bBlazefury'
    count: 1
    durability: 5
    lore:
      - '&7A god sword..'
      - '&7This is generations old!'
    interact:
      - 'message: &eYou can send yourself custom messages!'
      - 'console: say You can even execute more than one command!'
      - 'player: say This is item slot 1'
      - 'say Hello world!'
    interact-right:
      - 'console: gamemode 1 %player%'
      - 'message: &eYou have been set to creative mode.'
    interact-left:
      - 'console: gamemode 3 %player%'
      - 'message: &eYou have been set to spectator mode.'
    interact-air:
      - 'message: &eThis will prevent commands from being executed when you click on blocks such as a sign.'
    interact-air-right:
      - 'message: &eThis will prevent commands from being executed when you click on blocks such as a sign.'
    interact-air-left:
      - 'message: &eThis will prevent commands from being executed when you click on blocks such as a sign.'
    inventory:
      - 'console: gamemode 2 %player%'
      - 'message: &eYou have been set to adventure mode.'
    enchantment: FIRE_ASPECT:3, DAMAGE_ALL:5, DAMAGE_UNDEAD:5, KNOCKBACK:8
    commands-sequence: SEQUENTIAL
    commands-sound: BLOCK_NOTE_PLING
    commands-particle: FIREWORK:BLACK:RED:BURST:3
    commands-warmup: 5
    commands-cost: 25
    commands-cooldown: 5
    cooldown-message: '&7[&eItemJoin&7] &a[%item%&a] &cis on cooldown for &a%timeleft% &cseconds..'
    probability: 25
    use-cooldown: 10
    itemflags: inventory-modify, death-drops, unbreakable, disposable, count-lock, cancel-events, placement, hide-durability, hide-attributes, self-drops, first-join, CreativeBypass, AllowOpBypass
    triggers: join, respawn, world-switch
    permission-node: 'itemjoin.ultra'
    enabled-regions: region1, region2
    enabled-worlds: world, world_nether, world_the_end
```

--------------------------------

### Gamemode-Switch Trigger Example

Source: https://github.com/rockinchaos/itemjoin/wiki/Creating-Items

An example demonstrating the 'gamemode-switch' trigger, which can be used in conjunction with 'limit-modes' to manage items based on player gamemodes. It also includes 'join' and specifies enabled worlds.

```yaml
  arrow-item-example:
    id: ARROW
    slot: 0
    name: '&fArrow'
    limit-modes: CREATIVE
    triggers: JOIN, GAMEMODE-SWITCH
    enabled-worlds: world, world_nether, world_the_end
```

--------------------------------

### Item with Armor Trim Meta

Source: https://github.com/rockinchaos/itemjoin/wiki/Recent-Changes

Example of how to define armor trim meta for an item, specifying both the trim material and pattern.

```yaml
trim-test:
  id: DIAMOND_CHESTPLATE
  slot: CHESTPLATE
  trim-meta: LAPIS:COAST
```

--------------------------------

### Example open_url JSON Event

Source: https://github.com/rockinchaos/itemjoin/wiki/Creating-Items

Demonstrates a basic open_url JSON event for books. This event is used to create a clickable link that opens a specified URL.

```text
<open_url:https://www.spigotmc.org/resources/itemjoin.12661/>
```

--------------------------------

### Dynamic Command Cost Example

Source: https://github.com/rockinchaos/itemjoin/wiki/Recent-Changes

Demonstrates setting a dynamic cost for executing commands based on player data (e.g., deaths) or a fixed decimal value. This allows for economy-based command restrictions.

```yaml
commands-cost: '%player_deaths%'
commands-cost: 1.5
```

--------------------------------

### ItemJoin Custom Permission Node Example

Source: https://github.com/rockinchaos/itemjoin/wiki/Z---Main

This example shows how to assign a custom permission node to a specific item. Ensure 'Permissions.Obtain-Item' is set to TRUE in `config.yml` for item permissions to function.

```yaml
itemjoin.world_the_end.*
itemjoin.world_the_end.ultra-item

items:
  example-item:
    id: DIAMOND_SWORD
    slot: 0
    permission-node: 'itemjoin.specialty'
```

--------------------------------

### Item with Multiple Interaction Commands

Source: https://github.com/rockinchaos/itemjoin/wiki/Creating-Items

This example demonstrates how to define various commands for different interaction types (interact, interact-right, interact-left, inventory) for a specific item. It includes console, player, and op commands, delays, server switching, and item swapping.

```yaml
items:
  ultra-item:
    id: DIAMOND_SWORD
    slot: 0
    interact:
      - 'message: &eYou can send yourself custom messages!'
      - 'console: say You can even execute more than one command!'
      - 'player: say I am executed by player'
      - 'op: say I am executed by player but I have all the permissions!'
      - 'delay: 100'
      - 'server: survival'
      - 'say I am executed by player since I dont have a executor...'
      - 'swap-item: ultra-item'
    interact-right:
      - 'console: gamemode 1 %player%'
      - 'message: &eYou have been set to creative mode.'
    interact-left:
      - 'console: gamemode 3 %player%'
      - 'message: &eYou have been set to spectator mode.'
    inventory:
      - 'console: gamemode 2 %player%'
      - 'message: &eYou have been set to adventure mode.'
    commands-sequence: SEQUENTIAL
    commands-sound: BLOCK_NOTE_PLING
    commands-particle: HEART:3
    commands-warmup: 5
    commands-cost: 25
    commands-cooldown: 5
    cooldown-message: '&7[&eItemJoin&7] &a[%item%&a] &cis on cooldown for &a%timeleft% &cseconds..'
    enabled-worlds: world
```

--------------------------------

### On-Kill Command Executor Example

Source: https://github.com/rockinchaos/itemjoin/wiki/Recent-Changes

Executes a specified command when a player is killed. This is useful for triggering actions upon player death.

```yaml
example-item:
  id: IRON_SWORD
  slot: 0
  on-kill:
    - 'message: &aYou killed a player!'
```

--------------------------------

### Item Commands with Cost and Particle Effects

Source: https://github.com/rockinchaos/itemjoin/wiki/Creating-Items

Example of an item with multiple commands, a sound effect, a random single command sequence, cooldown, and triggers. This item requires specific permissions and is enabled in certain worlds.

```yaml
random-item:
    id: EMERALD
    slot: 0
    name: '&aRandomizer'
    interact:
      - 'message: &eCOMMAND 1'
      - 'message: &eCOMMAND 2'
      - 'message: &eCOMMAND 3'
      - 'message: &eCOMMAND 4'
      - 'message: &eCOMMAND 5'
    commands-sound: BLOCK_NOTE_PLING
    commands-sequence: RANDOM_SINGLE
    commands-cooldown: 5
    cooldown-message: '&7[&eItemJoin&7] &a[%item%&a] &cis on cooldown for &a%timeleft% &cseconds..'
    triggers: join, respawn, world-switch, region-enter
    permission-node: 'itemjoin.ultra'
    enabled-worlds: world, world_the_end
```

--------------------------------

### Item Command Permissions Example

Source: https://github.com/rockinchaos/itemjoin/wiki/Recent-Changes

Demonstrates how to configure permissions for item commands, including inverted permissions and custom failure messages. Use this to control who can execute commands associated with custom items.

```yaml
interact:
- 'console: eco give %player% 5000'
interact-permission: 
- '!itemjoin.group.owner'
- 'itemjoin.group.newbies'
interact-fail-message: '%prefix% &cfailed to execute the interact-right commands.'
```

--------------------------------

### Basic Item Configuration

Source: https://github.com/rockinchaos/itemjoin/wiki/Creating-Items

Defines basic items with ID, slot, name, probability, triggers, and enabled worlds. Use this for simple item setups.

```yaml
items:
  sword-of-a-god:
    id: DIAMOND_SWORD
    slot: 0
    name: '&eYou have been chosen..'
    probability: 15
    triggers: join, world-switch
    enabled-worlds: world, world_nether, world_the_end
  herobrine-apple:
    id: GOLDEN_APPLE
    slot: 0
    name: '&cHerobrine Apple'
    probability: 55
    enabled-worlds: world, world_nether, world_the_end
  filler-pane-item-four:
    id: DIAMOND_PICKAXE
    slot: 0
    name: '&fUseless Pickaxe'
    probability: 110
    triggers: join, world-switch
    enabled-worlds: world, world_nether, world_the_end
```

--------------------------------

### JSON Book Color Example

Source: https://github.com/rockinchaos/itemjoin/wiki/Recent-Changes

Specifies text and its color for JSON books. Requires the 'color' option to be enabled.

```yaml
<text:Hello World!><color:#663e10>
```

--------------------------------

### Inverted Permission Node Example

Source: https://github.com/rockinchaos/itemjoin/wiki/Recent-Changes

Shows how to grant an item to players who *do not* have a specific permission node. This is useful for creating items accessible to a general audience or specific excluded groups.

```yaml
permission-node: '!fish.cakes'
```

--------------------------------

### Item Configuration with TokenEnchant

Source: https://github.com/rockinchaos/itemjoin/wiki/API-&-Dependencies

Example of an item configuration in ItemJoin that includes both TokenEnchant and default Minecraft enchantments.

```yaml
items:
  any-text:
    id: BOW
    slot: 0
    enchantment: EXPLOSIVE:3, DISK:2, ARROW_DAMAGE:3, DAMAGE_ALL:5
    enabled-worlds: world_name_here, another_world_name
```

--------------------------------

### ItemJoin Plugin Commands

Source: https://github.com/rockinchaos/itemjoin/wiki/Z---Main

This section outlines the various commands available in the ItemJoin plugin, including their descriptions, permissions, and usage examples.

```yaml
itemjoin:
   description: Shows the plugin information, specific version, and author including a redirect
   to the help menu.
   permission: itemjoin.use
   aliases: [ij]
   usage: |
       /itemjoin
       Example: /itemjoin
```

```yaml
itemjoin help:
   description: Displays a page of the available help menu showing the available commands.
   permission: itemjoin.use
   usage: |
       /itemjoin help
       Example: /itemjoin help
       Example: /itemjoin help 2
       Example: /itemjoin help 3
       Example: /itemjoin help 4
       Example: /itemjoin help 5
       Example: /itemjoin help 6
       Example: /itemjoin help 7
       Example: /itemjoin help 8
       Example: /itemjoin help 9
```

```yaml
itemjoin reload:
   description: Reloads all plugin configuration files and caches any new data.
   permission: itemjoin.reload
   usage: |
       /itemjoin reload
       Example: /itemjoin reload - Configuration(s) Reloaded!
```

```yaml
itemjoin menu:
   description: Opens a GUI Menu to allow the view, modification, and creation of all custom items.
   permission: itemjoin.menu
   usage: |
       /itemjoin menu
       Example: /itemjoin menu - The creator menu has been launched!
```

```yaml
itemjoin info:
   description: Displays any needed information for the item you are holding, such as material type
   and in legacy versions the data value.
   permission: itemjoin.use
   usage: |
       /itemjoin info
       Example: /itemjoin info - The item type is WOODEN_SWORD.
```

```yaml
itemjoin world:
   description: Shows you what world you are in, useful for debugging purposes.
   permission: itemjoin.use
   usage: |
       /itemjoin world
       Example: /itemjoin world - You are in the world Pandora_the_end.
```

```yaml
itemjoin list:
   description: Shows you what items are defined and their respective enabled worlds.
   permission: itemjoin.list
   usage: |
       /itemjoin list
       Example: /itemjoin list - Current defines items are map-item, ultra-item.
```

```yaml
itemjoin updates:
   description: Checks for any available updates for the plugin.
   permission: itemjoin.updates
   usage: |
       /itemjoin updates
       Example: /itemjoin updates - You have requested to check for available plugin updates!
```

```yaml
itemjoin upgrade:
   description: Forces the plugin to update to the latest version if a new version is found,
   a server restart will be required for changes to take effect.
   permission: itemjoin.upgrade
   usage: |
       /itemjoin upgrade
       Example: /itemjoin upgrade - You have requested to force update the plugin.
```

```yaml
itemjoin permissions:
   description: Displays a page of every permission node showing which permissions are
   enabled/disabled for the player, including custom item nodes.
   permission: itemjoin.permissions
   usage: |
       /itemjoin permissions
       Example: /itemjoin permissions - You have the permissions itemjoin.reload.
       Example: /itemjoin permissions 2 - You have the permissions ultra-item.
```

```yaml
itemjoin get:
   description: Gives the specified custom item and the amount you specified to the player's inventory.
   permission: itemjoin.get, itemjoin.get.others
   usage: |
       /itemjoin get
       Example: /itemjoin get Ultra - You have received the item [Ultra]!
       Example: /itemjoin get Ultra 12 - You have received 12x of the item [Ultra]!
       Example: /itemjoin get Ultra RockinChaos - You have given the item [Ultra] to RockinChaos!
       Example: /itemjoin get Ultra RockinChaos 8 - You have given 8x of the item [Ultra] to RockinChaos!
```

```yaml
itemjoin getOnline:
   description: Gives the specified custom item and the amount to all online players.
   permission: itemjoin.get.others
   usage: |
       /itemjoin getOnline
       Example: /itemjoin getOnline Ultra - You have given the item [Ultra] to RockinChaos!
```

--------------------------------

### Execute Commands on Item Drop

Source: https://github.com/rockinchaos/itemjoin/wiki/Recent-Changes

Use the 'on-drop' command to specify actions that should execute when an item with this property is dropped by a player. This example shows a message being sent.

```yaml
example-item:
  id: DIAMOND_SWORD
  slot: 0
  on-drop:
    - 'message: &cCome back! You left me behind!'
```

--------------------------------

### Custom Book Item Configuration

Source: https://github.com/rockinchaos/itemjoin/wiki/Creating-Items

An example configuration for a custom book item in ItemJoin. This includes setting the ID, author, name, lore, and defining the content of multiple pages.

```yaml
  book-item:
    id: WRITTEN_BOOK
    author: '&bRockinChaos'
    slot: 6
    name: '&c&nCreating a Book'
    lore:
    - '&7'
    - '&7Useful for server rules'
    - '&7and other server information.'
    pages:
      '1':
      - '&aThanks for checking'
      - '&aout &bItemJoin &aby'
      - '<text:&b@RockinChaos#6746><open_url:https://discord.gg/D5FnJ7C><show_text:Click to visit the discord.>'
      - ''
      - '&0This is an example of'
      - '    a &9custom book&0.'
      - '&0-=-=-=-=-=-=-=-=-=-'
      - ''
      - '&0You can set an &cauthor&r'
      - '&0and you can add text'
      - '&0components using the'
      - '&0format <<text:TYPE><show_text:Replace TYPE with the component type. 
Example: run_command, show_text, open_url.>:<text:VALUE><show_text:Replace VALUE with the text, url or command.>>.'
      '2':
      - '&cHow do you specify a'
      - '&cnew page number?'
      - ''
      - '&0As displayed to the'
      - '&0left in the items.yml.'
      - '&0Create a number to'
      - '&0specify the new page.'
      - '&cMakesure you put'
      - '&ceach number in order.'
      - ''
```

--------------------------------

### Crafting Slot Items Example

Source: https://github.com/rockinchaos/itemjoin/wiki/Creating-Items

Defines items for specific crafting slots (CRAFTING[#]). Supports item flags and world restrictions.

```yaml
diamond-item:
  id: DIAMOND
  slot: CRAFTING[1]
  itemflags: death-drops, self-drops
  triggers: join
  enabled-worlds: world, world_nether, world_the_end
iron-item:
  id: IRON_INGOT
  slot: CRAFTING[2]
  itemflags: death-drops, self-drops
  triggers: join
  enabled-worlds: world, world_nether, world_the_end
gold-item:
  id: GOLD_INGOT
  slot: CRAFTING[3]
  itemflags: death-drops, self-drops
  triggers: join
  enabled-worlds: world, world_nether, world_the_end
redstone-item:
  id: REDSTONE
  slot: CRAFTING[4]
  itemflags: death-drops, self-drops
  triggers: join
  enabled-worlds: world, world_nether, world_the_end
```

--------------------------------

### Example JSON Event for Books

Source: https://github.com/rockinchaos/itemjoin/wiki/Creating-Items

This snippet shows how to combine multiple JSON events to create interactive text components within a book. It includes text, hover text, and an open URL action.

```text
<text:I am a clickable hover text component><show_text:Visit the website! 
Anyone is welcome.><open_url:https://www.craftationgaming.com>
```

--------------------------------

### Example change_page JSON Event

Source: https://github.com/rockinchaos/itemjoin/wiki/Creating-Items

Shows a change_page JSON event for books. This event creates a clickable element that allows the player to navigate to a different page within the book.

```text
Switch Pages<change_page:2>
```

--------------------------------

### Specify Model Components in ItemJoin

Source: https://github.com/rockinchaos/itemjoin/wiki/Recent-Changes

Example configuration for specifying model components for resource packs in ItemJoin. Supports multiple values for strings.

```yaml
model-components:
  strings: 'chest_old'
  colors: ORANGE
  flags: 'true'
  floats: '20.0'
```

--------------------------------

### Item Damage Command Example

Source: https://github.com/rockinchaos/itemjoin/wiki/Recent-Changes

Applies a specified amount of damage (durability loss) to an item when an interaction occurs. If durability reaches 0 or below, the item is removed.

```yaml
example-item:
  id: DIAMOND_SWORD
  slot: 0
  interact:
    - 'damage: 15'
    - 'message: &cI have lost 15 durability points!'
```

--------------------------------

### Create Custom Food with Effects

Source: https://github.com/rockinchaos/itemjoin/wiki/Creating-Items

Similar to custom apples, use 'potion-effects' with any consumable item ID. This example shows effects for cooked beef and a player head with a custom skull texture.

```yaml
items:
  beef-item:
    id: COOKED_BEEF
    slot: 0
    potion-effects: NIGHT_VISION:2:400
  skull-item:
    id: PLAYER_HEAD
    slot: 1
    potion-effects: GLOWING:1:410
    skull-texture: 'eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvOWI3NGNmMDA4ZGNmNDM3NDc0MGU1ODdlM2FkOGE5ZjBhNWY1NDI3ZGUyZDY5ZmZhZjA2MjA2NjNmMjEyYmNkZSJ9fX0='
```

--------------------------------

### ItemJoin Get Command

Source: https://github.com/rockinchaos/itemjoin/wiki/Permissions

Grants access to the basic /itemjoin get command, allowing the executor to give themselves any custom item with a specified amount. This permission is given by default.

```plaintext
/itemjoin get
```

--------------------------------

### Show Plugin Information

Source: https://github.com/rockinchaos/itemjoin/wiki/Commands

Use this command to display basic plugin information, including version and author. It also provides a link to the help menu.

```minecraft-commands
/ij
/itemjoin
```

--------------------------------

### Display Help Menu

Source: https://github.com/rockinchaos/itemjoin/wiki/Commands

Opens the help menu to show available commands. You can specify a page number to navigate through the help sections.

```minecraft-commands
/itemjoin help 2
```

--------------------------------

### Download PlaceholderAPI Extension

Source: https://github.com/rockinchaos/itemjoin/wiki/Troubleshooting

Use the PlaceholderAPI cloud to download necessary extensions, such as 'Vault', to ensure placeholders are formatted correctly. Reload PlaceholderAPI or restart the server after downloading.

```bash
/papi ecloud download Vault
```

```bash
/papi reload
```

--------------------------------

### Using MyCommand Raw Commands

Source: https://github.com/rockinchaos/itemjoin/wiki/Troubleshooting

Execute MyCommand commands via the console using a specific format. Replace 'putcommandhere' with the actual command from your MyCommand configuration.

```yaml
interact:
  - 'console: mycmd-runas player %player% /putcommandhere'
```

```yaml
interact:
  - 'console: mycmd-runas player %player% /gm %player% 1'
```

--------------------------------

### Get Item Information

Source: https://github.com/rockinchaos/itemjoin/wiki/Commands

Displays details about the item currently held by the player, including its material type and data value (for legacy versions).

```minecraft-commands
/itemjoin info
```

--------------------------------

### Item Commands with Sequential Lists

Source: https://github.com/rockinchaos/itemjoin/wiki/Creating-Items

Demonstrates defining two distinct command lists for an interaction, 'winner' and 'loser', with a 50% chance of executing either. If no 'commands-sequence' is defined, commands execute sequentially by default.

```yaml
interact-right:
    winner:
    - 'message: &aYou have won the dice role!'
    - 'console: give %player% diamond 64'
    loser:
    - 'message: &cYou have lost the dice role..'
    - 'console: kill %player%'
```

--------------------------------

### Create Custom Firework Charge

Source: https://github.com/rockinchaos/itemjoin/wiki/Creating-Items

Set the item ID to FIREWORK_CHARGE and use 'charge-color' to specify the color. This example creates a blue firework charge.

```yaml
items:
  charge-item:
    id: FIREWORK_CHARGE
    charge-color: BLUE
    slot: 0
```

--------------------------------

### Dump Information Command

Source: https://github.com/rockinchaos/itemjoin/wiki/Commands

Creates a dump of important plugin and server information, useful for bug reporting.

```bash
/itemjoin dump
```

--------------------------------

### Linking Text with run_command Event

Source: https://github.com/rockinchaos/itemjoin/wiki/Creating-Items

Demonstrates how to link text with a run_command JSON event, making the text clickable and executable as a command. This is useful for interactive prompts or information.

```text
<text:&aWhat is ItemJoin?><run_command:/say ItemJoin is so AMAZING!>
```

--------------------------------

### Customizing Command Sounds

Source: https://github.com/rockinchaos/itemjoin/wiki/Creating-Items

Demonstrates how to add volume and pitch parameters to the 'commands-sound' configuration. This allows for finer control over sound effects played by commands.

```yaml
commands-sound: 'BLOCK_NOTE_PLING:10:1'
```

--------------------------------

### Create Custom Banner with Patterns

Source: https://github.com/rockinchaos/itemjoin/wiki/Creating-Items

Set the item ID to BANNER and use 'banner-meta' to define colors and patterns. Multiple patterns can be combined, separated by commas. The format is COLOR:PATTERN.

```yaml
    banner-meta: RED:HALF_HORIZONTAL, BLACK:RHOMBUS_MIDDLE, RED:STRIPE_TOP, WHITE:STRIPE_BOTTOM, BLACK:STRIPE_MIDDLE, WHITE:CIRCLE_MIDDLE
```

```yaml
items:
  banner-item:
    id: BANNER
    slot: 0
    banner-meta: BLUE:BASE, WHITE:CREEPER
    enabled-worlds: world, world_nether, world_the_end
```

--------------------------------

### ItemJoin Get Others Commands

Source: https://github.com/rockinchaos/itemjoin/wiki/Permissions

Grants access to commands that affect other players, such as giving them items. This permission is given by default. Allows the executor to give any custom item to any or all players and any specified amount.

```plaintext
/itemjoin getOnline
```

```plaintext
/itemjoin getAll <player>
```

```plaintext
/itemjoin get <item> <player>
```

--------------------------------

### Create Custom Dyed Leather Armor

Source: https://github.com/rockinchaos/itemjoin/wiki/Creating-Items

Use leather armor item IDs and the 'leather-color' identifier to set the color. Colors can be specified by name or hex code. This example creates a blue leather helmet.

```yaml
    leather-color: f4d0ec
```

```yaml
items:
  leather-helmet:
    id: LEATHER_HELMET
    leather-color: BLUE
    slot: 0
```

--------------------------------

### Enable Item Obtaining Permissions

Source: https://github.com/rockinchaos/itemjoin/wiki/Troubleshooting

Configure 'Obtain-Items' and 'Obtain-Items-OP' in config.yml to enforce permission checks for item acquisition by non-OP and OP players, respectively.

```yaml
Obtain-Items: true
Obtain-Items-OP: true
```

--------------------------------

### Enabling Commands for Specific Worlds

Source: https://github.com/rockinchaos/itemjoin/wiki/Config.yml

List the worlds where commands should be executed upon player join. Worlds are separated by commas.

```yml
enabled-worlds: world, world_nether
```

--------------------------------

### Complex Animated Item with Dynamic Lore

Source: https://github.com/rockinchaos/itemjoin/wiki/Creating-Items

A comprehensive example of an animated item displaying dynamic statistics like mob kills, player kills, deaths, location, health, and food level. The lore and name can also animate using '<delay:ms>'.

```yaml
  animated-item:
    id: SIGN
    slot: 0
    name:
      1: '<delay:20>&f&lStatistics'
      2: '<delay:40>&e&lS&f&lt&e&la&f&lt&e&li&f&ls&e&lt&f&li&e&lc&f&ls'
      3: '<delay:20>&b&lS&f&lt&b&la&f&lt&b&li&f&ls&b&lt&f&li&b&lc&f&ls'
      4: '<delay:40>&a&lS&f&lt&a&la&f&lt&a&li&f&ls&a&lt&f&li&a&lc&f&ls'
      5: '<delay:20>&d&lS&f&lt&d&la&f&lt&d&li&f&ls&d&lt&f&li&d&lc&f&ls'
      6: '<delay:40>&e&lS&f&lt&e&la&f&lt&e&li&f&ls&e&lt&f&li&e&lc&f&ls'
    lore:
      1:
      - '<delay:60>&cMob Kills: %mob_kills%'
      - '&cPlayer Kills: %player_kills%'
      2:
      - '<delay:60>&cDeaths: %player_deaths%'
      - '&cYour Location: %player_location%'
      3:
      - '<delay:60>&cHealth: %player_health%'
      - '&cFood Level: %player_food%'
    itemflags: death-drops, animate
    triggers: join, respawn, world-switch
    enabled-worlds: world, world_nether, world_the_end
```

--------------------------------

### Various Item Slot Definitions

Source: https://github.com/rockinchaos/itemjoin/wiki/Creating-Items

Demonstrates assigning items to various inventory slots, including numerical slots, 'Arbitrary', and armor/offhand slots.

```yaml
items:
 first-item:
   d: SKULL_ITEM
   slot: 0 #// This can be any number between 0 and 35, depending on the location you want it in the players inventory.
 second-item:
   id: DIAMOND_SWORD
   slot: Arbitrary
 helmet-item:
   id: DIAMOND_HELMET
   slot: Helmet
 chestplate-item:
   id: 299
   slot: Chestplate
 leggings-item:
   id: DIAMOND_LEGGINGS
   slot: Leggings
 boots-item:
   id: LEATHER_BOOTS
   slot: Boots
 offhand-item:
   id: SHIELD
   slot: Offhand
  redstone-item:
    id: REDSTONE
    slot: CRAFTING[4]
    itemflags: death-drops, self-drops
    triggers: join
    enabled-worlds: world, world_nether, world_the_end
```

--------------------------------

### Using Raw JSON Data for Book Lines

Source: https://github.com/rockinchaos/itemjoin/wiki/Creating-Items

Demonstrates how to use raw JSON data for book lines in ItemJoin. This allows for advanced formatting and complex JSON events that might not be directly supported by the simplified syntax.

```yaml
  book-item-example:
    id: WRITTEN_BOOK
    slot: 0
    name: '&c&nCreating a Book'
    author: '&bItemJoin'
    lore:
      - '&7'
      - '&7This magical book is given on join!'
    pages:
      1:
      - 'raw: ["",{"text":"I am a hidden text!","color":"yellow","clickEvent":{"action":"open_url","value":"https://www.spigotmc.org/resources/itemjoin.12661/"},"hoverEvent":{"action":"show_text","value":{"text":"","extra":[{"text":"Click to visit the spigot page.","color":"blue"}]}}}]'
      - '&eThis is Line Number TWO of page ONE.'
```

--------------------------------

### Creating a Custom Map Item

Source: https://github.com/rockinchaos/itemjoin/wiki/Creating-Items

Set up a custom map item by assigning it the FILLED_MAP ID and specifying a custom image file from the ItemJoin folder. The image must be 128x128 pixels or smaller.

```yaml
items:
  map-item:
    id: FILLED_MAP
    slot: 0
    custom-map-image: 'default.png'
```

--------------------------------

### Basic Item Creation

Source: https://github.com/rockinchaos/itemjoin/wiki/Creating-Items

Defines three items with their IDs, slots, and enabled worlds. If enabled-worlds is not specified, the item is given to all worlds by default. If slot is not specified, it's given in the first available slot.

```yaml
items:
  any-text:
    id: 284
    slot: 0
    enabled-worlds: world_name_here, another_world_name
  another-item:
    id: SEEDS
    slot: 2
  wheat-item:
    id: WHEAT
    slot: 4
    enabled-worlds: world, world_nether, world_the_end
  diamond-item:
    id: DIAMOND
```

--------------------------------

### ItemJoin Enable Command

Source: https://github.com/rockinchaos/itemjoin/wiki/Permissions

Grants access to the basic /itemjoin enable command, allowing the executor to enable custom items for all players. This permission is given by default.

```plaintext
/itemjoin enable
```

--------------------------------

### Custom Recipe Ingredients

Source: https://github.com/rockinchaos/itemjoin/wiki/Creating-Items

Shows how to use custom item nodes as ingredients in a crafting recipe, alongside standard materials.

```yaml
ingredients:
- 'G:GOLD_INGOT' # G Stands for Gold Ingot.
- 'U:ultra-item' # U Stands for the custom ultra-item.
- 'B:bungee-item' # B Stands for the custom bungee-item.
```

--------------------------------

### Using ChestCommands Raw Commands

Source: https://github.com/rockinchaos/itemjoin/wiki/Troubleshooting

Use raw commands for ChestCommands GUI to open menus. Ensure the command is not a custom command created within ChestCommands.

```yaml
interact:
  - 'player: cc open options'
```

```yaml
interact:
  - 'cc open options'
```

--------------------------------

### Configure Items for Region Entry Triggers

Source: https://github.com/rockinchaos/itemjoin/wiki/API-&-Dependencies

Set up items to be given to players when they enter, join, or respawn into specific WorldGuard regions. Items are removed upon exiting the region.

```yaml
items:
 first-item:
   id: PLAYER_HEAD
   slot: 0
   triggers: region-enter
   enabled-regions: region1, region2
 second-item:
   id: DIAMOND_SWORD
   slot: Arbitrary
   triggers: region-enter
   enabled-regions: region1, region2
 helmet-item:
   id: DIAMOND_HELMET
   slot: Helmet
   triggers: region-enter
   enabled-regions: region1, region2
 chestplate-item:
   id: 299
   slot: Chestplate
   triggers: region-enter, join, respawn, world-change
   enabled-regions: region1, region2
 leggings-item:
   id: DIAMOND_LEGGINGS
   slot: Leggings
   triggers: region-enter, join, respawn, world-change
   enabled-regions: region1, region2
 boots-item:
   id: LEATHER_BOOTS
   slot: Boots
   triggers: region-enter
   enabled-regions: region1, region2
```

--------------------------------

### Linking Text with open_url Event

Source: https://github.com/rockinchaos/itemjoin/wiki/Creating-Items

Shows how to link regular text with an open_url JSON event to make the text clickable and open a URL. This allows for custom display text for links.

```text
<text:&aView the resource><open_url:https://www.spigotmc.org/resources/itemjoin.12661/>
```

--------------------------------

### Linking Regular Text with open_url Event

Source: https://github.com/rockinchaos/itemjoin/wiki/Creating-Items

Illustrates how to combine regular, non-JSON event text with a JSON event. This allows for a seamless blend of standard text and interactive elements.

```text
&aView the resource<open_url:https://www.spigotmc.org/resources/itemjoin.12661/>
```

--------------------------------

### Configure Item with Economy Cost for Commands

Source: https://github.com/rockinchaos/itemjoin/wiki/API-&-Dependencies

Integrate with Vault to set an economy cost for executing item commands. Players must have sufficient balance to run the command.

```yaml
items:
  ultra-item:
    id: DIAMOND_SWORD
    slot: 0
    commands:
      multi-click:
        - 'message: &eYou were just charged to send yourself a message... How do you feel..?'
    commands-type: interact
    commands-cost: 25
    enabled-worlds: world
```

--------------------------------

### Define Item Permissions (World Specific)

Source: https://github.com/rockinchaos/itemjoin/wiki/Creating-Items

Set up permissions required for players to receive specific items in a particular world. Permissions are case-sensitive.

```yaml
itemjoin.Your_Specified_World_Name_Here.Item_Name:
  description: Gives permission to get a specific item in a specific world. Replace Item_Name with the name of the specified item (in the items.yml) and Your_Specified_World_Name_Here with the name of the world to receive that item.
  default: false
```

```yaml
itemjoin.Your_Specified_World_Name_Here.:
  description: Gives permission to get all items from the specified world. Replace Your_Specified_World_Name_Here with the name of the world to receive that item.
  default: false
```

--------------------------------

### List Defined Items

Source: https://github.com/rockinchaos/itemjoin/wiki/Commands

Displays a paginated list of all defined items and the worlds they are enabled in. This command requires the `itemjoin.list` permission.

```minecraft-commands
/itemjoin list
/itemjoin list 2
/itemjoin list 3
```

--------------------------------

### Defining Active Commands

Source: https://github.com/rockinchaos/itemjoin/wiki/Config.yml

List commands to be executed upon specific triggers. Commands are executed as Console, use %player% for player-specific actions. 'first-join' executes commands only once per player per world.

```yml
commands:
 - 'itemjoin get <item> <player>'
 - 'first-join: say This is a command only executed once per world, per player.'
```

--------------------------------

### Creating a Toggle Command for an Item

Source: https://github.com/rockinchaos/itemjoin/wiki/Creating-Items

Define a toggle command for an item, allowing players to enable/disable it. Specify custom toggle commands, permissions, and messages.

```yaml
items:
  toggle-item:
    id: COMPASS
    toggle:
      - 'compass'
      - 'toggle compass'
    toggle-permission: 'itemjoin.compass.toggle'
    toggle-message: '&7You have toggled your navigation compass!'
    enabled-worlds: world
```

--------------------------------

### Command Execution Sequence

Source: https://github.com/rockinchaos/itemjoin/wiki/Config.yml

Set the sequence for executing multiple commands. Options are SEQUENTIAL (execute in order) or RANDOM_SINGLE (execute one randomly).

```yml
commands-sequence: SEQUENTIAL
```