MCWild v1.7.6

• Added configurable mob combat tagging with combat-tag.tag-mobs.
• Blocked /wild in blacklisted worlds and disabled dimensions.
• Applied config-driven retry delay, async toggle, and stats interval behavior.
• Used configured End fallback coordinates and improved Nether/End safety settings handling.
• Fixed combat tag expiry notifications so players are notified when combat ends.
• Replaced deprecated biome name access to remove the build warning.

Migration Notes

• You will need to delete your config.yml and allow the plugin to regenerate it.

MCWild v1.7.5

Bug Fixes:

• Fixed an issue where the config would be overwritten on server restart if it was changed while the server was running.

MCWild v1.7.4

New feature:

• Added a new option to the config.yml: require-permission
  • When set to true, players will need the permission node mcwild.wild to use /wild
  • When set to false, ANYONE will be able to use /wild without the need for a permissions plugin or permissions.yml

Migration Notes

• You will need to delete your config.yml and allow the plugin to regenerate it.

MCWild v1.7.3

Bug Fixes:

• Fixed an issue where the combat notification message displayed the raw text {duration} instead of the actual number of seconds remaining. Players will now properly see exactly how long their combat timer lasts when they get hit.

MCWild v1.7.2

Supported Versions: Minecraft 1.21.x (including 1.21.11) System Requirement: Java 21

This update focuses on stability and compatibility, introducing a new adaptive loading system that ensures smooth performance across all server software types, including standard Spigot and high-performance forks like Paper.

Update Highlights

Universal Server Support I have implemented a new adaptive chunk loading system.

• Paper/Purpur Users: The plugin utilizes true asynchronous loading for zero-lag teleportation.
• Spigot Users: Addressed a critical issue where the plugin would crash due to missing API features. The plugin now automatically switches to a "Safe Mode" on Spigot servers to prevent crashes.

Performance Optimization: Smart Biome Filtering For servers running in "Safe Mode" (Standard Spigot), generating new chunks can be demanding. I have added a pre-check system:

• The plugin now checks the biome type before generating the terrain.
• If the random location is an Ocean or River, the plugin skips the generation process entirely and retries immediately.
• This significantly reduces the "Can't keep up" warnings and lag spikes associated with generating water worlds.

Server Health Protection

• Throttle System: If a safe location is not found immediately, the plugin now waits briefly before retrying. This allows the server to recover and process other events, preventing TPS drops during mass teleportation.
• Generated Chunk Priority: The system prioritizes locations where chunks already exist on the drive, making teleportation instant in explored areas.

Bug Fixes

• Fixed a critical error regarding cooldown management that occurred when reloading the plugin.
• Resolved compatibility issues with the latest Minecraft 1.21.11 server jars.

Note: No configuration changes are required for this update.

Version 1.7.0 - Performance Update

🚀 Performance Improvements

• Async Location Finding: Heavy location search moved to background threads (Spigot compatible)
• Concurrent Teleport Management: Support for up to 5 simultaneous teleportations
• 60% Reduction in main thread blocking during teleportations
• Performance Monitoring: Real-time teleport timing and statistics

🔒 Permission Changes

• Breaking Change: /wild command now requires OP permission by default
• Changed mcwild.wild from default: true to default: op
• Administrators must now grant mcwild.wild permission to players/groups

✨ New Features

• Active teleport tracking prevents spam and server overload
• Enhanced debug logging with performance metrics
• Automatic cleanup of interrupted teleportations
• Player disconnect handling during teleportation

⚙️ New Configuration Options

• performance.max-concurrent-teleports - Limit simultaneous teleports (default: 5)
• performance.async-operations - Enable/disable async operations (default: true)
• performance.stats-interval - Performance logging frequency (default: 50)

📊 Performance Impact

• Significantly improved server responsiveness during peak usage
• Reduced TPS impact when multiple players use /wild
• Better memory management with proper task cleanup

🔄 Migration Notes

• Action Required: Grant mcwild.wild permission to players who should access /wild
• All configuration files remain backwards compatible
• Existing cooldown and combat systems unchanged

Version 1.6.0 - Combat Update

⚔️ Added

• Combat Tagging System: Players can no longer use /wild while in PvP combat
• Smart Combat Detection: Automatically detects player vs player damage including projectiles
• Configurable Combat Duration: Set how long combat lasts after taking/dealing damage (default: 15 seconds)
• Combat Notifications: Players are notified when entering and leaving combat
• Combat Logout Protection: Optional punishment system for players who log out during combat
• World Blacklisting: Disable combat tagging in specific worlds (spawn areas, creative worlds)
• New Permission: mcwild.wild.combat.bypass - Allows bypassing combat restrictions
• Combat-related Messages: New message configurations for combat status and restrictions

🔧 Configuration Options Added

• combat-tag.enabled - Enable/disable combat tagging system
• combat-tag.duration - Combat duration in seconds (default: 15)
• combat-tag.notify-on-tag - Notify players when tagged in combat
• combat-tag.notify-on-untag - Notify players when combat ends
• combat-tag.punish-logout - Enable combat logout punishment
• combat-tag.logout-punishment - Type of punishment ("none", "kill", "damage")
• combat-tag.logout-damage - Damage amount for logout punishment
• combat-tag.blacklisted-worlds - List of worlds where combat tagging is disabled

📝 Enhanced

• Improved Logging: Enhanced debug output for combat events
• Thread Safety: Combat tag tracking uses thread-safe data structures
• Memory Management: Automatic cleanup of expired combat tags
• Error Handling: Better error handling for combat-related events

🛠️ Technical Changes

• Added CombatManager.java - Core combat tagging logic
• Added CombatListener.java - PvP event handling
• Updated MCWild.java - Integrated combat manager
• Updated WildCommand.java - Added combat status checks
• Enhanced plugin initialization and shutdown procedures

🔒 Permissions

• Added mcwild.wild.combat.bypass permission for staff/VIP players
• Updated mcwild.* permission to include combat bypass

💬 New Messages

• combat-tagged - Notification when entering combat
• combat-ended - Notification when leaving combat
• cannot-teleport-in-combat - Warning when trying to use /wild in combat
• Combat logout punishment messages
• Combat help information

⚙️ Compatibility

• Backward Compatible: All existing features work unchanged
• Optional Feature: Combat tagging can be completely disabled via config
• No Breaking Changes: Existing configurations remain valid
• Spigot 1.21+: Optimized for latest Minecraft versions

🐛 Bug Fixes

• Improved chunk loading reliability
• Enhanced error handling for teleportation failures
• Better memory management for player data

---

📋 Migration Notes

• No manual migration required
• Combat tagging is enabled by default but can be disabled
• Existing permissions and configurations remain unchanged
• New configuration options will be auto-generated on first startup

• Configurable Nether and End support
• Configurable cooldown
• Configurable messages