rcon bot

bot de discord.py orientado al hosteo de un server de minecraft, mediante la rcon

cómo usar

descargar

1. git clone https://github.com/retuci0/rcon-bot/ para clonar el repositorio
2. cd rcon-bot para cambiar de directorio al del bot
3. python -m venv .venv para crear un entorno virtual
4. source .venv/bin/activate (linux) o .\.venv\Scripts\activate (windows) para activar el entorno virtual
5. pip install -r requirements.txt para instalar requisitos
6. python bot.py para iniciar el bot

requisitos

python>=3.12

config

crea un archivo llamado config.yaml y rellénalo con esto, sustituyendo los datos necesarios:

discord:
  token: ""  # TOKEN DEL BOT (desde discord.dev)
  prefix: "!"  # prefijo de comandos (ej.: !abrir)
  admin_users: [806597513943056464,]  # usuarios que pueden usar !cerrar y !comando
  allowed_channels: ["general",]  # canales en los que funcionará el bot

server:
  directory: "/srv/minecraft/mc-server"  # directorio del server (path absoluto)
  file: "paper.jar"  # nombre del archivo .jar del server
  script: "/srv/minecraft/bot/start.sh"  # directorio del script de inicio (path absoluto del script start.sh que viene con el bot)
  session: "server"  # nombre de la sesión de tmux
  jvmargs: "-Xmx2G -Xms2G"  # args de la JVM
  inactivity_time: 300  # tiempo de inactividad para cerrar el server de manera automática, en segundos

rcon:
  host: "127.0.0.1"  # ip del server
  port: 25575  # puerto de la rcon
  password: "CONTRASEÑA_RCON"  # contraseña de la rcon

tras hacer un cambio en la config., recuerda reiniciar el bot

server

configura lo siguiente en server.properties:

enable-rcon=true
rcon.password=CONTRASEÑA_RCON
rcon.port=25575

acceder a la consola

una vez iniciado el server, puedes acceder a la consola ejecutando tmux attach -t server, reemplazando server por el nombre dado a la sesión en config.yaml

comandos

• !abrir: abre el server
• !cerrar: cierra el server
• !estado: muestra el estado del server (abierto | cerrado, jugadores en línea, tps)
• !ip: muestra la ip pública del server y los puertos
• !comando ...: ejecuta un comando en el server
• !recargar: recarga la configuración, para aplicar cambios sin la necesidad de reiniciar el bot