HN 系列 Wiki

主题

这页按使用场景汇总 HNEconomy 当前命令。

如果你只想先记住最常用的几条：

  • 玩家看余额 / 打开个人经济面板：/money
  • 玩家转账：/pay
  • 玩家切换拒收：/paytoggle
  • 管理调账：/hneco give / /hneco take / /hneco set / /hneco transfer
  • 查流水：/hneco log / /hneco logsearch
  • 查归档流水：/hneco logarchive / /hneco logarchivesearch
  • 运维状态：/hneco status / /hneco cleanup

玩家命令 ​

/money ​

默认打开个人经济面板。

text
/money
/money [货币]
/money <玩家> [货币]
/bal

用途 ​

  • 玩家无参数执行时，打开自己的经济面板
  • 玩家查看自己的单个货币余额
  • 有权限的管理者查看别人余额

特点 ​

  • /money 无参数时是 GUI 主入口
  • /money gold 这类写法是文本查看指定货币余额
  • 玩家查看自己时，还会附带显示收款状态
  • /bal 是别名
  • 控制台如需查余额，请使用 /hneco balance <玩家> [货币]

/pay ​

玩家转账；玩家无参数执行时会打开转账流程面板。

text
/pay
/pay <玩家> <金额> [货币] [原因...]

例子 ​

text
/pay
/pay Steve 100
/pay Steve 100 gold
/pay Steve 88 gold 公会活动补贴

当前 GUI 流程 ​

text
目标玩家 → 货币选择 → 金额选择 → 确认转账

特点 ​

  • /pay 无参数时会打开在线玩家选择面板
  • 选择目标后，会进入 pay-currency.yml 对应的货币选择页
  • 再进入 pay-amount.yml 对应的金额页与确认页
  • 默认使用主货币
  • 如果第三个参数匹配货币 ID，就按指定货币转账
  • 会受以下配置约束：
    • 开关
    • 权限
    • 最小金额
    • 最大金额
    • 每日限额
    • 冷却时间
    • 拒收状态
    • 手续费

/paytoggle ​

切换是否接收别人转账。

text
/paytoggle
/paytoggle toggle
/paytoggle on
/paytoggle off
/paytoggle status

用途 ​

  • 玩家拒收转账
  • 玩家恢复接收转账
  • 查看自己的当前收款状态

管理命令：/hneco ​

主管理命令别名：

text
/hneco
/hnec

面板入口与维护命令 ​

/hneco menu ​

打开个人经济面板。

text
/hneco menu
/hneco wallet

说明 ​

  • wallet 是别名
  • 这是 /money 无参数打开面板的管理命令版本
  • 仅玩家可执行

/hneco reload ​

text
/hneco reload

重载以下内容：

  • config.yml
  • currencies.yml
  • gui/*.yml

通常在你修改配置、货币定义、GUI 布局后使用。

/hneco status ​

text
/hneco status

查看当前运维状态，包括：

  • 主流水表条数
  • 归档流水表条数
  • 幂等表条数
  • 玩家转账日统计条数
  • 导出文件数
  • Placeholder 缓存状态
  • 自动清理与归档保留策略
  • 最近一次清理任务开始/完成时间与结果

适合：

  • 排查归档清理是否真的在跑
  • 判断主表和归档表体量
  • 查看最近维护结果

/hneco cleanup ​

text
/hneco cleanup

手动触发一次经济归档与清理任务。

会处理的内容 ​

  • 过期幂等记录
  • 过期玩家转账日统计
  • 超过保留期的主流水归档
  • 过期导出文件

说明 ​

  • 命令是异步执行的
  • 执行结果可结合 /hneco status 查看
  • 即使自动清理关闭，通常仍可手动执行这条命令

余额与资金变更 ​

/hneco balance ​

text
/hneco balance <玩家> [货币]

查看指定玩家余额。

/hneco give ​

text
/hneco give <玩家> <货币> <金额> [原因...]

给玩家加钱，并写流水。

/hneco take ​

text
/hneco take <玩家> <货币> <金额> [原因...]

给玩家扣钱，并写流水。

/hneco set ​

text
/hneco set <玩家> <货币> <金额> [原因...]

设置玩家余额，并写流水。

这不是“静默覆盖”，系统仍然会记录：

  • before
  • after
  • delta
  • reason

/hneco transfer ​

text
/hneco transfer <转出玩家> <转入玩家> <货币> <金额> [原因...]

管理员转账入口。

适合：

  • 手动调账
  • 运营补发
  • 玩家间问题处理

货币管理 ​

/hneco currency list ​

查看当前已注册货币。

/hneco currency create ​

text
/hneco currency create <id> <displayName> [symbol] [scale] [defaultBalance]

动态创建货币定义。

/hneco currency edit ​

text
/hneco currency edit <id> <field> <value...>

支持字段：

  • display-name
  • symbol
  • description
  • scale
  • default-balance
  • allow-negative
  • max-balance
  • sort-order

/hneco currency setmain ​

text
/hneco currency setmain <id>

设置主货币。

/hneco currency enable ​

text
/hneco currency enable <id>

启用货币。

/hneco currency disable ​

text
/hneco currency disable <id>

禁用货币。

日志、审计与导出命令 ​

/hneco log ​

text
/hneco log <玩家> [货币] [页码]

查询玩家主流水。

/hneco logarchive ​

text
/hneco logarchive <玩家> [货币] [页码]

查询玩家归档流水。

适合什么时候用 ​

  • 主流水里已经查不到旧记录
  • 你已经开启了流水归档
  • 你在查较久之前的历史账务

/hneco logsource ​

text
/hneco logsource <sourceType> <sourceId> [页码]

按来源查询主流水。

适合查：

  • 某命令来源
  • 某业务接入来源
  • 某模块是否异常刷钱

/hneco logarchivesource ​

text
/hneco logarchivesource <sourceType> <sourceId> [页码]

按来源查询归档流水。

/hneco logbiz ​

text
/hneco logbiz <businessId> [页码]

按业务 ID 查询主流水。

适合查：

  • 某次转账
  • 某次结算
  • 某笔批量业务

/hneco logarchivebiz ​

text
/hneco logarchivebiz <businessId> [页码]

按业务 ID 查询归档流水。

/hneco logsearch ​

支持组合筛选，例如：

text
/hneco logsearch player=Steve currency=gold type=ADMIN_GIVE
/hneco logsearch sourceType=PAY from=2026-03-01 to=2026-03-31
/hneco logsearch businessId=pay-xxxx

可用条件包括：

  • player=
  • currency=
  • type=
  • sourceType=
  • sourceId=
  • businessId=
  • operatorType=
  • operatorId=
  • from=
  • to=
  • page=

/hneco logarchivesearch ​

归档流水的高级组合筛选。

示例：

text
/hneco logarchivesearch player=Steve currency=gold from=2026-01-01 to=2026-02-01

可用筛选参数与 logsearch 基本一致，只是作用于归档表。

/hneco exportlog ​

text
/hneco exportlog [player=玩家] [currency=货币] [type=类型] [sourceType=来源类型] [sourceId=来源ID] [businessId=业务ID] [operatorType=操作人类型] [operatorId=操作人ID] [from=时间] [to=时间] [limit=条数]

按条件导出主流水 CSV。

/hneco exportarchive ​

text
/hneco exportarchive [player=玩家] [currency=货币] [type=类型] [sourceType=来源类型] [sourceId=来源ID] [businessId=业务ID] [operatorType=操作人类型] [operatorId=操作人ID] [from=时间] [to=时间] [limit=条数]

按条件导出归档流水 CSV。

系统资金池命令 ​

文档中使用“系统资金池”这一说法；实际命令路径仍为 /hneco treasury ...。

/hneco treasury balance ​

text
/hneco treasury balance [货币]

查看系统资金池余额。

/hneco treasury stats ​

text
/hneco treasury stats [货币]

查看：

  • 余额
  • 今日手续费收入
  • 累计手续费收入
  • 排名

/hneco treasury trend ​

text
/hneco treasury trend [货币] [天数]

查看最近若干天的系统资金池手续费收入趋势。

/hneco treasury give ​

text
/hneco treasury give <货币> <金额> [原因...]

管理员向系统资金池入账。

/hneco treasury take ​

text
/hneco treasury take <货币> <金额> [原因...]

管理员从系统资金池出账。

/hneco treasury log ​

text
/hneco treasury log [货币] [页码]

查询系统资金池流水。

/hneco treasury export ​

text
/hneco treasury export [货币] [limit]

导出系统资金池流水 CSV。

风控与统计命令 ​

/hneco paystat ​

text
/hneco paystat <玩家> [货币] [天数]

查看玩家：

  • 是否拒收
  • 最近一次转账时间
  • 近期转出统计

/hneco suspicious ​

text
/hneco suspicious <最小金额> [货币] [天数] [条数] [player=玩家] [reason=关键词]

筛选大额可疑转账。

/hneco top ​

text
/hneco top <货币> [天数] [人数]

查看转账排行榜。

/hneco topbalance ​

text
/hneco topbalance <货币> [人数]

查看余额排行榜。

常见入口怎么选 ​

我只是玩家，想看余额或打开个人经济面板 ​

text
/money

我只是玩家，想转账 ​

text
/pay

我是管理员，想给玩家调账 ​

text
/hneco give
/hneco take
/hneco set
/hneco transfer

我是运维，想查最近记录 ​

text
/hneco log
/hneco logsearch

我是运维，想查老记录 ​

text
/hneco logarchive
/hneco logarchivesearch
/hneco exportarchive

我想看归档清理是否正常 ​

text
/hneco status
/hneco cleanup

推荐阅读 ​

HN 系列插件文档

Copyright © 2024