# mc-server-manager

**Repository Path**: nfasystem/mc-server-manager

## Basic Information

- **Project Name**: mc-server-manager
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-09
- **Last Updated**: 2025-08-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Minecraft 服务器管理器 (Minecraft Server Manager)

一个强大、通用的 Shell 脚本，用于下载、安装、切换和管理多个 Minecraft 整合包服务端。

## ✨ 功能特性

- **多整合包支持**: 通过一个中央配置文件，轻松管理任意数量的整合包服务端。
- **一键安装**: 从 Gitee 仓库自动下载并安装指定的整合包服务端。
- **轻松切换**: 在已安装的多个整合包之间安全、快速地切换。
- **专业的进程管理**: 使用 `screen` 在后台运行服务器，确保稳定并可随时查看日志。
- **标准服务器操作**: 支持 `start`, `stop` (优雅关服), `restart` 等所有标准命令。
- **数据安全**: 内置 `backup` 命令，可一键备份当前服务器的世界存档。
- **轻松更新**: 使用 `update` 命令，可从 Git 仓库拉取整合包的最新配置和模组。
- **高可扩展性**: 添加新的整合包只需修改中央 `pack_list.json` 文件，无需改动主脚本。

## ⚙️ 系统要求

在运行此脚本之前，请确保你的 Linux 系统已安装以下工具：
- `git`
- `curl`
- `jq` (一个轻量级的命令行 JSON 解析器)
- `screen`

你可以使用你的包管理器来安装它们，例如在 Debian/Ubuntu 上：
```bash
sudo apt-get update && sudo apt-get install git curl jq screen -y
```

## 🚀 快速开始

1.  **下载脚本**

    将 `manager.sh` 脚本下载到你希望管理服务器的目录中。
    ```bash
    # 假设你将脚本放在了 /home/user/mc_manager 目录
    mkdir -p /home/user/mc_manager
    cd /home/user/mc_manager
    # 你可以从你的 Gitee 仓库下载
    wget https://gitee.com/your_username/mc-server-manager/raw/master/manager.sh
    ```

2.  **赋予执行权限**
    ```bash
    chmod +x manager.sh
    ```

## 📖 命令用法

所有命令都通过 `./manager.sh <命令>` 的方式执行。

### 管理命令

- **`./manager.sh list remote`**
  从远程地址拉取并显示所有可供安装的整合包列表。

- **`./manager.sh list local`**
  显示所有在本地已经安装的整合包，并用 `*` 标记出当前激活的服务器。

- **`./manager.sh install`**
  显示一个菜单，让你选择并安装一个新的整合包。

- **`./manager.sh switch`**
  显示一个菜单，让你在已安装的整合包之间进行切换。
  > **注意**: 切换前必须先停止当前运行的服务器。

- **`./manager.sh update [pack_id]`**
  从 Git 仓库拉取整合包的更新。如果提供了 `[pack_id]`，则更新指定的包；否则，更新当前激活的包。
  > **注意**: 更新前必须先停止服务器。

### 服务器操作命令
(以下命令都作用于当前激活的整合包)

- **`./manager.sh start`**
  在后台启动服务器。

- **`./manager.sh stop`**
  向服务器发送 `stop` 命令，进行优雅关服。

- **`./manager.sh restart`**
  重启服务器。如果服务器未运行，则直接启动。

- **`./manager.sh log`** (或 `./manager.sh attach`)
  附加到服务器的后台控制台，可以实时查看日志或输入命令。
  > **提示**: 按 `Ctrl+A` 然后按 `D` 可以从控制台分离，让服务器继续在后台运行。

- **`./manager.sh backup`**
  为当前服务器的世界文件夹创建一个 `.tar.gz` 格式的压缩备份。备份文件将存放在 `backups/[pack_id]/` 目录下。

---
*本项目旨在简化 Minecraft 服务器的部署和管理流程。*