Comment on page
Creating items
Step-by-step guide on creating custom items
AdvancedItems has an in-game editor to edit and create custom items! The editor is extremely simple and intuitive, with auto-completion and guides.
In-Game Command: /ai editor

This guide will walk you through the process of creating a custom item for the AdvancedItems plugin. By following these steps, you will learn how to configure the item's properties, abilities, and other settings.
- 1.Navigate to the
/plugins/AdvancedItems/items/
folder on your server. - 2.Create a new YAML file (e.g.,
custom_item.yml
) in this folder to store the settings for your custom item.
In the new YAML file, define the item's type, amount, name, lore, and other properties:
item:
type: CRAFTING_TABLE
amount: 1
name: '&dVirtual Crafting Table'
lore:
- '&7Right click to open a virtual crafting table'
force-glow: true
Define the general settings for the item, such as stacking, usage limits, and world restrictions:
esettings:
disabledStacking: true
ownerOnly: false
usageLimit: -1
restrictedWorlds:
- 'example
disableInteractions: true
disableInventoryInteractions: false
Configure the join settings to control whether the item is given to players when they join the server:
joinSettings:
giveItem: false
giveOnlyFirstJoin: false
giveItemSlot: 0
Set up the loot generation settings to control whether the item appears in randomly generated chests in the world:
lootGeneration:
ALL: 100
SIMPLE_DUNGEON: 80
Define the abilities, triggers, and effects associated with the item:
abilities:
RIGHT_CLICK:
effects:
- 'CANCEL_EVENT'
- 'OPEN_CRAFTING_TABLE'
Refer to the Abilities Wiki, Triggers Wiki, and Effects Wiki for more information on available settings.
If you want to create a custom crafting recipe for your item, set up the layout and materials.
This is an example configuration, you would need to completely configure this for yourself.
recipe:
layout:
- 'WWW'
- 'WWW'
- 'WWW'
materials:
W: CRAFTING_TABLE
- 1.Save the changes to your YAML file.
- 2.Reload the AdvancedItems plugin on your server to load the new custom item.
That's it! You've now created a custom item with the AdvancedItems plugin. For more detailed information on each of the settings, visit the corresponding wiki pages linked throughout this guide.
Last modified 2mo ago