🚀 CommandSuggest-MCDR

English | 简体中文

✨ A More Elegant MCDR Command Completion

This plugin requires the use of the McdrCmdSuggest server-side mod.

CommandSuggest-MCDR is an MCDR plugin that provides a more elegant command completion feature for MCDReforged. By registering MCDR commands on the Minecraft server and sending them to the client, players can enjoy a native command completion experience.

🛠️ Features

• ⚡ Native command completion: Registers MCDR commands as native Minecraft commands, allowing silent execution of MCDR commands.
• 💡 Supports argument suggestion completion (the suggests method in MCDR plugins).
• 🖥️ Pure server-side mod: No client installation required, compatible with vanilla clients.
• 🛡️ Does not rely on mixins, making it easier to maintain across multiple versions, with full support for official versions 1.14 ~ 1.21.8.
• ⚙️ Fully automatic default configuration: Works out of the box without manual setup.

📦 Installation

1. Download the latest version of McdrCmdSuggest from Modrinth or GitHub Releases.
2. Place the downloaded jar file into the mods folder of your Minecraft server.
3. Install this plugin on the server using !!MCDR plugin install command_suggest.
4. Restart the server.

⚙️ Configuration

Configuration Item	Description	Default Value
mode	Communication mode, currently only supports http	http
host	Host address for the HTTP server to listen on	localhost
port	Port number for the HTTP server to listen on; set to 0 to auto-select an available port	0

📝 Usage

Enter existing MCDR commands in the standard Minecraft command format starting with /, then use the Tab key in-game for command completion. For example, /!!help, /!!MCDR xxx (no need to configure other plugins or modify plugin code).

🔍 Comparison with Other Mods

Compared to other MCDR command completion mods, McdrCmdSuggest offers the following advantages:

• More elegant implementation: Directly utilizes Minecraft's native command system for a smoother user experience.
• More comprehensive features: Supports argument suggestion completion, suitable for more complex command structures.
• Better compatibility: MCDR commands can be completed even if they don't start with "!" or "!!", compatible with more plugins.
• Fewer dependencies: No mixin dependency, reducing potential maintenance costs, and no client mod required.

🧩 Technical Details

McdrCmdSuggest implements command completion as follows:

1. Registers a special command __mcdrcmdsuggest_register to receive command registration information from the server.
2. Dynamically registers Minecraft commands based on the received information.
3. If a command includes argument suggestions (suggests), a suggests method is added to query the corresponding MCDR plugin for suggestions (uses HTTP by default, only local communication between server and MCDR, no need to expose ports). Client suggestions are transmitted via Minecraft's native protocol.

🤝 Contributing

Issues and feature requests are welcome!

🙏 Acknowledgements

• MCDReforged - Powerful Minecraft server management framework.
• ZhuRuoLing/MCDRCommandCompletionReforged-Mod - Provided reference implementation.
• AnzhiZhang/MCDRCommandFabric - Provided reference implementation.

📄 Statement

This mod heavily references the code and implementation of ZhuRuoLing/MCDRCommandCompletionReforged-Mod and AnzhiZhang/MCDRCommandFabric. Without their work, this mod would not have been possible.