MCS3-Backup

MCS3-Backup

A Spigot plugin that can back up Minecraft server worlds and upload them to S3.

Features

• Create backups of worlds (schedules configurable using cron format)
• Automatic deletion of old backups (number of backups to keep configurable in config.yml)
• Upload backups to S3 (authentication and enable/disable configurable)

Installation

1. Download the latest .jar file from Releases
2. and place it in the plugins folder.
3. Restart the server.
4. Edit plugins/MCS3-Backup/config.yml and configure the settings as needed.

Configuration

backup-time: "0 0 * * *" # Schedule backups using cron format
backup-worlds: # List of directories to back up (relative to the root directory)
- world
- world_nether
- world_the_end
backup-keep-count: 1 # Number of backups to keep

S3: # See S3 setup instructions below
enabled: false # Enable or disable uploading to S3
bucket: "your-bucket-name"
region: "ap-northeast-1"
storage-class: "STANDARD"
upload-prefix: "backups/" # Slash at the end is optional

access-key: "your-access-key"
secret-access-key: "your-secret-access-key"

S3 Setup

1. Create an IAM user with s3:PutObject permissions and obtain the Access Key and Secret Access Key.
2. Create a S3 bucket and note the bucket name and region.
3. Edit the S3 section in config.yml and enter the obtained credentials.
4. Optionally, configure the storage-class and upload-prefix.
5. Restart the server.

Commands and Permissions ( /mcs3 )

All /mcs3 commands can be executed with the MCS3Backup.commands.mcs3 permission.

• reload : Reloads all configuration items from config.yml.
• help : Displays a list of available commands.
• next : Shows the scheduled time for the next backup.

Planned Features

• Manual backup via command
• List and delete backups
• Generate download links for backups
• Automatic deletion of backups in the S3 bucket
• Reload configuration via command

License

MCS3-Backup is released under the MIT License.