mcwrapper
github.com
- Free plan
- macOS
- Linux
What mcwrapper is
mcwrapper is a free Minecraft server wrapper for Linux, macOS, and other POSIX-compatible systems, designed for server administrators. It can start, stop, and restart a server, check its status, and pass commands through a named pipe called command_input. Its backup action disables world-data writing while it copies and compresses world data, then enables writing again. Backups get timestamps, a latest symlink, and a default retention of five backups. The restore action can stop the server, save current data, replace the world directory with a selected backup, and restart the server if it had been running. Restoring disconnects connected clients because it requires an interruption. The log action follows the Minecraft server log in real time, while the install action downloads the current minecraft_server.jar from Mojang. Configuration can be supplied through environment variables or mcwrapper.conf files in documented locations. Installation is available from RubyGems.org using gem install mcwrapper. The project provides a README and wiki pages covering setup, actions, configuration, and automated backups.
Who it suits
mcwrapper suits administrators managing Minecraft Java servers on Linux, macOS, or other POSIX-compatible systems. It is useful for those who want command-line server control and local backup and restore actions.
Good to know, and what to watch
- Can start, stop, restart, and check server status.
- Backups are timestamped and include a latest symlink.
- Default backup retention is five backups.
- Can follow the server log in real time.
- MIT License permits use and modification under its terms.
- Restoring disconnects connected clients.
- Restore replaces the world directory with a full backup.
- The MIT License provides the software as-is without warranty.
The verdict
mcwrapper combines server control, log following, and world backup actions for POSIX-compatible systems. Plan restores for an interruption, since connected clients are disconnected during the process.
What the maker publishes
- Backup retention
- Backups are timestamped, a latest symlink is created, and the default retention is five backups. source
- Backup retention
- Backups are timestamped, a `latest` symlink is created, and the default retention is the latest five backups. source
- Backups
- Its backup action safely backs up world data by disabling world-data writing, copying and compressing data, then re-enabling writing. source
- Backups
- The `backup` action disables world-data writing, copies and compresses current world data, then re-enables writing. source
- Command pipe
- mcwrapper exposes a configurable named pipe (FIFO) called `command_input` for sending commands to the server. source
- Command sending
- It sends arbitrary commands to the Minecraft server through a named pipe (FIFO) called command_input. source
- Configuration
- Configuration can be supplied through environment variables or mcwrapper.conf files searched in four documented locations. source
- Configuration
- Configuration can come from environment variables or `mcwrapper.conf`, searched in four documented locations. source
- Installation
- mcwrapper is installable from RubyGems.org with the command gem install mcwrapper. source
- Installation
- The project can be installed from RubyGems with `gem install mcwrapper`. source
- License
- The software is distributed under the MIT License, which permits use, copying, modification, distribution, sublicensing and sale subject to the license conditions. source
- License
- The software is distributed under the MIT license, which permits use, copying, modification, distribution, sublicensing, and sale subject to the license conditions. source
- Live logging
- The `log` action tails the Minecraft server log in real time. source
- Log reader
- The log action tails the Minecraft server log in real time. source
- Minecraft download
- The install action downloads the current minecraft_server.jar from Mojang and places it in the configured location. source
- Purpose
- mcwrapper is a Minecraft Server wrapper for OSX, Linux and other POSIX-compatible operating systems. source
- 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. source
- 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. source
- Restore limitation
- The `restore` action disconnects connected clients because restoring cannot be done without interruption. source
- Server control
- It can start, stop, restart and check the status of a Minecraft server. source
- Server control
- Actions include start, stop, restart, status, check, update, log, backup, restore, and command execution. source
- Server installation
- The `install` action downloads the current `minecraft_server.jar` from Mojang. source
- Support documentation
- The repository provides a README and wiki pages for getting started, actions, configuration, and automated backups. source
- Target user
- It is intended for Minecraft server administrators. source
Checked against the maker's pages on 2 Oct 2026.