HN 系列 Wiki

主题

最新版本：1.0.0 (2026-04-19) ​

重大更新 ​

升级到 HNCore 2.3.0 ​

HNEconomy 已升级到 HNCore 2.3.0，享受最新的框架能力：

  • API 边界重构：使用 HNCore 2.0.0 的新 API 设计
  • 通用搜索框架：集成 HNCore 2.2.0 的搜索能力
  • 输入会话框架：集成 HNCore 2.2.0 的输入管理

新增功能 ​

1. GUI 自定义金额输入 ​

位置：转账金额选择页面

功能：

  • 不再局限于预设的快捷金额
  • 点击"自定义金额"按钮，使用铁砧输入任意金额
  • 实时验证金额范围和精度
  • 输入成功后自动跳转到确认对话框

使用方式：

  1. 执行 /pay 进入转账流程
  2. 选择目标玩家和货币
  3. 在金额选择页面，点击"自定义金额"按钮（默认在 slot 49）
  4. 在铁砧界面输入金额
  5. 确认后自动进入转账确认流程

配置：

yaml
# gui/pay-amount.yml
custom-amount:
  slot: 49
  material: WRITABLE_BOOK
  name: "&a自定义金额"
  lore:
    - "&7点击输入任意金额"
    - "&7不受预设金额限制"

优势：

  • 无需关闭 GUI，在铁砧界面直接输入
  • 自动验证金额合法性
  • 支持小数点精度控制
  • 体验流畅，无需切换聊天

2. GUI 玩家搜索功能 ​

位置：转账目标选择页面

功能：

  • 快速搜索在线/离线玩家
  • 支持模糊匹配玩家名
  • 搜索结果即时反馈
  • 单个结果自动选择

使用方式：

  1. 执行 /pay 进入转账流程
  2. 在玩家列表页面，点击"搜索玩家"按钮（默认在 slot 22）
  3. 在聊天中输入玩家名关键词
  4. 查看搜索结果并选择目标玩家

配置：

yaml
# gui/pay-player-list.yml
search-player:
  slot: 22
  material: COMPASS
  name: "&a搜索玩家"
  lore:
    - "&7点击搜索玩家"
    - "&7支持模糊匹配"

优势：

  • 不再需要翻页查找玩家
  • 支持搜索离线玩家
  • 模糊匹配，输入部分名称即可
  • 搜索结果自动高亮显示

技术改进 ​

API 迁移 ​

HNCore 2.0.0 API 边界重构：

  • DatabaseManager → DatabaseService
  • MessageManager → MessageService
  • ConfigManager → ConfigService
  • SqlBatchSupport → 本地 SqlUtil 工具类
  • BatchLoopExecutor → 本地工具类

影响：

  • 更清晰的 API 边界
  • 更好的依赖管理
  • 更稳定的接口设计

新框架集成 ​

搜索框架（HNCore 2.2.0）：

  • 使用 SearchEngine<T> 实现玩家搜索
  • 创建 SearchablePlayer 包装类
  • 支持模糊匹配和别名

输入会话框架（HNCore 2.2.0）：

  • 使用 AnvilInputSession 实现铁砧输入
  • 使用 SimpleChatInputSession 实现聊天输入
  • 统一的输入验证和错误处理

配置变更 ​

新增配置项 ​

config.yml：

yaml
pay:
  # 启用转账备注输入（预留功能）
  enable-reason-input: true

新增 GUI 配置 ​

gui/pay-amount.yml：

  • 新增 custom-amount 按钮配置（slot 49）

gui/pay-player-list.yml：

  • 新增 search-player 按钮配置（slot 22）

新增消息配置 ​

messages.yml：

yaml
pay:
  # 自定义金额输入
  input-amount-prompt: "&a请在铁砧中输入转账金额："
  input-amount-invalid: "&c无效的金额格式"
  input-amount-too-small: "&c金额低于最小转账额"
  input-amount-too-large: "&c金额超过最大转账额"
  
  # 玩家搜索
  search-player-prompt: "&a请在聊天中输入玩家名："
  search-player-no-result: "&c未找到匹配的玩家"
  search-player-result: "&a找到 {count} 个匹配的玩家"

兼容性说明 ​

依赖版本 ​

  • HNCore: 2.3.0-SNAPSHOT+8325f8f 或更高版本
  • Paper: 1.20.1 或更高版本
  • Java: 17 或更高版本

向后兼容 ​

  • ✅ 完全向后兼容，无破坏性变更
  • ✅ 现有配置文件自动兼容
  • ✅ 现有数据库结构无变化
  • ✅ 现有命令和权限无变化

升级建议 ​

从旧版本升级：

  1. 备份数据库和配置文件
  2. 先升级 HNCore 到 2.3.0
  3. 替换 HNEconomy jar 文件
  4. 重启服务器
  5. 检查新增的配置项（可选）

新增功能默认启用：

  • 自定义金额输入：默认启用
  • 玩家搜索：默认启用

如需禁用新功能：

  • 删除或注释 GUI 配置中的对应按钮即可

已知问题 ​

测试环境问题 ​

  • 3 个单元测试被暂时禁用（需要重构 HNEconomyContext 的测试环境初始化）
  • 不影响实际使用，仅影响开发测试

功能限制 ​

  • 自定义金额输入：铁砧输入框有长度限制（约 35 字符）
  • 玩家搜索：搜索关键词通过聊天输入，需要暂时关闭 GUI

下一步计划 ​

中优先级功能 ​

  • 命令行转账备注输入（使用 CHAT 输入框架）
  • 交易记录搜索优化（使用搜索框架）
  • GUI 货币选择搜索（使用搜索框架）

低优先级功能 ​

  • 命令行玩家名补全优化（使用搜索框架）
  • 告示牌输入支持（多行文本输入场景）

相关文档 ​

技术文档 ​

项目仓库：

升级报告：

  • UPGRADE_SUMMARY.md - 升级总结
  • MIGRATION_COMPLETED.md - HNCore 2.0.0 迁移报告
  • HNCORE_2.2.0_IMPLEMENTATION_REPORT.md - HNCore 2.2.0 实施报告

历史版本 ​

0.9.x (2026-04-06) ​

初始版本，基于 HNCore 1.3.0

核心功能：

  • 多货币系统
  • 账户管理
  • 转账功能
  • 流水记录
  • 系统资金池
  • GUI 面板
  • Vault 集成
  • PlaceholderAPI 集成

最后更新: 2026-04-19
当前版本: 1.0.0
HNCore 版本: 2.3.0-SNAPSHOT+8325f8f

HN 系列插件文档

Copyright © 2024