Qexed

Qexed 是基于 Rust 所开发的一个我的世界Java版本服务端

当前对应的MC版本:1.21.8,每次只适配一个版本

项目介绍

Qexed one 单机版本

服务列表

• TCP连接入口
• 玩家列表
• 服务器状态
• 黑名单
• 白名单
• 警卫(反作弊)
• 典狱长(封禁管理)
• 游戏逻辑
• Ping
• 心跳
• 实体id分配器
• 视野
• 聊天
• 命令
• 实体
• 注册表
• 区块
• 世界

qexed_tcp_connect - TCP连接入口模块文档

文档信息

• 配置版本：0
• 最后更新：2025年12月15日 11:00

功能

1. 玩家进服的唯一权威入口
2. 处理握手阶段、配置节点、登录阶段的网络数据包
3. 转发配置阶段、游戏阶段的网络数据包
4. 实现登录认证

服务关系图

graph TD
    A[MC客户端] --> B[qexed_tcp_connect_app]
    
    B --> C{选择阶段}
    C -->|Status阶段| D[Status阶段:查询服务]
    C -->|Login阶段| E[Login阶段]
    
    D --> F[qexed_server_status]
    F --> G[qexed_game_logic]
    
    subgraph E [Login阶段]
        H[Login:黑名单查询] --> I[qexed_blacklist]
        J[Login:白名单查询] --> K[qexed_whitelist]
        L[Login:反作弊检查] --> M[qexed_guard]
        N[Login:封禁查询] --> O[qexed_varden]
    end
    
    I --> G
    K --> G
    M --> G
    O --> G

配置文件

请阅读配置

运维提示：修改监听地址(ip)重启此服务时,玩家会掉线。

命令

请阅读命令

常见问题

无

配置

文档信息

• 配置版本：0
• 最后更新：2025年12月15日

📍 服务器监听设置

🔐 玩家登录验证

🔄 网络性能与代理

如果您开启了代理 (proxy: true)

您还需要设置以下两项：

🛡️ 连接安全防护

为了防止恶意攻击和刷连接，服务器内置了基础防护。

⚙️ 配置文件示例

一份典型的、用于公开正版服的配置可能如下所示：

ip: "0.0.0.0:25565"
online_mode: true
network_compression_threshold: 256
proxy: false
# 当 proxy 为 false 时，以下 proxy_ 开头的设置无需理会
rate_limit_window_secs: 60
rate_limit_max_attempts: 10  # 稍微放宽了一点限制
status_timeout_secs: 5

一份用于在 BungeeCord 后方的子服务器配置可能如下：

ip: "0.0.0.0:25566"  # 注意端口不能与BungeeCord或其他子服冲突
online_mode: false    # BungeeCord 已统一验证，子服关闭验证
proxy: true           # 关键：必须开启
proxy_protocol: bungeecord  # 关键：必须匹配
proxy_token: "MySecureSharedToken123"  # 关键：必须与BungeeCord配置一致
rate_limit_window_secs: 30
rate_limit_max_attempts: 30  # 因代理转发，限制可大幅放宽

📁 配置文件位置

此模块的配置文件通常位于服务器根目录的 ./config/qexed_player_list/ 文件夹中，名称可能为 config.yaml、config.toml 或 config.json，具体取决于项目设定的格式。

总结：对于大多数想开一个简单服务器的用户，您主要需要关注 ip（端口） 和 online_mode（是否正版） 这两个设置。只有当您需要搭建复杂群组服时，才需要深入了解代理相关的配置。

在 qexed-one中,为 [tcp_connect_app]

命令

文档信息

• 配置版本：0
• 最后更新：2025年12月15日

本模块暂时不涉及命令

qexed_player_list 玩家列表

文档信息

• 配置版本：0
• 最后更新：2025年12月22日 14:00

功能

1. 统计玩家列表
2. 统计玩家数

服务关系图

graph TD
    A[qexed_server_status] -->|玩家数查询请求| B[qexed_player_list] 
    C[qexed_game_logic] -->|玩家进退服事件| B[qexed_player_list]

配置文件

version = 0
max_player = 20
auto_update = false

参数说明

命令

玩家列表的命令相对简单，只有查询功能而已

/list 玩家列表

描述: 查询玩家列表

权限组要求: qexed.list

另名:list、玩家列表

参数:page

指令说明: 玩家列表指令相对原版mc服务端来说，增加了页码信息，页码信息类似 help， 此外每页10个玩家，如下:

/list [页码:int]

游戏内执行效果:

常见问题

无

qexed_server_status 服务器状态

文档信息

• 配置版本：0
• 最后更新：2025年12月22日 14:30

功能

1. 答复Status阶段的PingStart请求
2. 玩家列表缓存

游戏内截图

服务关系图

graph TD
    A[qexed_tcp_connect_app] -->|玩家数据包构建请求| B[qexed_server_status] 
    B[qexed_server_status] --> |查询玩家数| C[qexed_player_list]

配置文件

version = 0
cache = 30
motd = [
    "欢迎使用量子叠加态",
    "桶木跑路了",
]
favicon = "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAEAAAABACAYAAACqaXHeAAAACXBIWXMAAA9hAAAPYQGoP6dpAAACtklEQVR42u2ay0rDQBSGJ2EQCipqERU3SkFQQUERRJSCuHDrQvcu3Powbn0DH6IIohQKIi26ELRF8FLxAlbsyksTmTC2yVwyk3ZizmySkjaT/zvnP5mT1PpuDJTgYaOEDwAAAAAAAAAAAAAAAAAAAAAAAABI5MAyX7YsS3lC07pvLCs+jAAd4DpqARXxia8BpsOzk5r6QgB0iTfZOnbU0TO9bthRCIhT0cRRpX4U4v2yUnUezJokrA10iReZX7XWYN0CdNUO0Wj7BUzm+rGJvpSJKn2c/M7ZikKQArC/1RqVnYPvjon3gyELwWp+N+j3QyJ8cHYNTU30uPuvz1V3W8yd/IHAmph3UToLqOi5uAAc8dnNDU/0eeW95SSf10UPQlgAQZEPC0U0kzAv5R3xtPDFhRQaHc+4+7flK1R5SqHba30W0HUHoe2gVAOIeFo4EZ8v1Bt7dTSzuuTCCqoHKqmvAoRAYM2PWdF3PH9eeQwUvzyf8WpB6cZiimve6rrdqmYMcylMCh6d8seFO088GbkiZkaB5ftOd4yYl/601x/KvylPxBN7DPUidC+Yjn4FTtQqYazBswETgCNueHygIR41xL94wi8ua2gk/eEer771ofvTI7SX/wrl7043Tszb4O6ijda3s6746bFu1J8e8rLCEX92WHL3afG8KDdHsB0AWHNw1wEOhJG5FTQ52uV+fqk9+grnpTHP68YCIBDoEZTuMguhZiBGA5CdTHYl2I5nCEHnhldj/1mcyBrDCABBdaEd/YUdx6jpPI8xAHQWQJl+w6gMoK0QNhNkmy3jLCCyihRprCJ5JqialrINjEhEVd8VYNPEs+4MUSynjXwsLmMJ7W+GTIh+OxsmOy7iY7cUjoN4aIaiAhCX6AcWQdX1eJz+TYbjfPFQAwAAAAAAAAAAAACl8QOub9TOwLTmGwAAAABJRU5ErkJggg=="

参数说明

命令

暂无

常见问题

为什么我服务器玩家有变化却还是显示原来的信息

服务器Ping请求有缓存，缓存结束后就就会刷新了。 缓存的时间根据你设置的cache决定

cache 默认30秒

我如何更换我服务器的头像

你可以前往 https://www.lddgo.net/convert/imagebasesix 或其他第三方网站进行生成

开发者不担保网站安全性，您可以自行浏览器搜索其他方法

上传后我们复制base64的编码的内容

截图中内容如下

data:image/png;base64,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

随后打开配置文件替换数据(favicon 字段)即可

qexed_chat 聊天

文档信息

• 配置版本：0
• 最后更新：2025年12月22日 14:45

功能

1. 聊天

游戏内截图

服务关系图

graph TD
    subgraph "游戏逻辑层"
        F[qexed_game_logic]
    end
    
    subgraph "聊天管理层"
        C[qexed_chat:manage]
    end
    
    subgraph "聊天任务层"
        B[qexed_chat:task]
        D[qexed_chat:task]
        E[qexed_chat:task]
    end
    
    subgraph "数据包处理层"
        A[qexed_packet_split]
    end
    
    F -->|1.获取聊天管理器| C
    C -->|2.创建聊天服务| B
    B -->|3.返回聊天服务句柄| F
    F -->|4.移交聊天管道| A
    A -->|5.分发聊天数据包| B
    B -->|6.广播聊天事件| C
    C -->|7.分发给所有客户端| B
    C -->|7.分发给所有客户端| D
    C -->|7.分发给所有客户端| E

配置文件

version = 0

参数说明

命令

暂无

常见问题

暂无

qexed_command 指令

文档信息

• 配置版本：0
• 最后更新：2025年12月22日 15:25

功能

1. 注册指令
2. 校验权限
3. 执行指令

游戏内截图

服务关系图

graph TD
    %% 输入层
    subgraph "输入层"
        B[qexed_cli<br/>终端命令行]
        A[qexed_one<br/>统一入口]
        F[qexed_packet_split<br/>数据包处理]
    end
    
    subgraph "游戏逻辑层"
        G[qexed_game_logic<br/>游戏主逻辑]
    end
    
    %% 指令管理层
    subgraph "指令管理层"
        
        H[qexed_command:manage<br/>指令管理器]
    end
    
    %% 指令执行层
    subgraph "指令执行层"
        C[qexed_command:task<br/>指令任务]
        D[qexed_permission<br/>权限验证]
        N[qexed_command:command<br/>指令执行器]
    end
    
    %% 网络层
    subgraph "网络层"
        E[qexed_tcp_connect_app<br/>TCP连接应用]
    end
    
    %% 条件判断节点
    I{是否已注册?}
    J{是否具备权限?}
    L{检测调用者类型}
    M{指令是否执行成功?}
    
    %% 流程连接
    %% 1. 终端指令流程
    B -->|终端命令行| A
    A -->|传递终端指令| H
    H -->|解析指令| I
    
    %% 2. 游戏内指令流程
    G -->|创建玩家指令任务| C
    C -->|转让任务所有权| F
    F -->|传递玩家指令| C
    C -->|解析指令| I
    
    %% 3. 权限验证流程
    I -->|请求权限检查| D
    D -->|验证结果| J
    
    %% 4. 权限分支
    J -->|有权限| N
    J -->|无权限| L
    
    %% 5. 调用者检测分支
    L -->|玩家调用| C
    L -->|终端调用| H
    
    %% 6. 指令执行流程
    N -->|执行指令| M
    M -->|执行成功| E
    M -->|执行失败| L
    
    %% 7. 结果发送
    N -->|构建数据包并发送| E
    
    %% 样式定义
    classDef input fill:#2d5f91,stroke:#1e3a5f,color:#fff
    classDef logic fill:#4a148c,stroke:#1e3a5f,color:#fff
    classDef management fill:#0d47a1,stroke:#1e3a5f,color:#fff
    classDef execution fill:#006064,stroke:#1e3a5f,color:#fff
    classDef network fill:#1b5e20,stroke:#1e3a5f,color:#fff
    classDef condition fill:#bf360c,stroke:#1e3a5f,color:#fff
    
    %% 应用样式
    class B,F input
    class G logic
    class A,H management
    class C,D,N execution
    class E network
    class I,J,L,M condition
    
    %% 添加图例
    subgraph "图例"
        LR1[输入层]:::input
        LR2[游戏逻辑层]:::logic
        LR3[指令管理层]:::management
        LR4[指令执行层]:::execution
        LR5[网络层]:::network
        LR6[条件判断]:::condition
    end

配置文件

version = 0
tab = true
game_stop_cmd = false
game_var_cmd = true

参数说明

命令

玩家列表的命令相对简单，只有查询功能而已

/help 帮助指令

描述: 查询已注册且有权限的指令

权限组要求: exed.help

另名:帮助、?、helpme

参数:page_or_command

指令说明: 每页10个指令，如下:

/list [页码:int]
/list [指令:String]

常见问题

暂无

游戏逻辑

文档信息

• 配置版本：0
• 最后更新：2025年12月22日 15:25

描述

正在编写,后续编写文档(这功能是全Qexed最复杂的一部分了)

Ping服务

文档信息

• 配置版本：0
• 最后更新：2025年12月22日 15:25

描述

当前版本未启用

qexed_heartbeat 心跳服务

文档信息

• 配置版本：0
• 最后更新：2025年12月22日 15:35

功能

1. 维护配置阶段与游戏阶段tcp连接心跳

服务关系图

graph TD
    %% 定义节点样式
    A[qexed_heartbeat<br/>心跳模块]:::mainNode
    B[qexed_packet_split<br/>数据包分割]:::processNode
    C[qexed_game_logic<br/>游戏逻辑]:::processNode
    
    %% 主样式定义
    classDef mainNode fill:#4CAF50,stroke:#388E3C,stroke-width:2px,color:white,font-weight:bold
    classDef processNode fill:#2196F3,stroke:#1976D2,stroke-width:2px,color:white
    classDef gameFlow fill:none,stroke:#4CAF50,stroke-width:2px,color:#4CAF50,font-weight:bold
    classDef configFlow fill:none,stroke:#FF9800,stroke-width:2px,color:#FF9800,font-weight:bold
    
    %% 游戏阶段心跳流
    subgraph "游戏阶段心跳"
        direction LR
        A -- "发送游戏阶段心跳" --> B
        B -. "游戏阶段心跳返回结果" .-> A
    end
    
    %% 配置阶段心跳流
    subgraph "配置阶段心跳"
        direction LR
        A == "发送配置阶段心跳" ==> C
        C -. "配置阶段心跳返回结果" .-> A
    end
    
    %% 应用样式到连线
    linkStyle 0 stroke:#4CAF50,stroke-width:2px
    linkStyle 1 stroke:#4CAF50,stroke-width:2px,stroke-dasharray:5
    linkStyle 2 stroke:#FF9800,stroke-width:2px
    linkStyle 3 stroke:#FF9800,stroke-width:2px,stroke-dasharray:5
    
    %% 图例
    subgraph "图例"
        Legend1[实线箭头: 请求]:::legend
        Legend2[虚线箭头: 响应]:::legend
        Legend3[绿色: 游戏阶段]:::legend
        Legend4[橙色: 配置阶段]:::legend
    end
    
    classDef legend fill:#f9f9f9,stroke:#ddd,stroke-width:1px,color:#333

配置文件

interval_seconds = 5
timeout_seconds = 30
max_consecutive_misses = 3
enabled = true

参数说明

命令

无

常见问题

无

实体id分配器

暂未启用

区块

开发中内容

配置

命令