AegisTick - Invisible Adaptive Server Optimizer

📋 Description

AegisTick is a cutting-edge performance optimization plugin for Minecraft servers that works completely invisibly to players. Unlike traditional "lag-clearing" plugins that wipe entities or send annoying messages, AegisTick intelligently optimizes server performance per-chunk without any player-visible effects.

The plugin uses advanced profiling and machine learning to identify high-stress chunks and applies temporary, reversible optimizations only when safe to do so. Players will never notice the optimizations - they'll only experience better TPS.

✨ Key Features

🎯 Smart Optimizations

• Hopper Throttling - Slows item transfers in inactive chunks
• Entity AI Sleep - Disables mob pathfinding when no players nearby
• Random Tick Scaling - Adjusts crop/block update speed per chunk
• Redstone Delay - Adds minimal delays to redstone in empty areas
• Item Merge - Aggressively combines dropped items to reduce entity count

🧠 Adaptive Learning

• Tracks chunk performance over time
• Learns which chunks cause the most lag
• Automatically adjusts optimization intensity
• Predicts lag spikes before they happen

🛡️ Safety First

Never optimizes when players are:

• Building (recent block placement)
• In combat (took damage recently)
• Looking at entities or redstone
• Within configurable radius of chunks

⚡ Emergency Mode

• Auto-activates when TPS drops below threshold
• Applies aggressive optimizations temporarily
• Auto-reverts when TPS recovers
• Fully configurable thresholds

📊 Performance Impact

Typical improvements on populated servers:

• 5-15% TPS gain overall
• 30-50% reduction in entity tick time
• 20-30% reduction in chunk tick time
• More stable TPS during peak hours
• No entity despawns or farm breaking

🎮 Server Compatibility

✅ Supported Platforms

* Spigot may work but Paper/Purpur are highly recommended for best performance.

❌ Not Compatible

• Bukkit (vanilla)
• Forge servers
• Fabric servers (stubs included for future support)
• Minecraft versions below 1.21

⚙️ Requirements

• Java: 21 or higher
• RAM: No additional requirements
• Dependencies: None (standalone plugin)

📦 Installation

1. Download aegistick-paper-1.0.0.jar
2. Place in your server's plugins folder
3. Restart the server
4. Configure in plugins/AegisTick/config.yml (auto-generated)
5. Use /aegistick to access admin GUI

🎛️ Commands

🔧 Configuration

Default config location: plugins/AegisTick/config.yml

Quick Settings

optimization:
  base-aggressiveness: 0.5 # How aggressive (0.0 = gentle, 1.0 = maximum)
  emergency-aggressiveness: 0.9 # Aggressiveness during TPS drop
  emergency-tps-threshold: 15.0 # When to activate emergency mode

safety:
  builder-protection-radius: 32 # Don't optimize within N blocks of building
  combat-protection-ticks: 600 # Protect for 30 seconds after combat
  afk-threshold-ticks: 6000 # Consider player AFK after 5 minutes

features:
  hopper-throttling: true # Enable hopper optimization
  entity-ai-sleep: true # Enable entity AI optimization
  random-tick-scaling: true # Enable random tick optimization
  redstone-delay: true # Enable redstone optimization
  item-merge: true # Enable item merging

learning:
  enabled: true # Enable adaptive learning

profile: SMP # Preset: SMP, CREATIVE, SKYBLOCK, SURVIVAL

🎨 Admin GUI

Access with /aegistick as an OP or with aegistick.admin permission.

GUI Features:

• ✅ Live TPS display
• ✅ Toggle individual optimizations
• ✅ View real-time statistics
• ✅ Emergency mode controls
• ✅ Profile switching (SMP/Creative/Skyblock)
• ✅ Visual status indicators

🚫 What It Doesn't Do

• ❌ No entity wiping - Never removes mobs or items
• ❌ No chat spam - Zero player-facing messages
• ❌ No global gamerules - Only per-chunk optimizations
• ❌ No farm breaking - Farms still work, just optimized
• ❌ No visible effects - 100% invisible to players

🏗️ For Server Owners

Best Use Cases

• SMP servers with 10+ active players
• Survival servers with large farms
• Economy servers with many shops/hoppers
• Servers experiencing TPS drops during peak hours

Not Recommended For

• Minigame servers (constant player activity everywhere)
• Small servers (<5 players) - overhead may not be worth it
• Creative-only servers - limited benefit

🐛 Troubleshooting

GUI Not Opening

• Ensure you have OP or aegistick.admin permission
• Check server console for errors
• Verify plugin loaded: /plugins should show green "AegisTick"

Plugin Not Loading

• Check Java version: java -version (must be 21+)
• Ensure you're using Paper/Purpur 1.21+
• Check for conflicting plugins

Optimizations Not Working

• Use /aegistick status to verify enabled
• Check that chunks have players nearby (safety protections)
• Review config settings - may need to increase aggressiveness

📝 Version History

v1.0.0 (Current)

• Initial release
• 5 core optimizations
• Adaptive learning engine
• Emergency mode
• Admin GUI
• Full Paper 1.21+ support

🤝 Support

For issues, suggestions, or questions:

• Check console logs for error messages
• Review plugins/AegisTick/config.yml settings
• Test with /aegistick status command

📜 License

This plugin is provided as-is for use on Minecraft servers. Redistribution and modification are subject to project license terms.

🎯 Core Philosophy

"The best optimization is the one players never notice."

AegisTick operates on three principles:

1. Invisible - Zero player-facing effects
2. Adaptive - Learns and improves over time
3. Safe - Never breaks farms or disrupts gameplay

Experience better server performance without compromising the player experience.