MCDR2Restic
mcdreforged.com
- Windows
- Linux
- Self-hosted
What MCDR2Restic is
MCDR2Restic is an open-source MCDReforged plugin for running restic backups of selected directories while a server operates. It supports scheduled jobs, immediate backups, and stopping a backup already in progress. Scheduled work can be skipped when no players are active, while a separate forced-scheduling setting bypasses that check and is disabled by default. With its default configuration, the plugin downloads a system restic binary when none is present in the MCDR working directory. Restore commands can queue and apply a complete snapshot, one file, or a folder. Notifications can be sent through OneBot QQ or Discord Webhook. A configuration check requires the local restic repository to be outside every backup source directory. MCDR2Restic runs on Linux and Windows in self-hosted setups, requires MCDReforged, PyYAML, and websocket-client, and supports Chinese and English messages. It is free under GPL-3.0, though its README may contain outdated information.
Who it suits
It suits MCDReforged server operators who need restic-based scheduled backups and restores. Users should understand restic concepts and be able to use restic independently.
Good to know, and what to watch
- Scheduled and immediate backup options
- Restores snapshots, files, and folders
- Automatic restic binary download
- OneBot QQ and Discord notifications
- Chinese and English messages
- Requires restic knowledge
- README may contain outdated information
- Requires three listed dependencies
The verdict
MCDR2Restic adds scheduling, notifications, activity-aware jobs, and restore commands to restic backups in MCDReforged. It is most suitable for operators comfortable configuring restic and maintaining a self-hosted server.
What the maker publishes
- Activity detection
- Scheduled backups can be skipped when the server is idle, and a separate forced scheduling option bypasses player activity detection and is disabled by default. source
- Backup scheduling
- It supports scheduled backups, immediate backups, and interrupting an ongoing backup task. source
- Dependencies
- The plugin lists MCDReforged >=2.12.0, PyYAML >=6.0, and websocket-client >=1.8.0 as requirements. source
- Documentation caveat
- The README says it is being refactored and may contain outdated information. source
- Languages
- The project supports Chinese and English messages and configuration comments, following the MCDR language setting. source
- License
- The project is released under the GNU General Public License v3.0 (GPL-3.0). source
- Notifications
- It supports OneBot QQ notifications and Discord Webhook notifications. source
- Player activity
- Scheduled backups can be skipped when no players are active; forced scheduling is also supported and disabled by default. source
- Prerequisite
- The maker recommends that users understand restic's basic concepts and configuration and be able to use restic independently. source
- Prerequisites
- The documentation recommends understanding and being able to use restic independently because most backup features require basic restic knowledge. source
- Purpose
- MCDR2Restic is an MCDReforged plugin that runs scheduled restic backups of specified directories while the server is running. source
- Repository safety
- A configuration check requires the local restic repository to be outside every backup source directory. source
- Restic download
- With the default configuration, the plugin automatically downloads a restic binary for the system if it is not found in the MCDR working directory. source
- Restore
- The plugin provides commands to queue and apply full-snapshot, single-file, and folder restores. source
- Restore
- The plugin supports queued full-snapshot, single-file, and folder restores. source
- Scheduling
- It supports scheduled backups, immediate backups, and interrupting an ongoing backup task. source
- Support
- The project welcomes pull requests and issues. source
Checked against the maker's pages on 9 Oct 2026.