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 commandsspunkylagfix.abyss
- Access to the abyss commandspunkylagfix.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!