https://github.com/0n1udra/slime_server

Control Minecraft server and more with Python Discord bot.
https://github.com/0n1udra/slime_server

discord-bot discord-bots discord-minecraft-bot discord-minecraft-integration discord-py discord-py-bot discord-python-bot discordapp discordbot minecraft minecraft-discord minecraft-discord-bot minecraft-server python python-3 python-minecraft python-minecraft-bot python3 rcon tmux

Last synced: 3 days ago
JSON representation

Control Minecraft server and more with Python Discord bot.

• Host: GitHub
• URL: https://github.com/0n1udra/slime_server
• Owner: 0n1udra
• License: gpl-3.0
• Created: 2020-09-13T20:07:58.000Z (about 4 years ago)
• Default Branch: master
• Last Pushed: 2024-08-20T03:57:26.000Z (about 1 month ago)
• Last Synced: 2024-09-26T01:41:06.477Z (8 days ago)
• Topics: discord-bot, discord-bots, discord-minecraft-bot, discord-minecraft-integration, discord-py, discord-py-bot, discord-python-bot, discordapp, discordbot, minecraft, minecraft-discord, minecraft-discord-bot, minecraft-server, python, python-3, python-minecraft, python-minecraft-bot, python3, rcon, tmux
• Language: Python
• Homepage:
• Size: 2.43 MB
• Stars: 68
• Watchers: 4
• Forks: 20
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
## Control Minecraft server with Discord bot.  

- Configure depending on if bot is on the same computer as server, or using RCON for remote control.  

- Interface with server using RCON, Tmux/Screen or subprocess. Some features are disabled if using RCON or Subprocess.  

  - NOTE: Some features will not work if on Windows, you can use something like [WSL](https://learn.microsoft.com/en-us/windows/wsl/install).  

  - Optionally run the bot and server inside the same or different Tmux/Screen sessions.  

  - The bot can use Tmux/Screen to send commands to the server, or use the Python subprocess module to run and manage the server.  

  - Some features depend on if you have read/write access to server files (server.jar, logs, property files, etc).  

  - If using Tmux/Screen or subprocess to control the server, the bot has to send a `xp` command with a randomly generated number so the bot can read the output properly.  

    - NOTE: This is disabled when using RCON.  

    - If you have better ways so it doesn't clog up the logs, lmk!  

- Basic commands: say, kick, teleport, save, weather, and gamemode.  

- Show connection history, chat log, online players, banned, OP list, and whitelist.  

- World save backup and restore system. Also has server folder backup/restore feature. These features need direct access to server files.  

- Server autosave, start, stop, status, version, log, update server.jar (only with Vanilla or PaperMC), and edit server.properties.  

---

- Join Discord server for bot help: https://discord.gg/s58XgzhE3U

- See releases (may not have latest code): https://github.com/0n1udra/slime_server/releases  

- Download latest commit (.zip): https://github.com/0n1udra/slime_server/archive/refs/heads/master.zip

- Jump to: [Guide](#setup), [Screenshots](#screenshots), [Support me](#support-me)  

### TODO List

- Discord user and role specific permissions for certain commands and/or command groups.

- Be able to setup and change bot and server settings without having to edit user_config.json file.

- Show command usage for more commands.

 

### Requirements

- [Python 3.8+](https://www.python.org/)

- [Java 64bit](https://www.java.com/en/download/linux_manual.jsp) (If bot starting Minecraft server)

- [Tmux](https://github.com/tmux/tmux/wiki)/[Screen](https://www.gnu.org/software/screen/) (Optional)

- [WSL](https://docs.microsoft.com/en-us/windows/wsl/install-win10) (Optional if on Windows)

### Python Modules

- [discord.py 2.0](https://github.com/Rapptz/discord.py)

- [asyncio](https://docs.python.org/3/library/asyncio.html)

- [file-read-backwards](https://pypi.org/project/file-read-backwards/) (Needed for reading server log file (for now))

- [mctools](https://pypi.org/project/mctools/) (If using RCON)

- [subprocess](https://docs.python.org/3/library/subprocess.html), [requests](https://pypi.org/project/requests/), [datetime](https://docs.python.org/3/library/datetime.html), [fileinput](https://docs.python.org/3.9/library/fileinput.html), [random](https://docs.python.org/3/library/random.html), [gzip](https://docs.python.org/3/library/gzip.html), [json](https://docs.python.org/3/library/json.html), [csv](https://docs.python.org/3/library/csv.html), [sys](https://docs.python.org/3/library/sys.html), [os](https://docs.python.org/3/library/os.html), [re](https://docs.python.org/3/library/re.html)

- [beautifulsoup4](https://pypi.org/project/beautifulsoup4/) (For `?serverupdate` feature)

# Setup

1. Create Discord bot in Discord Developer Portal. Scroll down for instructions or click [here](#create-discord-bot)  

3. Setup Python venv (if using) and install libraries. Scroll down for instructions or click [here](#using-virtualenv-or-venv).  

4. Update settings by editing `user_config.json` variables. Scroll down for more or click [here](#user-configs)  

    - NOTE: JSON file uses double quotes for strings.  

    - Also, Do NOT edit the `example` server config entry.  

5. Run `python3 run_bot.py help`, shows commands to setup tmux and/or run bot.

  - `python3 run_bot.py makefolders` - Create required folders if starting from scratch.

  - `python3 run_bot.py startbot` - Starts bot.

  - `python3 run_bot.py attachbot` - Attach to tmux/screen if using.

  - `python3 run_bot.py startbot attachtmux`

6. Use `?setchannel` or `?sc` command to set channel id. This is optional, any command issued to the bot will update the channel_id, however you may not see an output for that command until reissued.

7. Read through the help pages with `?help` or `?help2` in Discord.

8. Optionals:

  - Use `?serverscan` command to add servers you manually put in the 'servers' folder.

  - You can use `?update` to download latest .jar file (Downloads latest PaperMC by default, more details in `slime_vars.py` comments, line 63)

### Commands  

- `?help`, `?help2` - Help pages. First one is my custom embed layout, second one is default discord.py format.  

- `?start`, `?stop`, `?restart` - Start/stop Minecraft server.  

- `?check` - Check if server is online, and if console is reachable, if able.  

- `?status` - Server information: status, version, motd, address/IP, players online, etc.  

- `?players` - Show names of online players.  

- `?playerpanel` - Common bot commands and functionality using discord.py components.  

- `?teleportpanel` - Easy to use teleport panel. Includes return button to return teleported player to previous position.  

- `?playerlocate` - Get xyz coords of player.   

- `?serverproperties` - Show or edit properties in server.properties file.  

- `?worldbackup`, `?worldrestore`, `?serverbackup`, `?serverrestore` - Manage world and server backups.  

- `?serverlog`, `?chatlog`, `?connectionlog`, `?botlog` - Show logs for: server, just player chats, server connections and bot.  

- `?update` - Update server .jar file.   

  - The bot checks the server name and description configs to determine what flavor of server to get.  

    E.g. If `papermc` is in the server description, it'll get the latest PaperMC jar from official site.  

  - Currently working: vanilla, papermc  

- `?botupdate` - Uses Git CLI to pull the latest update from Master branch.   

   Note: Will not work if there's local changes. Either stash them or use `git restore .` in source folder.  

### User Configs

#### File Structure:

- Either use `python3 run_bot.py makefolders` to create these folders or create your own and update the paths in configs.  

  - Above command will create `Games` folder in your home directory if it doesn't exist. Then `Minecraft`, `servers`, `world_backups`, and `server_backups` inside.   

  

Example folder structure:

```

Home (home_path, e.g. ~/ or C:\Users\0n1udra)

└─ Games

    └─ Minecraft (mc_path)

       ├─ servers (servers_path)

       │  ├─ papernc (server_path, e.g. ~/Games/Minecraft/servers/papermc)

       │  │  └─ server.jar

       │  └─ vanilla

       │     └─ server.jar

       ├─ server_backups

       │  ├─ papermc (server_backups_path)

       │  └─ vanilla

       └─ world_backups

          ├─ papermc (world_backups_path)

          └─ vanilla

 ```

#### Bot Configs:  

- `use_pyenv`, `pyenv_activate_command` - If using python virtual environment.  

- `bot_launch_command` - Set custom arguments when launching bot.  

- `show_sensitive_info` - Show or hide sensitive info in launch banner.  

- `disabled_commands` - Disable specific commands. Must put original command name not aliases if you want to completely disable it.  

- `bot_token_filepath` - Path to Discord token file.  

- `command_prefix`, `case_insensitive` - Discord command prefix, and command case insensitivity.  

- `players_custom_status`, `custom_status_interval` - Show players online and server ping in bot's custom status section.  

  - `use_custom_ping_address`, `custom_ping_address` - Set a custom address for the ping section.  

- `bot_use_tmux`, `bot_tmux_name`, `bot_tmux_pane` - Run bot in a Tmux session. 

  - NOTE: Set `bot_tmux_name` and `server_tmux_name` to the same to run them both in the same session.

    currently only supports the bot and one Minecraft server.  

- `bot_use_screen`, `bot_screen_name` - Run bot in a Screen session.  

- `home_path`, `bot_source_path`, `mc_path`, `servers_path` - Used for setting default configs for bot and servers.  

- `user_config_filepath`, `bot_log_filepath` - Miscellaneous variables needed for bot.  

- `windows_compatibility` - Bot will automatically detect if running on Windows system.

  This is Needed to adapt some commands to work for Windows, like starting Minecraft server.  

- `windows_cmdline_start` - Bot will prefix this to `server_launch_command` to start server.  

- `selected_server`, `init` - More miscellaneous configs needed for bot functionality.   

 

#### Server Configs:

- `server_name`, `server_description`, `server_version` - Basic server info.  

  - NOTE: Bot will try to detect server version. If it doesn't work, you can set it manually. however, it might be overridden by the bot if it successfully detects a version.  

- `server_address`, `server_port` - Server domain/IP and port. Not needed, but some features may not work properly.  

- `server_use_essentialsx` - EssentialX plugin compatibility.   

  - NOTE: Bot will use `pong` command instead of `xp`. See `status_checker_command` below for more.  

- `server_files_access` - If you are running the bot on the same system as the server, and it can access server files.  

  - Needed for some features like world/server backup and restore, editing server.properties file, etc.  

- `server_use_rcon`, `rcon_pass`, `rcon_port` - RCON configs. Uses `server_address`.  

- `server_use_tmux`, `server_tmux_name`, `server_tmux_pane` - Run server in a Tmux session.  

- `server_use_screen`, `server_screen_name` - Run server using Screen.  

- `server_use_subprocess` - Run server using Python's subprocess module.  

  - NOTE: The server will stop if the bot process is interrupted or killed.  

- `server_launch_command` - Command used to start server. 

- `server_launch_path` - Optionally set a custom path to the server executable (usually a `.jar` file).  

- `startup_wait_time` - This is just used to send a Discord message notifying how long the server takes to start.  

- `save_world_wait_time` - Set how long it takes for the server to save the world after sending a `save-all` command.  

- `check_before_command` - Only used if `server_files_access` is true. Sends a command to the server to check if it's reachable before sending actual command.  

  - NOTE: This will clog your logs up. However, disabling this will mean the bot will not be sure if the server is reachable and if commands issued were successful or not.

  - `status_checker_command"` - The command that will be sent to server with a random number, then bot will check server logs to see if it was received.

  E.g. `xp 0.123463246`.

- `command_buffer_time` - The time it takes for the server to run commands. Change this if your server is slower.  

- `enable_autosave`, `autosave_interval` - Send `save-all` command at specified minutes interval.  

- `log_lines_limit` - Set limit to how many log lines bot can read for some commands, like `?chatlog`.  

- `server_path`, `world_backups_path`, `server_backups_path`, `server_logs_path`, `server_log_filepath`, `server_properties_filepath` - Bot will automatically set these based on `mc_path`. 

  You can manually update them.  

- `world_folders` - Specify what world folders to backup.  

- `useful_websites` - For `?links` command, which shows a Discord embed of these links.  

- `server_ip` - Bot will automatically set this if `server_address` is set.  

  

### Create Discord bot

  1. Go to: https://discord.com/developers/applications.  

  2. Create New App:  

       

  2. Go to OAUTH > URL Generator section to create invite link for the bot:   

       

  Set the permissions:  

      

  Invite bot to your server:  

       

  3. Go to Bot section and get the token if you haven't already:  

      

  4. While in the Bot section, scroll down and enable Message Content Intents:  

       

### Using Virtualenv or venv

Install Python3 venv:

```bash

sudo apt install python3-venv -y

```

Create Python Virtualenvt:

```bash

python -m venv ~/pyenvs/slime_server 

```

Activate new Python Virtualenv:

```bash

source ~/pyenvs/slime_server/bin/activate

```

Install required Python modules:

```bash

pip install -r requirements.txt

```

# Screenshots

  

  

   

# Support me

- PayPal [@dxzt](https://www.paypal.me/dxzt)  

- Venmo [@dxzt550](https://venmo.com/u/dxzt550)  

- Cash App [$DXZT550](https://cash.app/$DXZT550)