Qexed 安装与启动

面向普通使用者：这篇只讲安装、初始化和启动，不涉及源码构建。

前置条件

  • Windows 10/11 或 Linux 服务器环境
  • Minecraft Java Edition 客户端（当前兼容版本：26.1.2）
  • 可写目录用于存放 qexed 运行文件

准备运行目录

QexedRuntime/
  qexed.exe
  config/
  plugins/
  world/

首次运行后，config、plugins、world 会自动创建。

初始化配置

New-Item -ItemType Directory -Force "D:/Qexed"
Copy-Item "./qexed.exe" "D:/Qexed/qexed.exe"
Set-Location "D:/Qexed"
.\qexed.exe --init-settings --language zh-CN

编辑 config/qexed.toml：

language = "zh-CN"

[server]
ip = "0.0.0.0:43145"
online_mode = false
max_player = -1

[server.world]
path = "world"
read_only = false
game_mode = "survival"

启动服务端

Set-Location "D:/Qexed"
.\qexed.exe --language zh-CN

保持终端窗口开启；停止时使用 Ctrl+C。

客户端连接

  1. 在启动器中选择 Minecraft Java Edition 26.1.2。
  2. 进入多人游戏，添加服务器。
  3. 本机连接地址使用 127.0.0.1:43145。
  4. 局域网连接时，替换为服务端主机的 LAN IP，例如 192.168.1.10:43145。

常见问题

端口占用

修改 config/qexed.toml 中的 ip 端口并重启服务端。

连接失败

确认服务端进程仍在运行、防火墙放行对应端口、客户端版本与服务端要求一致。

编辑此页面