SpiritBeast Guardian v1.3

What's New in ContractBeast Guardian v1.3-SNAPSHOT

REBRAND
• Plugin renamed from SpiritBeastGuardian to ContractBeastGuardian
• Full medieval / kingdom contract-beast theme (replaces xianxia/cultivation wording)

LOCALIZATION (ZH)
• Complete Traditional Chinese rewrite: Oath Marks, Renown, Forge Alchemy, War Skills, Kingdom Bestiary
• Main GUI panel texts updated (hardcoded strings fixed)

FEATURES (unchanged core, rebranded UX)
• Multi-beast leveling (up to Lv.100), 4 bloodlines, 3 tactical modes
• Behavior-based learning & skill tree
• MythicMobs capture trap system
• MMOItems forge alchemy with beast resonance
• Beast diary, expandable backpack (PlayerPoints), TabList placeholders
• MCPet custom pet definitions, developer API & PAPI placeholders

REQUIREMENTS
• Paper 1.21+ | Java 21
• Soft: PlaceholderAPI, MMOItems, MMOCore, PlayerPoints, MythicMobs (optional integrations)

INSTALL
• Replace the JAR in /plugins and restart the server (full restart recommended, not /reload)
• Update config/messages if you customized the old SpiritBeast files

Coming soon: full English medieval localization & remaining hardcoded string cleanup.

### Update Description
Greetings, Immortals! The SpiritBeastGuardian v1.2 update is here. We’ve focused on deepening the bond between you and your spirit beasts through new gameplay mechanics and seamless integrations with the most popular RPG plugins.

New Features

- Herb Sensing System
- Your spirit beasts now possess "Intellect" . When wandering the world, they can sense hidden rare herbs (MMOItems) in grass, flowers, and azaleas.
- Sensing probability scales with the spirit's Intellect and Insight points.

- Spirit-Assisted Alchemy
- A new interactive GUI system for refining powerful pills.
- Your spirit beast will assist in the refining process, providing spiritual energy to increase the success rate.
- Includes high-tier visual effects (particles and sounds) and dynamic success calculations.

- Deep RPG Integrations
- MMOCore Support : Full Experience Synchronization. Your spirit's growth is now tied to your cultivation level. Killing MythicMobs grants both Spirit and Player XP.
- MMOItems Native Support : Fully integrated with custom items for Herbs, Pills, and Materials.
- MCPets Support : You can now use high-quality custom models from MCPets as your spirit's physical manifestation.
- PlaceholderAPI Expansion : New placeholders added to display spirit stats (Power, Intellect, Mood, etc.) in your scoreboards or chat. Improvements & Fixes
- Attribute System 2.0
- Fixed a critical issue where spirit attribute bonuses (Health/Damage) could stack indefinitely.
- Improved the clean removal of attributes upon spirit despawn or death.
- Behavior Engine Expansion
- Spirits now learn from even more player actions: Trading with Villagers , Enchanting , Crafting , and MythicMobs Hunting .
- Asynchronous Database Operations
- Moved all spirit data and backpack saving to asynchronous tasks to ensure zero main-thread lag during peak hours.
- Combat Balancing
- Refined the spirit damage formula: Now inherits a configurable percentage of the owner's attack damage.
- Optimized the Spirit Shield trigger logic for better survivability in intense PVP/PVE.


### Release Note Summary
v1.2 - The Alchemy Update

• NEW : Herb Sensing & Pill Refining systems.
• NEW : Deep integration with MMOCore, MMOItems, and MCPets.
• ENHANCED : Rewritten attribute synchronization to prevent stacking bugs.
• OPTIMIZED : Full async database handling for better performance.
• FIXED : Combat XP logic for MythicMobs and GUI inventory issues.

Greetings, Spirit Masters! Today’s update transforms SpiritBeast Guardian from a simple pet plugin into a deep, immersive cultivation ecosystem. We’ve introduced a brand-new profession, overhauled the combat AI, and prepared the plugin for the global market.

## ▘ NEW: Resonance Alchemy System
Forget simple crafting menus. Alchemy is now a spiritual bond between you and your companion.

• Passive Herb Sensing : Your Spirit Beast can now "smell" spiritual energy! While exploring, it will automatically discover and transform mundane plants into rare MMOItems Herbs .
• Soul Resonance Refining : Use a Cauldron as your furnace to perform high-stakes alchemy rituals with your spirit by your side.
• Dynamic Success Rates : Your spirit's Intellect and Insight attributes now directly determine your brewing success.
• Immersive Rituals : Experience high-frequency particle effects and multi-layered soundscapes that make every refining session feel like a grand ceremony.

## ▘ Overhauled Combat AI
We have rewritten the combat logic from the ground up to make your Spirit Beast a true protector.

• Retaliation Protocol : Spirits now instantly identify and counter-attack any entity (player or mob) that damages their master.
• Tactical Assistance : Your companion will prioritize and "focus fire" on the exact target you are currently attacking.
• AI Stability Fixes : Say goodbye to jittery dragons and fleeing cats. We’ve implemented custom pathfinding that removes vanilla "fear" behaviors and ensures smooth flying/following.

## ▘ Global Localization (i18n)
To support our growing community on BuiltByBit, we have officially launched our translation system:

• Instant Toggle : Switch between English and Chinese (Traditional) instantly via config.yml .
• External Language Files : Fully customizable messages_en.yml and messages_zh.yml . Every command, hover-text, and notification is now in your control.
• English Native GUI : International buyers now have access to a professionally translated, native English interface by default.

## ▘ Optimizations & Quality of Life

• MMOItems Native Hook : Fully customizable IDs for herbs and pills. Compatible with the latest MMOItems API.
• Custom Furnaces : You can now define any block (Furnace, Brewing Stand, etc.) as your alchemy station in the config.
• Admin Testing Suite : Added /bs admin getherb to help admins quickly test their MMOItems configurations.
• Performance Boost : Optimized pathfinding algorithms to significantly reduce CPU usage during multi-spirit combat.