---

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

```yaml
debug: true

---

🆘 Support

---

📜 License

© 2026 Arklandia Studios — All Rights Reserved