# \ud83d\udce2 Overview
\n**Keep your pets safe. Manage them with precision.**<\/p>\n
**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.<\/p>\n
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.<\/p>\n
### Why use this?
\n* **”Players keep killing my horses!”** \ud83d\udc49 Simply name them with a Name Tag to lock ownership.
\n* **”I have too many protected mobs causing lag.”** \ud83d\udc49 Use the Admin GUI to sort by “Distance” or “Date” and prune old entities.
\n* **”Where did that protected zombie go?”** \ud83d\udc49 Enable **Markup Mode** to make specific mobs glow through walls.<\/p>\n
# \u2728 Key Features
\n* **\ud83c\udff7\ufe0f Nametag Protection:** Players simply rename a Nametag and right-click a mob to claim it. The mob becomes invincible to other players.
\n* **\ud83d\udda5\ufe0f Visual Admin GUI:** A powerful inventory interface for OPs to browse all protected mobs.
\n * **Sortable:** Sort by **Name**, **Registration Date**, or **Distance** from you.
\n * **Teleport\/Track:** Easily locate entities relative to your position.
\n* **\ud83d\udd26 Markup Mode:** A unique feature that applies the **Glowing Effect** to protected mobs via the GUI, making them instantly visible for management or debugging.
\n* **\ud83d\udcbe Database Support:** Built on **HikariCP** for high-performance connections.
\n * **SQLite:** Zero-setup local file storage (Default).
\n * **MySQL:** Full support for large networks and external databases.
\n* **\u26a1 Performance First:** Written in Kotlin with asynchronous database I\/O to ensure your server TPS never drops.<\/p>\n
# \ud83c\udfae How to Use<\/p>\n
### For Players
\n1. Obtain a **Name Tag**.
\n2. Rename it in an Anvil.
\n3. **Right-click** any mob (Cow, Horse, Villager, etc.).
\n4. \ud83c\udf89 **Success!** The mob is now yours. Only you can damage or interact with it.<\/p>\n
### For Admins
\n1. Run `\/ag` to open the Management GUI.
\n2. Click the **Compass** to change sorting (e.g., find the nearest protected mobs).
\n3. **Right-Click** a mob head to toggle **Glowing** (Markup) to find it in the world.
\n4. **Left-Click** a mob head to **Delete Protection** (Permanently remove owner data).<\/p>\n
# \ud83d\udcdc Commands & Permissions<\/p>\n
| Command | Description | Permission | # \u2699\ufe0f Configuration ### config.yml # [Storage] Database Settings sqlite: mysql: # Connection Pool Settings (HikariCP) # \ud83d\udcf8 Gallery <\/p>\n **Markup Mode** <\/p>\n # \ud83d\udcc8 bStats<\/p>\n <\/p>\n","protected":false},"excerpt":{"rendered":" \ud83d\udc3e Protect, Track, and Manage! The essential Mob Protection plugin featuring Nametag claiming, SQL support, and a Visual Admin GUI. [1.20+]<\/p>\n","protected":false},"featured_media":14874,"template":"","meta":{"_minecraft_slug":"animalguard","_minecraft_project_id":"bDGrLtvF","_minecraft_author":"nekoneko2872","_minecraft_license":"LicenseRef-AnimalGuard","_minecraft_downloads":87,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"animalguard.zip","_minecraft_size_bytes":3314095,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T19:58:31.695510Z","_minecraft_date_created":"2025-12-19T10:06:34.837406Z","_minecraft_date_modified":"2026-03-01T04:16:12.504748Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/animalguard","_minecraft_icon_attachment_id":14874,"_minecraft_imported_at":"2026-05-31T18:10:47+00:00","_minecraft_import_hash":"9eac8f452d00071c0f29f32dc7a56861","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,127,128,867,129,123,92],"mod_loader":[132,133,134],"minecraft_version":[59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-14873","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-spigot","mod_category-technology","mod_category-utility","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n| :— | :— | :— |
\n| `\/ag` | Opens the Admin Management GUI. | `animalguard.admin` |
\n| `\/ag reload` | Reloads config.yml and messages.yml. | `animalguard.admin` |
\n| `\/ag blacklist list` | Shows all blacklisted mob types. | `animalguard.admin` |
\n| `\/ag blacklist add
\n| `\/ag blacklist remove
\n*(By default, `animalguard.admin` is granted to OPs)*<\/p>\n
\nYou can customize the storage backend and every message displayed to players.<\/p>\n
\n“`yaml
\n# =============================================================================
\n# AnimalGuard – Configuration
\n# =============================================================================<\/p>\n
\n# Choose between SQLite (local file) or MySQL (external).
\ndatabase:
\n type: sqlite # Options: sqlite, mysql<\/p>\n
\n file: “animalguard.db”<\/p>\n
\n host: “localhost”
\n port: 3306
\n database: “minecraft”
\n username: “root”
\n password: “password”
\n ssl: false<\/p>\n
\n pool-size: 10
\n connection-timeout: 30000
\n“`<\/p>\n
\n**Admin GUI**
\nManage all protected entities in a centralized interface. Sort by distance to clean up local areas.<\/p>\n
\nTargeted mobs glow, allowing Admins to easily distinguish protected entities from wild ones.<\/p>\n