🧹 ArkLagg

Advanced lag management plugin

Overview

ArkLagg is an advanced ClearLag plugin designed for Paper and Folia servers. It automatically removes ground entities and items at regular intervals, protects valuable items, and creates temporary safe zones around player death locations.

✨ Features

🔁 Automatic ClearLag — configurable cleanup interval (in seconds)
📢 Progressive announcements — warnings at 5 min, 1 min, 30 s, and 10 s before cleanup
🗑️ Item & entity cleanup — removes drops, mobs, projectiles, and falling blocks
🛡️ Death protection — temporary zone around death location to protect drops
🔒 Item blacklist — protection for tools, armor, and rare items (Mace, Elytra…)
🐾 Entity protection — tamed, named, villagers, and 1.21+ entities preserved
🎮 Third-party plugin support — Oraxen, ItemsAdder, enchanted items
⚡ Folia-compatible — regionalized scheduler, zero multi-thread conflict
🌐 Bilingual — French and English included (lang/fr.json, lang/en.json)
🐛 Debug mode — detailed logs toggled with a single config flag

📦 Installation

Drop the .jar file into your server's plugins/ folder and restart. Configuration files are generated automatically on first startup.

Required:

Paper or Folia 1.21.x (Java 21+) or Paper/Folia 26.x (Java 25+)
No required dependencies

Optional:

Oraxen — protection of custom items
ItemsAdder — protection of custom items

⚙️ Configuration

The config.yml is generated in plugins/ArkLagg/ on first startup.

# Language: fr | en
language: fr

# Debug logs
debug: false

# ── ClearLag ────────────────────────────────────────────────────────────
clearlag:
  enabled: true
  interval: 300          # Interval in seconds (default: 5 min)
  max-per-tick: 0        # Entities removed per tick (0 = unlimited)
  announcements:
    enabled: true
    timings: [300, 60, 30, 10]   # Seconds before cleanup

# ── Item cleanup ──────────────────────────────────────
item-cleanup:
  enabled: true
  min-age: 0             # Minimum age before removal (secondes)
  max-items: 0           # Maximum items removed per cycle (0 = illimité)
  by-type:
    common: true         # Remove common items
    valuable: false      # Protect rare items

# ── Entity cleanup ──────────────────────────────────
entity-cleanup:
  enabled: true
  hostile-mobs: true     # Hostile mobs
  passive-mobs: true     # Passive animals
  projectiles: true      # Arrows, fireballs…
  dropped-blocks: true   # Falling blocks

# ── Death protection zone ─────────────────────────
death-regions:
  enabled: true
  duration: 300          # Duration in seconds
  radius: 30             # Radius in blocks
  show-particles: true
  play-sound: true

# ── Entity protection ───────────────────────────────
entity-protection:
  protect-tamed: true          # Tamed
  protect-named: true          # Named (name tag)
  protect-in-water: false
  protect-near-players: 0      # Radius (0 = disabled)

# ── Protection items custom ──────────────────────────────────────────────
custom-items:
  protect-oraxen: true
  protect-itemsadder: true
  protect-all-custom: false
  protect-enchanted: true

# ── Blacklist items (never removed) ───────────────────
blacklist-items:
  - DIAMOND_PICKAXE
  - NETHERITE_SWORD
  - ELYTRA
  - MACE
  # ... see full config for the complete list

# ── Blacklist entités (never removed) ────────────────
blacklist-entities:
  - ARMOR_STAND
  - VILLAGER
  - CREAKING
  # ... see full config

# ── Performance ──────────────────────────────────────────────────────────
performance:
  use-async: false             # Async processing (experimental)
  chunk-based: true            # Chunk-by-chunk cleanup
  min-tps-threshold: 15.0      # Min TPS before pausing
  clear-memory: true           # Free memory after cleanup

💬 Language

Change language: fr in config.yml to switch language. Files are in plugins/ArkLagg/lang/.

File	Language
`lang/en.json`	English
`lang/fr.json`	French

🕹️ Commands

Command	Description	Permission
`/arklagg`	Show help	—
`/arklagg help`	Show help	—
`/arklagg clear`	Trigger a manual cleanup	`arklagg.clear`
`/arklagg reload`	Reload configuration	`arklagg.reload`

🔐 Permissions

Permission	Description	Default
`arklagg.clear`	Trigger a manual ClearLag	`op`
`arklagg.reload`	Reload the configuration	`op`

🖥️ Compatibility

Platform	Version	Java	Supported
Paper	1.21.x	21+	✅
Folia	1.21.x	21+	✅
Paper	26.x	25+	✅
Folia	26.x	25+	✅
Spigot	any	—	❌

🐛 Debug

debug: true

ArkLagg

Compatibility

Minecraft: Java Edition

Platforms

Tags

Creators

Details