ImmortalCultivation

A cultivation plugin that allows players to progress through various cultivation realms, meditate to gain qi and experience, and become more powerful. Inspired by cultivation novels, this plugin brings the mystical world of cultivation to your Minecraft server.

Features

Cultivation System

• Progress through 10 cultivation realms from Mortal to Mahayana
• Each realm has 9 stages of progression (except Mortal)
• Unique spiritual root system for each player
  • Spiritual roots determine a player's potential for cultivation, with varying rarity tiers: Common, Uncommon, Rare, Epic, and Legendary
  • Different types of spiritual roots with unique benefits:
    • Mortal Root: Common tier, standard Qi and experience gain (1x multiplier)
    • Earth Root: Uncommon tier, enhanced Qi and experience gain (2x multiplier)
    • Heavenly Root: Rare tier, significantly improved Qi and experience gain (4x multiplier)
    • Divine Root: Epic tier, exceptional Qi and experience gain (8x multiplier)
  • Rarity tiers affect the likelihood of obtaining a specific root, with weights determining probability
• Stat progression based on realm and stage
• Advanced tribulation system for higher realms
• Automatic Qi requirements calculation for each stage
• Dynamic number formatting for large values
• Compressed health display system for higher realms

Sect System

• Create and manage cultivation sects
• Hierarchical structure with customizable ranks
• Sect chat for internal communication
• Invitation and request system for joining sects
• Leadership transfer and management capabilities
• Member promotion and demotion system
• Sect disbanding functionality
• Comprehensive sect information display

Meditation System

• Use /ic ability meditation to start cultivating
• Gain Qi and Experience while meditating
• Anti-movement system during meditation
• Ground check to prevent starting meditation while flying or not on a block
• Visual sitting effect using an invisible ArmorStand to appear seated on the ground
• Action bar progress display with formatted values
• Realm-based Qi and Exp limits
• Intelligent number compression for large values

Cultivation Pools

• Discover special pools that boost Qi and Experience gains during meditation
• Different tiers of pools (Common, Rare, Legendary) with varying boost levels
• Visual particle effects to distinguish pool types
• Fire Resistance effect in Nether pools to protect against fire and lava damage
• Configurable pool spawn chances and locations

Combat Enhancement

• Increased damage based on cultivation level
• Progressive armor reduction system
• Damage reduction formula: damage × (100 / (100 + armor))
• Combat stats scale with progression
• Custom damage system for both PvP and PvE
• Compressed health display for better readability

Breakthrough System

• Progress between realms through breakthroughs
• Experience-based requirements
• Tribulation challenges during breakthrough (realm-specific)
• Visual effects (lightning) during tribulation
• Automatic Qi and Exp reset after breakthrough
• Enhanced stat scaling after breakthrough

Special Abilities

• Walk on water using Qi energy
• Toggle water-walking ability with /ic ability walkonwater command
• Qi consumption while walking on water surfaces
• Automatic deactivation when Qi is depleted
• Flight capabilities based on cultivation level with /ic ability fly command
• Automatic flight reactivation on rejoin if more than 3 blocks above ground
• Qi Infusion ability to coat body with Qi, granting Strength 2 and Resistance 1 at 1000 Qi per second, available at Nascent Soul realm with /ic ability qiinfusion command

User Interface

• /ic realms command to view all cultivation realms
• Interactive GUI with detailed information
• Visual progress bars for stages
• Custom colors for each realm
• Always-visible player information
• Formatted number display for large values
• Compressed health display system

Statistics System

• Health (with compression for high values)
• Attack Damage
• Armor
• Qi (with intelligent formatting)
• Experience (with intelligent formatting)
• Spiritual Root

Data Management

• Configurable auto-save system
• Logout data saving
• YAML-based player data system
• Customizable messages
• Flexible realm configuration
• Efficient number storage and formatting
• Automatic configuration update mechanism to merge new fields from default configurations during plugin updates while preserving player modifications

Server Age System

• Three-phase server progression: Growing Phase, Peak Era (Golden Age), and Declining Phase (Dharma Ending)
• Server age increases every 10 hours, affecting Qi gain multipliers
• Growing Phase: Qi gain increases by 2% per age
• Golden Age: Qi gain remains at peak level
• Dharma Ending: Qi gain decreases over time until reaching zero
• Configurable phase durations and multipliers
• Server age messages for Qi boost and decline notifications

Administrative System

• /ic command for administration
• Modify player Qi and Experience values
• Add or set specific amounts
• Support for K/M/B/T number format
• Configuration reloading
• Granular permission system

Cultivation Towers

• Discover and explore mystical cultivation towers scattered across the world
• Configurable spawn chance for towers in new chunks
• Minimum distance between towers to prevent clustering
• Towers can have multiple floors, with configurable minimum and maximum floors
• Option to match maximum floors to the number of cultivation realms
• Towers can be set as indestructible to prevent griefing
• Locked floors system, requiring players to unlock floors sequentially
• Player progress tracking per tower, allowing unlocking of higher floors
• Automatic clearing of area around tower locations for unobstructed generation
• Broadcast messages to all players when a new tower is generated, with location details

Player Races

• Select a unique race that influences gameplay and cultivation
• Race-specific modifiers for attack and defense stats
• Qi gain multipliers based on environmental conditions like biome or world type
• Special potion effects triggered by specific conditions (e.g., near lava)
• Customizable race configurations with YAML files for easy modification
• Notification system for applied race effects and stat modifiers

Spirit Stones

• Use spirit stones to gain temporary boosts to Qi gain
• Configurable boost percentage and duration for Qi enhancement
• Cooldown system to prevent overuse of spirit stones
• Visual boss bar displaying remaining boost time
• Boost duration extension when using additional spirit stones during an active boost
• Persistent boost data across player sessions for uninterrupted gameplay

Alchemy Profession System

• Comprehensive crafting system with a custom 3x3 GUI
• Craft powerful pills using spiritual herbs and Spirit Stones
• Plant mutation mechanic: use Spirit Stones on crops for a chance to mutate them
• Recipe Book GUI for tracking unlocked recipes
• Bulk crafting support for efficient pill creation
• Persistent alchemy progress and tier system

Custom Mob System

• 10 unique custom mob types inspired by xianxia themes (e.g., Demonic Beast, Rogue Cultivator)
• Universal spawning system replacing vanilla mobs with configurable probability
• Realm-based scaling: mobs spawn with cultivation realms based on location or distance
• Custom drops including Beast Cores, Spirit Essence, and more
• Dynamic nametags showing mob realm and health
• Full configuration via custom_mobs.yml and custom_drops.yml

Commands

All commands are accessed via the main /ic command.

• /ic realms - View the cultivation realms interface and details.
• /ic ability - Manage cultivation abilities.
  • breakthrough - Attempt to break through to the next realm.
  • meditation - Toggle meditation state to gain Qi.
  • walkonwater - Toggle the ability to walk on water (requires specific realm).
  • fly - Toggle flight ability (requires specific realm).
  • qiinfusion - Toggle Qi Infusion for combat buffs (requires Nascent Soul).
• /ic sect - Comprehensive sect management.
  • create <name> - Create a new sect.
  • invite <player> - Invite a player to your sect.
  • join <sect> - Join a sect you have been invited to.
  • promote/demote <player> - Manage member ranks.
  • leave - Leave your current sect.
  • disband - Disband the sect (Leader only).
  • chat <message> - Send a message to sect members.
  • info [sect] - View details of a sect.
  • list - List all existing sects.
• /ic alchemy - Open the Alchemy crafting GUI.
• /ic mastery - View your profession mastery and recipes.
• /ic poolcompass - Get a compass pointing to the nearest Cultivation Pool.
• /ic race select <race> - Select your character's race (if permitted).
• /ic admin - Administrative commands (requires permission).
  • menu - Open the admin configuration GUI.
  • give <player> <item> <amount> - Give custom items (SpiritStones, crops, drops).
  • spawnmob <mob_id> - Spawn a specific custom mob.
  • qi <add|set> <player> <amount> - Modify a player's Qi.
  • exp <add|set> <player> <amount> - Modify a player's Experience.
  • serverage <set|add|info> - Manage server age and phases.
  • reload - Reload all plugin configurations.

Permissions

• immortalcultivation.ability.meditation - Permission to meditate
• immortalcultivation.breakthrough - Permission for breakthrough
• immortalcultivation.realms - Permission to view realms
• immortalcultivation.ability.walkonwater - Permission to walk on water
• immortalcultivation.ability.fly - Permission to use flight ability
• immortalcultivation.ability.qiinfusion - Permission to use Qi Infusion ability
• immortalcultivation.admin - Permission for admin commands
• immortalcultivation.sect.create - Permission to create sects
• immortalcultivation.sect.manage - Permission to manage sects (promote, demote, etc.)
• immortalcultivation.poolcompass - Permission to use the pool compass command

Requirements

• Server Version: 1.21+
• Dependencies:
  • PlaceholderAPI (Optional) - For placeholder support
  • LuckPerms - For advanced permission management

LuckPerms Integration

• Automatic permission inheritance through realms
• Dynamic permission management based on cultivation progress
• Realm-specific permission groups
• Automatic permission updates during breakthroughs
• Integration with LuckPerms API for seamless permission handling
• Support for temporary permissions during special events or tribulations

PlaceholderAPI Integration

The following placeholders are available when PlaceholderAPI is installed:

Player Stats

• %immortalcultivation_qi% - Current Qi amount
• %immortalcultivation_maxqi% - Maximum Qi capacity
• %immortalcultivation_exp% - Current Experience amount
• %immortalcultivation_maxexp% - Maximum Experience capacity
• %immortalcultivation_realm% - Current cultivation realm
• %immortalcultivation_stage% - Current stage within realm
• %immortalcultivation_spiritualroot% - Player's spiritual root
• %immortalcultivation_spiritualroot_qimultiplier% - Spiritual root Qi multiplier
• %immortalcultivation_spiritualroot_expmultiplier% - Spiritual root Exp multiplier

Sect Stats

• %immortalcultivation_sect_name% - Player's sect name
• %immortalcultivation_sect_rank% - Player's rank in sect
• %immortalcultivation_sect_leader% - Name of the sect leader
• %immortalcultivation_sect_members_count% - Number of members in the sect
• %immortalcultivation_sect_created% - Creation date of the sect
• %immortalcultivation_sect_is_leader% - Whether the player is the sect leader (true/false)

Server Age Stats

• %immortalcultivation_server_age% - Current server age
• %immortalcultivation_server_qi_multiplier% - Current Qi gain multiplier based on server age phase
• %immortalcultivation_server_era% - Current server age phase (Growing Phase, Golden Age, or Dharma Ending)

Installation

1. Place the plugin JAR in your server's plugins folder
2. Restart your server
3. Configure the plugin in the config.yml file
4. Set up permissions for your players

Support

For support, bug reports, or feature requests, please visit our Discord Server