FunTalismans

Custom Talismans, Spheres and Passive Equipment for Paper/Purpur 1.21+.

FunTalismans lets server owners create custom talismans, spheres and RPG equipment through clean HOCON configuration files. Configure item appearance, lore, attributes, potion effects, head textures, rarities, custom data and equipment requirements without modifying plugin code.

![FunTalismans resource pack preview])

Download the FunTalismans Resource Pack to preview and test the custom talisman models in-game.

---

Compatibility

• Server software: Paper / Purpur 1.21+
• Java: Java 21
• Configuration format: HOCON
• Required dependencies: None
• Optional integrations: WorldGuard and PlaceholderAPI
• Optional resource pack: Compatible with Minecraft clients from 1.21.1 to 1.21.11

The core talisman system does not require NBTAPI.

---

Features

• Create custom talismans, spheres and equipment items.
• Apply passive potion effects based on where an item is equipped.
• Add attribute modifiers such as health, damage, speed, armor, attack speed and luck.
• Support talismans in the main hand, offhand, armor slots or player inventory.
• Configure custom names, lore, legacy colors, hex colors and gradients.
• Use player-head textures through Minecraft texture URLs, base64: values or raw Base64 values.
• Add Custom Model Data for resource-pack models.
• Configure enchantments, glow, unbreakable state, durability, item flags and persistent data.
• Create configurable rarities for custom progression systems.
• Support armor trims, dyed items, fireworks, goat horns and written books.
• Apply world and region restrictions globally or per talisman.
• Use shared WorldGuard flags without generating one flag for every talisman.
• Reload talismans and safely refresh loaded items without restarting the server.

---

Passive slots

Passive effects can work when a talisman is placed in:

• mainhand
• offhand
• head
• chest
• legs
• feet
• armor
• hands
• any
• inventory

inventory works only for passive effects. Attribute modifiers must use equipment slots such as mainhand, offhand or armor slots.

---

WorldGuard support

WorldGuard integration is optional. FunTalismans uses shared global flags, keeping region configuration clean even when your server has many talismans.

• fun-talismans-passive controls passive talisman effects in a region.
• fun-talismans-use is available as the shared use-control flag for talisman systems.

Example:

/rg flag <region> fun-talismans-passive deny

Normal talisman configuration changes can be reloaded in-game. Restart the server only when changing custom WorldGuard flag names in config.conf.

---

Live reload and updates

FunTalismans reloads talisman definitions without requiring a server restart.

The update system safely refreshes loaded talismans in:

• Player inventories and equipped slots.
• Dropped items near online players.
• Item Frames and Glow Item Frames.
• Open containers, chests and shulker boxes.
• Loaded chunks through configurable per-tick limits.

This allows administrators to balance items, replace textures or update attributes while keeping server performance stable.

---

Commands

/ftalismans give <player> <id> [amount]
/ftalismans reload
/ftalismans forceupdate

Available aliases:

/ft
/talisman
/tali
/talismans

Permissions:

funtalismans.give
funtalismans.reload
funtalismans.update

---

Configuration example

talismans {
  sphere-ikara {
    name: "<gradient:#FF0000:#FF6600>[★] Sphere of Ikar</gradient>"
    material: "player_head"
    texture: "http://textures.minecraft.net/texture/<texture-id>"
    rarity: "legendary"

    custom_model_data: 101

    unbreakable: false
    glow: true
    keepItemOnDeath: false

    lore: [
      "&7A sphere forged for battle.",
      "&7Equip it in the offhand",
      "&7to activate its power."
    ]

    effects {
      slot: "offhand"
      ambient: true
      particles: false
      icon: true
      list: [
        {
          type: "strength"
          amplifier: 0
        }
      ]
    }

    attributes: [
      {
        type: "max_health"
        amount: 4.0
        operation: "add_number"
        slot: "offhand"
      },
      {
        type: "movement_speed"
        amount: 0.10
        operation: "add_scalar"
        slot: "offhand"
      }
    ]

    nbt {
      talisman_id: "sphere-ikara"
      rarity: "legendary"
    }
  }
}

For player_head items, texture supports a Minecraft texture URL, a value prefixed with base64:, or a raw Base64 texture value.

---

Optional resource pack

The optional FunTalismans resource pack adds custom totem models through Custom Model Data.

• Supports Minecraft clients from 1.21.1 to 1.21.11.
• Includes legacy Custom Model Data support for 1.21.1–1.21.3.
• Includes modern item-definition support for 1.21.4+.
• Uses optimized display size for first person, third person, ground and GUI views.

Download the Resource Pack

Use the matching custom_model_data value in your talisman configuration to display its model.

---

Notes

• Create a backup before replacing configuration files.
• Use /ftalismans reload after normal configuration changes.
• Use /ftalismans forceupdate to queue a wider refresh for already loaded talismans.
• WorldGuard and PlaceholderAPI are optional; the core plugin works without them.

FunTalismans gives your server a flexible foundation for RPG progression, custom combat, collectible equipment and configurable passive gameplay.