EnchantVisualsRK 3.6.0

ABOUT ENCHANTVISUALSRK

EnchantVisualsRK transforms the way enchantments and item information are displayed on your Minecraft server.

It replaces broken high-level enchantment text such as:

with clean and configurable lines:

The real enchantments, levels, and effects are preserved. EnchantVisualsRK only changes how their information is displayed.

Version 3.7.0 introduces a completely redesigned manual update system. The plugin no longer scans inventories or processes items continuously in the background.

Administrators now decide exactly when items should be updated.


MAJOR PERFORMANCE REDESIGN

Previous versions could perform a large number of unnecessary item checks while only a small number of items required actual changes.

Version 3.7.0 removes the continuous item-checking architecture.

EnchantVisualsRK no longer automatically processes items when players:

• Move items inside inventories.
• Pick up dropped items.
• Switch their held item.
• Enchant equipment.
• Craft items.
• Use anvils or smithing tables.
• Open inventories.
• Join the server.

There is no periodic inventory scanner running in the background.

While no manual update command is running, EnchantVisualsRK remains practically inactive and does not continuously inspect player items.



CONTROLLED MANUAL UPDATE SYSTEM

Administrators can apply visual changes whenever they are ready.

Items are processed through a controlled queue instead of updating every item during one server tick.

The queue limits:

• The number of items processed per tick.
• The maximum processing time used per tick.
• Duplicate requests for the same player and inventory slot.

Default limits:

These limits can be customized in config.yml.

This system helps prevent sudden MSPT spikes when updating large inventories or multiple connected players.



FAST ITEM FINGERPRINTS

Version 3.7.0 removes expensive YAML serialization from item fingerprints.

The new deterministic 64-bit fingerprint only considers information relevant to the visual result:

• Material.
• Enchantments and levels.
• Display name.
• Custom Model Data.
• Relevant item flags.
• Durability when durability display is enabled.
• Current visual configuration.

Full YAML or NBT serialization is not performed for every item.

This significantly reduces unnecessary work on the main server thread.



MAIN VISUAL FEATURES

• Decimal, Roman, hybrid, or hidden enchantment levels.
• Fixes enchantment.level.X on high-level enchantments.
• Global and per-enchantment names.
• Custom colors, symbols, formats, and separators.
• Legacy color codes and hexadecimal colors.
• Configurable enchantment headers.
• Custom enchantment ordering.
• Option to place curses last.
• Hide selected enchantments.
• Special colors for high or legendary levels.
• Optional custom attribute display.
• Optional durability and rarity information.
• Preserves the original item lore.
• Original lore backup and restoration.
• Cleanup of duplicated lines created by older versions.
• Spanish, English, and Portuguese language files.
• Automatic configuration and language migration.
• No required dependencies.

MANUAL UPDATE COMMANDS

/enchantvisual applyhand

Updates only the item held in your main hand.

This is the recommended command for testing colors, symbols, formats, profiles, and configuration changes.

/enchantvisual apply

Updates your own inventory through the controlled queue.

/enchantvisual apply <player>

Updates only the selected online player's inventory.

/enchantvisual applyall

Displays a confirmation before starting a server-wide update.

/enchantvisual applyall confirm

Updates the inventories of all connected players through the controlled queue.

/enchantvisual progress

Displays the current update status:

/enchantvisual cancel

Safely cancels the current manual update.

/enchantvisual performance

Displays detailed performance statistics, including:

• Total items checked.
• Total items modified.
• Skipped updates.
• Fingerprint calls.
• Average fingerprint time.
• Maximum fingerprint time.
• Queued and processed updates.
• Duplicate updates avoided.
• Slow operations detected.

SAFE CONFIGURATION RELOADS

/enchantvisual reload only reloads configuration and language files.

It does not:

• Scan player inventories.
• Modify existing items.
• Start a global update.
• Run hidden item processing.

After changing your configuration, run /enchantvisual applyhand, /enchantvisual apply <player>, or /enchantvisual applyall confirm whenever you are ready to apply the changes.



IMPORTANT MANUAL MODE INFORMATION

Newly created or modified items are not formatted automatically.

This behavior is intentional and prevents the plugin from constantly checking inventories.

Recommended workflow:

1. Create or modify your items.
2. Configure their visual style.
3. Test one item using /enchantvisual applyhand.
4. Apply the changes to one player using /enchantvisual apply <player>.
5. Use /enchantvisual applyall confirm only when you want to update every connected player.

Gameplay counters do not automatically modify items while manual mode is active. This guarantees that items remain unchanged until an administrator requests an update.



BACKWARD-COMPATIBLE COMMANDS

The previous administrative commands remain available:

• fixhand
• fixinventory
• fixplayer
• fixall
• cleanup

Inventory-wide legacy commands now use the controlled update queue and no longer process every item in one server tick.

Existing command aliases are preserved:

• /enchantvisual
• /enchantvisuals
• /elrock
• /enchantlevel

VISUAL EDITOR AND PROFILES

• Expanded 54-slot in-game editor.
• Live preview using a high-level enchanted item.
• Controls for level format, symbols, colors, separators, headers, and attributes.
• Paginated editor to show or hide individual enchantments.
• Built-in Vanilla, Minimal, RPG, PvP, and Legendary profiles.
• Custom profile import and export.
• Automatic configuration backups before important changes.
• Save and cancel controls to prevent accidental changes.

Applying a profile changes the configuration but does not automatically scan inventories. Use a manual update command afterward.



RARITIES AND VISUAL RULES

• Configurable Common, Uncommon, Rare, Epic, Legendary, and Mythic rarities.
• Scoring using material, enchantment count, levels, and Custom Model Data.
• Priority-based visual rules.
• Conditions for material, item name, total levels, and highest level.
• Conditions for required enchantments and Custom Model Data.
• Rules can change rarity, colors, symbol, and level format.
• Rule validation integrated into /enchantvisual doctor.

Rarities and visual rules are disabled by default to protect existing item designs.



ITEM IDENTITY AND RESTRICTIONS

EnchantVisualsRK can assign persistent information to individual items:

• Unique item identifier.
• Owner UUID and player name.
• Creation date.
• Optional owner and identity lore.
• Bind, unbind, and inspect tools.
• Optional keep-on-death protection.

Restrictions can independently prevent:

• Dropping the item.
• Storing it inside containers.
• Trading it with villagers.
• Placing it as a block.
• Using it inside anvils.
• Transferring it to another player.

Item identity is stored inside each item. No external database is required.



ITEM COUNTERS

EnchantVisualsRK includes an optional item counter system for:

• Entity kills.
• Player kills.
• Blocks broken.
• Damage dealt.
• Damage received.
• Repairs performed.
• Projectiles fired.
• Distance travelled.
• Enchantments applied.

Manual mode note: Automatic gameplay counter updates are paused while the manual update system is active. This prevents gameplay events from modifying item data without an administrator command.



ADMINISTRATION AND DIAGNOSTICS

• Central administration panel.
• Formatting and fingerprint performance statistics.
• Processed, modified, skipped, and pending item information.
• Slow-operation monitoring.
• Update queue progress and cancellation.
• Update-source diagnostics.
• Configuration and rule validation.
• Complete English, Spanish, and Portuguese interface.

COMMAND LIST

Legacy commands remain available:



PERMISSIONS

Main administrative permission:

Manual update permissions:

Additional permissions:

Operators receive administrative access by default.



UPDATE CHECKER

• Safe asynchronous update checks.
• Console notification when a new version is available.
• Optional administrator notification when joining.
• Manual update check and version information commands.
• Configurable intervals, reminders, and connection timeouts.
• Update status integrated into /enchantvisual doctor.
• The plugin never downloads or installs updates automatically.
• If the update service is unavailable, the remaining plugin features continue working.

INSTALLATION

1. Stop your server completely.
2. Place EnchantVisualsRK-3.7.0.jar inside the plugins folder.
3. Start the server.
4. Edit plugins/EnchantVisualsRK/config.yml.
5. Select Spanish, English, or Portuguese using the language option.
6. Run /enchantvisual doctor.
7. Run /enchantvisual preview to verify the visual format.
8. Test one item using /enchantvisual applyhand.

Do not use the Bukkit /reload command.



UPDATING FROM AN OLDER VERSION

1. Stop the server completely.
2. Create a backup of plugins/EnchantVisualsRK.
3. Replace only the previous JAR.
4. Keep the existing plugin folder.
5. Start the server.
6. Allow the migration system to add missing options.
7. Run /enchantvisual doctor.
8. Run /enchantvisual reload.
9. Test one item using /enchantvisual applyhand.
10. Use /enchantvisual applyall confirm when ready to update connected players.

The migration system preserves existing configuration values and language customizations.



SUPPORT INFORMATION

When reporting a problem, provide:

• Exact Minecraft server version.
• Java version.
• EnchantVisualsRK version.
• Plugin list and versions.
• Output from /enchantvisual doctor.
• Output from /enchantvisual performance.
• Relevant section of logs/latest.log.
• A screenshot or copy of the affected item.
• Commands and steps required to reproduce the problem.

Official page:

EnchantVisualsRK on SpigotMC