ВЕРСИИ (7)

# Changelog - FunTalismans ## [v1.3.0] – Talisman Improvements ### Added * Added configurable effects when consuming talisman totems. * Added automatic custom totem animations using each talisman's CustomModelData. * Added PacketEvents integration for more reliable totem pop detection. * Added improved handling for stackable talismans across plugin reloads. * Expanded the internal system to support future talisman mechanics and abilities. ### Fixed * Fixed critical potion effect conflicts between talisman effects and stronger vanilla potion effects. * Fixed cases where potion effects could remain active after temporary effects expired or the talisman was removed. * Fixed passive talisman effects persisting after rapidly consuming or switching talisman totems. * Fixed effect cleanup and restoration issues that could cause duplicated or persistent effects. * Improved talisman updating and item data consistency after reloads. ### Improved * Improved compatibility between talisman effects and vanilla Minecraft potion mechanics. * Improved custom totem animation handling without modifying the player's real inventory. * Improved compatibility with newer Minecraft server versions. * Improved general stability and internal effect handling. ### Important * **PacketEvents is now required as a dependency for FunTalismans.** * Make sure **PacketEvents is installed and updated** before starting the server with FunTalismans v1.3.0. * It is highly recommended to **create a backup of your current FunTalismans folder and configuration files before updating**. * Replace the old plugin files with the new v1.3.0 files and review any updated configuration options before starting the server. * A **full server restart is recommended after updating**. Avoid using plugin managers or hot-reload tools when replacing the FunTalismans `.jar`.

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