PerfectBackup

插件

· 作者 au2001

使用游戏内命令,最简单的方式来备份和还原你的服务器。

0 本站下载 0 关注 更新于 9 年前

最新 PerfectBackup v1.6 · 1.10

一键开服(送7天)

Banner Description 为服务器创建备份是作为管理员最重要的工作之一。这就是我为你,也为我自己打造这款完美工具的原因。

这个插件可能是目前最简单的服务器备份插件!
只需一条命令(/backup),即可保存整个服务器(或部分文件)。
然后,通过另一条命令(/restore)即可恢复旧的备份!
使用此插件,你甚至无需启动 CraftBukkit 即可恢复备份!
你可以像这样通过 Java 运行 jar 文件:
“ java -jar PerfectBackup <backup_path> <server_path> [log] ”
其中 backup_path 是你的备份文件夹/zip 的路径,
server_path 是你服务器目录的路径,
log 是一个布尔值(true/false),用于控制是否显示调试日志(默认为 true)。
这会将文件夹/zip 中的备份恢复到你的服务器中,甚至无需启动 CraftBukkit。
它可用于迷你游戏,希望在每局游戏后自动重置服务器。
你还可以重命名备份文件,并移动它们*。插件仍可正常工作。
* 如果移动了它们,游戏内的 /backups 命令将不再显示这些备份。

Commands 该插件添加了三个基本命令:

  • /backup:创建服务器的备份。
  • /backups:列出本地备份。
  • /restore [id]:恢复某个备份。
  • /delbackup [id]:删除本地备份。
  • /testftp:测试 FTP 连接。

Configuration

# Config File

# The automatic backup system. # Players with permission PerfectBackup.warning will be warned on automatic backup. # interval: 2 h

# Interval format: # <amount> <t/s/m/h/d> # t = Ticks, s = Seconds, m = Minutes, h = Hours, d = Days

crontask: '0 0 4 *' # This would make it every day at 4 AM

# CronTask format: # * * * * * * # | | | | | | # | | | | | +–––– Day of the Week (1-7) # | | | | +–––––– Month (1-12) # | | | +–––––––– Day of the Month (1-31) # | | +–––––––––– Hour (0-23) # | +–––––––––––– Minute (0-59) # +–––––––––––––– Second (0-59)

# A few more examples... # crontask: '0 0 * * * *' This would make it every hour # crontask: '0 0 4 * * 7' This would make it every sunday at 4 AM # crontask: '0 0 4 1 * *' This would make it every first of the month at 4 AM

# The format for backup names. # If two backups have the same name, it will append " (1)", " (2)" etc. backupformat: 'PerfectBackup {DATE}'

# The format for dates. # MM = month, DD = Day, YYYY = Year, HH = 12h Hours, hh = 24h Hours, mm = Minutes, ss = Seconds, ms = Milliseconds, AM = AM/PM dateformat: 'MM-DD-YYYY hhh mmm sss' # e.g. 03-10-2016 11h 47m 24s

# Whether the backups should be in a zip file or in a folder. zipbackups: true

# The folder where to store the backups locally. localpath: 'plugins/PerfectBackup/backups'

# The maximum backups stored. Will delete older backups when reached. (≤ 0 to disable) # Note: this will only work with local backups (fallbacks included). maxbackups: -1

# Whether or not the plugin should broadcast when automatic backups start/end. # If this is set to false, only players with the PerfectBackup.warning permission will see it. broadcast: false

# Whether or not the plugin should broadcast when manual backups start/end. # If this is set to false, only players with the PerfectBackup.warning permission will see it. manualbroadcast: true

# Whether or not you should see detailed information while creating a backup. debug: false

# Whether or not the server should be restarted when a backup is restored. # This will run the command line "cd dirname" and "java -server -jar jarfile" # dirname being the directory to the server and jarfile the first .JAR file found in the server directory restorerestart: true

# FTP settings and configuration. # Different modes (when to use FTP): # - NEVER (disable) # - FALLBACK (when an error occurs) # - LIMIT (move files when maxbackups is reached)

# - FIRST (除非出错,否则优先使用 FTP) # - ALWAYS (仅保存到 FTP,从不使用本地) # - BOTH (同时保存到 FTP 和本地) ftp: mode: NEVER host: 'localhost' port: 21 user: 'PerfectUser' pass: 'P3rf3c7P455w0rd' path: '~/PerfectBackups/'

# 你想要备份的内容。 backup: jarfile: false # 服务器的 .jar 文件(例如 craftbukkit.jar) properties: true # server.properties 文件 ops: true # ops.json 文件 whitelist: false # whitelist.json 文件 spigotyml: true # 如果是 Spigot,则为 spigot.yml 文件 bukkityml: true # bukkit.yml 文件 aliases: false # commands.yml 文件 eula: false # eula.txt 文件 metrics: false # PluginMetrics 文件夹 logs: false # logs 文件夹,包含所有的 zip 文件(警告!这会使你的备份变得非常慢且体积巨大!) pluginjars: true # 插件的 .jar 文件 pluginconfs: true # 每个插件的数据文件夹 worlds: # 若要排除所有世界请使用 [],若要包含所有世界请使用 - '*'。 - 'world' - 'world_nether' - 'world_the_end' other: # 任何你想备份的其他文件,在文件名前加上 "!" 将阻止其被备份(重要!目录请使用 / 分隔符!) - 'plugins/PluginMetrics' - '!plugins/Essentials' - '!plugins/WorldEdit' - '!plugins/PerfectBackup/backups'

在这个配置中(它是默认配置),我们可以看到:

Interval

这是每次自动备份之间的时间间隔。
它必须具有“数字 + 空格 + 单位”的格式。
可用的单位是 t(刻)、s(秒)、m(分钟)、h(小时)和 d(天)。
如果你输入了无效值(例如 none,或者留空),它将禁用自动备份。
默认为 "2 h"(2 小时)。

Cron Task

以下是 6 个 cron 任务组件:
1/ 秒(0-59)
2/ 分钟(0-59)
3/ 小时(0-23)
4/ 日期(1-31)
5/ 月份(1-12)
6/ 星期几(1-7)
默认为 "0 0 4 * * *"(每天凌晨 4 点)。
你也可以使用例如:
crontask: '0 0 * * * *'(这将使其每小时执行一次)
crontask: '0 0 4 * * 7'(这将使其每周日凌晨 4 点执行一次)
crontask: '0 0 4 1 * *'(这将使其每月 1 号凌晨 4 点执行一次)

Backup Format

这是保存备份时备份名称的格式。
如果有多个备份具有相同的名称,第二个将添加 "_1",第三个添加 "_2",依此类推。
使用 {DATE} 插入日期,格式由 dateformat 设置决定。
默认为 "PerfectBackup {DATE}"。

Date Format

这是用于备份格式的日期格式。
你可以使用例如:
24 小时制:'MM-DD-YYYY hhh mmm sss'(默认)
AM/PM(12 小时制):'MM-DD-YYYY HHh mmm sss AM'

Zip Backups

如果设置为 true,备份将存储在 zip 文件中。
如果设置为 false 或其他值,它们将被保存在普通文件夹中。
默认为 true。

Local Path

在本地存储备份的文件夹。默认为 "plugins/PerfectBackup/backups"。

Max Backups

本地存储的最大备份数量。
一旦达到限制,最旧的备份将被删除。
默认为 -1(无限制)。

Broadcast
ManualBroadcast
Debug

如果设置为 true,将在创建备份时显示详细信息(对调试有用)。
如果不是,则只显示重要信息(开始、错误、结果)。
默认为 false。

Restart on Restore

如果设置为 true,当还原备份时服务器将重启。
这使得操作更简单,你无需手动重启服务器。
警告!在某些托管服务上这可能会导致控制台出现 bug。
这是通过两个命令完成的:
- cd <dirname>(dirname 是你的服务器目录)
- java -server -jar <jarfilepath>(jarfilepath 是你服务器目录中找到的第一个 JAR 文件的路径)
默认为 true,但通常不建议开启此选项。

FTP

在此处配置 FTP 备份存储。

  • Mode: 何时应使用 FTP(NEVER/FALLBACK/LIMIT/FIRST/ALWAYS/BOTH)。
  • Host: 访问你的 FTP 服务器的主机地址。
  • Port: FTP 服务器的端口(默认为 21)。
  • User: 用于登录你的 FTP 服务器的用户。
  • Pass: 用于以上述用户身份认证的密码。
  • Path: 备份将存储在服务器上的目录。
Backup

在此处配置哪些内容将被备份或不被备份。

  • JAR File: 是否应该备份服务器的 JAR 文件。
  • Properties:是否应备份 server.properties 文件。
  • OPs:是否应备份 ops.json 文件。
  • Whitelist:是否应备份 whitelist.json 文件。
  • Spigot YML:是否应备份 spigot.yml 文件。
  • Bukkit YML:是否应备份 bukkit.yml 文件。
  • Aliases:是否应备份 commands.yml 文件。
  • EULA:是否应备份 eula.txt 文件。
  • Metrics:是否应备份 Metrics 文件夹。
  • Logs:是否应备份 logs 文件夹(警告!这会使你的备份变慢且非常庞大!)。
  • Plugin JARs:是否应备份插件 JAR 文件。
  • Plugin Configurations:是否应备份插件数据文件夹。
  • Worlds:将备份的世界,使用 [] 表示无,使用 - '*' 表示所有世界。
  • Other Files:任何你想备份的其他文件,在文件名前加 "!" 可防止其被备份。使用 "/" 分隔目录。

权限 此插件中有四个权限节点,对应四个命令:

  • PerfectBackup.backup:允许你使用 /backup 命令。
  • PerfectBackup.list:允许你使用 /backups 命令。
  • PerfectBackup.restore:允许你使用 /restore 命令。
  • PerfectBackup.testftp:允许你使用 /testftp 命令。

待办与错误

待办列表
  • 添加 /testftp 命令以测试 FTP 连接。
  • 支持 SFTP 连接及其他远程协议。
  • 在 /backups、/restore 和 /delbackup 命令中支持远程备份。
  • 增加对更多 cron 格式的支持(至少包括 ","、"-" 和 "/")。
  • 添加一个 "dirtyonly" 设置,仅备份自上次备份以来发生更改的文件。
  • 添加一个命令以完全还原某个备份(删除所有旧文件并仅还原之前备份中保存的文件)。
  • 添加一个命令以仅还原某些文件,例如地图或地图内的区域。

如果你希望添加或修改某些内容,或者有任何疑问,请在评论区告诉我!

已知错误

如果你发现任何错误,请提交工单描述问题,以便我修复它!

工作原理 此插件的工作原理相当简单,但包含一些复杂的功能。
例如,文件的压缩和解压花了我不少时间才弄明白。
我还不得不将插件制作成一个可运行的 JAR 文件,以便它可以用于还原备份。
在我的代码中,共有五个类:

  1. MetricsLite 类,由 Hidendra 提供
  2. 主类 PerfectBackup,负责所有命令、配置以及自动备份功能。
  3. CronRunnable API,这是我自行编写的,当匹配到定时任务时执行相应的操作。
  4. BackupRestorer 类,包含 main(String[] args) 方法,在运行该 JAR 文件时执行。
  5. 最后但同样重要的是 BackupUtils 类,处理其他所有事务,包括备份的创建/还原、日期格式化、FTP 操作以及文件的:(解)压缩、复制/移动、删除。

这只是为了让你清楚服务器上正在发生的事情。
我不允许你复制此插件或其任何部分。
如果你对其进行修改,你将不会获得任何支持,也没有任何保障。

更多详情

帮助我

如果你喜欢我的插件,请分享它们、下载它们,并考虑通过页面右上角的按钮进行捐赠。
感谢你们给予的所有支持,我希望我的插件能继续帮助你。
我尽量保持插件尽可能最新,但有时我没有时间立即更新,所以可能会有些延迟。
但别忘了更新它们,让你的服务器获得最新功能!

常见问题解答

我没什么好说的了。不过我觉得做个问答环节挺合适的,那就来吧:

问:你还会继续更新这个插件吗?
答:很遗憾,不会了。由于学业和个人项目的原因,我没什么时间,所以我的大多数公共插件都不会频繁更新。
但我会听取大家提出的建议,并尽快实现它们(对于付费插件,通常在几小时内完成)。

问:有没有视频可以让我看看这个插件是怎么工作的?
答:有的,AbsintoJ 很慷慨地制作了一个视频。

问:它在 1.7 和 1.8 上能用吗?
答:应该可以,但由于它是为 1.8 设计的,我并没有在 1.7 上进行过实际测试。

问:为什么控制台里会显示 [Metrics]?
答:这是为了收集关于我插件的统计数据,我使用的是 Hidendra 开发的 MetricsLite。

问:恢复后的自动重启不起作用,为什么?
答:这可能是因为你的主机服务商阻止了我使用的命令。
或者是因为你的服务器根目录下有其他不是服务器 JAR 文件的文件。

问:为什么要叫“PerfectBackup”?
答:因为这是一个完美的工具,只需一条命令就能帮助你创建和恢复备份。

题外话

问:你为什么创建这个插件?/ 是什么动机让你去开发插件?
答:我喜欢创造东西,编程是我最喜欢的活动,而且我也热爱 Minecraft,于是我将两者结合,开始制作插件。
对于这个插件,昨天早上醒来时我觉得有点无聊,所以就做了这个,搞定。

问:你开发一个插件需要多长时间?
答:这个插件最初花了我一天时间,但我经常维护和对其进行工作。
有些可能需要三到四天(迷你游戏甚至超过一周)。

还有其他问题吗?

如果你有关于这个插件或其他任何问题:

  1. 私信我,我会将 Q + A 添加到这里。
  2. 在下面的评论中问我,我会回复。
  3. 如果是针对此插件的建议或错误报告,请提交工单。

Statistics Global statistics

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源