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.