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