⚔️ QinhCoreLib ⚔️
The all-in-one core library behind the Qinhuai RPG ecosystem
Item sources · Attributes · Scripting · GUI · Economy · Bridges — one foundation for your whole server.
![[IMG]](//proxy.spigotmc.org/83b7822ccb722b76d53588047bf8d0f0f9e89736/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4a6176612d32352b2d6f72616e6765)
![[IMG]](//proxy.spigotmc.org/b468825e3f119fdc99fa317cb94c850990b8767f/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f50617065722532302537432532305075727075722d312e32312e31312b2d626c7565)
![[IMG]](//proxy.spigotmc.org/b28b8ad9bc21ee74c47f29123c77c30e170b0835/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c616e6775616765732d372d677265656e)
![[IMG]](//proxy.spigotmc.org/161a70e5699fafa2bfa65021810a9b08210355d1/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f436f72652d416c6c2d2d696e2d2d4f6e652d726564)
────────────────────────────────────────
The all-in-one core library behind the Qinhuai RPG ecosystem
Item sources · Attributes · Scripting · GUI · Economy · Bridges — one foundation for your whole server.
────────────────────────────────────────
✨ What's Inside
- Unified Item Sources — reference items from 10+ plugins with one syntax (MMOItems, MythicMobs, ItemsAdder, Nexo, CraftEngine, NeigeItems, QI…)
- Scripting Engine — built-in GraalJS + Groovy for conditions, actions and item modules
- ️ Custom GUIs — draw menus in YAML with actions & conditions, no code
- Cross-plugin Economy — one API over Vault / ExcellentEconomy / PlayerPoints
- ️ Native Attributes & Elements — a full attribute & damage system with no AttributePlus required; add your own via yml + JS
- 7 Languages — fully translatable, just edit yml
- Custom Blocks & Bridges — ModelEngine, CustomCrops, MythicMobs, CraftEngine, MagicGem, CustomFishing…
- ️ Database · PDC · PlaceholderAPI · Diagnostics — SQLite/MySQL storage, persistent data, PAPI, one-command health check
QCL is the shared foundation for QinhItems / QinhSkills / QinhForge / QinhStrengthen — yet most features work standalone too. Plugins you don't have are skipped automatically: no hard dependencies, no startup errors.Click to expand...
────────────────────────────────────────
Unified Item Sources
One reference syntax to pull items from 10+ item plugins — any sub-plugin can copy and use it directly:
Code (Text):
vanilla:DIAMOND_SWORD ce:my_pack:blade mm-Dragon_Sword
mmoitems:SWORD:excalibur ia-pack_id nexo:ruby qinhitems:flame_blade
mmoitems:SWORD:excalibur ia-pack_id nexo:ruby qinhitems:flame_blade
────────────────────────────────────────
️ Platform Toolkit
Everything your gameplay plugins (or you, the server owner) need on one base:
- Scripting — GraalJS + Groovy: GUI conditions, click actions, diagnostics, external item modules
- Custom GUI — YAML-defined menus with data sources, pagination and actions, no code
- Economy — give / take / set across Vault / EE / PlayerPoints with one action string
- Custom Blocks — unified block abstraction bridging ModelEngine / CraftEngine
- Data — SQLite / MySQL storage, PDC helpers, PlaceholderAPI bridge
- Diagnostics — /qcl status shows ecosystem health, bridges, modules and health codes at a glance
────────────────────────────────────────
️ Native Attributes (no AttributePlus needed)
A built-in attribute & damage system — attack / crit / defense / dodge / penetration, plus an element system (fire / water / thunder… with mutual restraint). Attributes stack per source across items, classes, gems and sets.
Add your own with one yml entry + a short JS hook ( on_damage_dealt / taken / kill / tick / equip…):
Code (YAML):
attributes:
thorns:
display : Thorns
category : Mitigation
hooks:
on_damage_taken : qinhcorelib:attributes/thorns.js:onDamageTaken
thorns:
display : Thorns
category : Mitigation
hooks:
on_damage_taken : qinhcorelib:attributes/thorns.js:onDamageTaken
────────────────────────────────────────
Seven Languages
Interface, commands and messages are fully translatable, with auto-fallback to English. One line in config.yml:
Code (YAML):
language
: en_US
# zh_cn · en_US · zh_tw · ru_RU · fr_FR · vi_VN · es_ES
────────────────────────────────────────
Quick Start
- Download and drop into plugins/
- Start the server (requires Paper / Purpur 1.21.11+, Java 25+)
- /qcl status to check ecosystem health
- Configure item sources, GUIs, economy, attributes & languages, then /qcl reload
────────────────────────────────────────
Commands
| Command | Function |
| /qcl status | View ecosystem & bridge health |
| /qcl gui <id> | Open a custom GUI |
| /qcl attr list / show | Inspect registered attributes / a player's totals |
| /qcl reload | Reload configuration |
────────────────────────────────────────
Documentation
Full Wiki & guides → Qinhuai Docs
⭐ Find it useful? A Star / review is the best support you can give!
Compatible with Paper · Purpur · Spigot 1.21.11+ ｜ Java 25+ ｜ Core of the Qinhuai plugin series
Full Wiki & guides → Qinhuai Docs
⭐ Find it useful? A Star / review is the best support you can give!
Compatible with Paper · Purpur · Spigot 1.21.11+ ｜ Java 25+ ｜ Core of the Qinhuai plugin series
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.21, 26.1, 26.2
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
QinhCoreLib - Core Library for Qinh Series Plugins is a free Minecraft Java mod. Compatible with Minecraft 1.21, 26.1, 26.2. Downloaded 33 times (via Spigot). Download it and open it directly in the game.