mcwrapper
mcwrapper is a free Minecraft server wrapper for Linux, macOS, and other POSIX-compatible systems, intended for server administrators.
What mcwrapper is
mcwrapper is a free Minecraft server wrapper for Linux, macOS, and other POSIX-compatible systems, intended for server administrators. It can start, stop, restart, and check a server's status, as well as send commands through a named pipe (FIFO) called command_input. Its backup action pauses world-data writing while it copies and compresses data, then resumes writing. Backups receive timestamps, a latest symlink is created, and the default retention is five backups. Restoring stops the server if necessary, saves current data, replaces the world directory with the selected backup, and restarts the server if it had been running; connected clients are disconnected during restoration. The log action follows the Minecraft server log in real time. An install action downloads the current minecraft_server.jar from Mojang and places it in the configured location. Settings can come from environment variables or mcwrapper.conf files in documented locations. Installation is available through RubyGems.org with the command gem install mcwrapper. The project provides a README and wiki pages covering setup, actions, configuration, and automated backups. The MIT license states that the software is provided without warranty.
Good
- Can start, stop, restart, and check server status
- Backups are timestamped and create a latest symlink
- Default backup retention is five backups
- Log action follows the server log in real time
- Can download the current server jar
Watch out
- Restore disconnects connected clients
- Restore replaces the world directory with a selected backup
- MIT license provides the software without warranty
Who it suits
It suits Minecraft Java server administrators on Linux, macOS, or other POSIX-compatible systems who want server controls and backup actions. Administrators should account for client disconnections when restoring a backup.
Verdict
mcwrapper combines basic server control with compressed backups, restoration, and live log following. Its restore process interrupts connected clients, so that limitation matters when choosing how to manage a running server.
The facts
Each one read from mcwrapper's own pages, with the date it was checked.
What it does
- Backup retention
- Backups are timestamped, a `latest` symlink is created, and the default retention is the latest five backups.checked 2 Oct 2026
- Backups
- The `backup` action disables world-data writing, copies and compresses current world data, then re-enables writing.checked 2 Oct 2026
- Command pipe
- mcwrapper exposes a configurable named pipe (FIFO) called `command_input` for sending commands to the server.checked 2 Oct 2026
- Command sending
- It sends arbitrary commands to the Minecraft server through a named pipe (FIFO) called command_input.checked 30 Sep 2026
- Configuration
- Configuration can come from environment variables or `mcwrapper.conf`, searched in four documented locations.checked 2 Oct 2026
- Installation
- The project can be installed from RubyGems with `gem install mcwrapper`.checked 2 Oct 2026
- License
- The software is distributed under the MIT license, which permits use, copying, modification, distribution, sublicensing, and sale subject to the license conditions.checked 2 Oct 2026
- Live logging
- The `log` action tails the Minecraft server log in real time.checked 2 Oct 2026
- Log reader
- The log action tails the Minecraft server log in real time.checked 30 Sep 2026
- Minecraft download
- The install action downloads the current minecraft_server.jar from Mojang and places it in the configured location.checked 30 Sep 2026
- Purpose
- mcwrapper is a Minecraft Server wrapper for OSX and Linux that starts and stops servers, sends commands, and performs safe automatic world-data backups.checked 2 Oct 2026
- Restore
- The restore action stops the server if needed, backs up current data, copies the selected backup into the world directory and restarts the server if it was running.checked 30 Sep 2026
- Restore limitation
- The `restore` action disconnects connected clients because restoring cannot be done without interruption.checked 2 Oct 2026
- Server control
- Actions include start, stop, restart, status, check, update, log, backup, restore, and command execution.checked 2 Oct 2026
- Server installation
- The `install` action downloads the current `minecraft_server.jar` from Mojang.checked 2 Oct 2026
- Support documentation
- The repository provides a README and wiki pages for getting started, actions, configuration, and automated backups.checked 2 Oct 2026
- Target user
- It is intended for Minecraft server administrators.checked 30 Sep 2026
- Warranty
- The MIT license states that the software is provided as-is without warranty.checked 2 Oct 2026
Alternatives to mcwrapper
- 1
FastBack
Free planOpen sourceLinuxmacOSWindows7.2Free plan - 2
Just Enough Backups
Free planOpen sourceLinuxmacOSSelf-hostedWindows7.1Free plan - 3
FolderRewind
Free planOpen sourceAPIWindows7.0Free plan - 4
DriveBackupV2
Free planOpen sourceAPISelf-hosted6.9Free plan - 5
MineBackup
Free planLinuxmacOSSelf-hostedWindows6.6Free plan - 6
InstantBackup
Free planLinuxmacOSSelf-hostedWindows6.5Free plan
