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

mcwrapper

github.com

  • Free plan
  • macOS
  • Linux
7.1 Club score Visit github.com

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.