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.

!(https://cdn.modrinth.com/data/cached_images/f769a9ebd8462e26765b092ca8493593b8f0bd33.png))

(https://www.mediafire.com/file/nrpolsca51kg7ym/%2521__FunTalismans_RP.zip/file) 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.

```text /rg flag 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

```text /ftalismans give /ftalismans reload /ftalismans forceupdate ```

Available aliases:

```text /ft /talisman /tali /talismans ```

Permissions:

```text funtalismans.give funtalismans.reload funtalismans.update ```

## Configuration example

```yaml talismans { sphere-ikara { name: "[★] Sphere of Ikar" material: "player_head" texture: "http://textures.minecraft.net/texture/" 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. 1