Minecraft Fabric Server — 整合包安装与管理

• MC 1.21.5 + Fabric，已配置 Carpet 系列模组和优化模组
• install.sh 一键安装：自动下载 Fabric 服务端 + 模组 + 配置 systemd，安装后立即可用
• mccli.sh 统一管理：start/stop/restart/status/logs/backup/restore/rcon/console
• 交互式安装引导，也支持命令行参数无交互部署
• 依赖：java 21+ / curl / jq

项目简介

开箱即用的 Minecraft Fabric 整合包安装器。克隆仓库后运行 ./install.sh，脚本自动下载 Fabric 服务端、从 Modrinth 获取模组、生成 server.properties（含 RCON）、创建 systemd 服务，几分钟内完成部署。

安装后使用 ./mccli.sh 统一管理——无需记忆 systemd 或 RCON 命令。

技术栈

组件	选型
服务端	Fabric Loader 0.16.10
游戏版本	Minecraft 1.21.5
模组来源	Modrinth API
管理脚本	Bash

项目结构

minecraft/
├── install.sh        # 一键安装脚本
├── mccli.sh          # 管理 CLI (start/stop/backup/console...)
├── mods.txt          # 模组列表 (Modrinth slug=version)
├── server/           # 服务端目录 (安装后生成, gitignored)
│   ├── mods/         #   模组目录
│   ├── world/        #   世界存档
│   └── server.properties
└── backups/          # 备份目录

快速开始

git clone git@github.com:Chieko3020/minecraft.git
cd minecraft
./install.sh
# 按提示输入安装目录、服务器名称、内存限制

./mccli.sh start    # 启动
./mccli.sh status   # 状态 + 在线玩家
./mccli.sh backup   # 备份世界
./mccli.sh console  # 控制台交互

管理命令

命令	说明
start	启动服务器
stop	通过 RCON 优雅关闭
restart	重启服务器
status	systemd 状态 + 在线玩家
logs	最近 50 行日志
backup	创建 world 备份 (tar.gz)
restore <file>	恢复指定备份
rcon <cmd>	发送 RCON 命令
console	交互式控制台

模组

模组	用途
fabric-api	Fabric API 基础
carpet	Carpet 模组 — 游戏规则/TPS 优化
carpet-tis-addition	TIS Carpet 扩展
guglecarpet-addition	Gugle Carpet 扩展
alternate-current	红石优化
krypton	网络优化