Shopkeeper

⚒️ Shopkeeper

The Shopkeeper is a core game mechanic that allows players to purchase items during the preparation phase. Items are grouped into categories to make browsing and purchasing fast and intuitive.

---

⭐ Features

• Category-based Browsing: Items are organized into logical groups (Weapons, Potions, etc.).

• Upgrade Paths: Items can evolve through tiers using a shared ID system.

• Module System: Highly customizable item behavior through specialized configuration modules.

• Dynamic Availability: Items can be locked behind specific round numbers.

---

📂 Structure

All items are stored inside the ArenaLegends/items/ folder. Each item has its own file and configuration.

Every item file is built using modules, which define how the item behaves and appears in the shop.

Organize your /items/ folder logically — one file per item. Use shared-id for clear upgrade paths.

---

🧩 Item Modules

Modules are the building blocks of an item. You can mix and match them to create unique gear.

💰 Purchase Module

Defines how much an item costs and when it becomes available.

purchase:
  gold-cost: 750
  round-unlock: 1
  consumable: true
  category: "SUMMONS"

Key	Type	Description
gold-cost	integer	Price in gold.
round-unlock	integer	Minimum round number required to purchase.
consumable	boolean	If true, the item can be bought multiple times.
category	string	The tab name in the shop UI.

---

🔼 Upgrade Module

Allows items to be part of a progression chain.

upgrade:
  shared-id: "chestplate"
  upgrade-tier: 2

Key	Type	Description
shared-id	string	Common ID for all tiers of the same item.
upgrade-tier	integer	The level of this specific item in the chain.

---

✨ Enchant Module

Used for creating enchantments that can be applied to other items.

enchant:
  is-enchant: true
  max-purchases: 2
  cost-increase-per-purchase: 25
  apply-to:
    - BOW
  apply-enchants:
    - "enchant{PUNCH} power{1}"

Key	Type	Description
is-enchant	boolean	Marks the item as an enchantment.
max-purchases	integer	Maximum times this can be applied.
cost-increase-per-purchase	integer	Percentage price increase per purchase.
apply-to	list	List of item types this enchantment can affect.

---

🛡️ Equipment Builder Module

Controls the physical item given to the player, including its stats and visuals.

equipment-builder:
  0: # Slot (0-40)
    type: IRON_SWORD
    amount: 1
    lore:
      - "&8Permanent Weapon"
    attributes:
      - "attribute{ATTACK_DAMAGE} operation{ADD_NUMBER} value{5.0}"

Key	Description
type	The Bukkit Material name.
custom	ItemsAdder or namespace:id reference.
attributes	List of attribute modifiers (e.g., speed, damage).
ignore-slot	If true, finds the first empty slot instead of using the defined index.

---

📋 Examples

⚔️ Iron Sword (Tier 2)

A permanent weapon that upgrades from a Stone Sword.

View Configuration

purchase:
  gold-cost: 500
  round-unlock: 5
  consumable: false
  category: "WEAPONS"

upgrade:
  shared-id: "sword"
  upgrade-tier: 2

equipment-builder:
  0:
    ignore-slot: false
    lore:
      - "&8Permanent"
    type: IRON_SWORD
    attributes:
      - "attribute{ATTACK_DAMAGE} operation{ADD_NUMBER} value{5.0}"
      - "attribute{ATTACK_SPEED} operation{ADD_NUMBER} value{-2.6}"

---

🧪 Splash Potion

A simple consumable item.

View Configuration

purchase:
  gold-cost: 500
  round-unlock: 1
  consumable: true
  category: "POTIONS"

equipment-builder:
  0:
    ignore-slot: true
    lore:
      - "&8Consumable"
    type: SPLASH_POTION
    potions:
      - "effect{HASTE} duration{200} amplifier{0} ambient{false} particles{true}"

---

🪄 Random Augment (Mythic)

An item that executes a command when purchased.

View Configuration

mythic:
  is-mythic: true

enchant:
  is-enchant: true

command:
  - "console->al player {PLAYER} MODIFICATOR ROLL_AUGMENT PRISMATIC"

equipment-builder:
  0:
    name: "&cRandom Augment"
    type: PAPER
    model: 11205302