qingyue's Minecraft 服务器文档

欢迎来到qingyue's Minecraft 。这是一个以原版生存、生电、建筑和休闲为主的 Fabric 服务器，原则上允许任何玩法，但严格禁止任何毁服、卡服、破坏他人成果的行为。希望大家能在服务器中玩的开心。

服务器QQ群：416388992。加入服务器前必须先加入群聊并利用机器人完成注册，否则将无法登录。

下面是服务器的基本参数：

项目	信息
服务器地址	`mc.qingyue5.top`
Minecraft	Java Edition `1.20.1`
服务端	Fabric Loader `0.19.3`
玩法	原版生存·生电·建筑·休闲
正版验证	关闭
世界种子	`7579111`
世界难度	困难，死亡不掉落
登录验证	绑定QQ号的无感登录
QQ 群	`416388992`

开始游玩¶

安装¶

正确版本的原版Minecraft即可游玩。但为了游戏体验，推荐使用模组和光影。推荐模组列表可见模组清单。

新手推荐使用自动安装。这会为你一键安装 HMCL 启动器、游戏本体和推荐模组和光影。
如果你想使用自己的启动器，也可以仅下载推荐的模组。
再或者，可以手动安装Minecraft Java 1.20.1的Fabric 0.19.3版本。

注册¶

加入 QQ 群 416388992，打开登录凭据注册页。
填写 QQ 号和 Minecraft 用户名，通过 QQ 私聊收取六位验证码。
验证后下载个人登录 Mod，将 JAR 放入客户端 mods 目录。

注意： - Minecraft 用户名必须与启动器中的名称完全一致，包括大小写。QQ号和游戏内用户名一一对应，不能出现1对多的情况。 - 个人登录 Mod 等同于登录凭据，不要向他人转发。一人多台设备的，只要把Mod放入每台设备的模组文件夹，就都可以实现登录。 - mod若丢失，需要重新在注册页下载。重新下载后，旧 Mod 会立即失效。 - 如果需要解除绑定的，暂不支持网页端操作。可以私信群主完成。

使用注册时的 Minecraft 用户名启动游戏，输入服务器地址：

mc.qingyue5.top

域名通过 SRV 记录指向游戏端口，通常不需要手动填写端口。DNS 异常时可临时使用 mc.qingyue5.top:30001。通过个人凭据验证后，服务器会自动同步原生白名单。

服务器维护信息¶

服务器重启、版本更新、故障和活动信息以 QQ 群 416388992 的群公告为准。服务器已启用自动备份与故障后重启；备份频率和保留周期待核实。

服务器生电机械与建筑¶

以下为服务器已建立的生电机械与建筑档案。请使用者严格遵守各机械的操作规范与挂机要求。

1. [刷铁机]¶

基本档案

机械类型：刷铁机
位置坐标：X: -123 / Y: 86 / Z: 15（主世界）
推荐挂机点：位于出生点加载区域，无需挂机
负责人/建造者：@Joesph1917
运行状态：🟢 正常运行

⚡ 性能与效率评估 (Performance & Yield)

理论产率：1500 铁锭/h

📷 结构与视效展示¶

外部全景	收集位置

服务器参数与模组¶

服务器设备配置¶

项目	当前配置
CPU	12 核 / 12 线程，最高 4.8 GHz；具体型号待核实
内存	32 GiB
Minecraft JVM	初始 4 GiB，上限 8 GiB，G1GC
系统	Ubuntu Server 24.04
系统盘	120 GB SSD
世界与服务数据	1 TB NVMe SSD
备份盘	500 GB HDD

关键服务器参数¶

参数	值
Minecraft	Java Edition `1.20.1`
Fabric Loader	`0.19.3`
游戏模式 / 难度	生存 / 困难
最大玩家数	50
视距	10 区块
模拟距离	8 区块
PVP	开启
生成结构	开启
出生点保护	0
世界种子	`7579111`
白名单	开启并强制执行，由登录系统同步
游戏端口	TCP `30001`
语音端口	UDP `30002`
语音距离	普通 128 格，低语 24 格

服务端模组¶

模组	版本	作用
Advanced Backups	3.7.1	世界自动备份
LuckPerms	5.4.102	权限组管理
Universal Perms	1.0.3	Fabric 命令权限接口
Fabric Carpet	1.4.112	生电规则、假人和技术辅助
Carpet Extra	1.4.115	Carpet 扩展规则
Carpet TIS Addition	1.82.4	Carpet 技术服扩展
Carpet Org Addition	1.34.2	Carpet 扩展功能
Gugle Carpet Addition	2.12.6	Carpet 扩展功能
Essential Commands	0.35.3	家、传送和公共传送点等命令
Fabric API	0.92.11	Fabric 基础 API
Lithium	0.11.4	游戏逻辑性能优化
FerriteCore	6.0.1	降低内存占用
Krypton	0.2.3	网络栈优化
MC Login Server	0.3.0	QQ 绑定凭据登录验证
Pickup Notifications	1.5.2	物品拾取提示
Quick Shulker	1.4.0	快速查看或使用潜影盒
Servux	0.1.0	为 MiniHUD 等 masa 系客户端模组提供服务端数据
spark	1.10.53	TPS、MSPT 和性能分析
Styled Chat	2.2.4	聊天样式
Simple Voice Chat	2.6.21	游戏内近距离语音
Yes Steve Model	2.6.5	自定义玩家模型支持

QQ Bot 功能¶

QQ Bot 运行于群 416388992，已连接 Minecraft 服务器和 AI 问答服务。

公开命令¶

命令	功能
`/help`	查看 Bot 帮助
`/签到` 或 `/sign`	每日签到、人品和推荐行为
`/mc status`	服务器状态、在线人数、MSPT 和内存
`/mc list`	在线玩家与假人列表
`/mc mods`	服务端模组列表
`/bot ping`	检查 Bot 是否在线
`/bot repeat add/list/del`	添加、查看或删除自己的复读规则
`/ai clear`	清除自己的 AI 对话上下文
`/ai retry`	重新生成上一次 AI 回复

消息与 AI¶

QQ 群中 @Bot 或使用 #ai 前缀可发起 AI 问答。
Minecraft 中使用 #ai 前缀可发起 AI 问答。
QQ 群中使用 #mc 将消息发送到 Minecraft；Minecraft 中使用 #qq 发送到 QQ 群。
Bot 还会处理关键词回复和连续复读。

AI 回复可能不准确，服务器参数、权限和维护信息以本文档及群公告为准。

模组使用教学¶

MiniHUD¶

MiniHUD 用于显示坐标、光照、区块、结构边界和生电相关信息。服务端已安装 Servux，可向 MiniHUD 提供部分服务端数据。

快捷键	作用
`H`	开关 MiniHUD 全局渲染
`H`+`C`	打开 MiniHUD 配置界面

常用功能¶

Info Lines：选择坐标、区块位置、朝向、游戏时间等常驻信息。
Light Level：显示方块光照等级，用于检查刷怪风险和建筑照明。
Structure Bounding Boxes：显示刷怪笼、要塞、神殿等结构范围；部分数据需要 Servux 同步。
Shapes：创建球体、圆柱或方框，用于标记刷怪范围、机器工作区或建筑边界。

建议只开启当前需要的信息行和渲染器，避免界面过于拥挤。如果快捷键冲突，可在 MiniHUD 的 Hotkeys 分页中重新绑定。

模组	版本	作用
AppleSkin	2.5.2	饥饿度与食物恢复信息
BetterF3	7.0.2	精简并重排 F3 信息
Cloth Config	11.1.136	配置界面依赖
Dynamic FPS	3.11.4	后台运行时降低资源占用
EMI	1.1.24	物品、配方和用途查询
Fabric API	0.92.11	Fabric 公共依赖
Fabric Language Kotlin	1.13.13	Kotlin 模组运行依赖
Indium	1.0.36	Sodium 渲染兼容层
Iris	1.7.6	光影加载
Litematica	0.15.4	建筑蓝图和材料统计
MaLiLib	0.16.3	Litematica 和 MiniHUD 的前置依赖
MiniHUD	0.27.1	坐标、结构边界和生电信息显示
Mod Menu	7.2.2	模组列表和配置入口
Mouse Tweaks	2.26	物品栏鼠标操作优化
Shulker Box Tooltip	4.0.4	潜影盒内容预览
Sodium	0.5.13	渲染性能优化
Simple Voice Chat	2.6.21	游戏内近距离语音
Xaero's Minimap	26.4.2	小地图和路径点
Xaero's World Map	1.44.2	世界地图
YetAnotherConfigLib	3.6.6	配置界面依赖
Yes Steve Model	2.6.5	自定义玩家模型
Zoomify	2.15.2	平滑缩放视野