AdvancedTick+ | Performance Optimizer v1.1.0

AdvancedTick+ Essentials
Addon for AdvancedTick+ — Requires AdvancedTick+ to function

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

AdvancedTick+ Essentials is an addon that extends AdvancedTick+ with eight additional features focused on automation, stability and deeper insights. Drop the JAR into your addons folder and everything activates automatically.

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

Performance History

Records TPS, MSPT, memory usage and player count every minute and stores the data in a local SQLite database. Keeps the last 7 days of data, automatically removing older entries. Accessible from the History tab in the AdvancedTick+ web dashboard — view graphs for the last hour, 3 hours, 24 hours, 3 days or 7 days. Export any time range as a CSV file for external analysis.

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

Restart Scheduler

Automatically restarts the server at configured times each day. Broadcasts warnings to all players at 10, 5 and 1 minute before the restart so no one is caught off guard. Also monitors TPS — if performance stays critically low for a configurable number of minutes, an emergency restart is triggered automatically.

YAML:

essentials:
  restart:
    enabled: true
    times:
      - "04:00"
      - "16:00"
    warn-minutes: [10, 5, 1]
    tps-threshold: 10.0
    tps-minutes: 5

​

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

Backup System

Creates compressed ZIP backups of all worlds at a configurable interval. Keeps only the last N backups and automatically removes older ones to save disk space. Sends a notification to your Discord channel when a backup completes, including the file size and time taken.

YAML:

essentials:
  backup:
    enabled: true
    interval-minutes: 60
    keep-last: 5
    discord-notify: true

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

Hopper Optimizer

Monitors hopper activity across all worlds and detects individual hoppers that are producing an excessive number of item transfer events per second. When TPS drops below the configured threshold, overactive hoppers are automatically throttled. When performance recovers, they return to normal operation. No commands required — fully automatic.

YAML:

essentials:
  hopper-optimizer:
    enabled: true
    throttle-threshold: 50
    tps-threshold: 17.0

​

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

TPS Whitelist

When TPS drops below a set threshold, new player logins are temporarily blocked. Players with the advancedtick.admin permission are always allowed through. A broadcast message notifies online players when the whitelist activates and again when it deactivates after TPS recovers.

YAML:

essentials:
  tps-whitelist:
    enabled: true
    tps-threshold: 15.0
    kick-message: "&cServer under heavy load. Please try again in a moment."

​

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

Player Lag Detector

Samples every online player every 5 seconds and calculates a lag score based on three factors — chunk loads triggered near the player, the number of entities within 16 blocks, and their ping. The results are visible with /at top, which lists the highest-scoring players alongside active redstone hotspot coordinates.

​

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

Alert Escalation

Tracks how long TPS has been below the threshold and escalates alerts over time. Admins receive in-game messages and Discord alerts at each level.

• 2 minutes — Notice sent to online admins
• 5 minutes — Warning broadcast + Discord alert
• 10 minutes — Critical alert with urgent Discord notification

Resets automatically when TPS recovers.

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

/at top Command

Shows a ranked list of the players currently putting the most load on the server, along with their chunk load rate, nearby entity count, ping and calculated lag score. Also displays the most active redstone block coordinates detected by AdvancedTick+'s Redstone Culler.

​

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

Installation

1. Make sure AdvancedTick+ is installed and running
2. Place ATEssentials.jar in plugins/AdvancedTick/addons/
3. Restart the server
4. Add the essentials: config section to your config.yml

On startup you will see:

Code:

[AT+ Essentials] Enabling AdvancedTick+ Essentials v1.0.0...
[AT+ Essentials] All modules active.

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

Requires: AdvancedTick+ v1.0.0 or higher · Paper / Purpur 1.20+