FioTags v1.54

FioTags Update - Changelog
(1.54)​

• Debug Logging Cleanup (Bloated Debug Message Fix)
  • Resolved excessive and repetitive debug output that previously flooded console logs.
  • Removed temporary shadow-tracing debug lines introduced during diagnostics.
  • Reduced noisy runtime logging paths so operational logs are now cleaner and easier to monitor.
• Admin Help Display Reconstructed
  • Reworked how admin help output is rendered to improve readability and command discoverability.
  • Adjusted help structure so command lines are more compact and consistent across admin sections.
  • Updated related usage messaging behavior to better align with actual command routing.
• Primary Command Namespace Updated
  • Changed main command usage from /fiotag to /fiotags.
  • Updated command registration and help/usage outputs to reflect the new primary alias.
  • Legacy command mentions were cleaned up to avoid mixed-prefix confusion.
• Permission Namespace Migration
  • Migrated permission nodes from fiotag.<key> to fiotags.<key>.
  • Updated permission checks and plugin metadata mappings for consistent node resolution.
  • Improved permission naming consistency with command namespace changes.
• Admin Tag State Command Refactor
  • Replaced old path /fiotag admin tag set with:
    /fiotags admin set <locked|unlocked|unclaim> <temporary|permanent> <dayValue> <player> <tagId>
  • Unified forced-state and temporary/permanent bypass management under a single command path.
  • Added duration argument flow for temporary state assignments via dayValue.
• Preview Chat Pipeline Changed (Fake Chat Removed)
  • FioTags no longer uses fake chat line rendering for preview output.
  • Preview flow now dispatches through a player-sudo style pipeline for more realistic chat behavior.
  • This improves compatibility with formatting handlers and reduces visual mismatch during previews.
• New MiniMessage Shadow Tag Support
  • Added support for <shadow:COLOR:OPACITY> formatting in FioTags text pipeline.
  • Implemented parser handling and compatibility fallbacks to prevent hard failures on unsupported paths.
  • Shadow parsing is now safely integrated with existing MiniMessage-based formatting logic.
• Version Naming Format Simplified
  • Adjusted displayed version style from X.XX.XX to X.XX.
  • Version presentation is now shorter and more consistent across user-facing outputs.
• Faulty Usage Argument Handling Optimized
  • Improved argument validation and usage feedback for incorrect command input.
  • Usage responses are now more targeted to the exact subcommand context instead of generic help spam.
  • Refined command feedback flow for faster correction when users mistype arguments.
• Legacy Color Output Modernization
  • Migrated key rendering paths from pure legacy color output toward Adventure Component-compatible formatting.
  • Implemented component-first rendering with fallback behavior for older/limited runtime environments.
  • Prepared formatting pipeline for modern MiniMessage features while preserving backward compatibility.

FioTags Update - Changelog
(1.53.11)​

• bStats Integration Added
  • Added official bStats metrics integration to help track plugin usage and runtime environment health.
• Hologram Plugin Dependency Removed for Tag Preview
  • FioTags no longer depends on external hologram plugins for preview rendering.
  • Removed hologram connector/detector bridge code and related provider routing logic.
  • Removed hologram-related softdepend entries from plugin.yml.
  • Preview rendering now runs fully native inside FioTags, reducing integration complexity and third-party breakage risk.
• Preview Renderer Migrated from ARMOR_STAND to TEXT_DISPLAY
  • Tag preview now uses TEXT_DISPLAY instead of ARMOR_STAND for cleaner and more modern visual rendering.
  • Preview text is now forced into a single-line display (no auto split to extra lines when text is long).
  • Follow behavior was improved toward FioChat-style smoothness, including motion/interpolation tuning and passenger-follow handling for TEXT_DISPLAY.
  • Sneak behavior now dims preview visibility (grayed-out feel) to better match vanilla-style nametag hiding behavior.
  • Fallback handling remains in place for older server environments that do not support TEXT_DISPLAY.

FioTags Update - Changelog
(1.53)​

• More Customization to Menu.yml
  • Server owner now can add a custom items to menu/menu.yml so not just the fiotag's default settings.

Example Item:
goback:
slot: 45
material: "SPRUCE_DOOR"
display_name: "<gold>Go Back</gold>"
lore:
- "<dark_gray>Button - Go Back</dark_gray>"
- ""
- "<gray>Click to go back to the"
- "<gray>Previous Menu."
- ""
- "<yellow>Click to go back</yellow>"
item_flags: []
banner_patterns: []
actions:
- "SOUND:UI_BUTTON_CLICK:1:1"
- "CONSOLE_COMMANDa open Cosmetics %player_name%"

Click to expand...

FioTags Update - Changelog
(1.53)​

• Player Head Texture Issue Fixed
  • Fixed a bug where custom PLAYER_HEAD textures failed to render and appeared as default/Steve heads.
  • Improved custom head loading flow so texture: "<value>" is applied more reliably.
• Paper 1.16.5 Crash Fixed (Voucher Conversion)
  • Fixed this error during voucher conversion on 1.16.5:
    
    Code:

    java.lang.NullPointerException
    at org.bukkit.craftbukkit.v1_16_R3.inventory.CraftMetaSkull.equalsCommon(...)

  • Root cause was unsafe ItemStack#isSimilar() comparison on certain SkullMeta cases.
  • Added a safe similarity fallback to prevent task crashes.

FioTags Update - Changelog
(1.53)​

• Voucher Conversion System Added
  Unlocked tags can now be converted into voucher items using Shift + Right Click from the tag menu.
  Converted tags are removed from ownership and set to locked state until redeemed.
• Per-Tag Voucher Conversion Control
  Added convertable_to_voucher support in tags.yml for every tag.
  Behavior is enforced as:
  • true = tag can be converted to voucher
  • false = tag cannot be converted
• Voucher Creator Identity + Timestamp
  Voucher lore supports {player} and {date}.
  Default voucher lore now includes Created at details.
• Voucher Self-Claim Settings
  Voucher settings are now grouped under:
  voucher.settings.enable_this_feature
voucher.settings.shift_right_to_convert
voucher.settings.claim_and_allow_self_claim
  
  When claim_and_allow_self_claim: true, creators can redeem their own vouchers.
• Voucher Anti-Exploit Restrictions Added
  Voucher items are blocked from:
  crafting, anvil, smithing, furnace fuel, and merchant trades.
  
  Voucher items still support storage/drop/transfer and right-click redeem behavior.
• Voucher Override Compatibility Expanded
  Added compatibility lookups for multiple override paths:
  • voucher.tags.<tag_id>
  • tags.<tag_id>.voucher
  • tags.<tag_id>.voucher-item
  • tags.<tag_id> (voucher-like keys)
  This improves compatibility for servers that structure configs differently.
• PLAYER_HEAD Voucher Guard Added
  When voucher material is configured as PLAYER_HEAD, a hard guard prevents accidental fallback to PAPER during item build.
• Voucher CustomModelData Support Added
  Voucher item options now support:
  model_data and custom_model_data
  for resource-pack based visuals.
• Small Font Syntax Migration Finalized
  Small font format standardized to <smallfont:Text>.
  Legacy nested forms were removed from active usage.
• Small Font Parsing Reliability Fix
  Fixed cases where <smallfont:...> did not parse consistently.
  Small font now applies correctly with dynamic placeholders such as {category}.

FioTags Update - Changelog
(1.52)​

• Tag Editor Unsaved Status Overhaul
  Tag section status for Locked, Unclaim, and Unlocked now always shows per-field indicators:
  <yellow>✎</yellow> <white>... for changed fields and
  <dark_gray>○</dark_gray> <gray>... for unchanged fields.
• Unsaved Count Positioning Update
  The unsaved change summary is now placed at the bottom of section lore, and only appears when there is an actual unsaved change:
  
  Code:

  <gray>Unsaved Change:</gray> <yellow>{amount}</yellow>
  <gray>(There is unsaved change on this option)</gray>

• Unsaved Detection Reliability Fix
  Fixed section unsaved tracking by resolving existing tag IDs case-insensitively before reading/writing paths, preventing false “no changes” states.
• List Chat Save Persistence Fix
  Fixed an issue where editing Requirements, Required, and Commands via chat prompt did not persist correctly.
• Immediate tags.yml Save on List Chat Save
  When saving list-chat edits on existing tags, FioTag now writes directly to tags.yml immediately.
• TOAST Gradient Rendering Fix
  Fixed TOAST: rendering so MiniMessage gradient/hex colors are preserved correctly in advancement toast titles.
• Create Locked Lore Default Update
  Updated the default locked lore line for new tag creation from:
  
  Code:

  <dark_gray>{custom_font:minifont:category} - ʟᴏᴄᴋᴇᴅ</dark_gray>

  to:
  
  Code:

  <dark_gray>{custom_font:minifont:category} ʟᴏᴄᴋᴇᴅ</dark_gray>

FioTags Update - Changelog
(1.51)​

• Requirement Notification Improvements
  Improved how the plugin notifies players when certain requirements are not met, providing clearer and more informative messages.
• Lore Editing System Upgrade
  The lore editing system now uses a chat prompt, allowing players to edit multiple lines at once instead of the previous one-by-one editing method.
• Category Creation Bug Fix
  Fixed an issue where creating a new category would override an existing category.
• Material Selector Improvement
  The Material Selector now displays the actual material selected by the player instead of the static CRAFTING_TABLE.
• First-Run Tag Bootstrap Fix
  FioTag now correctly copies the bundled tags.yml into the plugin data folder on first run instead of generating an empty tags file.
• Unreadable tags.yml Auto-Repair
  If tags.yml becomes corrupted or unreadable and resolves to 0 tags, FioTag will attempt an automatic repair and create a backup file (tags.yml.pre-repair.bak).
• Fail-Safe Tag Fallback
  If the runtime tags.yml is still unreadable, the plugin will fall back to bundled default tags so /fiotag does not open empty.
• UTF-8 Encoding Fix
  Saving tags.yml and language/message files now uses strict UTF-8 output to prevent mojibake or character corruption during reload/save cycles.
• Startup Banner Cleanup
  When total loaded tags equals 0, per-tag startup lines are now hidden to avoid displaying misleading or empty “loaded” entries.
• Critical Tag Configuration Fixes
  Corrected broken key and requirement entries including:
  
  Code:

  METADATA:add tag.diamonddigger
  [metadata] tag.diamonddigger
  [placeholder:%statistic_kill_entity:ZOMBIE%>=6969]