HN 系列 Wiki

主题

这页专门用来回答一个很实际的问题：

HNEconomy 当前有哪些权限节点，分别控制什么功能？

如果你正在做：

  • LuckPerms 分组配置
  • 管理员 / 运维权限拆分
  • VIP 手续费减免
  • 玩家是否允许查看他人余额

这页就是最省时间的速查表。

一、先说结论 ​

当前权限大致分成三类：

  1. 玩家常用功能权限
  2. 管理命令权限
  3. 手续费覆盖权限

同时要注意：

  • 一部分玩家命令本身默认不强制权限
  • 一部分能力是否需要权限，还会受 config.yml 开关影响
  • 下面表里列的是当前实现里实际出现的权限节点

二、玩家命令相关 ​

/money ​

场景权限
玩家查看自己余额 / 打开自己面板通常不需要额外权限
查看其他玩家余额hneconomy.command.balance.other

说明 ​

  • /money 无参数时默认打开个人经济面板
  • /money gold 这类查看自己余额通常不要求额外权限
  • /money <玩家> 这种跨玩家查看需要 hneconomy.command.balance.other

/pay ​

场景权限
玩家转账功能开启且不要求权限不需要额外权限
pay.require-permission: true 时使用 /pay 或转账 GUIhneconomy.command.pay

说明 ​

/pay 是否要求权限，取决于：

yml
pay:
  require-permission: false

如果你把它改成：

yml
true

那么玩家无论是直接输入 /pay，还是通过 GUI 发起转账，都会校验：

text
hneconomy.command.pay

/paytoggle ​

场景权限
切换自己是否允许收款当前无单独权限节点

说明 ​

当前实现中，/paytoggle 主要限制的是：

  • 必须由玩家执行

而不是额外权限节点。

三、/hneco 管理子命令权限 ​

下面这些是当前实现里有明确权限节点的子命令。

命令权限节点说明
/hneco balancehneconomy.command.balance查看指定玩家余额
/hneco menu / /hneco wallethneconomy.command.balance打开个人经济面板；当前复用 balance 权限
/hneco reloadhneconomy.command.reload重载配置、货币与 GUI
/hneco statushneconomy.command.status查看归档与清理状态
/hneco cleanuphneconomy.command.cleanup手动执行归档与清理
/hneco givehneconomy.command.give给玩家加钱
/hneco takehneconomy.command.take给玩家扣钱
/hneco sethneconomy.command.set设置玩家余额
/hneco transferhneconomy.command.transfer管理员转账
/hneco paystathneconomy.command.paystat查看玩家转账统计
/hneco treasury ...hneconomy.command.treasury系统资金池全部子命令
/hneco suspicioushneconomy.command.suspicious可疑交易筛查
/hneco tophneconomy.command.top转账排行榜
/hneco topbalancehneconomy.command.topbalance余额排行榜
/hneco loghneconomy.command.log查询主流水
/hneco logarchivehneconomy.command.logarchive查询归档流水
/hneco logsourcehneconomy.command.logsource按来源查主流水
/hneco logarchivesourcehneconomy.command.logarchivesource按来源查归档流水
/hneco logbizhneconomy.command.logbiz按业务 ID 查主流水
/hneco logarchivebizhneconomy.command.logarchivebiz按业务 ID 查归档流水
/hneco logsearchhneconomy.command.logsearch高级筛选主流水
/hneco logarchivesearchhneconomy.command.logarchivesearch高级筛选归档流水
/hneco exportloghneconomy.command.exportlog导出主流水 CSV
/hneco exportarchivehneconomy.command.exportarchive导出归档流水 CSV
/hneco currency ...hneconomy.command.currency货币管理全部子命令

四、跨玩家查看余额的额外权限 ​

这个节点很容易漏配：

text
hneconomy.command.balance.other

它主要影响：

  • /money <玩家> [货币]

也就是说：

  • 管理员如果只拿到了 /hneco balance，不代表一定能直接用 /money 玩家名
  • 如果你希望某些客服、GM 可以快速查看别人余额，最好把这个节点也一起配上

五、手续费覆盖权限 ​

这类权限不是写死在命令里的，而是来自 config.yml：

yml
pay:
  fee:
    permission-overrides:
      vip:
        permission: "hneconomy.payfee.vip"
        rate: 0.01

这意味着：

  • 你可以自己定义权限节点名
  • 节点本身由配置驱动
  • 常见做法是按玩家组做差异费率

典型示例 ​

权限节点常见用途
hneconomy.payfee.vipVIP 低手续费
hneconomy.payfee.svipSVIP 更低手续费
hneconomy.payfee.free免手续费

推荐思路 ​

例如：

  • 普通玩家：默认 3%
  • VIP：hneconomy.payfee.vip → 1%
  • 管理组：hneconomy.payfee.free → 0%

六、最常见的权限拆分方案 ​

方案 A：纯玩家服 ​

给普通玩家：

  • 不额外发任何 HNEconomy 权限
  • pay.require-permission: false

适用：

  • 玩家默认就能 /money、/pay、/paytoggle
  • 不开放任何管理命令

方案 B：客服 / GM ​

建议给：

  • hneconomy.command.balance
  • hneconomy.command.balance.other
  • hneconomy.command.log
  • hneconomy.command.logsearch
  • hneconomy.command.paystat
  • hneconomy.command.suspicious

适用：

  • 能查余额
  • 能查流水
  • 能做基础排查
  • 但不能直接改钱

方案 C：运营 / 经济管理员 ​

建议给：

  • 客服 / GM 权限
  • hneconomy.command.give
  • hneconomy.command.take
  • hneconomy.command.set
  • hneconomy.command.transfer
  • hneconomy.command.treasury
  • hneconomy.command.exportlog
  • hneconomy.command.exportarchive

适用：

  • 需要处理补偿
  • 需要调账
  • 需要维护系统资金池
  • 需要导出报表

方案 D：高级运维 ​

建议给：

  • 运营 / 经济管理员权限
  • hneconomy.command.status
  • hneconomy.command.cleanup
  • hneconomy.command.reload
  • hneconomy.command.currency
  • hneconomy.command.logarchive
  • hneconomy.command.logarchivesource
  • hneconomy.command.logarchivebiz
  • hneconomy.command.logarchivesearch

适用：

  • 维护归档清理
  • 调整货币定义
  • 做长期数据维护

七、几个容易踩的坑 ​

坑 1：只给了 /hneco balance，没给 balance.other ​

结果是：

  • /hneco balance Steve 可以查
  • /money Steve 不一定可以查

坑 2：把 /pay 权限和功能开关搞混了 ​

就算玩家有：

text
hneconomy.command.pay

如果：

yml
pay:
  enabled: false

那还是不能转账。

坑 3：配了 VIP 手续费节点，但忘了默认费率仍然生效 ​

手续费覆盖是“覆盖默认规则”，不是自动创建新规则。

所以你仍然需要先把基础费率配好，再按权限做覆盖。

坑 4：忘了归档相关权限 ​

如果你已经开了流水归档，但运维只拿到了 log / logsearch， 那查旧数据时很容易误以为“记录丢了”。

八、最推荐的排查顺序 ​

如果某个角色“明明应该能用，但就是提示不能用”，建议按这个顺序查：

  1. 先确认命令本身是不是启用状态
  2. 再确认配置里是否要求额外权限（例如 /pay）
  3. 再确认对应权限节点有没有真的发到玩家组
  4. 如果是 GUI 行为，也要确认 GUI 背后调用的功能权限是否满足
  5. 如果是查旧记录，再确认是否漏发了归档命令权限

推荐阅读 ​

HN 系列插件文档

Copyright © 2024