Dao Path

Dao Path

--- > *"Forge the Eternal Path, One Block at a Time"*

Dao Path is a Minecraft plugin based on the Xianxia/Cultivation theme that brings spiritual cultivation experience into the world of Minecraft. This plugin is designed with modular architecture making it easy to develop from a mini version towards a larger system.

---

Configuration

Edit `plugins/DaoPath/config.yml`: ```yaml

Basic configuration

qi: base-regen: 1.0 # Qi regeneration rate display-interval: 20 # Action bar update interval

realms:

Realm progression settings

skills:

Skill balance settings

```

---

🎮 How to Play

Getting Started

1. Journey Start

```bash /cultivate ``` This command starts your cultivation journey and grants you Mortal to begin with. You'll start as a Mortal at Level 0.

2. Qi System

Qi regenerates automatically every second based on your current realm: - Higher realms = faster Qi regeneration - Qi is displayed in the action bar in real-time - Use `/cultivate info` to see your current Qi status

3. XP & Leveling

- Level Up formula: to earn XP (different mobs give different XP) - Level Up formula: Level × 100 XP needed for next level - When you level up: - Level increases by 1 - Maximum Qi increases - You gain +50 Qi instantly - Use `/cultivate info` to see your XP progress

Mob XP Values (examples): | Mob | XP | |-----|----| | Zombie, Spider | 10 | | Skeleton | 12 | | Creeper | 15 | | Enderman | 20 | | Warden | 100 |

4. Skills

Skills are bound to specific input actions:

| Input Action | Default Skill | Description | |--------------|---------------|-------------| | Sneak Twice | Qi Blast | Ranged projectile attack | | Sneak Twice | Qi Shield | Defensive shield | | Sneak Twice | Flash Step | Quick teleport/dash |

Note: Left click skills will not activate when holding placeable items (blocks) in your hand - this allows you to place blocks normally.

You can also use skills manually: ```bash /skill use <skill_id> # Activate a specific skill ```

To rebind skills: ```bash /skill bind <slot> <skill> # Bind skill to a slot (right, left, double) /skill bindings # View current bindings /skill unbind <slot> # Unbind a slot (no skill will trigger) /skill unbind <skill_id> # Unbind a specific skill ```

Auto-Bind on Breakthrough: When you successfully breakthrough to a new realm, new skills will automatically bind to empty slots: - Qi Condensation → binds Qi Blast to Right Click (if slot is empty) - Foundation Building → binds Qi Shield to Left Click (if slot is empty) - Core Formation → binds Flash Step to Double Sneak (if slot is empty)

5. Breakthrough

When you've met all requirements, you can advance to the next realm:

Requirements: - Level 10 or higher - Qi at 90% or more - Qi Progress threshold met (accumulates from Qi gain)

Success: When breakthrough to Nascent Soul (Tier 4) or higher, you must survive a heavenly trial: - Success: 5 seconds to prepare - Success: Dodge the lightning strikes - Success: If you die, breakthrough fails - Success: Survive all strikes to complete breakthrough

```bash /breakthrough # Attempt to breakthrough /breakthrough info # View your progress toward breakthrough ```

Upon successful breakthrough: - Your realm advances to the next tier - Your level resets to 1 - Maximum Qi increases significantly - New skills are unlocked - New skills are automatically bound to empty slots - Qi and Qi Progress reset - New potion effects granted

6. Potion Effects

As you advance through realms, you automatically receive potion effects that enhance your abilities:

| Realm Tier | Realm Name | Potion Effects | |------------|------------|----------------| | 1 | Qi Condensation | Speed I (3 min), Jump Boost I (3 min) | | 2 | Foundation Building | Speed I (5 min), Resistance I (3 min), Night Vision (10 min) | | 3 | Core Formation | Speed II (7 min), Resistance I (5 min), Fire Resistance (5 min) | | 4 | Nascent Soul | Speed II (10 min), Resistance II (5 min), Fire Resistance (10 min), Water Breathing (10 min) | | 5 | Spirit Transformation | Speed II (15 min), Resistance II (10 min), Fire Resistance (15 min), Slow Falling (5 min) | | 6 | Divine Transcendence | Speed III (20 min), Resistance III (10 min), Fire Resistance (20 min), Jump Boost II (10 min) | | 7 | Celestial | Speed III (30 min), Resistance III (20 min), Fire Resistance (30 min), Jump Boost II (15 min), Night Vision (Permanent) | | 8 | Immortal | Speed III (1 hour), Resistance IV (30 min), Fire Resistance (1 hour), Jump Boost III (30 min), Regeneration I (10 min), Night Vision (Permanent) | | 9 | Transcendent | Speed III (Permanent), Resistance IV (1 hour), Fire Resistance (Permanent), Jump Boost III (1 hour), Regeneration II (20 min), Night Vision (Permanent), Absorption IV (30 min) |

7. Status

```bash /cultivate info # View detailed cultivation status /cultivate realm # View all available realms ```

---

🔧 Configuration Guide

Core Settings

Qi System

```yaml qi: base-regen: 1.0 # Base Qi per second regen-multiplier: 1.5 # Multiplier per realm tier display-interval: 20 # Ticks between action bar updates max-qi-display: true # Show max Qi in action bar ```

Realm Settings

```yaml realms: qi-gathering: display-name: "Qi Gathering" chinese-name: "聚气期" max-qi: 100 qi-threshold: 1000 unlock-skills: []

foundation-building: display-name: "Foundation Building" chinese-name: "筑基期" max-qi: 500 qi-threshold: 5000 unlock-skills: ["qi_blast", "qi_shield"] ```

Skill Settings

```yaml skills: qi-blast: display-name: "Qi Blast" qi-cost: 20 cooldown: 3 damage: 10 range: 20

qi-shield: display-name: "Qi Shield" qi-cost: 30 cooldown: 8 duration: 5 absorb-amount: 50 ```

Tribulation Settings

```yaml tribulation: enabled: true trigger-realm: 4 # Nascent Soul and above warning-seconds: 5 # Warning before lightning lightning-radius: 8 # Strike area radius ```

Flight Settings

```yaml flight: enabled: true realm-required: 3 # Core Formation and above qi-cost-per-second: 5 # Qi consumed per second ```

Aura Settings

```yaml aura: enabled: true interval-ticks: 5 # Particle spawn interval particles-per-tick: 1 # Particles per spawn ```

Combat Settings

```yaml combat: enabled: true base-damage: 5 # Base attack damage realm-multiplier: 2 # Damage increase per realm tier critical-multiplier: 2.0 # Critical hit damage multiplier critical-tier4-6-chance: 0.10 # 10% crit chance critical-tier7-9-chance: 0.15 # 15% crit chance ```

Permission Nodes

| Permission | Default | Description | |------------|---------|-------------| | `daopath.cultivate` | `true` | Use `/cultivate` command | | `daopath.breakthrough` | `true` | Use `/breakthrough` command | | `daopath.skill` | `true` | Use skill commands | | `daopath.flight` | `true` | Use flight (high realm) | | `daopath.admin` | `op` | Admin commands |

Messages Configuration

```yaml messages: prefix: "&8[&6道路&8] " breakthrough-success: "&6Selamat! Kamu telah mencapai realm &e{realm}&6!" skill-no-qi: "&cQi tidak cukup untuk &e{skill}&c." skill-cooldown: "&cSkill &e{skill} &ccooldown. Sisa: &e{time}s" ```

---

🎮 Features Overview

Core Systems

1. Qi System

- Realm Bonus: Automatic Qi recovery based on realm tier - Realm Bonus: Real-time Qi status shown on screen - Realm Bonus: Qi consumption for abilities (each skill has different cost) - Realm Bonus: Tracks total Qi accumulated toward breakthrough threshold - Realm Bonus: Higher realms grant faster Qi regeneration

2. Experience & Leveling

- XP Formula: Earn XP by killing mobs - XP Formula: +50 Qi bonus and increased max Qi on level up - XP Formula: Level × 100 XP needed for next level

3. Realm Progression

- Tribulation: From Mortal to Transcendent - Tribulation: - Level 10 or higher - Qi at 90% or more of max Qi - Qi Progress threshold met (accumulates from Qi gain over time) - Tribulation: Increased max Qi, faster regeneration, unlocked skills, potion effects - Tribulation: Authentic Xianxia theme - Tribulation: Heaven's trial (lightning) for Tier 4+

4. Skill System

- Visual Effects: Realm-based abilities - Visual Effects: - Right Click → Skill 1 (default: Qi Blast) - Left Click → Skill 2 (default: Qi Shield) - Sneak Twice → Skill 3 (default: Flash Step) - Visual Effects: Rebind skills to preferred slots - Visual Effects: Balanced skill timing - Visual Effects: Particle and sound feedback

5. Data Persistence

- Migration Tools: Human-readable player data - Migration Tools: Data saved automatically on player quit - Migration Tools: Manual backup commands - Migration Tools: Data import/export

6. Tribulation System

- Failure Consequence: Lightning trial during breakthrough (Tier 4+) - Failure Consequence: Players must dodge lightning strikes to succeed - Failure Consequence: More lightning strikes at higher realms - Failure Consequence: Visual and audio warnings before strikes - Failure Consequence: Breakthrough fails if player dies

7. Flight System

- Visual Feedback: Fly using Qi as fuel - Visual Feedback: Unlock at higher realms - Visual Feedback: Faster flight at higher tiers - Visual Feedback: Particle trails while flying

8. Cultivation Aura

- Particle Density: Aura effects around players - Particle Density: Different particle types per realm tier - Particle Density: Orange → Purple → Blue → Gold - Particle Density: Increases with realm tier

9. Combat System

- Combat Feedback: Higher damage at higher realms - Combat Feedback: Chance for 2x damage (Tier 4+) - Combat Feedback: Receive less damage based on realm tier (up to 50%) - Combat Feedback: Visual and text indicators for critical hits

10. Mob XP System

- Level Benefits: Earn XP by defeating mobs - Level Benefits: Different XP values for different mobs - Level Benefits: XP needed scales with level - Level Benefits: Max Qi increase on level up

Command Reference

```bash

Cultivation

/cultivate # Start your journey or view status /cultivate info # Detailed cultivation status /cultivate realm # View all available realms

Breakthrough

/breakthrough # Attempt to advance to next realm /breakthrough info # View breakthrough requirements & progress

Skills

/skill # View available skills /skill use <skill_id> # Manually activate a skill /skill bind <slot> <skill> # Bind skill to slot (right, left, double) /skill bindings # View current skill bindings /skill unbind <slot> # Unbind slot (no skill triggers) /skill unbind <skill_id> # Unbind specific skill

Flight (high realms only)

/flight # Toggle flight mode

Admin Commands

/daopath addxp <player> <amount> /daopath setlevel <player> <level> /daopath setrealm <player> <realm> /daopath setqi <player> <amount> /daopath setqiprocess <player> <amount> /daopath heal <player> /daopath giveskill <player> <skill> /daopath info <player> /daopath reset <player> /daopath reload ```

---

📝 Changelog

Version 1.0.0-R (Current)

Added

- ✅ Core Qi system with regeneration - ✅ 10-tier realm progression - ✅ 11 unique cultivation skills - ✅ Action bar display system - ✅ Player data persistence - ✅ Administrative commands - ✅ Configuration system - ✅ Potion Effects - Heaven's trial lightning during breakthrough (Tier 4+) - ✅ Potion Effects - Qi-based flight for high realms - ✅ Potion Effects - Visual particles based on realm tier - ✅ Potion Effects - Realm-based damage bonuses and critical hits - ✅ Potion Effects - XP from killing mobs - ✅ Potion Effects - Automatic buffs per realm tier - ✅ Admin commands: giveskill, reset, reload

Known Issues

- ⚠️ Limited PvP integration (future enhancement)

Breaking Changes

- None in this release

---

📊 Statistics & Analytics

Plugin Metrics (Optional)

```yaml

Enable anonymous usage statistics

metrics: enabled: false # Default: false bStats: true # bStats integration ```

Data Collection

- Server version and type - Plugin version - Player count (anonymous) - Feature usage statistics - Performance metrics

---

📜 License

``` MIT License

Copyright (c) 2024 DaoPath Project

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. ```

---

*DaoPath v1.0.0-R - Cultivation/Xinxia System for Minecraft* *Last Updated: 2024-02-26* *Documentation Version: 1.0*