Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

MCDR2Restic

mcdreforged.com

  • Windows
  • Linux
  • Self-hosted
6.2 Club score Visit mcdreforged.com

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.