MCDR-Command-Suggestion

🚀 McdrCmdSuggest

✨ Более элегантное автодополнение команд MCDR

Для работы этого мода требуется плагин CommandSuggest.

McdrCmdSuggest — это мод для Fabric, который обеспечивает более элегантное автодополнение команд для MCDReforged. Регистрируя команды MCDR на сервере Minecraft и отправляя их клиенту, игроки получают нативное автодополнение команд.

🛠️ Возможности

• ⚡ Нативное автодополнение команд: регистрирует команды MCDR как нативные команды Minecraft, позволяя выполнять команды MCDR без вывода в чат.
• 💡 Поддержка автодополнения аргументов (метод suggests в плагинах MCDR).
• 🖥️ Чисто серверный мод: не требует установки на клиент, совместим с ванильными клиентами.
• 🛡️ Без зависимости от mixin: проще поддерживать на разных версиях.
• ⚙️ Полностью автоматическая конфигурация по умолчанию: работает из коробки без ручной настройки.

📦 Установка

1. Скачайте последнюю версию McdrCmdSuggest с Modrinth или GitHub Releases.
2. Поместите скачанный jar-файл в папку mods вашего сервера Minecraft.
3. Установите соответствующий плагин MCDR на сервере.
4. Перезапустите сервер.

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

Вводите существующие команды MCDR в стандартном формате команд Minecraft, начиная с /, затем используйте клавишу Tab в игре для автодополнения. Например, /!!help, /!!MCDR xxx (не нужно настраивать другие плагины или менять код плагинов).

🔍 Сравнение с другими модами

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

• Более элегантная реализация: напрямую использует нативную систему команд Minecraft для более плавного взаимодействия.
• Более полный функционал: поддерживает автодополнение аргументов, подходит для более сложных структур команд.
• Лучшая совместимость: команды MCDR дополняются, даже если они не начинаются с "!" или "!!", совместим с большим числом плагинов.
• Меньше зависимостей: без зависимости от mixin, что снижает затраты на поддержку, и не требует клиентского мода.

🧩 Технические детали

McdrCmdSuggest реализует автодополнение команд следующим образом:

1. Регистрирует специальную команду __mcdrcmdsuggest_register для получения информации о регистрации команд от сервера.
2. Динамически регистрирует команды Minecraft на основе полученной информации.
3. Если команда включает подсказки аргументов (suggests), добавляется метод suggests для запроса подсказок у соответствующего плагина MCDR (по умолчанию используется HTTP, только локальная связь между сервером и MCDR, порты открывать не нужно). Подсказки для клиента передаются через нативный протокол Minecraft.

🤝 Участие в разработке

Приветствуются сообщения о проблемах и предложения по функционалу!

🙏 Благодарности

• MCDReforged — мощный фреймворк для управления сервером Minecraft.
• ZhuRuoLing/MCDRCommandCompletionReforged-Mod — предоставил референсную реализацию.
• AnzhiZhang/MCDRCommandFabric — предоставил референсную реализацию.

📄 Заявление

Этот мод во многом опирается на код и реализацию ZhuRuoLing/MCDRCommandCompletionReforged-Mod и AnzhiZhang/MCDRCommandFabric. Без их работы этот мод был бы невозможен.

✨ Более элегантная реализация автодополнения команд MCDR

Требуется плагин CommandSuggest.

McdrCmdSuggest — это мод для Fabric, который обеспечивает более элегантное автодополнение команд для MCDReforged. Регистрируя команды MCDR на сервере Minecraft и отправляя их клиенту, игроки получают нативный опыт автодополнения команд.

🛠️ Возможности

• ⚡ Нативный опыт автодополнения: команды MCDR регистрируются как нативные команды Minecraft, что позволяет тихо отправлять команды MCDR
• 💡 Поддержка автодополнения аргументов (метод suggests в плагинах MCDR)
• 🖥️ Чисто серверный мод, клиенту устанавливать не нужно, поддерживаются ванильные клиенты
• 🛡️ Не зависит от mixins, проще поддерживать несколько версий
• ⚙️ Конфигурация по умолчанию полностью автоматическая, работает из коробки без ручной настройки

📦 Установка

1. Скачайте последнюю версию McdrCmdSuggest с Modrinth или GitHub Releases
2. Поместите скачанный jar-файл в папку mods сервера Minecraft
3. Установите на сервере соответствующий плагин MCDR
4. Перезапустите сервер

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

Вводите обычные команды MCDR в виде стандартных команд Minecraft, начинающихся с /, а затем используйте Tab в игре для автодополнения. Например, /!!help, /!!MCDR xxx (не требуется настраивать другие плагины или менять код плагинов).

🔍 Сравнение с другими модами

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

• Более элегантная реализация: напрямую использует нативную систему команд Minecraft, обеспечивая более плавный опыт
• Более полный функционал: поддерживает автодополнение аргументов, подходит для более сложных структур команд
• Лучшая совместимость: команды MCDR дополняются, даже если не начинаются с "!" или "!!", совместим с большим числом плагинов
• Меньше зависимостей: не зависит от mixins, снижает потенциальные затраты на поддержку, не требует клиентского мода

🧩 Технические детали

McdrCmdSuggest реализует автодополнение команд следующим образом:

1. Регистрирует специальную команду __mcdrcmdsuggest_register для приёма информации о регистрации команд, отправляемой сервером
2. На основе полученной информации динамически регистрирует команды Minecraft
3. Если команда содержит предложения аргументов (suggests), для неё добавляется метод suggests, запрашивающий результаты у сопутствующего плагина MCDR (по умолчанию используется http, связь только локальная между сервером и MCDR, порты наружу открывать не нужно), а предложения клиенту передаются по встроенному протоколу Minecraft

🤝 Вклад

Приветствуются сообщения о проблемах и запросы на новые функции!

🙏 Благодарности

• MCDReforged — мощный фреймворк для управления сервером Minecraft
• ZhuRuoLing/MCDRCommandCompletionReforged-Mod — предоставил референсную реализацию
• AnzhiZhang/MCDRCommandFabric — предоставил референсную реализацию

📄 Заявление

Этот мод во многом опирается на код и реализацию ZhuRuoLing/MCDRCommandCompletionReforged-Mod и AnzhiZhang/MCDRCommandFabric. Без их работы этот мод был бы невозможен.