minecraft-minder/README.md
zyphlar 6d22b4d999 Update 3 files
- /minecraft.php
- /README.md
- /mineautoshutdown.sh
2023-01-27 01:21:18 +00:00

44 lines
1.8 KiB
Markdown

# Minecraft server automatic startup and shutdown
A collection of scripts to start a Minecraft server on Digitalocean on demand
and automatically shut it down when not in use.
## Installation and Usage
These packages require PHP, Python3, the PIP module mcstatus, and a webserver.
`python3 -m pip install mcstatus`
Install the .php file on a webserver and configure the variables as desired.
Place the remaining files on a server with CRON (could be the same server, just
not inside the web folder) and run the shell script every 5 minutes:
`*/5 * * * * root /your/path/here/mineautoshutdown.sh 2>&1 | logger`
Ensure the same password is present in the php script and the shutdown script.
Review all other files to make sure passwords/keys/hostnames are correct.
Call the php script via HTTP using the correct password when players want to play:
`curl http://your.webserver.here/minecraft.php?action=on&password=your_password_here`
If the CRON job runs properly and has all the right variables/permissions/dependencies,
it will shut down the DO droplet about 30-40 minutes after no players are detected in the game.
## License
Copyright (C) 2023 zyphlar
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <https://www.gnu.org/licenses/>.