SpiritBeast Guardian v1.2 v1.2

Supported Minecraft Versions: 1.21.4-1.21.11

Works best in 1.21.11

# SpiritBeast Guardian - The Ultimate Cultivation Companion System

### Ascend to the Divine Realm with your loyal spirit beast!

## Overview

SpiritBeast Guardian is more than just a pet addon; it's a comprehensive nurturing ecosystem designed for high-end role-playing and survival servers. It bridges the gap between player progression and physical interaction, featuring a unique Resonance Alchemy system and a deeply integrated MMO item system.

Whether you're battling ancient bosses or searching for rare herbs in the wild, your spirit beast is your most loyal protector and companion on your path to immortality.

## Unique Game Mechanics

### The Path to Immortality (Levels and Realms)

- Realm System: Spirits will advance through levels, from Tier 1 Divine Beasts to Legendary Divine Beasts.

- Dynamic Attributes: Allocate attribute points to Strength, Vitality, Intelligence, and Insight to customize your spirit's role.

- Visual Improvements: As your spirit advances through realms, its power increases, and its title changes accordingly.

### Wild Herb Awareness and Alchemy

Passive Perception: During exploration, your spirit will sense the hidden spiritual energy within ordinary plants (grass, ferns) and transform them into rare MMO items called herbs.

Resonance Refining: Use a cauldron as a furnace. Perform a soul resonance ritual with your spirit to refine powerful pills.

Success Rate: The success rate of alchemy depends on your spiritual power and insight. High-level herbs have a chance to be refined into legendary Tier 2 pills!

### Advanced Combat AI

Intelligent Protection: Your spirit will automatically retaliate against anyone who attacks its master.

Auxiliary Logic: Your spirit will prioritize attacking the target you are currently attacking.

Conflict-Free AI: Customize pathfinding logic to eliminate annoying vanilla behaviors (such as a cat running away or a dragon shaking).

Three Behavior Modes:

- Follow: Always by your side.

- Combat: Actively hunt down nearby threats.

- Guard: Defend specific locations.

###  MythicMobs Capture

- Soul Traps: Capture weakened mythical monsters using special items and turn them into your own spirit beasts!

Professional User Interface

Sanctuary GUI: A beautifully designed 54-slot menu for managing all your spirit collections.

Spirit Management: Switch between different active spirits with a click.

Immersive Effects: Powered by CMI or native particles – experience the roaring furnace and thunderous bells during alchemy.

## Technical Features and Integrations

 Fully Localized (i18n): Supports English and Traditional Chinese. Instantly switchable in config.yml.

 MMOItems Support: Natively integrated herbs, pills, and special equipment.

 Asynchronous Saving: High-performance database processing (HikariCP) ensures zero latency for the main thread.

 Rich API: Provides a user-friendly interface for developers, facilitating further customization.

## Commands

/bs Summon - Connect with a new spirit.

/bs Menu - Open the Beast Sanctuary.

/bs Statistics - View detailed spirit information.

/bs Name - Rename your companion.

/bs admin getherb - (Administrator) Test the alchemy system.

## Why Choose SpiritBeast Guardian?

Most pet addons are static, but SpiritBeast Guardian is dynamic. It encourages player exploration, rewards player effort through attribute upgrades, and provides a significant source of gold/resources through the alchemy system. It's the perfect complement to any server looking to improve player retention and game depth.

 Ready to begin your journey?

For any questions, you can contact me via Discord: mrbear_2025

•  Dynamic Learning Engine: Your sprite tracks your activities. Engage in combat, and your sprite will learn offensive spells. Focus on mining, and it will awaken its ability to sense ores.
  
   Deep Evolution and Skill Tree:
  
  
• A unique meditation system where players guide their spirits through complex skill trees to break through to higher realms.

•  Four-Path Cultivation System :
• Combat, Mining, Crafting, and Farming. These four paths determine the spirit's attribute growth and specializations.

•  Stunning Oriental UI :
• Fully customized, high-quality GUI menus including Spirit Info, Pokedex, Sacrifice Furnace, and Attribute Point allocation.

•  Spirit Resonance & Alliances :
• When players fight together, their spirits resonate, providing powerful area-of-effect buffs and the ability to form permanent Spirit Alliances.

•  Rarity & Tier System :
• A gacha-style rarity system (N to UR) that determines base attribute multipliers and long-term growth potential.

•  Sacrifice Furnace (Feeding) :
• Players can sacrifice excess resources into the furnace, converting them into Spirit EXP to accelerate their companion's growth.

#  SpiritBeast Guardian | Ten Thousand Beasts Immortal Domain

The Most Hardcore & In-Depth Eastern Cultivation Pet System for Minecraft

Tired of boring Minecraft pet plugins that do nothing but follow you around?

SpiritBeast Guardian ( Ling Shou Guardian) completely redefines pets. Combining Cultivation Realms, Five Elements Attribute Allocation, MythicMobs Capture System, and Multi-Pet Synergistic Combat, your pets become your strongest weapon to dominate the server!

No longer just decorations — build your own Beast Legion and become truly invincible!

##  Core Features

### 1.  Multi-Spirit Beast Summoning & Attribute Feedback

• Five Beasts at Once: Summon up to 5 Spirit Beasts simultaneously to fight by your side.
• Spiritual Energy Feedback: Every active Spirit Beast feeds 10% of its Max Health and Attack Power directly back to you. The more you cultivate, the stronger you become!
• Advanced AI: Completely rewritten combat AI supports flying (e.g. Phantoms) and aquatic mobs. Three modes: Follow, Combat, and Guard.

  100% Friendly Fire Protection — your beasts will never harm each other or you.

### 2.  Seamless MythicMobs Capture System

• Spirit Beast Capture Orb: No complicated commands needed. Simply throw a Spirit Beast Capture Orb at any MythicMobs custom monster to attempt capture.
• Realistic Capture Mechanics: Success rate depends on the monster’s remaining health and level difference. Beat the boss down to low HP for the best chance — experience the real thrill of taming!
• Perfect Domestication: Once captured, the wild MythicMobs loses its original AI and skills, transforming into your controllable 1st Tier Spirit Beast. Keep its stunning appearance and train it from scratch.

### 3.  Cultivation Realms & Attribute System (RPG Stats)

• 100-Level Progression: Spirit Beasts grow from Tier 1 all the way to Tier 9, eventually evolving into Holy Beasts and Divine Beasts.
• Free Attribute Allocation: Gain attribute points on level-up. Distribute them into Strength (Damage), Vitality (Health), Agility (Armor & Movement Speed), and Spiritual Power (Skills). Create pure tanks, assassins, or mage-type beasts.
• Rarity System: Every beast receives a random rarity at capture/birth (Mortal → Spiritual → Immortal → Divine → Sacred). Higher rarity = significantly higher base stat multipliers.

### 4.  Behavior Learning & Cultivation System

- Everything Can Cultivate: Spirit Beasts do not level up by hitting dummies. They gain Cultivation Insight by observing your actions!

  -  Combat Insight — You kill MythicMobs

  -  Spiritual Vein Insight — You mine rare ores

  -  Artifact Refining Insight — You build or craft

  -  Spiritual Planting Insight — You farm crops or fish

- Unlock Divine Abilities: Reach certain thresholds (e.g. mine 500 times) and your beast will achieve enlightenment, unlocking powerful unique skills (auto-mining detection, area roar, etc.).

### 5.  Server-Wide Power Ranking & Beautiful GUI

• Dynamic Combat Power: The system calculates a comprehensive Battle Power score based on realm, attributes, unlocked abilities, and accumulated cultivation.
• Immersive Eastern-Style UI: Open the stunning glass-panel GUI with /bs menu. Manage beasts, toggle active status, and allocate points in a beautiful, theme-fitting interface.
• Asynchronous Leaderboard: Use /bs top or the GUI button to view real-time server-wide rankings and fuel healthy competition.

##  How to Play

1. Get Your First Spirit Beast

   - Ask staff for a starter orb or purchase one from the in-game shop.

   - Find configured MythicMobs in the wild (e.g. Holy Domain True Dragon, Skeleton King).

   - Beat the mob to low health and right-click with the Capture Orb.

2. Train & Deploy

- Type /bs menu to open the Beast panel.

- Click the beast icon to activate it (maximum 5 beasts). Witness your health and attack power soar!

3. Level Up Through Adventure

- Take your beasts to challenge powerful mythical monsters to gain combat experience.

- Accumulate enough Insight → Domain Breakthrough (Upgrade).

4. Attribute Distribution

After leveling up, carefully allocate attribute points. Tank-type beasts (e.g., Earthshaker) → Vitality + Agility. Offensive beasts (e.g., Howling Wolf) → Strength.

5. Death and Soul Guardian

- If a beast dies in battle, it will enter Soul Guardian state. It can be revived after the cooldown ends or by consuming Soul Stones/Experience.

## Administrator Commands

All administrator commands are located under /bs admin for server management and economic control:

[ICODE]/bs admin give <player> <capture/fragment> [quantity][/ICODE] — Give a captured item

[ICODE]/bs admin setlevel <player> <beast UUID> <level>[/ICODE] — Force server level setting

[ICODE]/bs admin setrarity <player> <beast UUID> <rarity>[/ICODE] — Change beast rarity (ideal as a donor reward)

[ICODE]/bs admin revive <player> <beast UUID>[/ICODE] — Force revive any beast

[ICODE]/bs admin reset <player> <beast UUID>[/ICODE] — Reset attribute points for reallocation

Commands

/bs Menu

/bs Summon

/bs Help

/bs Recall

/bs Pattern

/bs Name

/bs Learning

/bs Statistics

/bs Pokédex

/bs Administrator