EnchantVisualsRK v3.6.0

EnchantVisualsRK

Advanced enchantment display, item identity, rarities, restrictions and persistent counters

Version 3.6.0

ABOUT

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

It replaces broken high-level text such as:


with clean and configurable lines such as:


The plugin preserves the real enchantments and their effects. It only changes how item information is displayed.

Version 3.6.0 also includes visual profiles, automatic rarities, item ownership, restrictions, persistent counters, administration menus, performance metrics and update diagnostics.

MAIN FEATURES

• Decimal, Roman, hybrid or hidden enchantment levels.
• Fixes enchantment.level.X on high-level enchantments.
• Global and per-enchantment names, colors, symbols and separators.
• Legacy color codes and hexadecimal colors.
• Configurable enchantment header.
• 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.
• Automatic lore backup and restoration.
• Automatic cleanup of duplicate lines from previous versions.
• Intelligent updates that avoid unnecessary item modifications.
• Automatic configuration and language migrations.
• Spanish, English and Portuguese language files.
• No required dependencies.

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 saving or applying profiles.
• Save and cancel controls to prevent accidental changes.

AUTOMATIC RARITIES AND VISUAL RULES

• Configurable Common, Uncommon, Rare, Epic, Legendary and Mythic rarities.
• Automatic 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 /elrock 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.

PERSISTENT ITEM COUNTERS

EnchantVisualsRK includes optional persistent counters for individual items:

• Entity kills.
• Player kills.
• Blocks broken.
• Damage dealt.
• Repairs performed.
• Projectiles fired.
• Distance travelled.
• Enchantments applied.
• Additional configurable item activity.

Counters support configurable lore and formatted numbers.


Counter resets require confirmation. Duplicate item UUIDs can be logged or regenerated safely. Items are never deleted automatically.

ADMINISTRATION AND PERFORMANCE

• Central /elrock admin control panel.
• Formatting performance statistics.
• Processed, changed, skipped and restored item information.
• Legacy and fallback update-source diagnostics.
• Safe confirmation before resetting statistics.
• Complete English, Spanish and Portuguese interface.

COMMANDS


PERMISSIONS

Main administrative permission:


Update notification permission:


Operators receive administrative access by default. Additional permissions and bypass options can be configured for individual systems.

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 /elrock doctor.
• The plugin never downloads or installs updates automatically.
• If the update service is unavailable, the remaining plugin features continue working normally.

INSTALLATION

1. Stop your server completely.
2. Remove the previous EnchantVisualsRK JAR.
3. Place EnchantVisualsRK-3.6.0.jar inside the plugins folder.
4. Start the server.
5. Edit plugins/EnchantVisualsRK/config.yml.
6. Select Spanish, English or Portuguese using the language option.
7. Run /elrock doctor.
8. Run /elrock preview to verify the visual format.
9. Use /elrock reload after making normal configuration changes.

Do not use the Bukkit /reload command.

UPDATING FROM AN OLDER VERSION

1. Stop the server completely.
2. Replace only the previous JAR.
3. Keep the existing plugins/EnchantVisualsRK folder.
4. Start the server.
5. Allow the automatic migration system to add missing options.
6. Run /elrock doctor.
7. Check the editor, profiles, restrictions and counter settings before enabling them.

The migration system preserves existing configuration values and language customizations. Automatic backups are created before important configuration changes.

REQUIREMENTS AND COMPATIBILITY

• Java 17 or newer.
• Spigot, Paper or Purpur.
• Minecraft 1.20 or newer.
• Developed for modern 1.20 and 1.21 server versions.
• No required dependencies.

SUPPORT INFORMATION

When reporting a problem, provide:

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

Official page:
EnchantVisualsRK on SpigotMC

Make a backup before updating a production server. Test identity, restrictions, counters, rarities and visual rules before enabling them globally.