Перейти к содержимому
Mineforgian

FunTalismans

A complete and highly customizable system of magic talismans for Minecraft servers. Add unique items with attributes, effects, rarities, and much more.

Загрузки
1K
Подписчики
1
Обновлён
29 июня 2026 г.
Лицензия
All-Rights-Reserved

Опубликован 21 ноября 2025 г.

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]Talismans custom model data)

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.

Ченджлог

1.2.0Релиз1.21.9, 1.21.10, 1.21.11 · 29 июня 2026 г.

Changelog - FunTalismans

[v1.2.0] – Major Systems, WorldGuard & Resource Pack Update

[!IMPORTANT] UPDATE INSTRUCTIONS:

  1. Stop the server.
  2. Create a backup of your existing /plugins/FunTalismans/ folder.
  3. Replace the old plugin .jar with the new version.
  4. Start the server once to generate the updated configuration files.
  5. Merge your custom talismans, rarities and messages into the new files.
  6. Update the optional FunTalismans Resource Pack if you use Custom Model Data models.

New Features

  • Global WorldGuard Integration

    • Added a simplified global WorldGuard flag system for all talismans.
    • Added fun-talismans-passive to control passive talisman effects inside regions.
    • Added fun-talismans-use as the shared use-control flag for talisman systems.
    • Added configurable WorldGuard flag names in config.conf.
    • Added a cleaner alternative to managing many individual talisman flags.

    Example:

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

  • Expanded Passive Talisman Support

    • Talismans can now provide passive effects from:
      • Main hand.
      • Offhand.
      • Helmet, chestplate, leggings and boots.
      • Any armor slot.
      • Both hands.
      • Any equipped slot.
      • Player inventory and hotbar.

  • Optional Resource Pack

    • Added support for the official FunTalismans Resource Pack.
    • Added custom totem models through Custom Model Data.
    • Added compatibility for Minecraft clients from 1.21.1 to 1.21.11.
    • Added legacy Custom Model Data support for 1.21.1–1.21.3.
    • Added modern item-definition support for 1.21.4+.
    • Added optimized model size for first person, third person, ground and GUI views.

  • Improved Talisman and Sphere Definitions

    • Added updated talismans and spheres ready for use.
    • Added normalized player-head texture support.
    • Player-head textures now support:
      • Minecraft texture URLs.
      • Base64 values with the base64: prefix.
      • Raw Base64 texture values.
    • Improved compatibility for custom talisman names, lore and Russian display text.

  • Configuration Guide Improvements

    • Updated the talisman configuration guide with valid examples.
    • Added clearer documentation for attributes, effects, slots, textures, NBT and item properties.
    • Added examples for inventory passive talismans.
    • Added WorldGuard global flag examples.
    • Removed outdated or unsupported configuration options from the guide.

Improvements

  • Passive Effect Performance

    • Improved passive-effect refresh queues to avoid large updates in a single tick.
    • Added configurable per-tick limits for passive refreshes.
    • Added movement refresh coalescing to reduce unnecessary checks during continuous movement.
    • Added periodic reconciliation for passive effects changed by other plugins or commands.

  • Live Update System

    • Improved live updates for talismans already loaded on the server.
    • Updates are processed gradually through configurable per-tick limits.
    • Improved updates for:
      • Player inventories and equipped items.
      • Dropped talismans near online players.
      • Item Frames and Glow Item Frames.
      • Open chests, barrels and shulker boxes.
      • Loaded chunks.

  • WorldGuard Performance

    • Added short-term caching for WorldGuard flag decisions.
    • Reduced repeated region checks while players move.
    • Added configurable cache lifetime and maximum cache entries.

  • Update Prioritization

    • Player-visible talismans are prioritized before background chunk scanning.
    • Nearby dropped talismans and Item Frames are refreshed first.
    • Open containers receive priority updates.
    • Large update jobs now use bounded queues to protect MSPT.

  • Configuration Cleanup

    • Improved comments for server owners.
    • Removed internal development notes from public configuration files.
    • Added clearer descriptions for performance settings.
    • Added safer defaults for large servers.

Fixes

  • Reload Stability

    • Improved reload behavior when talisman definitions, textures, names, lore, attributes or effects are changed.
    • Improved refresh handling for existing talismans after configuration changes.
    • Reduced the possibility of outdated item data remaining after a reload.

  • WorldGuard Flag Management

    • Added a global flag approach for passive effects and talisman systems.
    • Improved configuration clarity for servers with many talismans.

  • Resource Pack Compatibility

    • Added separate model handling for legacy and modern Minecraft item formats.
    • Improved custom totem model display size across supported client versions.

  • Release Build

    • Fixed the ProGuard version mismatch that could prevent obfuscated release builds from being generated.
    • Improved release validation for protected plugin JAR files.

Commands

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

Available aliases:

/ft
/talisman
/tali
/talismans

Permissions:

funtalismans.give
funtalismans.reload
funtalismans.update

Notes

  • Use /ftalismans reload after normal configuration changes.
  • Use /ftalismans forceupdate to queue a wider refresh for loaded talismans.
  • Restart the server only when changing the custom WorldGuard flag names in config.conf.
  • WorldGuard and PlaceholderAPI remain optional integrations.
  • Create a backup before replacing custom configuration files.

FunTalismans v1.2.0 delivers a safer, cleaner and more scalable foundation for RPG progression, custom combat, collectible equipment and passive talisman systems.

1.1.0Релиз1.21.9, 1.21.10, 1.21.11 · 21 декабря 2025 г.

Changelog - FunTalisman

[v1.1.0] – Stability & Update Improvements

[!IMPORTANT] CRITICAL UPDATE INSTRUCTIONS: To ensure full compatibility with the new item synchronization system, a clean installation is mandatory:

  1. Stop the server.
  2. Delete the entire /plugins/FunTalisman/ folder.
  3. Reinstall the plugin by replacing the old .jar file.
  4. Start the server to generate the updated configuration files.

Fixes

  • Reload System: Resolved an issue where /talisman reload failed to update the stats of existing talismans already present in the world.
  • Total Synchronization: The reload process now fully refreshes all talismans located in:
    • Player inventories.
    • Ender Chests.
    • Containers (Chests, Barrels, Shulkers).
    • Temporary inventories (Crafting tables, anvils, etc.).
  • Data Consistency: Ensured that NBT data and attributes remain correctly linked after modifications to the configuration files.

New Features

  • Default Configuration: The talismans.conf file now comes pre-loaded with a total of 15 unique talismans (including the Sphere and Totem series), fully configured and ready for use.
  • New Subcommand: /talisman forceupdate
    • Manually forces a global refresh of every talisman instance across the server.

Improvements

  • General Stability: Minor internal code fixes to improve performance when scanning multiple inventories.
  • Data Handling: Improved update logic to prevent talismans from retaining outdated data or "ghost" attributes.
1.0.0Релиз1.21.8, 1.21.9, 1.21.10 · 21 ноября 2025 г.

v1.0.0 – Initial Release

  • Complete customizable talisman system.
  • Flexible configuration with HOCON.
  • Passive effects applied automatically to players.
  • Support for item glow, hex colors, and custom formatting.
  • Various stability fixes and configuration checks.

Комментарии

Загружаем…