Skip to content

BoxPvP Template

Mark edited this page Sep 12, 2026 · 2 revisions

items.yml (BoxPVP Template)

# ==========================================================
#  zMItemsBuilder — BoxPVP Template
# ==========================================================
#
#  Example configuration for BoxPVP servers.
#
#  This template demonstrates:
#  - Reusable custom items
#  - Groups with levels and rarities
#  - Scalable enchantments
#  - Scalable attributes
#  - Custom player heads
#  - Item restrictions
#
#  Documentation:
#    https://github.com/zMarkitos/zMItemsBuilder/wiki
#
# ==========================================================

# Internal version (DO NOT MODIFY)
items-version: 1

# ==========================================================
# Rarities
# ==========================================================

raritys:
  special: "★★★&7★★"
  objects: "★★★★&7★"
  levels: ""

# ==========================================================
# Visual / Lore Templates
# ==========================================================

esthetic:
  name-template: "&f{item_type} &8▸ {prefix_item}"
  enchant-format: "   {primary_color}• &f{enchant_name} {secondary_color}{level}"
  lore-template:
    - ""
    - " {primary_color}&l|&r &fEnchantments:"
    - "{enchants}"

# ==========================================================
# Head Textures
# ==========================================================

heads-texture:
  boxpvp1: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvZWFlZDUyYTA0ZWRmYzQyOTU5MGMyMWQ1OWQ1MDA1ZTNiYTYyODY2YzUyYWVkODk1ZjFiZTk0ZDdmNjQyYTAxMyJ9fX0="
  boxpvp2: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvOTU5Y2FmNDQ3ZDZmZDI2N2IyOTFlMDI5OWNmMmZmNDg4ZjM3MjdiM2JlZTgzNGNkMjc5YzdkMmY4YWJkYjZiMiJ9fX0="
  boxpvp3: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvZTY0ZGI0ZjI1YmQ3ZjljZDZhYmYzYWI5MzQyYjVhMTIwNDdhZTY4ZjkwOTA1MmNlMDMyNGRlODE3NTZkMWIwNiJ9fX0="

# ==========================================================
# Items
# ==========================================================

items:

  # --------------------------------------------------------
  # Helmet
  # --------------------------------------------------------

  boxpvp_casco:
    mode: single
    material: PLAYER_HEAD
    item-type: "Helmet"

    name: "&f{item_type} &8▸ {prefix_item}"

    lore:
      - ""
      - " {primary_color}&l|&r &fEnchantments:"
      - "{enchants}"
      - ""
      - " {primary_color}&l|&r &fEffects:"
      - "   {primary_color}&l•&r &fExtra life {secondary_color}+{attribute_level:max_health}"

    unbreakable: true

    enchants:
      protection:
        base: 2
        per-level: 2
        max: 50
      unbreaking: 2
      mending: 1

    item-flags:
      - HIDE_ENCHANTS

    behavior-flags: []

    attributes:
      max_health:
        attribute: MAX_HEALTH
        amount:
          base: 2
          per-level: 2
          max: 60
        operation: ADD_NUMBER
        slot: HELMET

  # --------------------------------------------------------
  # Elytra
  # --------------------------------------------------------

  boxpvp_elytra:
    mode: single
    material: ELYTRA
    display-type: "Elytra"

    name: "&f{item_type} &8▸ {prefix_item}"

    lore:
      - ""
      - " {primary_color}&l|&r &fEnchantments:"
      - "{enchants}"

    unbreakable: true

    enchants:
      protection:
        base: 2
        per-level: 2
        max: 50
      unbreaking: 2
      mending: 1

    item-flags:
      - HIDE_ENCHANTS

    behavior-flags: []

  # --------------------------------------------------------
  # Leggings
  # --------------------------------------------------------

  boxpvp_grebas:
    mode: armor
    base-material: LEATHER
    pieces:
      - leggings

    name: "&f{item_type} &8▸ {prefix_item}"

    lore:
      - ""
      - " {primary_color}&l|&r &fEnchantments:"
      - "{enchants}"

    unbreakable: true

    enchants:
      protection:
        base: 2
        per-level: 2
        max: 50
      unbreaking: 2
      mending: 1

    item-flags:
      - HIDE_ENCHANTS

    behavior-flags: []

  # --------------------------------------------------------
  # Boots
  # --------------------------------------------------------

  boxpvp_botas:
    mode: armor
    base-material: LEATHER
    pieces:
      - boots

    name: "&f{item_type} &8▸ {prefix_item}"

    lore:
      - ""
      - " {primary_color}&l|&r &fEnchantments:"
      - "{enchants}"
      - ""
      - " {primary_color}&l|&r &fEffects:"
      - "   {primary_color}&l•&r &fExtra speed {secondary_color}+{attribute_level:speed}"

    unbreakable: true

    enchants:
      protection:
        base: 2
        per-level: 2
        max: 50
      unbreaking: 2
      mending: 1

    item-flags:
      - HIDE_ENCHANTS

    behavior-flags: []

    attributes:
      speed:
        attribute: MOVEMENT_SPEED
        amount:
          base: 0.02
          per-level: 0.01
          max: 0.9
        operation: ADD_NUMBER
        slot: BOOTS

  # --------------------------------------------------------
  # Sword
  # --------------------------------------------------------

  boxpvp_filo:
    mode: single
    material: WHITE_CANDLE
    display-type: "Sword"

    name: "&f{item_type} &8▸ {prefix_item}"

    lore:
      - ""
      - " {primary_color}&l|&r &fEnchantments:"
      - "{enchants}"
      - ""

    unbreakable: true

    enchants:
      sharpness:
        base: 2
        per-level: 2
        max: 50
      unbreaking: 2
      mending: 1

    item-flags:
      - HIDE_ENCHANTS

    behavior-flags:
      - NO_PLACE

  # --------------------------------------------------------
  # Pickaxe
  # --------------------------------------------------------

  boxpvp_pico:
    mode: single
    material: NETHERITE_PICKAXE
    display-type: "Pickaxe"

    name: "&f{item_type} &8▸ {prefix_item}"

    lore:
      - ""
      - " {primary_color}&l|&r &fEnchantments:"
      - "{enchants}"

    unbreakable: true

    enchants:
      efficiency:
        base: 2
        per-level: 2
        max: 50
      unbreaking: 2
      mending: 1

    item-flags:
      - HIDE_ATTRIBUTES
      - HIDE_ENCHANTS

    behavior-flags: []

# ==========================================================
# Groups
# ==========================================================

groups:

  boxpvp1:
    rarity: boxpvp
    level: 1
    head: boxpvp1
    items:
      - boxpvp_casco
      - boxpvp_elytra
      - boxpvp_grebas
      - boxpvp_botas
      - boxpvp_filo
      - boxpvp_pico

  boxpvp2:
    rarity: boxpvp
    level: 2
    head: boxpvp2
    items:
      - boxpvp_casco
      - boxpvp_elytra
      - boxpvp_grebas
      - boxpvp_botas
      - boxpvp_filo
      - boxpvp_pico

  boxpvp3:
    rarity: boxpvp
    level: 3
    head: boxpvp3
    items:
      - boxpvp_casco
      - boxpvp_elytra
      - boxpvp_grebas
      - boxpvp_botas
      - boxpvp_filo
      - boxpvp_pico

Clone this wiki locally