Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/hmlendea/minecraft-server-raspberrypi
My Minecraft server optimised for Raspberry Pi 4
https://github.com/hmlendea/minecraft-server-raspberrypi
minecraft-raspberry-pi minecraft-server minecraft-server-raspberry-pi raspberry-pi
Last synced: about 2 months ago
JSON representation
My Minecraft server optimised for Raspberry Pi 4
- Host: GitHub
- URL: https://github.com/hmlendea/minecraft-server-raspberrypi
- Owner: hmlendea
- License: gpl-3.0
- Created: 2020-08-01T21:32:28.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2024-10-30T09:17:31.000Z (2 months ago)
- Last Synced: 2024-10-30T10:25:33.594Z (2 months ago)
- Topics: minecraft-raspberry-pi, minecraft-server, minecraft-server-raspberry-pi, raspberry-pi
- Language: Shell
- Homepage:
- Size: 45.5 MB
- Stars: 5
- Watchers: 3
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
[](https://hmlendea.go.ro/fund.html)
# About
This repository contains a lightweight Minecraft server optimized for running on a Raspberry Pi 4. The server uses PurpurMC, a high-performance Minecraft server implementation that is based on the popular PaperMC software.
The server is pre-configured with optimized settings files and scripts for dynamically changing server and plugin settings to ensure the best possible performance on a Raspberry Pi 4.
## Prerequisites
Before you can use this server, you'll need to make sure you have the following prerequisites:
- A Raspberry Pi 4
- A compatible power supply
- An SD card with a Linux-based OS installed
- Java 16 or later installed on your Raspberry Pi
# Installation
## Web server
**Note**: The web server is only required if you want to use map plugins (such as DynMap, Pl3xMap, etc)
Install the following packages: `lighttpd`, `fcgi`, `php-cgi`
Update `/etc/lighttpd/lighttpd.conf` to:
```
server.port = 25550
server.username = "http"
server.groupname = "http"
server.document-root = "/srv/http"
server.errorlog = "/var/log/lighttpd/error.log"
dir-listing.activate = "enable"
index-file.names = ( "index.html" )
mimetype.assign = (
".html" => "text/html",
".txt" => "text/plain",
".css" => "text/css",
".js" => "application/x-javascript",
".jpg" => "image/jpeg",
".jpeg" => "image/jpeg",
".gif" => "image/gif",
".png" => "image/png",
"" => "application/octet-stream"
)
include "conf.d/fastcgi.conf"
```
Create the `/etc/lighttpd/conf.d/fastcgi.conf` file with:
```
server.modules += ("mod_fastcgi")
index-file.names += ("index.php")
fastcgi.server = (
".php" => (
"localhost" => (
"bin-path" => "/usr/bin/php-cgi",
"socket" => "/tmp/php-fastcgi.sock",
"broken-scriptfilename" => "enable",
"max-procs" => "4",
"bin-environment" => (
"PHP_FCGI_CHILDREN" => "1"
)
)
)
)
```
### DynMap
Next we need to allow the web server to send chat messages to the Minecraft server by running the following commands:
```
touch /srv/http/standalone/dynmap_webchat.json
chown http /srv/http/standalone/dynmap_webchat.json
```
## Configuration
The server is pre-configured with optimized settings files and scripts for dynamically changing server and plugin settings. However, if you need to customize the server settings, you can do so by editing the following files:
Updating or customising those configurations should be done through the `scripts/configure-settings.sh` script.
## Usage
This server is designed to be easy to use and maintain. To start the server, simply run the following command:
```bash
./start.sh
```
This will start the server with the pre-configured settings and Java flags. To stop the server, simply use `Ctrl+C` in the terminal.
## Contributing
If you would like to contribute to this project, feel free to submit a pull request or open an issue on GitHub. We welcome all contributions, big or small!