xChunkHoppers

Minecraft 版本： 1.16 1.16.1 1.16.2 1.16.3 1.16.4 1.16.5 1.17 1.17.1 1.18 1.18.1 1.18.2 1.19 1.19.1 1.19.2 1.19.3 1.19.4 1.20 1.20.1 1.20.2 1.20.3 1.20.4 1.20.5 1.20.6 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11

平台： bukkit paper purpur spigot

标签： game-mechanics minigame storage

xChunkHoppers 

? The Ultimate Chunk Collector Plugin

? Description

xChunkHoppers is the ultimate solution for Survival, SkyBlock, and Factions servers. It allows you to create "Magic Hoppers" that automatically collect items within a specific radius or the entire Chunk without the need for water streams or lag.

Optimized for high performance, with support for Hex Colors, Effects, GUI Menu, and a complete API for developers.

✨ Key Features

• ?️ Extreme Performance: Smart caching and PersistentDataContainer (PDC). Zero lag.
• ? Multi-Types: Create infinite hopper types (VIP, GOD, BASIC) with configurable ranges (8x8, 64x64, Full Chunk).
• ? Premium Design: Full support for HEX colors (&#RRGGBB) and gradients.
• ?️ GUI Menu: Visual admin panel to obtain items (/xch menu).
• ? Data Persistence: data.yml system to save locations across restarts.
• ? Visual Effects: Fully configurable sounds and particles when placing blocks.
• ? Developer API: Simple API to integrate with other plugins.
• ⚙️ Filtering: Whitelist or blacklist of materials (e.g., only Cactus and Iron).

? Installation

1.  Download xChunkHoppers.jar.
2.  Place it in your server's /plugins/ folder.
3.  (Optional) Install PlaceholderAPI to use variables.
4.  Restart the server.
5.  Configure the hopper types in config.yml and enjoy!

Example Video:

? Commands and Permissions

Other Permissions

• xchunkhoppers.place » Allows placing Chunk Hoppers.
• xchunkhoppers.break » Allows breaking and retrieving Chunk Hoppers.

?️ Configuration

#         ___ _                 _
#__  __ / __\ |__  _   _ _ __ | | __ /\  /\___  _ __  _ __   ___ _ __ ___
#\ \/ // /  | '_ \| | | | '_ \| |/ // /_/ / _ \| '_ \| '_ \ / _ \ '__/ __|
# >  </ /___| | | | |_| | | | |   </ __  / (_) | |_) | |_) |  __/ |  \__ \
#/_/\_\____/|_| |_|\__,_|_| |_|_|\_\/ /_/ \___/| .__/| .__/ \___|_|  |___/
#                                              |_|   |_|
#                 Web: [https://xplugin.es](https://xplugin.es)
#          Wiki: [https://xplugin.es/xchunkhoppers](https://xplugin.es/xchunkhoppers)
#            Discord: [https://discord.xplugin.es](https://discord.xplugin.es)

settings:
  # Enable or disable full plugin functionality
  enabled: true

  # If true: Only collects items in 'filter-list'.
  # If false: Collects everything EXCEPT items in 'filter-list'.
  use-whitelist: false

  # List of materials (Use Bukkit Material enum names)
  filter-list:
    - "COBBLESTONE"
    - "DIRT"
    - "ROTTEN_FLESH"

# GUI Menu
menu:
  title: "&#B3B3B3Admin hoppers menu"
  size: 27
  fill:
    enabled: true
    material: "BLACK_STAINED_GLASS_PANE" # Material to fill empty slots

# Hoppers
hopper-types:
  default:
    radius: -1
    name: "&#00ff00Chunk Hopper &7(16x16)"
    lore:
      - "&8 Special Item"
      - ""
      - "&f Place this block to"
      - "&f collect all items"
      - "&f in this chunk automatically."
      - ""
      - "&eUnique Chunk!"
      - ""
  vip:
    radius: 4
    name: "&#ffaa00Hopper &lVIP &7(8x8)"
    lore:
      - "&8 VIP Item"
      - ""
      - "&f Place this block to"
      - "&f collect all items"
      - "&f in this chunk automatically."
      - ""
      - "&eUnique Chunk!"
      - ""
  god:
    radius: 32
    name: "&#ff0000Hopper &lGOD &7(64x64)"
    lore:
      - "&8 GOD Item"
      - ""
      - "&f Place this block to"
      - "&f collect all items"
      - "&f in this chunk automatically."
      - ""
      - "&eUnique Chunk!"
      - ""

# Configuration of effects when placing the Hopper and using the Menu
effects:
  sound:
    enabled: true
    # Sound names: [https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Sound.html](https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Sound.html)
    type: "ENTITY_PLAYER_LEVELUP"
    volume: 1.0
    pitch: 1.0
  particles:
    enabled: true
    type: "VILLAGER_HAPPY"
    count: 15

permissions:
  admin: "xchunkhoppers.admin"
  place: "xchunkhoppers.place"
  break: "xchunkhoppers.break"

messages:
  prefix: "&8[&d&lxCH&8] "
  no-permission: "&cYou do not have permission to do this."
  reload: "&#00ff00Configuration and Data reloaded successfully."
  player-not-found: "&cPlayer not found."
  give-success: "&aYou gave &e%amount% &f%type% &a to &f%player%&a."
  received: "&aYou have received a &dChunk Hopper&a."
  placed: "&#00ff00Chunk Hopper placed! It will now collect items in this range."
  broken: "&eYou have removed the Chunk Hopper."
  already-exists: "&cA Chunk Hopper already exists here."
  type-not-found: "&cThat Hopper type does not exist in the config."

version: 1.0.0

? Developer API

To use the API in your plugin, add xChunkHoppers as a depend in your plugin.yml.

Maven / Gradle
Add the jar as a local library.

import jn.willfrydev.xchunkhoppers.xChunkHoppers;
import jn.willfrydev.xchunkhoppers.api.ChunkHopperAPI;

public class YourPlugin extends JavaPlugin {
    
    public void checkHopper(Chunk chunk) {
        ChunkHopperAPI api = xChunkHoppers.getAPI();

        if (api.hasHopper(chunk)) {
            getLogger().info("There is a magic hopper in this chunk!");
            
            Location loc = api.getHopperLocation(chunk);
            // Do something...
        }
    }
}

Is Open Source :)

You can click here!