endstone-easybackuper 0.4.6b1

📖 简介

EasyBackuper 是一个专为 Endstone 服务器设计的备份插件，旨在简化备份过程，提高备份效率，并确保数据安全。它支持自动定时备份、智能清理、实时通知、多线程加速、多格式支持、备份恢复和多语言等功能，为服务器管理员提供全面的数据保护解决方案。

✨ 核心特性

🗂️ 目录结构

服务器根目录/
├── logs/
│   └── EasyBackuper/                    # 日志目录
│       ├── easybackuper_YYYYMMDD.log    # 主日志文件
│       └── easybackuper_restore_YYYYMMDD.log  # 恢复日志
├── plugins/
│   ├── endstone_easybackuper-x.x.x-py3-none-any.whl  # 插件主文件
│   └── EasyBackuper/                    # 插件资源目录
│       ├── 7za.exe                      # 7z压缩工具
│       ├── restore_handler.exe          # 备份恢复处理器
│       ├── config/
│       │   └── EasyBackuper.json        # 配置文件
│       └── langs/                       # 多语言文件
│           ├── zh_CN.json               # 简体中文
│           └── en_US.json               # 英文
└── backup/                              # 备份文件存储目录

🚀 快速开始

安装步骤

1. 下载插件

   • 从 Release页面 下载最新版本
   • 或从 MineBBS 获取

2. 安装插件

   # 将插件主文件复制到服务器 plugins 目录
   cp endstone_easybackuper-x.x.x-py3-none-any.whl plugins/
   

3. 安装依赖文件

   • 将 7za.exe、restore_handler.exe 放入 plugins/EasyBackuper/ 目录 (restore_handler.exe 可从 Release页面 下载 或者 手动编译)

4. 启动服务器

   • 重启服务器或使用 /reload 命令
   • 插件会自动生成默认配置文件

⚙️ 配置详解

配置文件位于：plugins/EasyBackuper/config/EasyBackuper.json

📋 主要配置项

{
  // 🌐 国际化设置
  "Language": "zh_CN",  // 可选: zh_CN, en_US
  
  // 🗜️ 压缩配置
  "Compression": {
    "method": "zip",  // 压缩算法: 7z, zip, tar
    "exe_7z_path": "./plugins/EasyBackuper/7za.exe",  // 7z可执行文件路径
    "formats": {
      "7z": {
        "extension": ".7z",
        "compress_args": ["a", "-t7z", "-mx=5"],
        "extract_args": ["x", "-y"]
      },
      "zip": {
        "extension": ".zip",
        "compress_args": ["a", "-tzip", "-mx=5"],
        "extract_args": ["x", "-y"]
      },
      "tar": {
        "extension": ".tar.gz",
        "compress_args": ["a", "-ttar", "-mx=5"],
        "extract_args": ["x", "-y"]
      }
    }
  },
  
  // 📁 存储路径
  "BackupFolderPath": "./backup",  // 备份文件保存路径
  
  // ⚡ 性能配置
  "Max_Workers": 4,  // 并发线程数
  
  // 🧹 自动清理
  "Auto_Clean": {
    "Use_Number_Detection": {
      "Status": false,    // 启用自动清理
      "Max_Number": 5,   // 最大保留备份数量
      "Mode": 0          // 0=开服后清理, 1=备份后清理, 2=开服时清理
    }
  },
  
  // ⏰ 定时任务
  "Scheduled_Tasks": {
    "Status": false,                // 启用定时备份
    "Cron": "*/30 * * * * *"      // Cron表达式，每30秒
  },
  
  // 📢 通知设置
  "Broadcast": {
    "Status": true,                // 启用广播通知
    "Time_ms": 5000,              // 备份前通知时间（毫秒）
    "Title": "[OP]要开始备份啦~",
    "Message": "将于 5秒 后进行备份！",
    "Server_Title": "[Server]Never Gonna Give You UP~",
    "Server_Message": "Never Gonna Let You Down~",
    "Backup_success_Title": "备份完成！",
    "Backup_success_Message": "星级服务，让爱连接",
    "Backup_wrong_Title": "很好的邢级服务，使我备份失败",
    "Backup_wrong_Message": "RT"
  },
  
  // 🔍 调试设置
  "Debug_MoreLogs": false,         // 启用详细日志（控制台）
  "Debug_MoreLogs_Player": false,  // 启用详细日志（玩家）
  "Debug_MoreLogs_Cron": false,   // 启用详细日志（Cron任务）

  // 🔄 恢复配置
  "Restore": {
    "exe_path": "./plugins/EasyBackuper/restore_handler.exe",  // 恢复处理器路径
    "config": {
      "backup_old_world_before_restore": true,  // 恢复前备份当前世界
      "restart_server": {
        "status": false,                        // 恢复后自动重启
        "wait_time_s": 3,                       // 重启等待时间（秒）
        "start_script_path": "./start.bat"          // 启动脚本路径
      },
      "debug": false  // 启用恢复调试日志
    }
  }
}

⏰ Cron表达式示例

🎮 命令手册

备份管理命令

恢复管理命令

🔧 高级功能

🗜️ 7z压缩配置

1. 下载7za.exe

   # 从 7-Zip官网 下载7za.exe
   # 放置在 plugins/EasyBackuper/ 目录
   

2. 修改配置

   {
     "Compression": {
       "method": "7z",
       "exe_7z_path": "./plugins/EasyBackuper/7za.exe"
     }
   }
   

3. 重载配置

   /backup reload
   

💡 Linux 自定义 7z 路径：EndStone 官方 Docker 镜像默认不包含 p7zip-full（PATH 中没有 7z）。若服务器上无法直接调用 7z，可通过 exe_7z_path 指定自定义的 7z 可执行文件（例如自行编译的 7za，或已安装 p7zip-full 后 7z 的实际路径）。备份与回档（恢复处理器）都会读取该配置：

{
  "Compression": {
    "exe_7z_path": "/path/to/your/7za"
  }
}

修改后执行 /backup reload 即可生效。若未指定自定义路径，回档程序在非 Windows 平台会自动回退到 PATH 中的 7z。

🔄 备份恢复处理器

恢复处理器 (restore_handler.exe) 用于安全地恢复备份文件：

1. 工作原理

   • 检测并等待正在运行的 bedrock_server 进程关闭
   • 备份当前世界文件（可选）
   • 解压备份文件到服务器目录
   • 自动重启服务器（可选）

2. 位置

   plugins/EasyBackuper/restore_handler.exe
   

💡 输出语言：回档程序的输出日志语言跟随配置文件 EasyBackuper.json 中的 Language 项（zh_CN 中文 / en_US 英文），无需单独下载英文版可执行文件。

🚀 多线程优化建议

⚠️ 注意：线程数过高可能导致服务器卡顿，请根据实际情况调整。

🛠️ 故障排除

常见问题

📊 日志文件说明

📄 许可证

本项目采用 AGPL-3.0 许可证开源。

版权所有 (c) 2023 梦涵LOVE

本程序是自由软件：您可以自由地重新发布和修改它，
但必须遵循AGPL-3.0许可证的条款。

完整许可证文本请参阅 LICENSE 文件。

👥 贡献指南

欢迎提交 Issue 和 Pull Request！

1. Fork 项目仓库
2. 创建功能分支

   git checkout -b feature/AmazingFeature
   

3. 提交更改

   git commit -m 'Add some AmazingFeature'
   

4. 推送分支

   git push origin feature/AmazingFeature
   

5. 创建 Pull Request

🌟 支持与反馈

• GitHub Issues: 提交问题
• MineBBS: 讨论帖
• 作者: 梦涵LOVE

⭐ 如果这个项目对你有帮助，请给我们一个 Star！

Star History