Skip to main content

Blacklist System

Player and item blacklist functionality.

Overview​

The blacklist system allows you to restrict which players can use orders and which items can be ordered.

Player Blacklist​

Purpose​

Prevent specific players from:

  • Creating orders
  • Delivering to orders
  • Using order system

Configuration​

blacklist:
  enabled: true
  players:
    - "player-uuid-here"
    - "PlayerName"

Usage​

Players can be blacklisted by:

  • UUID (recommended, more reliable)
  • Player name (less reliable, names can change)

Management​

  • Edit config.yml to add/remove players
  • Reload with /orders reload
  • Or use API (if available)

Item Blacklist​

Purpose​

Prevent specific items from being ordered:

  • Problematic items (bedrock, barriers)
  • Exploit items
  • Server-specific restrictions

Configuration​

blacklist:
  enabled: true
  items:
    - BEDROCK
    - BARRIER
    - COMMAND_BLOCK
    - SPAWNER

Hardcoded Blocked Items​

These items are always blocked (cannot be disabled):

  • All shulker box variants
  • Bundle

This prevents data loss and exploits.

Blacklist Behavior​

When Enabled​

  • Blacklisted players cannot create orders
  • Blacklisted players cannot deliver
  • Blacklisted items cannot be ordered
  • System checks blacklist on all operations

When Disabled​

  • All players can use orders
  • All items can be ordered (except hardcoded)
  • Blacklist checks are skipped

Best Practices​

  1. Use UUIDs: More reliable than names
  2. Document Reasons: Keep notes of why players/items are blacklisted
  3. Regular Review: Review blacklist periodically
  4. Test Changes: Test blacklist changes before production