Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/cfunkz/minecraft-discord-bot
Minecraft Discord Bot
https://github.com/cfunkz/minecraft-discord-bot
discord discord-bot discord-py discord-py-rewrite discord-python-bot discord-python-rewrite-bot mcrcon mcstatus mcstatusbot minecraft minecraft-bot minecraft-rcon python python3 rcon
Last synced: 23 days ago
JSON representation
Minecraft Discord Bot
- Host: GitHub
- URL: https://github.com/cfunkz/minecraft-discord-bot
- Owner: cfunkz
- Created: 2024-09-16T15:00:03.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2024-12-15T02:53:12.000Z (27 days ago)
- Last Synced: 2024-12-15T03:24:19.678Z (27 days ago)
- Topics: discord, discord-bot, discord-py, discord-py-rewrite, discord-python-bot, discord-python-rewrite-bot, mcrcon, mcstatus, mcstatusbot, minecraft, minecraft-bot, minecraft-rcon, python, python3, rcon
- Language: Python
- Homepage:
- Size: 48.8 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Minecraft RCON Bot
This bot allows managing Minecraft server using RCON through discord. App commands.
## Configuration
1. **Set up your environment variables:**
- Create a `.env` file in the same directory as `config.py`.
- Add the following entries with your specific details:
```env
DISCORD_TOKEN=discord_bot_token
IP=your_ip_or_domain # IP address of the Minecraft server
PORT=25565 # Port number of the Minecraft server
RCON_PASSWORD=your_rcon_password # Rcon password
RCON_PORT=25575 # Rcon Port
RCON_HOST=your_rcon_host # Rcon IP, same as server ip usually
```
2. **Optional:** If you do not want to use the `.env` file for any reason, you can hardcode the values directly in `config.py`.
3. **Admin Roles:**
- Admin roles are managed through `admin_roles.json` which is created upon bots first startup.
- Update this file to include the role IDs that should have admin or add them with `/role add`, `/role remove` and `/role view` commands in discord (Only allowed for users with moderation privileges on the given discord channel).
## Commands
### Admin Roles
- **/role add [role_id]** - Add a role ID to the list of admin roles.
- **/role add [role_id]** - Remove a role ID from the list of admin roles.
- **/role view** - View all admin role IDs.
### Server User Commands
- **/status** - Get the server status.
- **/banlist** - View the list of banned players.
- **/seed** - Get the world seed.
### Administration Commands
- **/give [item] [amount] [player]** - Give items to a player.
- **/xp [add|set|query] [player] [amount] [points|levels]** - Give experience points to a player.
- **/time [day|night|midnight|noon"]** - Set the time of day.
- **/weather [clear|rain|thunder]** - Set the weather.
- **/ban [player] [reason]** - Ban a player.
- **/unban [player]** - Unban a player.
- **/kick [player] [reason]** - Kick a player from the server.
- **/advancement [grant|revoke] [player] [advancement]** - Give an advancement to a player.
- **/difficulty [difficulty]** - Set the game difficulty.
- **/effect [player] [effect] [duration] [amplifier]** - Apply an effect to a player.
- **/summon [entity] [x] [y] [z]** - Summon an entity at specified coordinates.
- **/spawn [player]** - Teleports player to spawn
- **/kill [player]** - Kill a player.
- **/list** - List all players online.
- **/locate [structure]** - Locate a structure in the world.
- **/reload** - Reload server configurations.
- **/setworldspawn [x] [y] [z]** - Set the world spawn point.
- **/teleport [player] [player2]** - Teleport a player to specified coordinates.
For anything you wish to be added, let me know :)