GriefPreventionAddon
一款现代化、功能丰富的 GriefPrevention 配套插件。
提供领地 TNT 保护、访客 /sethome 权限管理、PvP 开关、自然生物生成过滤、自定义领地别名、快速传送、自定义落点、交互式 GUI 菜单以及全局管理面板。
支持 Paper、Lecithin 26.2 以及与 Paper API 兼容的服务端核心,具备异步线程安全性,内部库零硬依赖,并完全支持多语言(i18n)本地化及自动检测玩家客户端语言。
? Features / 主要功能
| Feature | Description (English) | 說明 (繁體中文) | Command |
|---|---|---|---|
| TNT Explosion Control | Claim owners can allow or block explosion block damage inside their claim. Precise edge-filtering protects boundary blocks. | 地主自主決定領地內是否允許 TNT 爆炸破壞方塊,邊界過濾演算法精準保護領地方塊。 | /ctnt [on|off|status] |
Guest /sethome Control |
Claim owners decide whether untrusted visitors can use /sethome in their claim, preventing unauthorized fast travel. |
地主可自由設定是否允許未信任的訪客在自己領地內使用 /sethome 設家。 |
/csethome [on|off|status] |
| PvP Combat Toggle | Enable or disable player vs player combat inside the claim with real-time feedback. | 地主可自主開啟或關閉領地內的 PVP 對戰狀態,保護和平玩家。 | /pvp (/pvpinclaim) |
| Natural Mob Filters | Selectively toggle natural spawning for 5 mob categories (Hostile, Raider, Phantom, Slime, Ambient) without affecting spawners or breeding. | 分類開關自然生怪(一般敵對 / 掠奪者 / 夜魅 / 史萊姆 / 蝙蝠),不影響生怪磚與繁殖。 | /cmob [category] |
| Fast Claim Teleport | Instantly teleport to claim centers or custom spawn locations with safe height and region resolution. | 安全瞬間傳送至領地中心或自訂落腳點。 | /claimtp [id|alias] (/ctp) |
| Custom Spawn Point | Claim owners can define their exact standing location as the landing target for /ctp. |
地主可將當前站立點設為 /ctp 傳送落腳點,隨時自由清除或恢復中心。 |
/cspawn [set|clear] |
| Claim Aliases & Naming | Assign memorable names (e.g. home, farm, shop) to claims for convenient teleportation and recognition. |
為領地設定自訂別名(如「主家」、「農場」),支援中英文並可直接用於傳送。 | /cname [alias|clear] |
| Interactive GUI Menu | Chest GUI for intuitive claim settings, renaming, spawn points, and toggle adjustments. | 視覺化箱子選單,直觀管理領地狀態、改名、落腳點、TNT、PvP 與各類生物生成。 | /csettings [id|alias] |
| Global Admin Panel | Multi-page paginated administrative GUI to inspect, filter, search, teleport, edit, or purge all server claims. | 全伺服器管理員面板,具備分頁、篩選、即時搜尋、強制傳送、改名與刪除功能。 | /cadmin [list|tp|delete...] |
| Multi-Language (i18n) | Full localization support with automatic Minecraft client locale matching (zh_TW, en_US, etc.). |
完整的國際化多語言架構,依照玩家客戶端語言自動切換繁中與英文。 | Configurable |
? Requirements / 環境需求
- Minecraft Core: Paper, Lecithin 26.2, 或与 Paper API 兼容的服务端实现。
(注:上游 GriefPrevention 在未进行兼容性修改的情况下无法在标准 Folia 上原生运行;多线程服务端执行需要 Lecithin 或 Paper 兼容环境)。 - Java Runtime: Java 25。
- Dependencies: GriefPrevention (软依赖)。
- No proprietary libraries required — 100% 独立且开源。
? Commands & Permissions / 指令與權限
Player Commands / 玩家指令
| Command / 指令 | Aliases / 別名 | Permission / 權限 | Description / 說明 |
|---|---|---|---|
/csettings [id|alias] |
/claimsettings, /cmenu, /claimgui |
griefpreventionaddon.user |
Open claim settings GUI / 開啟領地設定選單 |
/ctnt [on|off|status] |
/claimtnt |
griefpreventionaddon.tnt |
Toggle or check TNT explosion damage / 切換 TNT 爆炸破壞 |
/csethome [on|off|status] |
/claimsethome, /sethomeinclaim |
griefpreventionaddon.sethome |
Toggle visitor /sethome permission / 切換訪客設家權限 |
/pvp |
/pvpinclaim, /cpvp |
griefpreventionaddon.user |
Toggle claim PvP combat / 切換領地 PVP 狀態 |
/cmob [category] |
/claimmobs |
griefpreventionaddon.user |
Toggle mob natural spawning categories / 切換生物自然生成 |
/claiminfo |
無 | griefpreventionaddon.user |
View info & actions for current claim / 查詢當前領地資訊 |
/claimtp [id|alias] |
/ctp, /claimteleport |
griefpreventionaddon.tp |
Teleport to claim center or custom spawn / 傳送至領地 |
/claimname [alias|clear] |
/cname, /claimalias |
griefpreventionaddon.user |
Set or clear custom claim alias / 設定或清除領地別名 |
/claimspawn [set|clear] |
/cspawn, /csetspawn |
griefpreventionaddon.spawn |
Set current spot as claim spawn point / 設定領地落腳點 |
/claimslist |
/claims, /myclaims |
griefpreventionaddon.user |
List all owned claims with teleport buttons / 列出名下領地 |
Admin Commands & Permissions / 管理員指令與權限
| Command / 指令 | Permission / 權限 | Description / 說明 |
|---|---|---|
/cadmin |
griefpreventionaddon.admin |
Open global claims admin GUI / 開啟全服領地管理面板 |
/cadmin list [player] |
griefpreventionaddon.admin |
List all claims or claims of a specific player / 檢視特定玩家或全部領地 |
/cadmin tp <id|alias> |
griefpreventionaddon.admin |
Force teleport to any claim / 強制傳送至任意領地 |
/cadmin delete <id> |
griefpreventionaddon.admin |
Force delete claim and purge database records / 強制刪除領地與設定 |
/cadmin name <id> <alias|clear> |
griefpreventionaddon.admin |
Modify alias of any claim / 設定或清除任意領地別名 |
/cadmin set <id> <key> <true|false> |
griefpreventionaddon.admin |
Force toggle a claim setting key / 強制設定領地開關數值 |
⚙️ Configuration & Localization / 設定與多語言
该插件将配置存储在 plugins/GriefPreventionAddon/config.yml 中:
locale:
# 默认回退语言(zh_TW、en_US 等)
default-language: "zh_TW"
# 自动检测并匹配玩家客户端区域设置
auto-detect-client-locale: true
tnt:
default-allowed: false
pvp:
default-allowed: false
sethome:
default-allowed: false
语言文件位于 plugins/GriefPreventionAddon/languages/ 目录下:
messages_zh_TW.yml(繁体中文)messages_en_US.yml(英文)
所有面向用户的消息、GUI 物品、标题和卡片描述均使用 MiniMessage 格式,且无需编译即可自定义。
?️ 构建与测试 / 建置與測試
构建要求:JDK 25。
# 克隆仓库
git clone https://github.com/Lycohinya/GriefPreventionAddon
# 运行完整的单元测试
./gradlew test
# 编译并打包独立的 shadowJar
./gradlew build
输出的 JAR 文件将生成在 build/libs/GriefPreventionAddon-0.3.1.jar 中。
? 许可证 / 授權條款
本项目遵循 GNU General Public License v3.0 (GPL-3.0) 许可协议。
详情请参阅 LICENSE 文件。
由 TinyYana 开发。
你是这个资源的作者?登录后可认领此资源。
相似资源
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
ExyliaPlugins 的库。
通过对话框或铁砧界面帮助你的 Anthme
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧