Chunk Collectors

A relatively simple chunk collector plugin, quite customisable. Allows for fully configurable messages, item names, notification settings, item filters (on/off/permission), hopper extraction, and collected item counting. Integrates with DecentHolograms if you want holograms above the chunk collectors, though this can be disabled if you have DH but don't want holograms.

config.yml

messages:
  prefix: "&8[&bChunkCollector&8] &7"
  no-permission: "&cYou do not have permission to use this command."
  collector-given: "&aYou have been given a Chunk Collector."
  collector-received: "&aYou received a Chunk Collector."
  placed: "&aChunk Collector placed!"
  broken: "&cChunk Collector broken."
  limit-reached: "&cThere is already a Chunk Collector in this chunk!"
  only-players: "&cOnly players can use this command."
  player-not-found: "&cPlayer not found."
  collector-full: "&c&lChunk Collector is FULL!"
  info-header: "&8&m----------&r &b&lChunk Collector Info &8&m----------"
  info-location: "&7Location: &f%world% (%x%, %y%, %z%)"
  info-chunk: "&7Chunk: &f(%chunk_x%, %chunk_z%)"
  info-stats: "&7Items Collected: &f%count%"
  info-no-collector: "&cNo Chunk Collector found in this chunk."
  filter-updated: "&aFilter updated for this chunk's collector!"
  filter-mode-set: "&7Filter mode set to: &f%mode%"
  filter-item-added: "&7Added &f%item% &7to filter list."
  filter-item-removed: "&7Removed &f%item% &7from filter list."
  filter-cleared: "&7Filter list cleared."
  filter-help: "&b&lChunk Collector Filter Help:\n&7/collectorfilter mode <DISABLED|WHITELIST|BLACKLIST>\n&7/collectorfilter add <item>\n&7/collectorfilter remove <item>\n&7/collectorfilter clear\n&7/collectorfilter list"
  filter-list-header: "&b&lFilter Settings:"
  filter-list-mode: "&7Mode: &f%mode%"
  filter-list-items: "&7Items: &f%items%"
  invalid-mode: "&cInvalid mode! Use DISABLED, WHITELIST, or BLACKLIST."
  invalid-item: "&cInvalid item type: %item%"
  not-owner: "&cYou don't own the collector in this chunk!"
  filtering-disabled: "&cItem filtering is currently disabled on this server."

item:
  name: "&b&lChunk Collector"
  lore:
    - "&7Place this in a chunk to"
    - "&7collect all dropped items!"
    - "&7(One per chunk)"

# Full inventory notification settings
full-notification:
  enabled: true
  notify-owner: true  # Notify the owner who placed the collector
  notify-nearby: false  # Also notify nearby players
  radius: 16  # Blocks radius to notify nearby players (if notify-nearby is true)
  cooldown: 30  # Seconds between notifications for the same collector

# Default item filtering settings (players can configure per-collector)
item-filter:
  enabled: true  # Enable/disable item filtering feature globally
  require-permission: false  # Require chunkcollector.filter permission to use filtering
  default-mode: "DISABLED"  # DISABLED, WHITELIST, or BLACKLIST
  default-items: []  # Default items to filter

# Hologram settings (requires DecentHolograms plugin)
holograms:
  enabled: true  # Enable/disable holograms (only works if DecentHolograms is installed)
  height: 1.5  # Height above the chest
  lines:
    - "&b&lChunk Collector"
    - "&7Collecting items in this chunk"

# Hopper settings
hoppers:
  allow-extraction: true  # Allow hoppers to extract items from chunk collectors

# Statistics settings
statistics:
  enabled: true  # Track how many items each collector has collected
  show-in-info: true  # Display statistics in /collectorinfo command

# bStats settings
bstats:
  enabled: true  # Send anonymous usage statistics to bStats (https://bstats.org/) pls keep on

Command	Description	Permission	Default
/givecollector [player] [quantity]	Give a chunk collector to a player, optional quantity and player	chunkcollector.give	Defaults to OP
/collectorinfo	Get information about the current chunk's collector	chunkcollector.use	Defaults to all players
/collectorfilter	Filter what blocks the collector picks up	chunkcollector.filter	Defaults to all players
/collectorreload	Reloads the config	chunkcollector.reload	Defaults to OP