### Ever wanted to walk the path of a Xianxia cultivator? Now you can with Cultivation, this mod adds a full realm-and-Qi progression system to your server -- meditate to draw Spirit Qi from the world, hunt creatures for cultivation cores, break through seven realms of power, choose a race once you're strong enough, and bind weapons and armor to your own soul. ===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--=== ## Features: Climb 7 realms -- Body Refinement, Qi Condensation, Foundation Establishment, Golden Core Formation, Nascent Soul, Soul Formation, and Void Refinement -- each with 4 sub-stages (Early, Middle, Late, Peak). Both sub-stage advancements and realm breakthroughs are real, timed meditation rituals with a real risk of failure -- breakthroughs are the bigger, higher-stakes ritual of the two. * Meditate to pull ambient Qi from your chunk's Spirit Vein, a real per-chunk energy pool that depletes and regenerates over time. * Hunt creatures for a chance at Spirit, Profound, or Divine Cores -- absorb them instantly, or absorb one mid-meditation for a bonus. * Realm breakthroughs are a timed, high-stakes ritual -- cancel one early and you're demoted a stage. * Choose a race -- Human, Demon, or Deity -- once you reach Golden Core Formation, each with its own server-tunable bonuses to health, damage, Qi gain, and breakthrough speed. * Bind any weapon or armor piece into a Life-Bound Treasure that levels up from combat -- its level shows right in the item's name, and its tooltip tells you exactly how much benefit it's granting. * Persistent, toggleable HUD showing your realm, stage, Qi, and breakthrough progress at a glance. * Live in-game admin config editor -- retune the entire mod without ever opening a JSON file. * Every number in the mod lives in a themed config file -- nothing is hardcoded. * Fully localized: English, Portuguese (Brazil), Russian, Ukrainian, and Simplified Chinese, with proper Xianxia terminology. * Works in Singleplayer and Multiplayer. * and More! ===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--=== ## Roadmap: * More realms beyond Void Refinement for long-term progression. * Unique techniques/skills per race. * Custom particles and sound cues for breakthroughs. * Sect/clan support for group cultivation. * More Life-Bound Treasure benefit types beyond flat damage/reduction. * Additional language support. ===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--=== ## Commands, Config, and Permissions: ### Commands Extra Info:

/cultivation (aliases: /cult, /qi)
- Opens your cultivation stats page. Requires permission: cultivation
/cultivation info (i)
- Prints your realm, stage, and Qi progress to chat.
/cultivation meditate (med)
- Toggles meditation, drawing Spirit Qi from the Spirit Vein of the chunk you're standing in.
/cultivation bind
- Personalizes the item in your hand into a Life-Bound Treasure. Run again on your own item to reset it to level 1.
/cultivation race
- Opens the race menu to view racial benefits and choose your race (once eligible).
/cultivation hud
- Toggles the persistent Cultivation HUD on or off.
/cultivation settings (options)
- Opens the player settings menu.
/cultivation admin
- Requires permission: cultivation.admin
- /cultivation admin (no args)
  - Opens the live config editor UI.
- /cultivation admin setrealm {player} {realm}
  - Sets a player's realm directly. Omit {player} to target yourself.
- /cultivation admin setstage {player} {stage}
  - Sets a player's sub-stage directly (Early, Middle, Late, or Peak).
- /cultivation admin setrace {player} {race}
  - Sets a player's race directly (Human, Demon, or Deity), bypassing the Golden Core requirement (configurable).
- /cultivation admin grantracechoice {player} [amount]
  - Grants a player additional race-selection choices.
- /cultivation admin setlifebound {player} {level} [xp]
  - Force-sets the level (and optionally the XP) of the Life-Bound Treasure a player is currently holding.
- /cultivation admin reset {player}
  - Resets a player's cultivation progress back to Body Refinement, Early-Stage.
/cultivation debug (d)
- Requires permission: cultivation.debug
- /cultivation debug vein
  - Prints the current/max Qi of the Spirit Vein in the chunk you're standing in.
  - Requires permission: cultivation.debug.vein

### Permissions Extra Info:

cultivation
- The base /cultivation command and all player-facing subcommands (info, meditate, bind, race, hud, settings).
cultivation.admin
- Access to /cultivation admin and all of its subcommands.
cultivation.debug
- Access to the /cultivation debug command group.
cultivation.debug.vein
- Access to /cultivation debug vein.

### Config Extra Info:

Every number in Cultivation lives in one of these themed config files -- edit the JSON directly, or use /cultivation admin for the live in-game editor:

"Config.json"
- The core Qi curve (how much Qi each sub-stage/realm requires) and the max health / damage bonus granted per level.
"SpiritCoreConfig.json"
- Drop chances and Qi values for Spirit, Profound, and Divine Cores, plus the meditation-absorb bonus multiplier.
"SpiritVeinConfig.json"
- Spirit Vein min/max Qi, regen/drain rates, meditation timing, and the Qi Gathering Talisman's multiplier.
"BreakthroughConfig.json"
- The minimum chunk Qi and ritual duration required to complete a realm breakthrough.
"LifeBoundConfig.json"
- Life-Bound Treasure XP curve, max level, and the damage bonus / damage reduction granted per level.
"RaceSystemConfig.json"
- Cross-race server behavior, such as whether admin race overrides bypass the Golden Core requirement.
"Race/Human.json", "Race/Demon.json", "Race/Deity.json"
- Each race's own health/damage/Qi-gain/breakthrough-speed bonuses and menu flavor text, fully independent of each other.

===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--=== ## HOW TO INSTALL: ### Client: Upload the Cultivation.jar file into your %appdata%\Hytale\UserData\Mods\ Folder ### Server: Upload the Cultivation.jar file into your servers mods\ folder Make sure you delete any previous version of Cultivation otherwise your world may not start. ===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--=== ## VERSION COMPATIBILITY: v0.1.0-latest : Built against Hytale Server 0.5.6 - Active support for continued versions until specified. ===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--=== ## Known Limitations: * Early release (v0.1.0) -- progression numbers, race balance, and Life-Bound bonuses are still being tuned based on feedback. * Found a bug or have a balance suggestion? Please report it so it can get fixed. ===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--=== ## Support the Creator: You can support me by using my creator code SIREN at checkout. ===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--===