Truly Best Friends Forever

**Auto Tracking & Persistence**: After taming any ownable entity (wolves, cats, horses, parrots, mod pets, etc.), it is automatically registered. NBT data is persisted at `<world>/trulybestfriends/<playerUUID>/<petUUID>.nbt`, with a `pets_index.nbt` index maintained.

- **Pet Management UI**: Adds a "Pet Friends" tab to the inventory screen (via L2Tabs), or accessible through a custom keybind (unbound by default, set in Options → Controls). View each pet's name, species, health, dimension, and coordinates.

- **Real-time Sync**: The server periodically pushes the latest pet state (health, position, dimension, etc.) to the client. The health bar and location info in the GUI refresh automatically without reopening the panel.

- **Recall / Release**: Single click to recall a pet into storage (with distance limit and cooldown), click again to release. Supports summoning pets to the player when their chunk is unloaded, with automatic teleport after chunk loading.

- **Area Recall**: Hold **Shift** and click the recall button to recall all pets within range at once. Use the **scroll wheel** to adjust range (1–16 blocks, default 8).

- **Cross-dimension Summoning**: Summon pets from any dimension to your side, with automatic forced chunk loading and entity deduplication.

- **Teleport**: Click coordinates to teleport to your pet, or teleport your pet to you.

- **Glow Highlight**: Apply a 5-second glowing effect to the selected pet for easy spotting in complex terrain.

- **Death & Revival**: When a tracked pet dies, its drops are cleared (NBT preserved), and it can be revived from the panel using a configurable revival item (default: 1 **Totem of Undying**). Revival applies totem effects (Regeneration, Absorption, Fire Resistance). Specific entity types can be whitelisted to keep their drops and become non-revivable (default includes `touhou_little_maid:maid`).

- **Two-step Deletion**: To prevent accidents, deleting pet data requires two steps — first left-click to enter "pending deletion" state, then Shift + left-click to confirm. Switching selection resets the pending state.

- **Shoulder Pet Tracking**: Automatically tracks entities sitting on your shoulder (e.g. parrots). When dismounted from shoulder, the UUID is automatically re-associated, preventing lost tracking.

- **Priority System**: Each pet can be assigned a priority from 1–6 for sorting in the panel and future formation features.

- **Mount Inventory Backup**: For container-carrying entities (e.g. chested horses), their inventory NBT is independently backed up, compatible with any number of slots from mod entities.

- **Multi-language Dimension Names**: Built-in display names for 20+ common dimensions (vanilla 3 + Twilight Forest, Aether, Otherside, Everbright/Everdawn, Undergarden, Bumblezone, Tropics, Gaia, Midnight, all Ad Astra planets and orbits) in both English and Chinese.

- **Offline NBT Editing**: When the server is shut down, you can directly edit `.nbt` files in the world directory. Changes will be preserved and applied to entities on next startup (recommended only for recalled entities).