Minecraft RCON Client

A simple command-line tool to manage your Minecraft server via RCON protocol. Optional AI-powered command generation available.

Installation

Option 1: Download Executable

Grab the latest executable for your OS from Releases:

• Windows: rcon_client.exe
• macOS: rcon_client.dmg
• Linux: Build from source

Run and you're done.

Option 2: Build from Source

Requires Python 3.8+.

pip install -r requirements.txt
python src/rcon_client.py

To build an executable yourself:

pip install pyinstaller
pyinstaller --onefile --name rcon_client src/rcon_client.py
# Executable will be in dist/

Getting Started

1. Run the app
2. Enter your Minecraft server host, port, and RCON password
3. You're connected

Commands

Basic RCON (All You Need)

Type any Minecraft command. The tool automatically adds / if you forget it.

> say Hello everyone
> list
> weather clear
> gamemode survival @a

Optional: LLM Features

The AI command generation is completely optional. Use it if you want, skip it if you don't.

To enable: set your OpenRouter API key with /apikey <key>, then pick a model with /models.

Then you can use:

• /ask <query> - Ask a question
• /cmd <query> - Get a command suggestion
• /exc DANGER <query> - Generate and run a command

OpenRouter API Key

Only needed if you want to use LLM features.

1. Go to https://openrouter.ai/settings/keys
2. Generate a new API key
3. Use /apikey <your-key> in the app

Keys are valid for 30 days.

Secure Key Storage

Your API key is stored securely using your operating system's credential manager:

• Windows: Credential Manager
• macOS: Keychain
• Linux: Secret Service

The key is encrypted and tied to your user account. It's not stored in plain text.

Data Privacy with OpenRouter

When you use OpenRouter's free or paid models, be aware:

• Your prompts and the AI's responses may be used for training or analytics by OpenRouter
• OpenRouter's privacy policy: https://openrouter.ai/privacy
• Avoid sending personal information, server passwords, or sensitive data through the LLM
• The RCON password you use locally is never sent to OpenRouter
• Only your LLM queries and responses are transmitted

Important: RCON is Dangerous

RCON gives direct access to execute any command on your server. Be careful:

• Only give RCON access to trusted people
• Never share your RCON password
• The /exc DANGER command requires explicit typing - think before you use it
• Always understand what command you're about to run

This tool does not prevent you from running destructive commands. You are responsible for what you execute.

Commands Reference

• /clear - Clear screen and show help
• /apikey <key> - Set and save your OpenRouter key (optional)
• /models - Pick a free LLM model (optional)
• /ask <query> - Get a text response (optional)
• /cmd <query> - Generate a command suggestion (optional)
• /exc DANGER <query> - Generate and execute a command (optional)
• quit or /exit - Exit the app

The LLM commands are all optional. Basic RCON works without them.

Troubleshooting

• Connection refused - Check host, port, RCON password, and that RCON is enabled on your server.
• No models found - Check internet connection and that your OpenRouter key is valid.
• Key expired - API keys expire after 30 days. Run /apikey <new-key> to refresh.