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.

🌱 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

📜 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