Upgrades
Configure drawer upgrades
Cette page est affichée en anglais car sa traduction française n’est pas encore disponible.
Upgrades increase the storage capacity of drawers. Configure them in the upgrades section of config.yml.
Basic Structure
upgrades:
woodUpgrade: # Upgrade name
displayName: "Wood Upgrade" # Human-readable name
limit: 4096 # New item limit
displayItem: # Item shown on drawer
material: IRON_BLOCK
craft: # Crafting recipe
enable: true
result:
# ...
shade:
# ...
ingredients:
# ...Properties
| Property | Type | Description |
|---|---|---|
displayName | String | Name shown in messages |
limit | Long | New storage limit per slot |
displayItem | ItemStack | Item displayed on drawer when upgrade is applied |
craft | Object | Crafting recipe configuration |
Display Item
Configure the item shown on the drawer face when the upgrade is applied:
displayItem:
material: IRON_BLOCKYou can use any zMenu item configuration:
displayItem:
material: PLAYER_HEAD
url: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6..."Craft Configuration
Each upgrade has its own crafting recipe:
craft:
enable: true
result:
url: "eyJ0ZXh0dXJlcyI6..." # Player head texture
name: "#cc7727Wood Upgrade"
lore:
- "&7Increases drawer capacity"
- "&7New limit: &e4096 items"
shade:
- "AAA"
- "BCB"
- "AAA"
ingredients:
A:
material: STICK
B:
material: BARREL
C:
customCraft: upgradeDisplay # Reference to custom craftUsing Custom Crafts
You can reference custom crafts as ingredients:
ingredients:
C:
customCraft: upgradeDisplayThis requires defining upgradeDisplay in customCrafts section.
Example Upgrades
Iron Upgrade
upgrades:
ironUpgrade:
displayName: "Iron Upgrade"
limit: 8192
displayItem:
material: IRON_BLOCK
craft:
enable: true
result:
material: PLAYER_HEAD
url: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6..."
name: "&7Iron Upgrade"
lore:
- "&7Limit: &f8192"
shade:
- "AAA"
- "BCB"
- "AAA"
ingredients:
A:
material: IRON_INGOT
B:
material: BARREL
C:
customCraft: upgradeDisplayDiamond Upgrade
upgrades:
diamondUpgrade:
displayName: "Diamond Upgrade"
limit: 32768
displayItem:
material: DIAMOND_BLOCK
craft:
enable: true
result:
material: PLAYER_HEAD
url: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6..."
name: "&bDiamond Upgrade"
lore:
- "&7Limit: &f32768"
shade:
- "AAA"
- "BCB"
- "ADA"
ingredients:
A:
material: DIAMOND
B:
material: BARREL
C:
customCraft: upgradeDisplay
D:
material: DIAMOND_BLOCKNetherite Upgrade
upgrades:
netheriteUpgrade:
displayName: "Netherite Upgrade"
limit: 2147483647 # Max int value (unlimited)
displayItem:
material: NETHERITE_BLOCK
craft:
enable: true
result:
material: PLAYER_HEAD
url: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6..."
name: "&8Netherite Upgrade"
lore:
- "&7Limit: &fUnlimited"
shade:
- "ADA"
- "BCB"
- "ADA"
ingredients:
A:
material: NETHERITE_INGOT
B:
material: NETHERITE_BLOCK
C:
customCraft: upgradeDisplay
D:
material: ANCIENT_DEBRISApplying Upgrades
Players apply upgrades by:
- Crafting the upgrade item
- Right-clicking on a placed drawer with the upgrade in hand
Upgrades can only increase the limit. If a drawer already has a higher limit upgrade, applying a lower one will fail.
Giving Upgrades
Admins can give pre-upgraded drawers:
/zdrawer give drawer single Steve ironUpgradeOr give the upgrade item directly:
/zdrawer give craft ironUpgrade Steve