{"id":18654981,"url":"https://github.com/hmlendea/minecraft-server-raspberrypi","last_synced_at":"2025-04-11T17:31:52.320Z","repository":{"id":74299450,"uuid":"284342111","full_name":"hmlendea/minecraft-server-raspberrypi","owner":"hmlendea","description":"My Minecraft server optimised for Raspberry Pi 4","archived":false,"fork":false,"pushed_at":"2025-04-08T22:17:15.000Z","size":47402,"stargazers_count":7,"open_issues_count":1,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-08T23:23:44.087Z","etag":null,"topics":["minecraft-raspberry-pi","minecraft-server","minecraft-server-raspberry-pi","raspberry-pi"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hmlendea.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":null,"patreon":"hmlendea","open_collective":null,"ko_fi":"hmlendea","tidelift":null,"community_bridge":null,"liberapay":"HMlendea","issuehunt":null,"otechie":null,"custom":"https://hmlendea.go.ro/fund.html"}},"created_at":"2020-08-01T21:32:28.000Z","updated_at":"2025-04-08T22:17:19.000Z","dependencies_parsed_at":"2023-07-08T17:45:13.092Z","dependency_job_id":"9836d18c-e16f-4aaf-baf4-a143927eabca","html_url":"https://github.com/hmlendea/minecraft-server-raspberrypi","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hmlendea%2Fminecraft-server-raspberrypi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hmlendea%2Fminecraft-server-raspberrypi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hmlendea%2Fminecraft-server-raspberrypi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hmlendea%2Fminecraft-server-raspberrypi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hmlendea","download_url":"https://codeload.github.com/hmlendea/minecraft-server-raspberrypi/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248449832,"owners_count":21105570,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["minecraft-raspberry-pi","minecraft-server","minecraft-server-raspberry-pi","raspberry-pi"],"created_at":"2024-11-07T07:17:18.400Z","updated_at":"2025-04-11T17:31:49.937Z","avatar_url":"https://github.com/hmlendea.png","language":"Shell","funding_links":["https://patreon.com/hmlendea","https://ko-fi.com/hmlendea","https://liberapay.com/HMlendea","https://hmlendea.go.ro/fund.html"],"categories":[],"sub_categories":[],"readme":"[![Donate](https://img.shields.io/badge/-%E2%99%A5%20Donate-%23ff69b4)](https://hmlendea.go.ro/fund.html)\n\n# About\n\nThis 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.\n\nThe 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.\n\n## Prerequisites\n\nBefore you can use this server, you'll need to make sure you have the following prerequisites:\n\n- A Raspberry Pi 4\n- A compatible power supply\n- An SD card with a Linux-based OS installed\n- Java 16 or later installed on your Raspberry Pi\n\n# Installation\n\n## Web server\n\n**Note**: The web server is only required if you want to use map plugins (such as DynMap, Pl3xMap, etc)\n\nInstall the following packages: `lighttpd`, `fcgi`, `php-cgi`\n\nUpdate `/etc/lighttpd/lighttpd.conf` to:\n\n```\nserver.port             = 25550\nserver.username         = \"http\"\nserver.groupname        = \"http\"\nserver.document-root    = \"/srv/http\"\nserver.errorlog         = \"/var/log/lighttpd/error.log\"\ndir-listing.activate    = \"enable\"\nindex-file.names        = ( \"index.html\" )\nmimetype.assign         = (\n\t\t\t\t\".html\" =\u003e \"text/html\",\n\t\t\t\t\".txt\" =\u003e \"text/plain\",\n\t\t\t\t\".css\" =\u003e \"text/css\",\n\t\t\t\t\".js\" =\u003e \"application/x-javascript\",\n\t\t\t\t\".jpg\" =\u003e \"image/jpeg\",\n\t\t\t\t\".jpeg\" =\u003e \"image/jpeg\",\n\t\t\t\t\".gif\" =\u003e \"image/gif\",\n\t\t\t\t\".png\" =\u003e \"image/png\",\n\t\t\t\t\"\" =\u003e \"application/octet-stream\"\n\t\t\t)\ninclude \"conf.d/fastcgi.conf\"\n```\n\nCreate the `/etc/lighttpd/conf.d/fastcgi.conf` file with:\n\n```\nserver.modules += (\"mod_fastcgi\")\nindex-file.names += (\"index.php\")\nfastcgi.server = (\n    \".php\" =\u003e (\n        \"localhost\" =\u003e (\n            \"bin-path\" =\u003e \"/usr/bin/php-cgi\",\n            \"socket\" =\u003e \"/tmp/php-fastcgi.sock\",\n            \"broken-scriptfilename\" =\u003e \"enable\",\n            \"max-procs\" =\u003e \"4\",\n            \"bin-environment\" =\u003e (\n                \"PHP_FCGI_CHILDREN\" =\u003e \"1\"\n            )\n        )\n    )\n)\n```\n\n### DynMap\n\nNext we need to allow the web server to send chat messages to the Minecraft server by running the following commands:\n\n```\ntouch /srv/http/standalone/dynmap_webchat.json\nchown http /srv/http/standalone/dynmap_webchat.json\n```\n\n## Configuration\n\nThe 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:\n\nUpdating or customising those configurations should be done through the `scripts/configure-settings.sh` script.\n\n## Usage\n\nThis server is designed to be easy to use and maintain. To start the server, simply run the following command:\n```bash\n./start.sh\n```\n\nThis will start the server with the pre-configured settings and Java flags. To stop the server, simply use `Ctrl+C` in the terminal.\n\n## Contributing\n\nIf 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!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhmlendea%2Fminecraft-server-raspberrypi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhmlendea%2Fminecraft-server-raspberrypi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhmlendea%2Fminecraft-server-raspberrypi/lists"}