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

Dao Path

Compatibility

Minecraft: Java Edition

Platforms

Creators

Details

Dao Path

Configuration

🎮 How to Play

Getting Started

1. Journey Start

2. Qi System

3. XP & Leveling

4. Skills

5. Breakthrough

6. Potion Effects

7. Status

🔧 Configuration Guide

Core Settings

Qi System

Realm Settings

Skill Settings

Tribulation Settings

Flight Settings

Aura Settings

Combat Settings

Permission Nodes

Messages Configuration

🎮 Features Overview

Core Systems

1. Qi System

2. Experience & Leveling

3. Realm Progression

4. Skill System

5. Data Persistence

6. Tribulation System

7. Flight System

8. Cultivation Aura

9. Combat System

10. Mob XP System

Command Reference

📝 Changelog

Version 1.0.0-R (Current)

Added

Known Issues

Breaking Changes

📊 Statistics & Analytics

Plugin Metrics (Optional)

Data Collection

📜 License