GuardaPrevenção

🛡️ GuardaPrevenção v1.2.2 — Major Stability & Compatibility Update

GuardaPrevenção continues to evolve with a strong focus on stability, performance, and real-world server reliability. This update combines all previous improvements with several critical fixes discovered after extensive testing on Paper and Purpur environments.

After a complete audit of the plugin, multiple issues were identified and resolved, resulting in the most polished version of GuardaPrevenção to date.

🔍 Full Plugin Review

The entire plugin ecosystem was analyzed and refined, including:

✅ 21 Java classes ✅ YAML configuration files ✅ plugin.yml ✅ Maven project structure ✅ PlaceholderAPI integration ✅ GUI systems ✅ Anti-lag mechanics ✅ Suspension systems ✅ Data persistence logic ✅ Thread safety improvements 🐛 Critical Bugs Fixed 🔴 Bug #1 — Plugin Failed to Load on Some Servers Error Directory 'plugins/GuardaPrevenção.jar' failed to update! Root Cause

The JAR filename contained special Unicode characters (ã, ç, etc.). Certain filesystem environments used by Paper/Purpur cannot properly handle plugin JAR filenames containing non-ASCII characters.

Solution

The distributed plugin file has been renamed to:

GuardaPrevencao-1.2.2.jar

without accents.

Result ✅ 100% compatible loading. ✅ No startup failures caused by the JAR filename. ✅ The in-game plugin name remains GuardaPrevenção through plugin.yml. 🔴 Bug #2 — Suspensions Did Not Persist After Rejoining Root Cause

Suspended players were only forced into Adventure Mode if they had already been in Adventure Mode before disconnecting.

After a server restart, Minecraft restored their previous gamemode (usually Survival), allowing suspended players to bypass restrictions.

Solution

The join logic was completely redesigned.

Now:

If the player is suspended: Adventure Mode is immediately enforced. If the suspension expired while the player was offline: Their normal Survival mode is automatically restored. The validation delay was increased to: 20 ticks (1 second)

to ensure the player has fully loaded.

Result ✅ Suspensions persist correctly. ✅ No bypass after reconnecting. ✅ Automatic restoration after expiration. 🔴 Bug #3 — Suspended Players Could Change Gamemode Root Cause

Gamemode protection used:

EventPriority.HIGH

which allowed other plugins to override the restriction.

Solution

Changed to:

EventPriority.HIGHEST

making GuardaPrevenção the final authority in the event chain.

Result ✅ Suspended players cannot bypass restrictions. ✅ Improved compatibility with other plugins. 🟡 Bug #4 — Silent Save Failures Root Cause

If administrators manually deleted the plugin's data folders while the server was running, saving operations could fail silently.

Solution

Automatic directory recreation was added before every save operation.

Affected managers:

SuspensionManager TravadorManager

using:

mkdirs()

before persistence.

Result ✅ Reliable saves. ✅ Automatic recovery from missing folders. 🟡 Bug #5 — XP Orb Cleanup Logic Root Cause

The decompiled cleanup logic contained inverted boolean conditions, causing XP orb cleanup to behave inconsistently.

Solution

The logic was rewritten clearly and safely.

Result ✅ XP cleanup now respects configuration settings exactly. 🔧 Previously Fixed Issues

This release also includes all fixes from earlier updates:

Fixed Typographical errors in messages. Cinematic welcome timing issues. Duplicate cleanup tasks after reloads. OfflinePlayer null validation. TPS display calculation improvements. ConcurrentModificationExceptions. Console execution handling. Tab completion issues. GUI spelling corrections. Entity cleanup mappings. Placeholder registration failures. Memory division safeguards. ✨ New Improvements 🛶 Expanded GTravar Support

The restriction system now supports 28 additional materials, including:

Chest Boats Bamboo Rafts Bamboo Chest Rafts Mangrove Boats Crimson Signs Warped Signs Various transportation and utility blocks

Giving administrators even more control over server mechanics.

🔒 Improved Immunity Cache

The whitelist and immunity cache system now updates instantly.

Whenever a player is added to or removed from the whitelist:

Cache entries are automatically invalidated. Changes take effect immediately. Result ✅ Accurate permission handling. ✅ No stale cache data. ☕ Modern Java Codebase

The internal codebase has been modernized using newer Java features while maintaining compatibility.

Improvements Switch expressions. Pattern matching with instanceof. Cleaner command implementations. Improved readability and maintainability.

Compatible with modern Paper/Purpur environments.

🛡️ Official Branding

The plugin officially uses the identity:

GuardaPrevenção

This branding has been standardized across:

Messages Banners Configurations Documentation Commands 🔗 Main Alias

Added support for:

/guardaprevencao

making the plugin easier to access using its official name.

🚫 GProibir Suspension System

A complete punishment system designed for temporary restrictions.

Staff Commands Command Description /gproibir [reason] Suspend a player /gproibir reset Remove a suspension /gproibir info View suspension details /gproibir resetbv global Reset cinematic welcomes Player Commands Command Description /gminhapunicao View your own punishment Features Adventure Mode enforcement. Automatic expiration handling. Persistent punishment records. Anti-gamemode bypass. Cinematic titles and sounds. YAML-based storage. 🔒 GTravar Restriction Module

Interactive GUI-based protection system.

Features 6×9 management interface. Decorative inventory design. Sound feedback. Real-time toggles. Staff alerts. Authorization cache.

Supports restrictions for:

TNT Lava Water Flint and Steel End Crystals Withers Redstone components Vehicles Signs Fireworks Bedrock Command Blocks Beacons And dozens more. ⚡ Anti-Lag Systems

Powerful optimization tools to maintain server performance.

Commands Command Description /sistemas travar Enable emergency restrictions /sistemas liberar Disable restrictions /sistemas limpar Manual cleanup /glimpar confirmar Confirm cleanup with broadcast /gstatus View TPS, RAM, player count, and entities Features Scheduled cleanup. Ground item removal. Projectile optimization. Configurable entity cleanup. Live performance monitoring. 🎯 PlaceholderAPI Support

Integrates seamlessly with scoreboards, TAB, holograms, and other plugins.

Available placeholders include:

%guardiao_badge% %guardiao_status% %guardiao_tempo_restante% %guardiao_motivo% %guardiao_dias_originais% 📦 Installation Place GuardaPrevencao-1.2.2.jar inside your plugins/ folder. Restart your server. Configure the generated files inside: plugins/GuardaPrevencao/ Adjust settings to match your server's needs. 🚀 Why Choose GuardaPrevenção?

GuardaPrevenção combines anti-lag optimization, advanced restriction controls, suspension management, and server protection into a single lightweight solution.

Instead of relying on multiple plugins, you get one unified system built for modern Minecraft communities.

Highlights ✅ Paper & Purpur 1.21+ compatible ✅ Lightweight and optimized ✅ Java 21 compatible ✅ PlaceholderAPI support ✅ GUI-based management ✅ Persistent punishments ✅ Advanced anti-lag tools ✅ Staff notification systems ✅ Continuous improvements and bug fixes

GuardaPrevenção is built to help administrators prevent abuse, maintain performance, and manage their servers with confidence.