? 概览
保护你的宠物,精准管理它们。
AnimalGuard 是一款专为现代 Minecraft 服务器(Paper 1.20+)设计的强大且轻量的保护插件。它将使用 Name Tag 这一简单行为转化为安全的归属权声明。
与那些顺便包含动物保护的复杂领地插件不同,AnimalGuard 专注于纯粹的 实体保护,并提供企业级性能(HikariCP)和精致的管理员 GUI。
为什么要使用它?
- “玩家一直在杀我的马!” ? 只需给它们起个名字(使用 Name Tag)即可锁定所有权。
- “我有太多受保护的生物导致卡顿。” ? 使用管理员 GUI 按“距离”或“日期”排序,并清理旧的实体。
- “那只受保护的僵尸去哪了?” ? 启用 Markup Mode 让特定生物在墙后也能发光显示。
✨ 主要功能
- ?️ 名牌保护: 玩家只需重命名一个 Name Tag 并右键点击生物即可认领该生物。该生物将对其他玩家无敌。
- ?️ 可视化管理员 GUI: 一个强大的库存界面,供 OP 浏览所有受保护的生物。
- 可排序: 按 名称、注册日期 或 与你之间的距离 进行排序。
- 传送/追踪: 轻松定位相对于你位置的实体。
- ? Markup 模式: 一项独特功能,通过 GUI 为受保护生物应用 发光效果,使其在管理或调试时立即可见。
- ? 数据库支持: 基于 HikariCP 构建,提供高性能连接。
- SQLite: 零设置的本地文件存储(默认)。
- MySQL: 完全支持大型网络和外部数据库。
- ⚡ 性能优先: 使用 Kotlin 编写,采用异步数据库 I/O,确保你的服务器 TPS 永不下降。
? 使用方法
对于玩家
- 获取一个 Name Tag。
- 在铁砧中重命名它。
- 右键点击 任何生物(牛、马、村民等)。
- ? 成功! 该生物现在归你所有。只有你可以伤害或与它互动。
对于管理员
- 运行
/ag 打开管理 GUI。
- 点击 指南针 更改排序方式(例如,查找最近的受保护生物)。
- 右键点击 生物头颅以切换 发光(Markup)状态,从而在世界中找到它。
- 左键点击 生物头颅以 删除保护(永久移除所有者数据)。
? 命令与权限
| 命令 |
描述 |
权限 |
/ag |
打开管理员管理 GUI。 |
animalguard.admin |
/ag reload |
重新加载 config.yml 和 messages.yml。 |
animalguard.admin |
/ag blacklist list |
显示所有黑名单中的生物类型。 |
animalguard.admin |
/ag blacklist add <type> |
将某种生物类型添加到黑名单。 |
animalguard.admin |
/ag blacklist remove <type> |
从黑名单中移除某种生物类型。 |
animalguard.admin |
(默认情况下,animalguard.admin 权限授予 OP) |
|
|
⚙️ 配置
你可以自定义存储后端以及向玩家显示的每条消息。
config.yml
# =============================================================================
# AnimalGuard - 配置文件
# =============================================================================
# [存储] 数据库设置
# 在 SQLite(本地文件)或 MySQL(外部数据库)之间选择。
database:
type: sqlite # 选项:sqlite, mysql
sqlite:
file: "animalguard.db"
mysql:
host: "localhost"
port: 3306
database: "minecraft"
username: "root"
password: "password"
ssl: false
# 连接池设置 (HikariCP)
pool-size: 10
connection-timeout: 30000
? 截图
管理员 GUI
在一个集中式界面中管理所有受保护的实体。按距离排序以清理局部区域。

Markup 模式
目标生物会发光,使管理员能够轻松区分受保护实体和野生实体。

? bStats
? Overview
Keep your pets safe. Manage them with precision.
AnimalGuard is a robust, lightweight protection plugin designed for modern Minecraft servers (Paper 1.20+). It transforms the simple act of using a Name Tag into a secure ownership claim.
Unlike complex land-claiming plugins that happen to include animals, AnimalGuard focuses purely on Entity Protection with enterprise-grade performance (HikariCP) and a sophisticated Admin GUI.
Why use this?
- "Players keep killing my horses!" ? Simply name them with a Name Tag to lock ownership.
- "I have too many protected mobs causing lag." ? Use the Admin GUI to sort by "Distance" or "Date" and prune old entities.
- "Where did that protected zombie go?" ? Enable Markup Mode to make specific mobs glow through walls.
✨ Key Features
- ?️ Nametag Protection: Players simply rename a Nametag and right-click a mob to claim it. The mob becomes invincible to other players.
- ?️ Visual Admin GUI: A powerful inventory interface for OPs to browse all protected mobs.
- Sortable: Sort by Name, Registration Date, or Distance from you.
- Teleport/Track: Easily locate entities relative to your position.
- ? Markup Mode: A unique feature that applies the Glowing Effect to protected mobs via the GUI, making them instantly visible for management or debugging.
- ? Database Support: Built on HikariCP for high-performance connections.
- SQLite: Zero-setup local file storage (Default).
- MySQL: Full support for large networks and external databases.
- ⚡ Performance First: Written in Kotlin with asynchronous database I/O to ensure your server TPS never drops.
? How to Use
For Players
- Obtain a Name Tag.
- Rename it in an Anvil.
- Right-click any mob (Cow, Horse, Villager, etc.).
- ? Success! The mob is now yours. Only you can damage or interact with it.
For Admins
- Run
/ag to open the Management GUI.
- Click the Compass to change sorting (e.g., find the nearest protected mobs).
- Right-Click a mob head to toggle Glowing (Markup) to find it in the world.
- Left-Click a mob head to Delete Protection (Permanently remove owner data).
? Commands & Permissions
| Command |
Description |
Permission |
/ag |
Opens the Admin Management GUI. |
animalguard.admin |
/ag reload |
Reloads config.yml and messages.yml. |
animalguard.admin |
/ag blacklist list |
Shows all blacklisted mob types. |
animalguard.admin |
/ag blacklist add <type> |
Adds a mob type to the blacklist. |
animalguard.admin |
/ag blacklist remove <type> |
Removes a mob type from the blacklist. |
animalguard.admin |
(By default, animalguard.admin is granted to OPs) |
|
|
⚙️ Configuration
You can customize the storage backend and every message displayed to players.
config.yml
# =============================================================================
# AnimalGuard - Configuration
# =============================================================================
# [Storage] Database Settings
# Choose between SQLite (local file) or MySQL (external).
database:
type: sqlite # Options: sqlite, mysql
sqlite:
file: "animalguard.db"
mysql:
host: "localhost"
port: 3306
database: "minecraft"
username: "root"
password: "password"
ssl: false
# Connection Pool Settings (HikariCP)
pool-size: 10
connection-timeout: 30000
? Gallery
Admin GUI
Manage all protected entities in a centralized interface. Sort by distance to clean up local areas.

Markup Mode
Targeted mobs glow, allowing Admins to easily distinguish protected entities from wild ones.

? bStats
评论 0
登录后参与评分
还没有评论,来抢沙发吧