这页的目标不是把所有经济概念一次性讲完，而是带你 按最短路径跑通一套可验证链路：

1. HNCore 共享数据库已启用
2. HNEconomy 能正常启动并生成配置
3. 货币定义被正确加载
4. 管理员命令能改余额并落数据库流水
5. 玩家 /money、/pay 能正常工作

但要先说清楚：

HNEconomy 的快速开始，不是教你“怎么把余额改掉”这么简单。
它真正要你验证的是：余额变化、流水落库、系统资金池归集、占位符展示、运维排查，这整条审计链路有没有跑通。

---

第 0 步：准备依赖

必需依赖

• HNCore
• HNEconomy

可选依赖

• Vault
• PlaceholderAPI

HNEconomy 当前版本 默认强依赖 HNCore 共享数据库，所以最关键的前置条件不是 Vault，而是 HNCore 的 storage.yml 里数据库已经启用。

---

第 1 步：先确认 HNCore 共享数据库可用

重点确认：

• HNCore 已先于 HNEconomy 启动
• HNCore 的共享数据库是 active 状态
• HNEconomy 启动时没有提示共享数据库不可用

如果共享数据库没开，当前版本的 HNEconomy 会直接拒绝启动，而不是静默切到本地库。

这是一种刻意设计：

• 避免多服账目分裂
• 避免运维误以为正在共库，实际却写到了本地 SQLite
• 保证账本、系统资金池、流水、排行榜都基于同一份数据

---

第 2 步：首次启动后先确认文件

启动服务器后，优先确认这些文件已经生成：

• plugins/HNEconomy/config.yml
• plugins/HNEconomy/currencies.yml

其中：

• config.yml 负责共享数据库接入、主货币、玩家转账、系统资金池、导出、告警等全局设置
• currencies.yml 负责多货币定义

---

第 3 步：先看默认货币定义

默认示例里通常会有：

• gold
• point

例如：

currencies:
  gold:
    display-name: "金币"
    symbol: "$"
    enabled: true
    scale: 0
    default-balance: 0

  point:
    display-name: "积分"
    symbol: "P"
    enabled: true
    scale: 0
    default-balance: 0

你需要先确认的点

• 至少有一个启用货币
• main-currency 指向的是一个存在且启用的货币
• scale 是否符合你的服实际需求

如果你只是想先跑通整条链路，建议先只保留一个主货币，例如 gold。

---

第 4 步：先用管理员命令改一次余额

最稳的第一轮验证不是先测 Vault，而是直接测原生命令。

查看余额

/hneco balance <玩家>
/hneco balance <玩家> gold

发钱

/hneco give <玩家> gold 100 新手补偿

扣钱

/hneco take <玩家> gold 20 测试扣款

设置余额

/hneco set <玩家> gold 500 初始资金

这一步你要验证什么

• 余额确实变化了
• 命令反馈成功
• 对应流水也被写入数据库

这一步只是在证明系统会“记账”；真正能体现 HNEconomy 区别的，是下一步继续验证它会不会把这笔账记得能查、能筛、能追、能解释。

---

第 5 步：用日志命令确认“不是只改了余额”

你做完上一步后，不要只看余额，要继续看流水。

查看玩家流水

/hneco log <玩家>
/hneco log <玩家> gold

你应该看到的内容

每条流水至少会包含：

• 增减金额
• 变化类型
• 来源类型 / 来源 ID
• 明文原因
• 时间

这一步最关键，因为 HNEconomy 的核心不是“有个余额表”，而是：

所有余额变化都必须同时形成可审计流水。

换句话说：

• 只看到余额变了，不算验证完成
• 只有在流水里能看到原因、来源、业务标记和时间，才算这套系统真正跑通
• 对 HNEconomy 来说，审计链路不是附加功能，而是产品核心

---

第 6 步：再验证玩家个人经济面板与转账

玩家查看自己余额

/money
/money gold
/bal

这里要注意：

• /money 无参数时，默认会打开个人经济面板
• /money gold 这类写法会直接文本查看指定货币余额
• /bal 是余额查询别名

玩家转账

/pay <玩家> 100
/pay <玩家> 100 gold
/pay <玩家> 88 gold 公会活动补贴

这一步建议顺便验证

• /paytoggle status
• /paytoggle off
• /paytoggle on

这样你能顺手确认：

• 玩家转账开关是否生效
• 拒收状态是否生效
• /money 是否会显示自己的收款状态

---

第 7 步：如果你开了手续费，再测一次 /pay

如果 config.yml 里启用了：

pay:
  fee:
    enabled: true

那么推荐你再测一次 /pay，确认以下行为：

• 收款方收到主金额
• 付款方多扣手续费
• 系统资金池收到手续费
• 三边都有流水

这一步能验证当前版本最重要的一条完整业务流程：

• 玩家支付
• 手续费归集
• 系统资金池入账
• 审计闭环

---

第 8 步：顺手检查系统资金池

查看系统资金池余额

/hneco treasury balance
/hneco treasury balance gold

查看系统资金池统计

/hneco treasury stats
/hneco treasury stats gold

查看系统资金池趋势

/hneco treasury trend gold 7

如果你刚做过带手续费的 /pay，这里通常就能看到：

• 系统资金池余额
• 今日手续费收入
• 累计手续费收入

---

第 9 步：如果装了 PlaceholderAPI，再验证占位符

当前版本的对外占位符前缀建议按 HNCore 占位符桥 来写，也就是：

%hncore_economy_<params>%

建议至少测这些：

• %hncore_economy_balance%
• %hncore_economy_balance_gold%
• %hncore_economy_pay_receive_text%
• %hncore_economy_treasury_balance%
• %hncore_economy_treasury_today_fee_formatted%

如果这些能正常显示，说明：

• 玩家余额接口正常
• 系统资金池统计接口正常
• Placeholder 扩展注册成功

---

第 10 步：最推荐的首轮排查顺序

如果你觉得“命令都打了，但结果不对”，建议按这个顺序排查：

1. 先看 HNCore 共享数据库是否真的启用
2. 再看 config.yml 的 main-currency 是否指向有效货币
3. 再看 currencies.yml 里货币是否启用
4. 再用 /hneco balance 看余额
5. 再用 /hneco log 看流水
6. 最后再看 /pay、系统资金池、Placeholder、Vault 这些上层能力

也就是说，先排账务核心，再排集成层。

---

下一步推荐阅读

如果你已经跑通这页，建议继续读：

1. 安装与首次启动
2. config.yml 配置说明
3. currencies.yml 配置说明
4. 命令说明
5. 流水、系统资金池与运维
6. 运维排障清单与故障定位顺序

如果你现在最关心的是“我怎么查账、怎么追溯钱从哪里来”，下一页建议直接去看 流水、系统资金池与运维。