快速开始

新接触 ArcartX-Suite 的服主请按下面顺序读完本章 — 整个过程大约 15 分钟就能让一个模块跑起来。

路线图

1. 安装 — 把 jar 丢进 plugins/，确认依赖、Java、MC 版本无误。
2. 云端授权 — 配置 cloud.qq / apiKey，在云端装备授权模块（也可从顶栏「云端授权」进入）。
3. 模块启用 — 理解 modules.<module>.enabled 模块开关。
4. 第一次启用流程 — 推荐的"先开 1 个最小模块 → 全开"流程。
5. 命令速查 — 管理命令（/axs）与玩家命令一表打尽。
6. 配置管理 — 智能诊断、/axs config 修复与配置目录拆分说明。
7. PlaceholderAPI 速查 — 各模块的 PAPI 前缀与典型字段。
8. 条件系统（PAPI + Aria + JS） — Menu / Prop / EventPacket / Mail 统一条件语法，支持 PAPI 行内、Aria 脚本、原生 JavaScript 三种模式。
9. 跨服功能配置 — 多服 Chat / Tab / Mail 等（统一 CrossServer SDK）。
10. Warehouse 多服 MySQL 部署 — 仓库跨服数据共享。
11. 多 UI 同时发包 — 多界面并存时的包路由。
12. Proxy 代理端插件 — 群组服代理端装哪个 jar、BC/VC 目录示例、与跨服 SDK 的区别。

开发者

若要 自己开发第三方模块，请从顶栏 开发者 进入，或阅读：

• 开发第三方模块 — 从零搭建 Gradle 工程到部署
• 使用第三方模块 — 服主安装他人模块 Jar
• Capability 详解 — 跨模块通信（开发向教程；API 速查见顶栏 API）

一句话总览

ArcartX 客户端 MOD  ──────  网络包 ──────  ArcartX-Suite 服务端 jar
     ↑ 渲染 UI / HUD                           ↑ 业务逻辑 / 数据库 / 桥接
     │                                          │
     └────── plugins/ArcartX-Suite/ ─────────────┘
              ├── config.yml          总开关 + cross-server 跨服
              ├── ArcartX*.yml        各模块配置
              ├── ui/                 ArcartX UI 模板
              ├── chat/, mail/, ...   模块子资源
              └── *.db                持久化数据

顺序很重要

先安装 ArcartX 客户端 MOD，再装 ArcartX-Suite 服务端。ArcartX-Suite 在 plugin.yml 中 depend: ArcartX，服务端缺少 ArcartX 时 ArcartX-Suite 不会启动。