Enabling RCON

Configure RCON on your Minecraft server so CubeAdmin can send commands.

What is RCON?

RCON (Remote Console) is a protocol built into Minecraft that allows external tools to send commands to the server over a TCP connection. CubeAdmin uses RCON for:

  • Player management (ban, kick, whitelist add/remove)
  • Executing commands from the in-app console
  • Running scheduled tasks via the cron scheduler

Without RCON, the live console (output streaming) still works, but command execution, player management, and the scheduler will not function.

Configuring server.properties

Open server.properties in your Minecraft server directory and add or update these lines:

enable-rcon=true
rcon.port=25575
rcon.password=your-strong-password-here
broadcast-rcon-to-ops=false

Restart the Minecraft server after saving the file. The changes take effect on the next boot.

Configuring CubeAdmin

Set these environment variables in your .env / .env.local:

MC_RCON_HOST=127.0.0.1      # Use "minecraft" in Docker Compose
MC_RCON_PORT=25575
MC_RCON_PASSWORD=your-strong-password-here

The password must exactly match the one in server.properties.

Security

  • Never expose port 25575 to the public internet. RCON gives full server control with no rate limiting. Bind it to 127.0.0.1 or use a private Docker network.
  • Use a strong, random password — at least 16 characters.
  • Set broadcast-rcon-to-ops=false so RCON commands are not visible to ops in-game.

Docker Compose

In the provided docker-compose.yml, the Minecraft container and CubeAdmin share a private Docker network (cubeadmin_net). Set MC_RCON_HOST=minecraft to reach the Minecraft container by its service name. The RCON port is not exposed to the host.

Activer RCON

Configurez RCON sur votre serveur Minecraft pour que CubeAdmin puisse envoyer des commandes.

Qu'est-ce que RCON ?

RCON (Remote Console) est un protocole intégré à Minecraft permettant à des outils externes d'envoyer des commandes au serveur via une connexion TCP. CubeAdmin utilise RCON pour :

  • La gestion des joueurs (ban, kick, whitelist)
  • L'exécution de commandes depuis la console intégrée
  • L'exécution de tâches planifiées via le planificateur cron

Sans RCON, le streaming de la console fonctionne toujours, mais l'exécution de commandes, la gestion des joueurs et le planificateur ne fonctionneront pas.

Configurer server.properties

Ouvrez server.properties dans le répertoire de votre serveur Minecraft et ajoutez ou modifiez ces lignes :

enable-rcon=true
rcon.port=25575
rcon.password=votre-mot-de-passe-fort
broadcast-rcon-to-ops=false

Redémarrez le serveur Minecraft après avoir sauvegardé le fichier. Les modifications prennent effet au prochain démarrage.

Configurer CubeAdmin

Définissez ces variables d'environnement dans votre .env / .env.local :

MC_RCON_HOST=127.0.0.1      # Utilisez "minecraft" dans Docker Compose
MC_RCON_PORT=25575
MC_RCON_PASSWORD=votre-mot-de-passe-fort

Le mot de passe doit correspondre exactement à celui dans server.properties.

Sécurité

  • N'exposez jamais le port 25575 sur internet. RCON donne un contrôle total du serveur sans limitation de débit. Liez-le à 127.0.0.1 ou utilisez un réseau Docker privé.
  • Utilisez un mot de passe fort et aléatoire — au moins 16 caractères.
  • Définissez broadcast-rcon-to-ops=false pour que les commandes RCON ne soient pas visibles des ops en jeu.

Docker Compose

Dans le docker-compose.yml fourni, le conteneur Minecraft et CubeAdmin partagent un réseau Docker privé (cubeadmin_net). Définissez MC_RCON_HOST=minecraft pour atteindre le conteneur Minecraft par son nom de service. Le port RCON n'est pas exposé à l'hôte.