这页重点讲三件事：

1. 安装顺序
2. 首次启动需要确认什么
3. 哪些现象算正常，哪些现象说明配置有问题

---

依赖关系

必需依赖

• HNCore
• HNEconomy

可选依赖

• Vault
• PlaceholderAPI

plugin.yml 中当前关系是：

• depend: HNCore
• softdepend: Vault, PlaceholderAPI

也就是说：

• 没有 HNCore，HNEconomy 无法工作
• 没有 Vault / PlaceholderAPI，HNEconomy 仍然可以启动，只是少了对应集成能力

---

为什么必须先装 HNCore

因为当前版本的 HNEconomy 不是自己维护数据库连接池，而是直接复用：

• HNCore 日志
• HNCore 配置管理
• HNCore 命令注册
• HNCore 共享数据库
• HNCore 事务能力

所以你可以把 HNEconomy 理解成：

建立在 HNCore 基础设施之上的经济平台层。

---

首次启动前要确认的事

1）HNCore 共享数据库已启用

这是最重要的一项。

当前版本默认要求：

database:
  use-shared-database: true

并且 HNCore 的共享数据库必须真的可用。

如果共享数据库不可用，HNEconomy 会拒绝启动。

2）主货币配置正确

main-currency: "gold"

你要确保：

• gold 存在于 currencies.yml
• 并且该货币是启用状态

3）至少存在一个启用货币

如果 currencies.yml 里一个可用货币都没有，插件虽然可以读到文件，但业务上是跑不起来的。

---

首次启动会做什么

HNEconomy 启动时，核心流程大致是：

1. 加载 config.yml
2. 加载 currencies.yml
3. 获取 HNCore 共享数据库
4. 初始化经济相关数据表
5. 把货币定义同步到数据库
6. 初始化服务层与命令层
7. 释放并加载 gui/*.yml 玩家面板配置
8. 检查并注册 Vault / PlaceholderAPI 接入
9. 启动系统资金池阈值告警任务（如果开启）

---

首次启动后会生成什么

你通常会看到：

• plugins/HNEconomy/config.yml
• plugins/HNEconomy/currencies.yml
• plugins/HNEconomy/gui/player-economy.yml
• plugins/HNEconomy/gui/pay-player-list.yml
• plugins/HNEconomy/gui/pay-currency.yml
• plugins/HNEconomy/gui/pay-amount.yml

其中 gui/ 目录用于配置玩家面板：

• /money 无参数时打开的个人经济面板
• /pay 无参数时打开的在线玩家选择面板
• 选择目标后打开的货币选择面板
• 选择货币后打开的金额面板与确认流程

此外，数据库里还会建立经济相关表，例如：

• 货币定义表
• 账户余额表
• 流水表
• 幂等表
• 玩家转账设置表
• 玩家每日转账统计表

具体表名会受 table-prefix 影响。

---

什么现象算正常

下面这些现象都属于正常：

• HNEconomy 成功启用
• 默认货币能被 /hneco currency list 看到
• /money 能正常打开个人经济面板，或通过 /money <货币> 显示余额
• /hneco give、/hneco take、/hneco set 能成功执行
• /hneco log 能查到对应流水
• 如果装了 PlaceholderAPI，%hncore_economy_xxx% 这类占位符能返回值
• 如果装了 Vault，Vault 经济服务能正常注册

---

哪些情况说明启动阶段有问题

情况 1：提示 HNCore 共享数据库不可用

这通常说明：

• HNCore 数据库没启用
• HNCore 连接失败
• 或者你以为是共库，实际并没有启用共享数据库

情况 2：主货币无效

这通常说明：

• main-currency 指向了一个不存在的货币
• 或者该货币已经被禁用

情况 3：Vault / PlaceholderAPI 没接上

先确认：

• 你是否真的装了对应插件
• config.yml 里是否把对应能力开启

情况 4：插件能启动，但命令报货币不存在

优先检查：

• currencies.yml 写法是否正确
• currency id 是否和命令里输入的一致
• 是否启用了该货币

---

推荐的首启验证命令

服务器起好后，建议按这个顺序验证：

/hneco currency list
/hneco balance <玩家>
/hneco give <玩家> gold 100 首启测试
/hneco log <玩家> gold
/money

如果这几步都通，说明：

• 货币注册没问题
• 账户体系没问题
• 流水体系没问题
• 玩家侧基础命令没问题

---

下一步推荐阅读

1. config.yml 配置说明
2. currencies.yml 配置说明
3. 命令说明
4. GUI 与玩家面板配置
5. 运维排障清单与故障定位顺序
6. 常见问题