命令历史增强

命令历史增强

Command History Plus 是一个轻量级客户端 Fabric 模组,可在屏幕右侧的紧凑覆盖层中随时保留最近的命令。

游戏机制

Command History Plus 是一个轻量级的 客户端 Fabric 模组,可在屏幕右侧的紧凑悬浮窗中随时保留你最近的命令。

功能

  • 屏幕历史记录悬浮窗
    • 在 HUD 右侧显示你最近的 /命令。
    • 使用鼠标滚轮滚动以浏览更早的条目。
    • 悬停高亮,已固定的命令带有 📌 图标。
  • 聊天中的点击交互
    • 聊天打开时左键点击某个条目:
      • 将命令插入聊天框,或
      • 如果启用了即时发送,则立即发送。
    • 右键点击可从历史记录中移除命令。
  • 固定命令
    • 让重要命令始终位于列表顶部。
    • 已固定的条目也会在 /chp pin 和 /chp unpin 中作为建议出现。
  • 按世界 / 按服务器划分历史记录
    • 为以下内容提供独立的历史记录配置:
      • 单人世界。
      • 多人服务器。
    • 可选模式:将每个配置存储在其独立的 JSON 文件中(默认启用)。
  • 可配置的历史记录
    • 可限制存储条目数量(historyLimit,0 = 无限制)。
    • 可选择在点击或使用快速插入快捷键时使用即时发送。
    • 异步、去抖保存,避免频繁写入磁盘。
  • 搜索
    • 按下搜索快捷键并在聊天中输入,即可按子字符串筛选悬浮窗。

按键绑定

所有按键绑定均为客户端生效,可在 Minecraft 的控制菜单中更改。

  • 切换历史记录悬浮窗(默认 H)——显示/隐藏悬浮窗。
  • 插入最后一条命令(默认 ↑)——将最近一条命令插入聊天。
  • 插入所选命令(默认 ↓)——将当前悬停/顶部命令插入聊天。
  • 在历史记录中搜索(默认 F)——切换搜索模式;激活时,当前聊天文本将用作筛选条件。

命令

所有命令均为客户端命令,仅影响你的本地历史记录。

  • /chp help
    显示包含所有子命令的简短帮助信息。

  • /chp clear
    清除当前配置的历史记录。

  • /chp reload
    从磁盘重新加载历史记录和设置(在手动编辑配置文件后很有用)。

  • /chp pin <command>
    固定一个命令,使其显示在列表顶部。自动补全来源于你的历史记录和已固定的命令。

  • /chp unpin <command>
    取消固定之前固定的命令。自动补全来源于已固定的命令。

  • /chp instantsend <true|false|toggle>
    启用 / 禁用 / 切换即时发送模式:

    • 开启时,左键点击条目(或使用快速插入快捷键)会立即发送命令。
    • 关闭时,命令只会插入聊天框。

数据存储

模组将其数据存储在:

  • config/command_history_plus/config.json —— 全局设置,以及可选的嵌入式配置。

配置与独立文件

以下选项控制历史记录的存储方式:

  • separateProfileFiles(默认:true)
    • true —— 每个配置存储在其独立的 JSON 文件中:
      • 单人世界:config/command_history_plus/singleplayer/<world>.json
      • 服务器:config/command_history_plus/servers/<address>.json
      • 其他配置(包括 global):config/command_history_plus/profiles/<id>.json
    • false —— 所有配置一起存储在 config.json 的 "profiles" 对象下(旧版模式,为向后兼容而保留)。

其他重要选项:

  • instantSend —— 是否启用即时发送。
  • historyLimit —— 每个配置的最大条目数(0 = 无限制)。

本地化

Command History Plus 目前提供以下语言的本地化:

  • 英语(en_us)
  • 俄语(ru_ru)
  • 西班牙语(西班牙)(es_es)
  • 西班牙语(墨西哥)(es_mx)
  • 葡萄牙语(巴西)(pt_br)
  • 德语(de_de)
  • 法语(fr_fr)

Minecraft 会自动选择与你的客户端设置匹配的语言。