如何用mcpi库实现Python与Minecraft 1.20.1连接？连接被拒问题排查

核心原因 #

原版mcpi库仅适配Minecraft 1.8及更早版本，与1.20.1的网络协议不兼容，同时服务器配置可能存在权限或端口限制，导致连接被主动拒绝。以下是具体修复方案：

1. 替换为高版本兼容的mcpi分支或安装对应插件 #

• 卸载原版mcpi，安装适配新版的分支：

  pip uninstall mcpi
  pip install mcpi-api
  

• 若使用Fabric/Forge服务器，安装支持1.20.1的RaspberryJuice插件（该插件专门为mcpi提供协议兼容），安装后重启服务器。

2. 检查服务器配置 #

• 编辑server.properties文件：
  • 设置enable-rcon=true，开启远程控制权限
  • 配置rcon.port=25575（默认mcpi关联端口），可根据插件说明调整
  • 确保server-ip=0.0.0.0（允许所有IP连接）或设置为你的本地IP（如192.168.x.x）
• 关闭本地防火墙对Minecraft服务器端口（默认25565）和RCON端口（25575）的限制，或添加入站规则。

3. 修改测试代码指定连接参数 #

默认Minecraft.create()尝试连接localhost:4711，需根据实际配置指定IP和端口：

from mcpi.minecraft import Minecraft

# 替换为你的服务器IP和插件对应的端口（RaspberryJuice默认是4711）
mc = Minecraft.create(address="127.0.0.1", port=4711)
mc.postToChat("Hello World")

4. 前置验证 #

运行Python代码前，必须确保你的Minecraft客户端已成功加入本地服务器，mcpi依赖客户端的会话连接才能正常交互。

内容的提问来源于stack exchange，提问作者DaPac1