BackupMe

Implements the "Pterodactyl backup system" but can also backup your server without restarting it and mainly made for those who don't use Pterodactyl to use This plugin implements a backup system that works like the "Pterodactyl backup system"

Configuration

Options

Option	Description
enable-plugin	The plugin power switch. If this option is false, the plugin will disable on load.
archiver-format	The archiver format that will be use
backup-name	The name format that the backup archive file will be used, please see the available name format tag list!
file-checker-interval	The interval in seconds between every time the file checker checks if a backup.me is created.
ignore-disk-space	Continue to do a server backup even if the server disk is not having enough space.
check-for-file	File name for the file checker to check (Default backup.me)
operation-log	Will a debug log message be send when a file is added or ignored (This might cause a console spam!)

Available archiver formats

ID	Format
0	Zip
1	Gz
2	Bzip2

Name format tags

Tag	Replacement
{y}	Current year represented by a two-digit number
{m}	Current month represented by a two-digit number
{d}	Current date represented by a two-digit number
{h}	Current hour represented by a two-digit number
{i}	Current minute represented by a two-digit number
{s}	Current second represented by a two-digit number
{format}	The chosen backup archiver format (zip / tar)
{uuid}	A universal unique identifier of the current backup archive task

Examples formats:

• backup-{y}-{m}-{d} {h}-{i}-{s}.{format}
• backup_my_server_{uuid}.{format}
• backup {y}-{m}-{d} ({uuid}).{format}

backupignore.gitignore

Backup ignore is only available on Linux servers at the moment! You can input certain rules to prevent the backup archiver from adding that file to the backup archive file.

This file is using the GitIgnore syntax (I will replace this with another file pattern regex system since this thing requires an additional GitIgnoreChecker library and causes many issues when this plugin is running on other OS such as Windows)

Example rules (For people who have never used the GitIgnore syntax before)

Rules	What this rule means
/plugins/	The plugins directory at the backup source directory
plugins/	All the plugins directory no matter where it is
/plugin.phar	The plugin.phar file at the backup source directory
plugin.phar	The plugin.phar file at anywhere
plugin.*	The plugin file but any file extension names will match this rule
*.phar	Any .phar files
!worlds/*	None of all in any of the worlds directory

Start backup

Create a file name backup.me at the server root directory or use the /backupme command from console or in-game. When the file checker finds it, a server backup will be started.

Please do not turn off the server during the backup

If a message with the backup task used time, the total amount of added files and ignored files popup. It means that the backup task is completed, you can do whatever you want at that time. The backup archive file will be generated at the server root directory (Where you create the backup.me file)

Permissions

Permission	Command
backupme.cmd.backup	/backupme

API

Custom backup requests

Event

Other plugins can manually start a server backup by calling a \Endermanbugzjfc\BackupMe\events\BackupRequestEvent event

Customize

Member function name	Action
setBackupIgnoreContent(string $content)	Overwrite the original backup ignore file contents
setName(string $name)	Overwrite the original backup archive file name
setFormat(int $format)	Overwrite the original backup archiver format

Available archiver formats (All in \Endermanbugzjfc\BackupMe\BackupRequestListener):

• BackupRequestListener::ZIP
• BackupRequestListener::TARGZ
• BackupRequestListener::TARBZ2