SpunkyLagFix is a powerful plugin designed to enhance your Minecraft server's performance by minimizing entity lag, cleaning up the world, and optimizing various server processes. If you're struggling with lag, excessive mobs, or redstone contraptions slowing down your server, this plugin is the perfect solution.

Features

1. CustomAI Optimization

• Optimizes mob behavior to reduce server load
• Disables AI when no players are nearby
• Different ranges for hostile (32 blocks) and passive mobs (16 blocks)
• Significantly reduces CPU usage from mob pathfinding

2. Items Cleaner

• Automatically cleans dropped items from the ground
• Valuable items (enchanted/named) are stored in the "abyss"
• Configurable cleanup intervals
• 30-second warning before cleanup
• Players can retrieve their items using /abyss

3. Entity Limiter

• Limits entities per chunk to prevent lag
• Configurable limits for different mob types:
  • Zombies/Skeletons: 20 per chunk
  • Spiders: 15 per chunk
  • Animals (Chicken/Cow/Sheep/Pig): 10 per chunk
• Automatically removes excess entities

4. Lag Monitor

• Monitors server TPS (Ticks Per Second)
• Tracks memory usage
• Automatically takes action when performance drops
• Notifies admins of performance issues

5. Anti-Redstone

• Prevents laggy redstone contraptions
• Detects and disables redstone clocks
• Configurable pulse limits
• Helps prevent redstone-based lag machines

Commands

Main Command: /spunkylagfix (aliases: /slf, /slagfix)

Subcommands:

• /spunkylagfix reload - Reloads plugin configuration
• /spunkylagfix status - Shows server performance stats
• /spunkylagfix clean - Manually triggers item cleanup
• /spunkylagfix optimize - Runs all optimization features
• /spunkylagfix killmobs - Removes all mobs from the world
• /spunkylagfix clearentity - Cleans up entities (minecarts, boats, items, etc.)
• /spunkylagfix toggle-ai - Toggles CustomAI feature
• /spunkylagfix toggle-cleaner - Toggles ItemsCleaner
• /spunkylagfix toggle-limiter - Toggles EntityLimiter
• /spunkylagfix toggle-redstone - Toggles AntiRedstone

Abyss Command: /abyss

• Retrieves valuable items that were cleaned up
• Items are stored safely instead of being deleted
• Accessible to all players by default

Permissions

• spunkylagfix.admin - Access to all plugin commands
• spunkylagfix.abyss - Access to the abyss command
• spunkylagfix.notify - Receives plugin notifications

Configuration

All features are configurable in config.yml:

items-cleaner:
  enabled: true
  interval: 5  # Minutes between cleanups
  warning-time: 30  # Seconds

entity-limiter:
  enabled: true
  limits:
    ZOMBIE: 20
    SKELETON: 20
    # etc...

custom-ai:
  enabled: true
  check-radius: 16

anti-redstone:
  enabled: true
  max-pulses: 100
  reset-ticks: 100

lag-monitor:
  enabled: true
  tps-threshold: 18.0
  memory-threshold: 80

Special Features

1. Welcome Message

• Shows when players join
• Includes clickable YouTube channel link
• Different messages for operators and regular players

2. Performance Monitoring

• Real-time TPS monitoring
• Memory usage tracking
• Automatic optimization when needed

3. Safe Mode Operations

• All features can be toggled individually
• Configurable thresholds and limits
• Backup systems for valuable items

Conclusion

SpunkyLagFix is a comprehensive solution for server lag, combining multiple optimization techniques while remaining user-friendly and fully configurable. With its powerful commands and automated features, you can keep your server running smoothly and lag-free!