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

Installation

1. Download NuLLAbyss-3.0.0.jar
2. Place in your server's plugins/ folder
3. Restart the server
4. Edit configuration files in plugins/NuLLAbyss/
5. Use /abyss reload to apply changes

Requirements:

• Paper/Spigot 1.21+
• Java 21+

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

Commands

Command	Permission	Description
/abyss	abyss.use	Open The Void GUI
/abyss reload	abyss.reload	Reload all configuration files
/abyss open	abyss.admin	Force open The Void
/abyss close	abyss.admin	Force close The Void
/abyss status	abyss.admin	View current status and next opening time

Note: 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 Files

The plugin creates 4 configuration files:

• config.yml — Main configuration
• exclude_items.yml — Items excluded from collection
• en_messages.yml — English messages
• pl_messages.yml — Polish messages

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

⏱️ Timing Settings

How minPlayers works:

• When players drop below minimum → current cycle completes, then pauses
• When enough players join → new cycle starts automatically
• Set to 0 to disable this feature

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

World Settings

Each world can have individual settings:

Mode behavior:

• blacklist — Unlisted worlds: command=true, collect=true, clear=false
• whitelist — Unlisted worlds: everything disabled

Setting combinations:

allow-command	collect-items	clear-items	Result
true	true	false	Normal behavior — items collected to Void
true	false	true	Items cleared but not saved
false	false	true	Clearing only, no player access
false	false	false	Plugin disabled for this world

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

Item Clear Module

Automatically clears ground items in worlds with clear-items: true

Two modes:

• interval: 0 (on-open mode) — Items cleared only when The Void opens
• interval: 60 (periodic mode) — Items cleared every 60 seconds independently

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

Exclude Items

Items in exclude_items.yml will NEVER be collected or cleared:

Use cases:

• Protect admin items from being collected
• Exclude specific materials (e.g., diamonds)
• Protect custom named items

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

Pagination

Enable unlimited item storage with multiple pages:

Navigation:

• Slot 45 — Previous page button
• Slot 49 — Page info (current/total)
• Slot 53 — Next page button

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

Messages & Colors

All messages support:

• HEX colors: &#RRGGBB (e.g., &#c41e3a)
• Legacy colors: &c, &l, &o, etc.

Placeholders:

Placeholder	Description
%timeleft%	Formatted time until next opening
%time%	Minutes until opening (for reminders)
%seconds%	Seconds until clear (for warnings)
%page%	Current page number
%total%	Total pages
%items%	Total items count
%needed%	Players needed to start cycle

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

❓ FAQ

Q: Items aren't being collected?

• Check if collect-items: true for that world
• Check if item isn't in exclude_items.yml
• Items must be older than minItemAge (default 5 seconds)

Q: Clear warnings not showing?

• Check warningEnabled: true
• For interval: 0 mode, warnings use warningTimes before Void opens

Q: Abyss not starting?

• Check minPlayers setting — may be waiting for more players
• Check console for "waiting for players" message

Q: Command aliases not updating after reload?

• Command aliases require server restart to update
• Other settings apply immediately with /abyss reload

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

Support

Need help? Have suggestions?


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