Smart Completion

模组

· 作者 endorh

Minecraft 命令的 Better Completion

6 本站下载 0 关注 更新于 1 个月前

最新 3.0.0 · 26.3 · Fabric

一键开服(送7天)

因为打字太费劲了

? 简介

提供更好命令自动补全建议的客户端模组。

支持来自数据包或服务端插件的模组化与自定义命令,且无需在服务端安装即可生效。

? 用法

若要输入由多个单词组成的命令/参数,只需键入其单词的部分首字母。

例如,如果你想输入 /gamerule doDaylightCycle true,可以输入 /gr dc t。

Typing `/gr dc t` results in `/gamerule doDaylightCycle true`

⌨ 快捷键

除了 <Tab>,你还可以使用 <Ctrl>+<Space> 来接受建议,它会自动插入一个空格,以便你开始输入下一个参数。

此外,如果当前命令已知是不完整的(你的文本显示为红色),按下 <Enter> 将接受选中的建议(如果有),而不是尝试执行无效的命令。

默认情况下,使用 <Ctrl>+<Space> 接受建议或通过中键点击也会清除光标后的剩余文本,如果你决定稍后编辑前面的参数。此行为可以按按键/鼠标按钮进行配置。

? 区分建议

为了在建议之间进行区分,你可能需要为每个单词输入多个字母。

例如,要输入 fireDamage 而不是 fallDamage(在输入 fd 时首先出现),你可以输入 fid。

通过输入更多字母来区分 `[f]all[D]amage` 和 `[f]ire[D]amage`

通常,多输入几个字母以获取你想要的建议排在列表前面,比使用箭头键或使用 <Tab> 循环选择要快得多,因为打字可以形成肌肉记忆。

随着时间的推移,你会习惯输入最少量的字母来打出你经常使用的命令,并且打起来会非常顺畅。

? 浏览建议

由于你输入的单词不需要位于你正在输入的名称的开头,与 Minecraft 建议通常的工作方式相比,你可能会发现更多有用的建议。

例如,如果你输入 /give @p wood,你将看到所有包含以 wood 开头的单词的物品建议(例如 oak_[wood]),而不仅仅是名称本身以 wood 开头的物品(例如 [wood]en_axe)。

当玩家输入 `/give @p wood` 时提供的建议

此外,如果你的查询不匹配建议的任何首字母,它还会在建议中的任意位置查找以提供模糊匹配,这些匹配列在智能匹配之后。当你不确定自己在寻找什么时,这很有帮助。

? 额外功能

该模组还默认反转建议的顺序,因此最相关的建议是离输入栏最近且你的眼睛已经看向的位置。

如果你觉得这太令人困惑,可以使用以下命令禁用它:

/smartcompletion invert_suggestion_order false

它还防止鼠标在选择出现在其下方的建议时进行选择,这是一个旧 bug,使得在小窗口中输入命令变得比实际需要更困难。

✨ 它是如何工作的?

对于你输入的每个命令,我们向服务器请求建议两次。一次省略你为最后一个参数输入的内容(盲查),另一次包括所有内容作为保证(知情查询)。大多数时候,只发送一个请求,因为我们还在你输入时缓存请求以减少延迟和建议列表的闪烁。

然后,我们假设服务器将回复盲查的所有可能建议,并在客户端对建议进行智能过滤和排序。

如果在知情列表中有任何未被我们过滤匹配的意外建议,它们也将以不同的颜色显示,这样你永远不会错过任何潜在复杂命令提供的智能建议。

为了过滤建议,我们使用两种方法:

  • 查询片段与建议部分的 initials 之间的智能匹配(gr 匹配 [g]ame[r]ule)(任何代码编辑器中的补全工作方式)
  • 在建议内对查询的每个部分进行弱搜索(lock on 匹配 b(lock)Explosi(on)DropDecay)(当你不知道自己在寻找什么时很有用)

✂ 单词是如何分割的?

我们在任何非字母字符以及 camelCase 单词处分割单词。

此外,如果命令无法以这种方式分割,我们将假设它以 flatcase 书写,就像大多数 Minecraft 命令一样。

不幸的是,除非你有字典,否则系统地分解 flatcase 是不可能的。这就是为什么我们使用一个小词典,其中包含 Minecraft、Fabric、[Neo]Forge 和 WorldEdit 命令中使用的单词,试图将命令分解为单词。

这个词典可以通过资源包覆盖(参见 wiki),但请随时报告任何单词未正确分割的问题。

? 建议是如何排序的?

建议根据以下标准排序, whichever applies first:

  1. 靠近光标的建议首先显示(/give @p chest 建议 [ 在 minecart_chest 之前)

  2. 单词 initials 的匹配先于后备匹配显示([d]oWeather[C]ycle > sen[dC]ommandFeedback)

  3. 超出某些阈值的显著匹配首先显示([app]le > [a]cacia_[p]ressure_[p]late)

  4. 更多初始匹配的匹配首先显示([d]o[I]nsomnia > [di]sableRaids)

  5. 某些 initials 可能匹配多于一个单词的匹配首先显示([d]o(D)aylight[C]ycle > [d]oWeather[C]ycle)

  6. 单词更少的建议首先显示([d]o[I]nsomnia > [d]o[I]mmediateRespawn)

  7. 更接近建议开头的匹配首先显示([g]ame[m]ode > default[g]ame[m]ode)

  8. 较短的建议首先显示([t]p > [t]ell)

  9. 否则,建议按照服务器提供的原始顺序显示(通常是字母顺序)([f]all[D]amage > [f]ire[D]amage)。

目前,无法自定义此顺序。如果您有任何改进建议,请告诉我。这些排序标准背后的逻辑是匹配自然预期,并通过直接输入更多首字母来实现冲突消歧。

? 自定义

建议会根据 style.json 文件中定义的样式进行高亮显示,这些样式可以被 资源包覆盖(参见 wiki)。

默认情况下,建议内的 匹配部分(如 [g]ame[r]ule)以 蓝色 高亮显示。

查询部分的 备选匹配(如 [d]o(D)aylight[C]ycle)、回退匹配(如 sen[dC]ommandFeedback)以及 意外的服务器建议 均以 深青色 高亮显示。

此外,如果建议以 词前缀 开头并 后跟冒号(即 资源位置命名空间),它将以 深灰色 高亮显示,除非被匹配到(如 {minecraft:}[g]olden_[ap]ple)。

❓ 帮助

本模组有一个 wiki,您可以前往查看。

另外,如果您遇到任何问题,或者只是想打个招呼,欢迎随时加入我们的 Discord Server。

? 支持本项目

如果您想支持本项目,请与您的朋友们分享!

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源