Systemd unit files for use with the Minecraft Server and associated services (backup and stats).
This repository has been archived on 2024-07-17. You can view files and clone it, but cannot push or open issues or pull requests.
Go to file
Adam Douglas e1773a7889 docs: add hyperlinks 2020-02-06 22:46:34 -06:00
CHANGELOG.md docs: add changelog, license and readme 2020-02-06 22:41:06 -06:00
LICENSE docs: add changelog, license and readme 2020-02-06 22:41:06 -06:00
README.md docs: add hyperlinks 2020-02-06 22:46:34 -06:00
minecraft-backup.service refacotr: clean up 2020-02-06 21:39:09 -06:00
minecraft-backup.timer Initial commit 2020-01-03 03:02:28 +00:00
minecraft-paper.service feat: add unit 2020-02-06 21:35:06 -06:00
minecraft-spigot.service feat: add unit 2020-02-06 21:35:06 -06:00
minecraft-stats.service refactor: change description to be more descriptive 2020-02-06 21:47:29 -06:00
minecraft-stats.timer refacotr: clean up 2020-02-06 21:39:09 -06:00
minecraft-vanilla.service feat: add unit 2020-02-06 21:35:06 -06:00

README.md

What Is Minecraft Server Systemd Services?

Systemd unit files for use with the Minecraft Server and associated services (backup and stats).

Features

  • Supports use with Minecraft server software PaperMC, SpigotMC and Vanilla.
  • Backup the Minecraft server directory.
    • To an archive.
    • Sync to a desired destination.
  • Keep MinecraftStats data synced.

System Requirements

Installation

Assumptions

  • Installed all required dependencies as stated in System Requirements section.
  • Dependencies are accessible via environment PATH.
  • Installation is done via Linux CLI.
  • Steps prefixed with a "$" (dollar sign) represents the CLI prompt. The text after the "$" is to be entered at the CLI.
  • Steps prefixed with a "#" (number sign) represents the CLI prompt with elevated user permissions (e.g. root). The text after the "#" is to be entered at the CLI.
  • A single backslash character beside another character is used to escape the proceeding character. In this case backslash character is not to to be entered at the CLI.
  • These instructions are an example of installation and configuration.

On Linux - Manual

  1. Change to your home directory.
$ cd ~
  1. Download the project.
$ git clone git@gitlab.com:adouglas/minecraft-systemd-services.git
  1. Change to the project directory.
$ cd minecraft-systemd-services
  1. Set file permissions.
$ chmod 644 minecraft-\*
  1. Set file ownership and group.
$ chown root:root minecraft-\*
  1. Move Systemd unit files.
# mv minecraft-\* /etc/systemd/system/
  1. Enable services.
# systemctl enable minecraft-paper.service
# systemctl enable minecraft-backup.timer
# systemctl enable minecraft-stats.timer

Usage

For an even simpler usage at the CLI run "wardenctl help" without double quotes.

Useful Command Examples

Action Command Example Notes
Reload all unit files systemctl daemon-reload Required after modifying unit file(s).
Restart unit systemctl restart minecraft-paper.service
Start unit systemctl start minecraft-paper.service
Stop unit systemctl stop minecraft-paper.service
View unit status systemctl status minecraft-paper.service
View unit messages journalctl -u minecraft-paper.service
View unit messages journalctl -fu minecraft-paper.service View most recent entries and follow new entries as they occur. Press CTRL-C to quit.

Copyright Notice

Copyright (c) 2019-2020 Adam Douglas Some Rights Reserved