https://github.com/ivelisya/minecraft-mcrcon

With MCRcon, server administrators can manage the world without logging into the console or game, and provide an intuitive visual interface./使用MCRcon，服务器管理员无需登录控制台或游戏，即可对世界进行管理，并提供直观的可视化界面。
https://github.com/ivelisya/minecraft-mcrcon

linux mcrcon minecraft minecraft-cheat minecraft-forge minecraft-plugin minecraft-server mojang mojang-api rcon remote remote-access-tool remote-administrative-tool remote-control remote-desktop source-rcon valve-rcon windows

Last synced: 10 days ago
JSON representation

With MCRcon, server administrators can manage the world without logging into the console or game, and provide an intuitive visual interface./使用MCRcon，服务器管理员无需登录控制台或游戏，即可对世界进行管理，并提供直观的可视化界面。

• Host: GitHub
• URL: https://github.com/ivelisya/minecraft-mcrcon
• Owner: Ivelisya
• Created: 2024-04-13T18:30:01.000Z (8 months ago)
• Default Branch: main
• Last Pushed: 2024-12-07T15:32:51.000Z (16 days ago)
• Last Synced: 2024-12-10T09:40:13.280Z (13 days ago)
• Topics: linux, mcrcon, minecraft, minecraft-cheat, minecraft-forge, minecraft-plugin, minecraft-server, mojang, mojang-api, rcon, remote, remote-access-tool, remote-administrative-tool, remote-control, remote-desktop, source-rcon, valve-rcon, windows
• Language: Python
• Homepage: https://github.com/smazyu/minecraft-mcrcon
• Size: 111 KB
• Stars: 2
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
[Switch to English | 切换到英文](#english-content)

[切换到中文 | Switch to Chinese](#chinese-content)

---

## English Content

# Module Introduction

- **automation_linux.py:** Automatically monitors the current number of players and sends a welcome message when new players join. Also responsible for cleaning up dropped items in the world every 30 minutes.

- **command.py:** Provides common commands executed via mcrcon for interaction with the game server.

- **一键开服.bat (One-click Start.bat):** Provides a script for quickly starting the game server. Just modify the name of the core file to start using it.

- **Visualization.py:** Manages the game server intuitively through a visual interface, including functions such as adding players to the whitelist, banning players, and kicking players. This module reads the current player list file for easy selection of players to manage.

- **main_automation.py:** Implements the same functionality as automation_linux.py but automatically opens a visual interface for easier management when enabled.

- **quickly_command.py:** Provides automation-generated player lists from the server for remote command input, similar to typing commands in the game.

### Additional Files

- **id.txt:** Contains IDs of common items. When executing the command to give items, command.py automatically opens this file to provide a list of items.

# Instructions for Use

- Use automation_linux.py or main_automation.py to monitor server status and automatically perform cleaning tasks.

- Use command.py to execute common commands on the game server.

- Use Visualization.py for visual management, which offers more intuitive and convenient operations.

- Use One-click Start.bat to quickly start the game server.

- Use quickly_command.py for remote command input without logging into the game or terminal.

- Detailed errors will be stored in the log folder.

# Overview of Features

## MCRcon Server Automation Management Tool (Python Scripts)

- **main_automation.py:**

  - Sends welcome messages to new players.

  - Cleans up ground items at regular intervals.

  - Monitors player joins and exits.

  - Automatically opens the Minecraft server management tool GUI.

**Note:** If you do not want to automatically start the GUI program, please use automation_linux.py or automation_win.py files.

## Minecraft Server Management Tool GUI (Python Program)

- **Visualization.py:**

  - Provides a visual interface.

  - Functions include:

    - Switching game modes.

    - Teleporting players.

    - Giving items to players.

    - Killing players.

    - Banning and unbanning players.

    - Setting weather and time.

    - Setting difficulty and game rules.

    - Managing whitelist, operators, and ban list.

**Note:** If you do not need a visual interface, please use command.py file.

## Minecraft Server Management Command Line Tool (Python Program)

- **command.py:**

  - Switching game modes.

  - Teleporting players.

  - Giving items to players.

  - Killing players.

  - Banning and unbanning players.

  - Kicking players.

  - Setting weather and time.

  - Setting difficulty and game rules.

  - Managing whitelist, operators, and ban list.

## Minecraft Server One-click Start Script (Windows Batch Script)

- **One-click Start.bat:**

  - Starts the Minecraft server with one click.

  - Automatically allocates memory.

  - Allows selection of Java version.

  - Allows selection of core files; just modify the name of the core file to start using it.

## Minecraft MCRCON Quick Commands (Python Program)

- **quickly_command.py:**

  - Provides player lists generated by the server automation management tool.

  - Inputs commands in a dialogue box (similar to typing "/op" command in the game).

### Dependency Installation

Before running any tool, make sure the following dependencies are installed:

```bash

pip install mcrcon toml

```

# Notes

## Configuration Files

- Before using the tools, make sure the corresponding configuration files are configured with the relevant information of the Minecraft server.

## Running the Tools

- **MCRcon Server Management Tool:**

  - Run automation_win.py or automation_linux.py to start the MCRcon server automation management tool.

  - To automatically start the server management tool GUI, use the main_automation.py file.

- **Minecraft Server Management Tool GUI:**

  - Run Visualization.py to start the GUI program.

- **Minecraft Server Management Command Line Tool:**

  - Run command.py to start the command line program.

- **Minecraft Server One-click Start Script:**

  - Double-click One-click Start.bat to start the Minecraft server.

- **Minecraft MCRCON Quick Commands (Python Program):**

  - Run quickly_command.py to start the command line program.

## Performing Actions

Follow the prompts on the corresponding tool's interface or command line to input the necessary information to execute actions.

## Configuring MCRcon

- Before using it, make sure mcrcon is enabled in the world properties of the Minecraft server. If you are using the Paper version or another server version, ensure that mcrcon is enabled in the world properties as well as in the default settings of the Paper version. If you are using another core, find the corresponding setting in the developer documentation of that core and enable it.

## Changing Paths

- If you did not download the entire project, be sure to change the paths before using. Pay special attention that the player selection in the visual program is based on the player list generated by the automation program.

## 中文内容

# 模块介绍

- **automation_linux.py：** 用于自动监控当前玩家数量，并在新玩家进入时发送欢迎信息。同时，负责每隔 30 分钟清理一次世界掉落物。

  

- **command.py：** 提供通过 mcrcon 执行的常见命令，用于与游戏服务器进行交互。

  

- **一键开服.bat：** 提供一键开启游戏服务器的脚本，只需修改核心文件的名称即可开始使用。

  

- **Visualization.py：** 通过可视化界面直观地管理游戏服务器，包括添加白名单、封禁玩家、踢出玩家等功能。该模块读取当前玩家列表文件，方便选择要管理的玩家。

  

- **main_automation.py：** 实现与 automation_linux.py 相同功能，但启用时会自动打开可视化界面，提供更便捷的管理方式。

- **quickly_command.py：** 提供自动化由服务器自动化管理工具生成的玩家列表，在对话框内输入指令(如你在游戏内输入op指令一样)

### 附加文件

- **id.txt：** 包含常见物品的 ID，当执行给予物品的命令时，command.py 会自动打开此文件提供物品列表。

# 使用说明

- 使用 automation_linux.py 或 main_automation.py 监控服务器状态和自动执行清理任务。

  

- 使用 command.py 执行游戏服务器的常见命令。

  

- 使用 Visualization.py 进行可视化管理，操作更直观、便捷。

- 使用一键开服.bat 快速启动游戏服务器。

- 使用 quickly_command.py 远程输入指令，无须登入游戏和终端

- log文件夹下会存储错误详细

# 功能概览

## MCRcon 服务器自动化管理工具 (Python 脚本)

- **main_automation.py：**

  - 发送欢迎消息给新玩家

  - 定时清理地面物品

  - 监控玩家的加入和退出

  - 同时打开 Minecraft 服务器管理工具 GUI

**注意：** 若您不想自动启动 GUI 程序，请使用 automation_linux.py 或 automation_win.py 文件。

## Minecraft 服务器管理工具 GUI (Python 程序)

- **Visualization.py：**

  - 提供可视化界面

  - 功能包括：

    - 切换游戏模式

    - 传送玩家

    - 给予玩家物品

    - 杀死玩家

    - 封禁和解封玩家

    - 设置天气和时间

    - 设置难度和游戏规则

    - 管理白名单、操作员和封禁名单

**注意：** 若您不需要可视化界面，请使用 command.py 文件。

## Minecraft 服务器管理命令行工具 (Python 程序)

- **command.py：**

  - 切换游戏模式

  - 传送玩家

  - 给予玩家物品

  - 杀死玩家

  - 封禁和解封玩家

  - 踢出玩家

  - 设置天气和时间

  - 设置难度和游戏规则

  - 管理白名单、操作员和封禁名单

## Minecraft 服务器一键启动脚本 (Windows 批处理脚本)

- **一键开服.bat：**

  - 一键启动 Minecraft 服务器

  - 自动分配内存

  - 可选择 Java 版本

  - 可选择核心文件，只需修改核心文件的名称即可开始使用

## Minecraft MCRCON 快速指令 (Python 程序)

- **quickly_command.py：**

  - 提供由服务器自动化管理工具生成的玩家列表

  - 在对话框内输入指令(如你在游戏内输入op指令一样)

### 安装依赖

在运行任何工具之前，请确保已安装以下依赖：

```bash

pip install mcrcon toml

```

# 注意事项

## 配置文件

- 在使用工具之前，请确保已配置好对应的配置文件，包含了 Minecraft 服务器的相关信息。

## 运行工具

- **MCRcon 服务器管理工具：**

  - 运行 automation_win.py 或 automation_linux.py 文件启动 MCRcon 服务器自动化管理工具。

  - 若要自动启动服务器管理工具 GUI，请使用 main_automation.py 文件。

- **Minecraft 服务器管理工具 GUI：**

  - 运行 Visualization.py 文件启动 GUI 程序。

- **Minecraft 服务器管理命令行工具：**

  - 运行 command.py 文件启动命令行程序。

- **Minecraft 服务器一键启动脚本：**

  - 双击运行 一键开服.bat 文件即可启动 Minecraft 服务器。

- **Minecraft MCRCON 快速指令 (Python 程序)：**

  - 运行 quickly_command.py 文件启动命令行程序

## 执行操作

根据对应工具的界面或命令行提示，输入相应的信息来执行操作。

## 配置 mcrcon

- 在使用之前，请确保在 Minecraft 服务器的世界属性中打开了 mcrcon。如果您使用了 Paper 端或其他服务器端，请确保在世界属性中打开了 mcrcon 的同时也在 Paper 端的默认设置中打开。如果您使用的是其他核心，请在该核心的开发者文档中找到对应的设置，并进行开启。

## 路径更改

- 若您并非下载了整个项目，请在使用前更改路径。特别注意，可视化程序的玩家选择是基于自动化程序生成的玩家列表。