Smart Completion

Потому что печатать — слишком утомительно

📖 О моде

Клиентский мод, который делает подсказки автодополнения команд удобнее.

Поддерживает команды из модов, а также кастомные команды из датапаков и серверных плагинов, при этом на сервере мод не нужен.

💡 Использование

Чтобы ввести команду или аргумент, состоящий из нескольких слов, наберите только несколько первых букв этих слов.

Например, если вы хотите ввести /gamerule doDaylightCycle true, можно набрать /gr dc t.

⌨ Горячие клавиши

Помимо `, принять подсказку можно через +` — при этом автоматически вставится пробел, чтобы сразу начать вводить следующий аргумент.

Кроме того, если текущая команда заведомо неполная (текст красный), нажатие `` примет выбранную подсказку, если она есть, вместо попытки выполнить неверную команду.

По умолчанию принятие подсказки через `+` или средней кнопкой мыши также стирает оставшийся текст после курсора — на случай, если вы решите отредактировать более ранний аргумент. Это поведение настраивается отдельно для каждой клавиши и кнопки мыши.

🔀 Различение подсказок

Чтобы выбрать между похожими подсказками, иногда нужно ввести больше одной буквы на слово.

Например, чтобы ввести fireDamage вместо fallDamage, которая появляется первой при вводе fd, можно набрать fid.

В целом набрать пару лишних букв, чтобы нужная подсказка оказалась в начале списка, гораздо быстрее, чем выбирать её стрелками или перебирать через `` — ввод запоминается на уровне мышечной памяти.

Со временем вы привыкнете к минимальному числу букв, нужному для ваших частых команд, и вводить их станет проще простого.

🔍 Просмотр подсказок

Поскольку набранные слова не обязаны стоять в начале названия, вы можете найти куда больше полезных подсказок, чем при обычной работе подсказок в Minecraft.

Например, если ввести /give @p wood, вы увидите подсказки для всех предметов, которые содержат слово, начинающееся с wood (например, oak_[wood]), а не только для предметов, чьё название само начинается с wood (например, [wood]en_axe).

Кроме того, если ваш запрос не совпадает ни с одними начальными буквами подсказки, мод также ищет совпадения в любом месте подсказок и выдаёт нечёткие совпадения, которые идут после умных. Это помогает, когда вы не знаете точно, что ищете.

🎁 Дополнительные возможности

По умолчанию мод также переворачивает порядок подсказок, чтобы самая подходящая была ближе всего к строке ввода — туда, куда вы и так смотрите.

Если это сбивает с толку, можно отключить командой:

/smartcompletion invert_suggestion_order false

Мод также не даёт мыши выбирать подсказки, когда они появляются под курсором — старый баг, из-за которого вводить команды в маленьких окнах сложнее, чем нужно.

✨ Как это работает?

Для каждой вводимой команды мы запрашиваем у сервера подсказки дважды. Один раз — опуская всё, что вы набрали для последнего аргумента (слепой запрос), и ещё раз — включая всё для гарантии (информированный запрос). В большинстве случаев отправляется только один запрос, так как мы также кэшируем запросы во время ввода, чтобы снизить задержку и мерцание списка подсказок.

Тогда мы исходим из того, что сервер ответит на слепой запрос всеми возможными вариантами, а умную фильтрацию и сортировку этих вариантов выполним на стороне клиента.

Если в списке с подсказками окажутся неожиданные варианты, которые не совпали с нашим фильтром, они тоже будут показаны другим цветом, так что ты никогда не пропустишь ни одну подсказку от потенциально сложных команд, которые предоставляют свои собственные умные подсказки.

Для фильтрации подсказок мы используем два подхода:

• Умное сопоставление между фрагментами твоего запроса и начальными буквами частей подсказки (gr совпадает с [g]ame[r]ule) (так работает автодополнение в любом редакторе кода)
• Слабый поиск каждой части твоего запроса внутри подсказки (lock on совпадает с b(lock)Explosi(on)DropDecay) (полезно, когда не знаешь, что именно ищешь)

✂ Как разбиваются слова?

Мы разбиваем слова по любому неалфавитному символу, а также по словам в camelCase.

Кроме того, если команду нельзя разбить таким образом, мы предполагаем, что она написана в flatcase, как большинство команд Minecraft.

К сожалению, без словаря систематически разбить flatcase невозможно. Поэтому используется небольшой словарь слов, применяемых в командах Minecraft, Fabric, [Neo]Forge и WorldEdit, чтобы попытаться разбить команды на слова.

Этот словарь можно переопределить ресурспаками (см. wiki), но не стесняйся сообщать о любых проблемах со словами, которые разбиваются неправильно.

📋 Как сортируются подсказки?

Подсказки сортируются по следующим критериям, в порядке применения:

1. Подсказки ближе к курсору показываются первыми (/give @p chest предлагает [ перед minecart_chest)
2. Совпадения по начальным буквам слов показываются перед запасными совпадениями ([d]oWeather[C]ycle > sen[dC]ommandFeedback)
3. Значимые совпадения сверх некоторых порогов показываются первыми ([app]le > [a]cacia_[p]ressure_[p]late)
4. Совпадения с большим числом начальных совпадений показываются первыми ([d]o[I]nsomnia > [di]sableRaids)
5. Совпадения, где некоторые начальные буквы могли совпасть более чем с одним словом, показываются первыми ([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) и неожиданные подсказки от сервера подсвечиваются тёмно-бирюзовым.

Кроме того, если подсказка начинается с префикса из слов, за которым следует двоеточие (то есть пространство имён resource location), он будет подсвечен тёмно-серым, если не совпал ({minecraft:}[g]olden_[ap]ple).

❓ Помощь

У этого мода есть вики, которую вы можете посмотреть.

Также, если у вас возникли проблемы или вы просто хотите сказать привет, заходите на наш Discord-сервер.

🤝 Поддержать проект

Если вы хотите поддержать этот проект, поделитесь им с друзьями!