The Shopkeeper is a central game mechanic that allows players to purchase items during the preparation phase. Items are organized into categories, making it easy for players to find and purchase what they need.
Categories
The shop organizes items into the following categories:
Permanent/Upgrades: Items like swords and armor that persist and can be upgraded
Consumables: Items that can be purchased repeatedly (e.g., Golden Apples, Ender Pearls)
Eggs: Special items that spawn minions when right-clicked on the ground
TNT: Throwable explosives activated by left-clicking
Organizing items into categories helps players quickly find what they need during the preparation phase.
Configuration
Creating Items
Access the /items/ directory.
Identify an existing item file to use as a template.
Duplicate the template file.
Rename the duplicate file for your new item.
Adjust the configuration to customize your item.
Item Modules
Items are configured using various modules that control their behavior and properties:
Module
Description
Prismatic
Controls whether the item is part of the prismatic item pool
Purchase
Defines buying conditions like cost and unlock requirements
Upgrade
Configures upgrade paths and tiers for items
Enchant
Handles enchantment application and limitations
Equipment-builder
Specifies inventory placement and item properties
Module Details
Prismatic Module
prismatic:is-prismatic:true# Makes item available in prismatic pool (Round 3 default)
Purchase Module
purchase:gold-cost:250# Cost in goldround-unlock:3# Round when item becomes availableconsumable:false# Whether item can be used multiple timescategory:"ARMOR"# Shop category for the item
Always set appropriate round-unlock values to maintain game balance.
Making powerful items available too early can disrupt gameplay.
Upgrade Module
upgrade:shared-id:"chestplate"# Groups items in same upgrade pathupgrade-tier:1# Position in upgrade sequence
Items with the same shared-id form an upgrade path. Higher upgrade-tier values represent better versions of the item.