🕳️ NuLLAbyss – Server Loot System for Hardcore Servers

NuLLAbyss is a utility plugin that creates a server-wide loot system. When players die or drop items, those items get collected into The Void, a shared inventory that opens periodically for everyone to loot.

Perfect for hardcore, survival, and SMP servers where fallen players' gear becomes fair game for the survivors.

---

🛠️ Key Features

Core System

• Automatic Item Collection — Ground items collected into The Void when it opens
• Scheduled Openings — Opens at configurable intervals, stays open for set duration
• Configurable Reminders — Warn players before opening (e.g., 15, 10, 5, 1 min)
• Despawn Protection — Save items right before they would disappear
• Pagination Support — Unlimited items with multiple pages and navigation

World Control

• Per-World Settings — Each world can have individual settings:
  • allow-command — Can players use /abyss in this world?
  • collect-items — Should items be saved to The Void?
  • clear-items — Should items be cleared from ground?
• Whitelist/Blacklist Mode — Control default behavior for unlisted worlds

Item Clear Module

• Active Item Clearing — Remove ground items in specific worlds
• Two Modes:
  • interval: 60 — Clear items every 60 seconds
  • interval: 0 — Clear items only when The Void opens
• Warning System — Broadcasts before clearing (configurable times)
• Player Notifications — Warn on world enter and item drop

Exclude Items

• Material Exclusions — Specify items that should never be collected
• Name Exclusions — Exclude items by custom display name
• Separate Config — Easy to manage exclude_items.yml

Smart Scheduling

• Minimum Players — Pause when server is empty (configurable threshold)
• Cycle Completion — If players leave mid-cycle, it completes before pausing
• Auto-Resume — Starts new cycle when enough players join

Customization

• Custom Commands — Define main command and aliases (/abyss, /trash, /void, etc.)
• Multilingual — English and Polish included
• HEX Color Support — Use &#RRGGBB in all messages
• Live Reload — Apply changes without restart

---

🧠 How It Works

1. Items dropped on the ground wait to be collected
2. Reminders notify players that The Void is about to open
3. When it opens — all ground items are swept into a shared GUI
4. Players rush to /abyss and grab what they can
5. After the timer ends, The Void closes

---

📋 Commands

Command	Permission	Description
/abyss	abyss.use	Open The Void GUI
/abyss reload	abyss.reload	Reload configuration
/abyss open	abyss.admin	Force open The Void
/abyss close	abyss.admin	Force close The Void
/abyss status	abyss.admin	View current status

Command name and aliases are configurable in config.yml

---

🔐 Permissions

Permission	Default	Description
abyss.use	true	Access to /abyss command
abyss.reload	op	Reload configuration
abyss.admin	op	Admin commands (open, close, status)

---

⚙️ Configuration

config.yml — Main configuration

minPlayers: 1        # 0 = always run, 1+ = wait for players
openDuration: 1800   # Time between openings (seconds)
openTime: 45         # How long it stays open

worlds:
  mode: "blacklist"
  list:
    world_nether:
      allow-command: false
      collect-items: false
      clear-items: true

itemClear:
  interval: 0        # 0 = clear on open, 60 = every 60s
  warningEnabled: true
  warningTimes: [30, 10, 5]

pagination:
  enabled: false
  itemsPerPage: 51
  limit: "off"

exclude_items.yml — Protected items

excludedItems:
  - BEDROCK
  - COMMAND_BLOCK

excludedNames:
  - "&cAdmin Sword"

---

💬 Support

Need help? Have suggestions?

Join our Discord

---

Crafted by NullaretH 💀
Where the fallen lose, the bold survive.