GriefPreventionAddon

插件

· 作者 TinyYana

一个现代且功能丰富的 GriefPrevention 伴侣插件,提供多种领地设置选项。

0 本站下载 0 关注 更新于 2 个月前

最新 0.3.1 · 26.2 · Folia / Paper

一键开服(送7天)

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 开发。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源