libaiplugin

A comprehensive cultivation & RPG plugin for Paper servers.

libaiplugin is an all-in-one progression framework inspired by Chinese cultivation (修仙) novels. It bundles 18+ interlocking systems — realms, spirit roots, runes, artifacts, sects, gods, and three cursed dimensions — into one cohesive experience.

Built from scratch. No dependencies. Fully configurable.

---

✨ Features

🧘 Cultivation System

Advance from Mortal to Heaven's Dao across 10 major realms and 46 levels. Each realm has its own energy cap, stat bonuses, and breakthrough conditions.

Realm	Levels	Highlights
Mortal	0	Starting point
Qi Refining	1–13	Auto-advance
Foundation	14–18	Requires Foundation Pill
Core Formation	19	Massive jump
Golden Core	20–22	—
Shattered Core	23	Requires God Lock
Nascent Soul	24–30	—
Spirit Transformation	31–36	Requires Heavenly Tribulation
Void Refining	37–45	Pre-godhood
Heaven's Dao	46	Requires Godhead unlock

🌱 Spirit Roots (12 Types)

Awaken a spirit root that defines your entire cultivation path:

• Basic: Wood, Iron, Earth, Gold, Water, Fire, Wind, Lightning, Ice
• Rare: Extreme Earth, Extreme Sky
• Corrupted: Evil Demon

Each root has unique passives — Wood heals while cultivating, Gold crits, Evil Demon wields withering decay at the cost of your own health.

📜 15 Runes × 4 Qualities

Socket runes into weapons and armor through a rich PDC-backed system.

Combat runes: Focus, Heavy Strike, Execute, Armor Break, Vengeance, Lifesteal, Shield Shatter Defense/Utility: Heavy Armor, Durability, Haste, Efficiency, Spell Power, Mana, Weight, Affinity, Purify (pollution resistance)

Qualities: Blue → Purple → Gold → Red, each scaling values up to 4×.

⚔ Artifacts (10 Unique)

Right-click weapons that consume mana to unleash devastating abilities:

• Flame Sword, Guardian Sword, Aurora Scythe
• Life Scroll, Void Blade, Frost Sword, Frost Bow
• Thunder Spear — lightning cascade on trident hit
• Hourglass — freeze all projectiles in a radius
• Star Guide — reveal nearby players

Each artifact has a realm requirement and unique cooldown.

🌍 Three Cursed Dimensions

• Polluted Land — eternal night, permanent thunderstorm, darkness debuffs
• Kill City — endless mob spawns, assimilation mechanic after 100 kills
• Forget Land — lose XP after 10min, lose items after 15min, lose your soul after 20min

☠ Pollution System

Every monster hit adds pollution. Reach the cap and you'll lose a realm, your max HP, and die.

• Realm-based resistance: 0% (Mortal) → 90% (Heaven's Dao)
• Stackable: Angel's Tears, Traveler's Bones, Reincarnation Marks, Purify rune
• Dynamic cap: 1,000 (Mortal) → 150,000 (Heaven's Dao)

🏯 Sects

Player-founded guilds with ranks (Disciple → Elder → Vice Leader → Leader), shared 54-slot warehouse, sect chat, territory teleport, and passive bonuses.

👑 Godhead System

At Void Refining 9, right-click a Reincarnation Mark to unlock godhood. Choose one of 8 Dao Paths (Metal, Wood, Water, Fire, Earth, Wind, Thunder, Ice), receive a custom god name, and gain permanent flight.

📋 Quest System

• 6 power tiers with 40+ quests
• Daily quests — 4 per day (1 easy + 1 medium + 1 hard + 1 random)
• Full GUI with progress bars and click-to-claim
• World-specific quests for the three cursed dimensions

🎭 Monster Articles

Wear monster heads to gain specialized bonuses:

• Creeper (clears nearby creepers), Zombie, Skeleton, Dragon, Wither Skeleton

📖 Scripting Language

A custom DSL for server owners to write event-driven logic without recompiling.

on "玩家进入世界" {
    if (this.player.名称 == "Steve") {
        this.shenqi.给予(this.player.名称)
    }
}

---

🛠 Technical

• Platform: Paper 1.21+ (tested on Paper 26.2)
• Java: 17+
• Storage: Flat-file YAML (async persistence)
• Architecture: Central tick scheduler with profiler, module load time tracking, JIT warmup
• Script compiler: .libai → .libaic.zip (per-node file split, ZIP-packed)

---

📦 Installation

1. Drop libaiplugin.jar into plugins/
2. Restart the server
3. All config files generate automatically
4. Use /libai reload after configuration changes

---

💬 Commands

Command	Description
/cd	Open the main menu
/help	Categorized command help
/quest	Quest GUI
/quest daily	Daily quests
/mingwen	Rune (Mingwen) system
/fuwen	Fuwen rune system
/shenqi	Artifacts
/sect	Sect management
/juexing	Awaken spirit root
/gongfa	Cultivation techniques
/pollution	Check pollution status

---

📜 License

This plugin is distributed under a custom license. Redistribution and decompilation are prohibited. See the in-game license/ folder for details.

---

🐛 Support

Found a bug? Have a suggestion? Open an issue on the tracker.

For development inquiries, contact: libainowhite