2015-07-11 08:13:10 +00:00
# Minecraft Server Manager [![Build Status][status-img]][status] [![Donate to MSM][donate-img]][donate]
2016-01-15 21:28:18 +00:00
[status-img]: https://api.travis-ci.org/msmhq/msm.svg?branch=master
2015-07-11 08:13:10 +00:00
[status]: http://travis-ci.org/msmhq/msm
[donate-img]: https://www.paypalobjects.com/en_GB/i/btn/btn_donate_SM.gif
[donate]: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick& hosted_button_id=Z7XQDNF7U5GLL
2012-05-22 15:12:57 +00:00
A single init script which makes running multiple Minecraft/Bukkit servers easier for us admins.
2012-05-19 16:50:22 +00:00
2012-11-03 22:42:28 +00:00
## Quick Installers
2012-08-12 01:58:19 +00:00
2012-11-03 22:42:28 +00:00
Install MSM on a **debian box** :
2012-08-12 01:58:19 +00:00
2012-11-03 22:42:28 +00:00
wget -q http://git.io/Sxpr9g -O /tmp/msm & & bash /tmp/msm
2012-08-12 01:58:19 +00:00
2012-11-03 22:42:28 +00:00
Or install MSM under **RedHat** :
wget -q http://git.io/lu0ULA -O /tmp/msm & & bash /tmp/msm
Or [suggest a new platform][issues].
2012-08-12 01:58:19 +00:00
2012-07-13 19:29:58 +00:00
## Getting Started
2012-05-29 06:05:10 +00:00
2012-07-15 00:20:19 +00:00
* [Install][install] MSM on your box.
2012-07-15 00:22:31 +00:00
* [Visit the docs][docs] for help with getting started.
2012-07-13 19:29:58 +00:00
* Fork and contribute your own modifications.
* Not a coder? [Post an issue][issues] with your idea for MSM instead.
2012-07-13 19:33:05 +00:00
* Read the [changelog][changelog] to get a picture of how MSM has evolved over time.
2012-07-13 19:29:58 +00:00
MSM is released under the GPLv3 licence, which is included in the repository [here][licence]. I'm open to suggestions where licencing is concerned.
2012-06-06 02:53:26 +00:00
2012-05-19 16:50:22 +00:00
## Features
2012-05-31 10:50:54 +00:00
As well as starting, stopping and restarting MSM has the following features:
2012-05-22 15:12:57 +00:00
* One script handles multiple servers, run two or more servers on one machine.
* Can create and start new servers with a single command, downloads the jars for you.
* Periodically makes [WorldEdit snapshot][we-snapshot] compatible backups of your worlds.
2012-05-31 10:50:54 +00:00
* Backup the entire server directory for complete protection.
2012-05-22 15:12:57 +00:00
* Load world's into RAM for faster access (reduces lag).
2012-05-31 10:50:54 +00:00
* Easily configurable global defaults, with per server overrides if needed.
2012-05-22 15:12:57 +00:00
* Apply server commands to one, multiple, or all servers in one go (useful for whitelisting a player on all servers.)
2012-05-31 10:50:54 +00:00
* Tab completion for all commands, makes everything faster and getting started a breeze.
* Keep server logs organsied by periodically "rolling" them.
* Organises jar files into groups (such as minecraft and craftbukkit) and links each server to a single jar. Includes automated download of new versions.
* Plethora of in-game commands (whitelist, blacklist, operator, gamemode, kick, say, time, toggledownfall, save)
* Send commands straight to the server via the command line.
2012-05-19 16:50:22 +00:00
2012-07-15 18:16:38 +00:00
## Support
1. If you find a problem with MSM and you think the problem is one that requires changing code [submit an issue][issues] via GitHub.
2012-06-27 17:23:01 +00:00
2016-01-19 04:42:15 +00:00
## Upcoming features
2012-05-19 16:50:22 +00:00
2012-05-31 09:27:07 +00:00
* **QuickBackup:** If you store your backups non-locally (maybe on a NAS), QuickBackup optionally creates a backup locally for speed, and then moves it after your players are building again! My initial testing shows a 54 second network backup confaltes to 23 seconds of in-game time.
2012-05-31 10:50:54 +00:00
* **Restore:** Roll-back to an old world or whole server backup automatically.
2012-05-19 16:50:22 +00:00
2012-06-27 17:23:01 +00:00
## Versioning
MSM uses semantic version numbers to better describe what code one might have installed, and indicate backwards incompatible changes.
2012-11-19 18:07:22 +00:00
Releases will be numbered in the following format:
2012-06-27 17:23:01 +00:00
`<major>.<minor>.<patch>`
And constructed with the following guidelines:
* Breaking backward compatibility bumps the major (and resets the minor and patch)
* New additions without breaking backward compatibility bumps the minor (and resets the patch)
* Bug fixes and misc changes bumps the patch
2012-11-19 18:08:24 +00:00
For more information on SemVer, visit http://semver.org/.
2012-06-27 17:23:01 +00:00
2012-05-19 16:50:22 +00:00
## Acknowledgements
This code grew out of an old version of [Ahtenus' Minecraft Init Script][ahtenus-minecraft-init].
2012-05-29 06:05:10 +00:00
[we-snapshot]: http://wiki.sk89q.com/wiki/WorldEdit/Snapshots
[ahtenus-minecraft-init]: https://github.com/Ahtenus/minecraft-init
2012-11-03 17:34:16 +00:00
[docs]: http://msmhq.com/docs/
[install]: http://msmhq.com/docs/installation.html
2015-07-15 16:36:16 +00:00
[changelog]: https://github.com/msmhq/msm/blob/master/CHANGELOG.markdown
[licence]: https://github.com/msmhq/msm/blob/master/LICENSE.markdown
[issues]: https://github.com/msmhq/msm/issues
