RconCli
A command-line interface for executing RCON protocol queries on game servers like Counter-Strike, Minecraft, and Rust.
What is RconCli?
rcon-cli is a command-line interface tool that allows remote administration of game servers using the RCON protocol. It enables server operators to execute commands, check server status, and manage players from a terminal, supporting a wide range of popular games like Counter-Strike, Minecraft, and Rust. The tool solves the problem of needing a simple, scriptable way to interact with game servers without relying on in-game consoles or proprietary admin panels.
Game server administrators and hosting providers who manage multiple game servers and need a reliable, command-line based tool for remote administration and automation.
Developers choose rcon-cli for its broad game compatibility, straightforward configuration, and Docker support, making it a versatile and portable alternative to game-specific admin tools or custom scripts.
Overview
RCON client for executing queries on game server.
Use Cases
Best For
- Remotely managing Counter-Strike: Global Offensive or Team Fortress 2 server commands
- Automating administrative tasks on Minecraft or Rust servers via scripts
- Managing multiple game servers from a single configuration file
- Running game server commands in Dockerized environments
- Quickly checking server status or player lists without logging into the game
- Supporting different RCON protocol variants (standard, web, telnet) for various games
Not Ideal For
- Administrators who require a graphical user interface or web-based dashboard for server management
- Projects that need to manage game servers without RCON protocol support or using proprietary admin systems
- Teams needing advanced automation features like scheduled tasks or integration with monitoring tools
- Environments where server credentials must be stored centrally in a secure vault, not local files
Pros & Cons
Pros
Supports over 10 popular games including CS:GO, Minecraft, and Rust, with specific usage examples listed in the README for each.
Handles standard RCON, web RCON (for Rust), and telnet protocols, as detailed in the usage section with -t flag examples for different games.
Uses a YAML configuration file to store multiple server settings, enabling easy environment switching with the -e flag, as shown in the configuration examples.
Available as a Docker image with usage instructions, facilitating consistent deployment and execution across various environments.
Optional logging of requests and responses to files, useful for auditing and troubleshooting, as mentioned in the configuration file documentation.
Cons
Requires manual specification of connection types (e.g., -t telnet or -t web) for certain games, which can lead to setup errors and confusion for new users.
Lacks built-in scripting or scheduling capabilities, forcing reliance on external tools for complex automation workflows beyond basic command execution.
Stores server passwords in plain YAML files, posing security risks in shared or untrusted environments without encryption or integration with secret managers.
Frequently Asked Questions
Related Projects
RetromA centralized game library/collection management service with a focus on emulation
LinuxGSMCLI tool for deployment and management of dedicated game servers on Linux: more than 120 games are supported. (Source Code) MIT Shell
Crafty ControllerMinecraft launcher and manager that allows users to start and administer Minecraft servers from a user-friendly interface. (Source Code) GPL-3.0 Docker/Python
auto-mcsCross-platform Minecraft server manager. (Source Code) AGPL-3.0 Python
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.