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
• 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 `/meditation` to start cultivating
• Gain Qi and Experience while meditating
• Anti-movement system during meditation
• Action bar progress display with formatted values
• Realm-based Qi and Exp limits
• Intelligent number compression for large values

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 `/walkonwater` command
• Qi consumption while walking on water surfaces
• Automatic deactivation when Qi is depleted
• Flight capabilities based on cultivation level

User Interface

• `/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

Administrative System

• `/ic admin` 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

Commands

• `/meditation` - Start/stop meditation
• `/breakthrough` - Attempt realm breakthrough
• `/realms` - View cultivation realms interface
• `/walkonwater` - Toggle the ability to walk on water surfaces
• `/fly` - Toggle flying ability (realm-dependent)
• - `/ic admin` - Administrative commands
  - qi <add|set> <player> <amount> - Modify player's Qi
  - exp <add|set> <player> <amount> - Modify player's Experience
  - reload - Reload plugin configuration
• `/sect` - Sect management commands
  - create <name> - Create a new sect
  - disband - Disband your sect (leader only)
  - info [sect] - View sect information
  - list - List all sects
  - leave - Leave your current sect
  - promote <player> - Promote a sect member
  - demote <player> - Demote a sect member
  - invite <player> - Invite a player to your sect
  - join <sect> - Join a sect (if invited)
  - chat <message> - Send a message to sect chat

Permissions

• `immortalcultivation.meditation` - Permission to meditate
• `immortalcultivation.breakthrough` - Permission for breakthrough
• `immortalcultivation.realms` - Permission to view realms
• `immortalcultivation.walkonwater` - Permission to walk on water
• `immortalcultivation.fly` - Permission to use flight ability
• `immortalcultivation.admin` - Permission for admin commands
• `immortalcultivation.sect.create` - Permission to create sects
• `immortalcultivation.sect.manage` - Permission to manage sects (promote, demote, etc.)

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)

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