Donut Shards v1.3.0

v1.3.0 - Folia Support Update! Universal Compatibility - Works on ALL Server Types!​

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ MAJOR NEW FEATURE: Folia Compatibility DonutShards is now dual-compatible and works on both traditional servers AND Folia! What This Means:

• Single JAR works everywhere - no separate versions needed
• Automatic detection of server type
• Full Folia region-based threading support
• Zero configuration required
• 100% backwards compatible with existing servers

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ WHAT IS FOLIA? Folia is Paper's next-generation multi-threaded server software that dramatically improves performance for large servers by using region-based multithreading instead of traditional single-threaded execution. Why This Update Matters:

• Future-proof your server - ready for Folia adoption
• No performance loss on traditional servers
• Seamless migration path when you upgrade
• Works on: Bukkit, Spigot, Paper, Purpur, AND Folia

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ TECHNICAL IMPROVEMENTS 1. FoliaLib Integration

• Added FoliaLib dependency for universal compatibility
• Intelligent server type detection
• Automatic scheduler selection
• No manual configuration needed

2. Scheduler Wrapper System

• New SchedulerUtil.java for abstracted scheduling
• Handles both traditional and region-based threading
• Seamless task execution across server types
• Prevents scheduling conflicts

3. Code Optimization

• Minimal code changes for maximum compatibility
• Fixed return type mismatches
• Improved error handling
• Better async task management

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ HOW IT WORKS On Traditional Servers (Bukkit/Spigot/Paper/Purpur):

Code:

 Plugin loads → Detects traditional server → Uses standard Bukkit scheduler → Works exactly as before

On Folia Servers:

Code:

 Plugin loads → Detects Folia → Uses region-based scheduler → Full multi-threading support

You don't need to do anything! The plugin automatically detects your server type and adapts. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ COMPATIBILITY Supported Server Types:

• Bukkit (all versions)
• Spigot (all versions)
• Paper (all versions)
• Purpur (all versions)
• Folia (all versions)
• Any Bukkit/Spigot/Paper fork

Minecraft Versions:

• 1.16+
• Full support for latest versions

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ MIGRATION GUIDE From Previous Version: 1. Stop your server 2. Replace old DonutShards.jar with new version 3. Start your server 4. Done! No config changes needed Works on Both:

• Existing Paper/Spigot servers - continues working normally
• New Folia servers - automatically uses Folia features

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ BUG FIXES

• Fixed scheduler return type mismatches
• Resolved CompletableFuture<Void> vs WrappedTask issues
• Improved async task handling
• Better error messages for scheduling failures

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ PERFORMANCE Traditional Servers:

• Zero performance overhead
• Same efficient execution as before
• No additional resource usage

Folia Servers:

• Full multi-threading benefits
• Region-based task execution
• Improved scalability for large servers
• Better CPU utilization

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Added toggle function for shards everywhere message per player setting.

CHANGELOG v1.2.4​

Added:​

• Added passive shard generation - players with permission earn 1 shard per minute everywhere (customizable)
• Added config option to toggle passive shard notifications

Changed:​

• AFK arena rewards reduced from 100 shards to 1 shard per interval
• Booster text now displays correctly (1.5x instead of 1.5xx)

Permission:​

• afkarena.shards.passive - Grant this to players who should receive passive shards