5c7ab407d7
- add MAX_COMMAND_LENGTH to define maximum command length - print auth failed message to stderr instead of stdout - remove unused net_send() function - remove unused net_clean_incoming() function - rewrite net_send_packet() function - net_recv_packet(): change the type of variable "ret" from int to ssize_t - net_recv_packet(): fail immediately if the packet size is out of spec - packet_print(): rename variable "def_color" to "default_color" - packet_print(): remove unecessary casts - packet_build(): use MAX_COMMAND_LENGTH - packet_build(): be more explicit in calculation of packet.size - packet_build(): use memcpy() instead of strncpy() - cast second argument of send()/recv() calls to (char *) so Windows is happy - rcon_auth(): change the return type from int to bool - run_terminal_mode(): use MAX_COMMAND_LENGTH
mcrcon
mcrcon is console based Minecraft rcon client for remote administration and server maintenance scripts.
Installing
Binary releases
Pre-built binaries are provided for Linux and Windows: https://github.com/Tiiffi/mcrcon/releases/latest
Via package manager
See https://pkgs.org/download/mcrcon and https://repology.org/project/mcrcon/packages for available packages in various Linux distros (note that some packages might be outdated).
- Fedora: https://packages.fedoraproject.org/pkgs/mcrcon/mcrcon/
- Gentoo: https://packages.gentoo.org/packages/games-util/mcrcon
- Arch: https://aur.archlinux.org/packages/mcrcon/
- NixOS: https://search.nixos.org/packages?show=mcrcon
- Snapcraft: https://snapcraft.io/mcrcon-nsg
- Scoop: https://scoop.sh/#/apps?q=mcrcon
Building from sources
git clone https://github.com/Tiiffi/mcrcon.git
cd mcrcon
make
# install is optional
sudo make install
Check INSTALL.md for more details.
Usage
mcrcon [OPTIONS] [COMMANDS]
Sends rcon commands to Minecraft server.
Option:
-H Server address (default: localhost)
-P Port (default: 25575)
-p Rcon password
-t Terminal mode
-s Silent mode
-c Disable colors
-r Output raw packets
-w Wait for specified duration (seconds) between each command (1 - 600s)
-h Print usage
-v Version information
Server address, port and password can be set using following environment variables:
MCRCON_HOST
MCRCON_PORT
MCRCON_PASS
Notes:
- mcrcon will start in terminal mode if no commands are given
- Command-line options will override environment variables
- Rcon commands with spaces must be enclosed in quotes
Example:
Send three commands ("say", "save-all", "stop") and wait five seconds between the commands:
mcrcon -H my.minecraft.server -p password -w 5 "say Server is restarting!" save-all stop
How to enable rcon on a Minecraft Server
Enable rcon by adding following lines to server.properties configuration file.
enable-rcon=true
rcon.port=25575
rcon.password=your_rcon_pasword
Contact
- WWW: https://github.com/Tiiffi/mcrcon/
- MAIL: tiiffi+mcrcon at gmail
- ISSUES: https://github.com/Tiiffi/mcrcon/issues/
When reporting issues, please provide the following information:
- Version of mcrcon: Please specify the precise version number
- Game: Indicate the specific game server you're using (e.g., Minecraft, Valve Source Engine game, ARK, ...)
- Server version: Provide the exact version of the game server
- Mods and Extensions: List all mods and extensions used, including their versions
- Issue Description: Clearly describe the problem you're encountering and the expected behavior.
- Steps to reproduce
If you're tech-savvy, consider providing a packet capture file (PCAP). Remember to use a fake password.
License
This project is licensed under the zlib License - see the LICENSE file for details.