🔌 外部插件对接

QinhCoreLib（QCL）从设计之初就是要和服务器上的一大批第三方插件共处的。它把这些插件全部当作软依赖：装了就自动接上、没装就静默跳过，绝不因为「缺少依赖」而拒绝加载。每个对接点都是一座反射桥——运行时探测目标类、按需调用，对方插件换了版本或干脆没装，QCL 自身也不会崩。

接上之后，别家插件的能力就被「借」进了整个生态：它们的物品能被 QI、自定义 GUI、CustomBlock、开发者 API 用统一的引用语法取用；它们的方块、模型、作物、经济也能直接复用。哪些插件接上了、各自支持到什么程度，都登记在一张桥接矩阵里，重启后用 /qcl status detail 一眼可查。

本节按对接对象分成三类来讲：取物品的物品类插件、做世界交互的方块/模型/作物插件、管钱的经济插件。建议先读概览页理解软依赖与反射桥的统一规矩，再按需翻阅对应分类页。

本节内容

• 🗺️ 软依赖总览与桥接矩阵 — 对接的设计哲学、如何确认接上了，以及一张覆盖全部插件的桥接总矩阵。
• 🎒 物品类插件 — 九个物品来源的引用前缀速查与逐插件细节，统一用引用字符串取物品。
• 🌳 方块/模型/作物 — CraftEngine 方块家具、ModelEngine 模型实体、CustomCrops 作物的世界交互能力。
• 🏦 经济插件 — Vault / ExcellentEconomy / PlayerPoints 三后端统一对接与 auto 选源逻辑。