---

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

---

🆘 Support

---

📜 License

© 2026 Arklandia Studios — All Rights Reserved