Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!
A modern, feature-rich companion addon for GriefPrevention. Provides various per-claim settings.
GriefPreventionAddon
A modern, feature-rich companion addon for GriefPrevention.
Provides per-claim TNT protection, guest /sethome permission management, PvP toggles, natural mob spawning filters, custom claim aliases, fast teleportation, custom landing points, interactive GUI menus, and a global administrative panel.
Supports Paper, Lecithin 26.2, and Paper API compatible server cores with asynchronous thread safety, zero hard dependencies on internal libraries, and full multi-language (i18n) localization with auto-detection of player client locales.
🌟 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, or compatible Paper API server implementations.
(Note: Upstream GriefPrevention does not run natively on standard Folia without compatibility modifications; multithreaded server execution requires Lecithin or a Paper-compatible environment). - Java Runtime: Java 25.
- Dependencies: GriefPrevention (Soft dependency).
- No proprietary libraries required — 100% standalone and open-source.
🎮 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 / 設定與多語言
The plugin stores configuration in plugins/GriefPreventionAddon/config.yml:
locale:
# Default fallback language (zh_TW, en_US, etc.)
default-language: "zh_TW"
# Auto detect and match player client locale
auto-detect-client-locale: true
tnt:
default-allowed: false
pvp:
default-allowed: false
sethome:
default-allowed: false
Language files are located in plugins/GriefPreventionAddon/languages/:
messages_zh_TW.yml(Traditional Chinese)messages_en_US.yml(English)
All user-facing messages, GUI items, titles, and card descriptions use MiniMessage formatting and can be customized without compiling.
🛠️ Building & Testing / 建置與測試
Build requirements: JDK 25.
# Clone the repository
git clone https://github.com/TinyYana/Lycohinya.git
cd Lycohinya/LycohinyaPlugins/GriefPreventionAddon
# Run full unit tests
./gradlew test
# Compile and package standalone shadowJar
./gradlew build
The output JAR will be generated in build/libs/GriefPreventionAddon-0.3.1.jar.
📄 License / 授權條款
This project is licensed under the GNU General Public License v3.0 (GPL-3.0).
See the LICENSE file for details.
Developed by TinyYana.
Information
1Downloads
0Stars
Supports Folia Addon
Pinned Versions
- R26.2
Pages
Members
1Owner