xChunkHoppers
? 终极区块收集插件
? 描述
xChunkHoppers 是生存、空岛和阵营服务器的终极解决方案。它允许你创建“魔法漏斗”,可以在特定半径或整个区块内自动收集物品,无需水流且无卡顿。
经过高性能优化,支持 十六进制颜色、特效、GUI 菜单以及供开发者使用的 完整 API。
✨ 主要功能
- ?️ 极致性能: 智能缓存和
PersistentDataContainer (PDC)。零卡顿。
- ? 多种类型: 创建无限数量的漏斗类型(VIP、GOD、BASIC),并配置范围(8x8、64x64、完整区块)。
- ? 高级设计: 完全支持 HEX 颜色 (
&#RRGGBB) 和渐变效果。
- ?️ GUI 菜单: 可视化管理面板用于获取物品 (
/xch menu)。
- ? 数据持久化:
data.yml 系统,跨重启保存位置信息。
- ? 视觉特效: 放置方块时完全可配置的音效和粒子效果。
- ? 开发者 API: 简单的 API,方便与其他插件集成。
- ⚙️ 过滤功能: 支持材料白名单或黑名单(例如:仅仙人掌和铁)。
? 安装
- 下载
xChunkHoppers.jar。
- 将其放入服务器的
/plugins/ 文件夹中。
- (可选)安装 PlaceholderAPI 以使用变量。
- 重启服务器。
- 在
config.yml 中配置漏斗类型,然后尽情体验吧!
示例视频:
? 命令与权限
| 命令 |
描述 |
权限 |
/xch give <player> <type> [amount] |
向玩家发放特定类型的 ChunkHopper。 |
xchunkhoppers.admin |
/xch menu |
打开包含所有漏斗的 GUI 菜单。 |
xchunkhoppers.admin |
/xch reload |
重新加载配置文件和数据库。 |
xchunkhoppers.admin |
其他权限
xchunkhoppers.place » 允许放置区块跳跃器。
xchunkhoppers.break » 允许破坏并回收区块跳跃器。
?️ 配置
# ___ _ _
#__ __ / __\ |__ _ _ _ __ | | __ /\ /\___ _ __ _ __ ___ _ __ ___
#\ \/ // / | '_ \| | | | '_ \| |/ // /_/ / _ \| '_ \| '_ \ / _ \ '__/ __|
# > </ /___| | | | |_| | | | | </ __ / (_) | |_) | |_) | __/ | \__ \
#/_/\_\____/|_| |_|\__,_|_| |_|_|\_\/ /_/ \___/| .__/| .__/ \___|_| |___/
# |_| |_|
网站:
Wiki:
Discord:
settings:
启用或禁用插件的全部功能
enabled: true
如果为 true:仅收集 'filter-list' 中的物品。
如果为 false:收集除 'filter-list' 中物品之外的所有物品。
use-whitelist: false
材料列表(使用 Bukkit Material 枚举名称)
filter-list:
- "COBBLESTONE"
- "DIRT"
- "ROTTEN_FLESH"
GUI 菜单
menu:
title: "&#B3B3B3管理员漏斗菜单"
size: 27
fill:
enabled: true
material: "BLACK_STAINED_GLASS_PANE" # 用于填充空槽的材料
漏斗
hopper-types:
default:
radius: -1
name: "�ff00区块漏斗 &7(16x16)"
lore:
- "&8 特殊物品"
- ""
- "&f 放置此方块以"
- "&f 自动收集"
- "&f 该区块内的所有物品。"
- ""
- "&e独特区块!"
- ""
vip:
radius: 4
name: "&#ffaa00漏斗 &lVIP &7(8x8)"
lore:
- "&8 VIP 物品"
- ""
- "&f 放置此方块以"
- "&f 自动收集"
- "&f 该区块内的所有物品。"
- ""
- "&e独特区块!"
- ""
god:
radius: 32
name: "&#ff0000漏斗 &lGOD &7(64x64)"
lore:
- "&8 GOD 物品"
- ""
- "&f 放置此方块以"
- "&f 自动收集"
- "&f 该区块内的所有物品。"
- ""
- "&e独特区块!"
- ""
放置漏斗和使用菜单时的效果配置
effects:
sound:
enabled: true
声音名称:
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: "&c您没有执行此操作的权限。"
reload: "�ff00配置和数据已成功重载。"
player-not-found: "&c未找到玩家。"
give-success: "&a您已向 &f%player%&a 发放了 &e%amount% &f%type%&a。"
received: "&a您已收到一个 &d区块漏斗&a。"
placed: "�ff00区块漏斗已放置!它将开始收集范围内的物品。"
broken: "&e您已移除区块漏斗。"
already-exists: "&c此处已存在一个区块漏斗。"
type-not-found: "&c配置中不存在该类型的漏斗。"
version: 1.0.0
### ? 开发者 API
要在您的插件中使用 API,请在 `plugin.yml` 中将 xChunkHoppers 添加为依赖项。
Maven / Gradle
将 jar 作为本地库添加。
```Java
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();
```java
if (api.hasHopper(chunk)) {
getLogger().info("该区块中存在一个魔法漏斗!");
Location loc = api.getHopperLocation(chunk);
// 执行某些操作...
}
}
}
这是开源的 :)
你可以点击这里!
由 WillfryDev 用 ❤️ 为社区制作。
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
| Command |
Description |
Permission |
/xch give <player> <type> [amount] |
Gives a specific ChunkHopper to a player. |
xchunkhoppers.admin |
/xch menu |
Opens the GUI menu with all hoppers. |
xchunkhoppers.admin |
/xch reload |
Reloads the configuration and database. |
xchunkhoppers.admin |
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: "�ff00Chunk 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: "�ff00Configuration 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: "�ff00Chunk 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!
Made with ❤️ by WillfryDev for the community.
评论 0
登录后参与评分
还没有评论,来抢沙发吧