FunTalismans

Changelog - FunTalismans

[v1.2.3] – Stability Fixes

Fixed

- General internal fixes and stability improvements. - Improved item safety and data preservation. Future updates will now focus directly on the talismans themselves, including new content, mechanics, balancing, and improvements.

Changelog - FunTalismans

[v1.2.2] – Minor Fixes

Fixed

* Minor internal fixes and stability improvements. * Small console and maintenance adjustments.

Changelog - FunTalismans

[v1.2.1] – WorldGuard Integration Fix

Fixed

* Fixed FunTalismans loading before WorldGuard was fully enabled. * Changed the plugin load phase to ensure WorldGuard is available during initialization. * Fixed incorrect warnings claiming WorldGuard was not installed. * Improved detection of WorldGuard, WorldEdit and FastAsyncWorldEdit. * Improved WorldGuard integration status messages. * WorldGuard custom flags continue to be registered correctly during server startup.

Notes

* WorldGuard remains an optional dependency.

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.

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. ---

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.