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:

# 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

/cultivate

This command starts your cultivation journey and grants you 50 Qi 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

• Kill mobs 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 + Right Click | Qi Blast | Ranged projectile attack |
| Sneak + Left Click | 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:

/skill use <skill_id>     # Activate a specific skill

To rebind skills:

/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)

Tribulation (Tier 4+):
When breakthrough to Nascent Soul (Tier 4) or higher, you must survive a heavenly trial:

• Warning Phase: 5 seconds to prepare
• Lightning Strikes: Dodge the lightning strikes
• Failure: If you die, breakthrough fails
• Success: Survive all strikes to complete breakthrough

/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

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

---

🔧 Configuration Guide

Core Settings

Qi System

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

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

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

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

Flight Settings

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

Aura Settings

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

Combat Settings

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

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

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

2. Experience & Leveling

• Mob Kills: Earn XP by killing mobs
• Level Up Rewards: +50 Qi bonus and increased max Qi on level up
• XP Formula: Level × 100 XP needed for next level

3. Realm Progression

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

4. Skill System

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

5. Data Persistence

• YAML Storage: Human-readable player data
• Auto-Save: Data saved automatically on player quit
• Backup Support: Manual backup commands
• Migration Tools: Data import/export

6. Tribulation System

• Heaven's Trial: Lightning trial during breakthrough (Tier 4+)
• Dodge Mechanics: Players must dodge lightning strikes to succeed
• Difficulty Scaling: More lightning strikes at higher realms
• Warning System: Visual and audio warnings before strikes
• Failure Consequence: Breakthrough fails if player dies

7. Flight System

• Qi-Based Flight: Fly using Qi as fuel
• Realm Requirements: Unlock at higher realms
• Speed Scaling: Faster flight at higher tiers
• Visual Feedback: Particle trails while flying

8. Cultivation Aura

• Visual Particles: Aura effects around players
• Tier-Based Effects: Different particle types per realm tier
• Color Progression: Orange → Purple → Blue → Gold
• Particle Density: Increases with realm tier

9. Combat System

• Realm Damage Bonus: Higher damage at higher realms
• Critical Hits: Chance for 2x damage (Tier 4+)
• Defense Reduction: Receive less damage based on realm tier (up to 50%)
• Combat Feedback: Visual and text indicators for critical hits

10. Mob XP System

• Kill Rewards: Earn XP by defeating mobs
• XP Table: Different XP values for different mobs
• Level Up: XP needed scales with level
• Level Benefits: Max Qi increase on level up

Command Reference

# 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
• ✅ Tribulation System - Heaven's trial lightning during breakthrough (Tier 4+)
• ✅ Flight System - Qi-based flight for high realms
• ✅ Cultivation Aura - Visual particles based on realm tier
• ✅ Combat System - Realm-based damage bonuses and critical hits
• ✅ Mob XP System - 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)

# 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