{"id":25832738,"url":"https://github.com/stensel8/picraft-raspberry","last_synced_at":"2025-02-28T21:40:37.794Z","repository":{"id":274327753,"uuid":"922586028","full_name":"Stensel8/picraft-raspberry","owner":"Stensel8","description":"My Minecraft server optimized for Raspberry Pi 5 (8/16GB)","archived":false,"fork":false,"pushed_at":"2025-02-23T23:50:50.000Z","size":95,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-24T00:27:07.927Z","etag":null,"topics":["minecraft","minecraft-server","raspberry-pi","raspberry-pi-5","webservers"],"latest_commit_sha":null,"homepage":"https://status.stensel.nl/","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/Stensel8.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"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}},"created_at":"2025-01-26T15:56:16.000Z","updated_at":"2025-02-23T23:53:41.000Z","dependencies_parsed_at":"2025-02-24T00:24:07.673Z","dependency_job_id":"fb928948-6dfd-43b1-b360-920b12bd7ab8","html_url":"https://github.com/Stensel8/picraft-raspberry","commit_stats":null,"previous_names":["stensel8/picraft-raspberry5"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Stensel8%2Fpicraft-raspberry","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Stensel8%2Fpicraft-raspberry/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Stensel8%2Fpicraft-raspberry/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Stensel8%2Fpicraft-raspberry/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Stensel8","download_url":"https://codeload.github.com/Stensel8/picraft-raspberry/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241245555,"owners_count":19933296,"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","minecraft-server","raspberry-pi","raspberry-pi-5","webservers"],"created_at":"2025-02-28T21:40:37.260Z","updated_at":"2025-02-28T21:40:37.788Z","avatar_url":"https://github.com/Stensel8.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Raspberry Pi Minecraft Server\n\nThis repository contains a lightweight Minecraft server optimized for running on a Raspberry Pi 5. It uses a combination of the latest **PaperMC forks/flavored servers** to deliver a smooth and efficient experience on resource-constrained devices.\n\n\u003e **Note:** This project is still under development. Contributions and feedback are welcome!\n\n## Features\n\n- **Optimized for Raspberry Pi 5:** Pre-configured with settings adjusted to the Raspberry Pi's hardware.\n- **Dynamic Dependency Management:** The `./start.sh` script auto-installs missing dependencies including:\n  - The latest PaperMC server (currently version 1.21.4)\n  - Azul Java JDK (auto-install if not found)\n- **Modern Server Configuration:** Uses optimized Java flags for better performance. (Experimental)\n\n## Prerequisites\n\nBefore using this server, ensure you have the following:\n\n- A Raspberry Pi 5 (8GB or 16GB model)\n- A compatible power supply\n- An NVMe drive with a Linux-based OS installed (NVMe HAT recommended for performance)\n- Java 21 or later installed on your Raspberry Pi (if not present, the `./start.sh` script can auto-install Azul Java JDK)\n\n## Installation\n\n### Automatic Setup\n\nSimply clone the repository and run the `./start.sh` script. This script will check for Java, download and verify the latest PaperMC jar, and install any missing dependencies:\n\n    git clone https://github.com/Stensel8/picraft-raspberry5.git\n    cd picraft-raspberry5\n    ./start.sh\n\n### Manual Java Installation (Optional)\n\nIf you prefer to manually install Java, we recommend using **Azul Zulu OpenJDK**. Below are the download links for **ARM64** (recommended for Raspberry Pi 5) and **x86_64** (for other compatible systems).\n\n#### .deb Package (Debian/Ubuntu)\n\n- **ARM64** (Raspberry Pi 5):  \n  Download from:  \n  https://cdn.azul.com/zulu/bin/zulu21.40.17-ca-jdk21.0.6-linux_arm64.deb  \n  Then install:\n  \n      sudo apt-get update\n      sudo apt-get install ./zulu21.40.17-ca-jdk21.0.6-linux_arm64.deb\n\n- **x86_64**:  \n  Download from:  \n  https://cdn.azul.com/zulu/bin/zulu21.40.17-ca-jdk21.0.6-linux_amd64.deb  \n  Then install:\n  \n      sudo apt-get update\n      sudo apt-get install ./zulu21.40.17-ca-jdk21.0.6-linux_amd64.deb\n\n#### .rpm Package (RedHat-based distros)\n\n- **ARM64** (Raspberry Pi 5):  \n  Download from:  \n  https://cdn.azul.com/zulu/bin/zulu21.40.17-ca-jdk21.0.6-linux.aarch64.rpm  \n  Then install:\n  \n      sudo rpm -i zulu21.40.17-ca-jdk21.0.6-linux.aarch64.rpm\n\n- **x86_64**:  \n  Download from:  \n  https://cdn.azul.com/zulu/bin/zulu21.40.17-ca-jdk21.0.6-linux.x86_64.rpm  \n  Then install:\n  \n      sudo rpm -i zulu21.40.17-ca-jdk21.0.6-linux.x86_64.rpm\n\n#### .tar.gz Archive (Manual Install)\n\n- **ARM64** (Raspberry Pi 5):  \n  Download from:  \n  https://cdn.azul.com/zulu/bin/zulu21.40.17-ca-jdk21.0.6-linux_aarch64.tar.gz  \n  Then extract and add the `bin` folder to your PATH:\n  \n      tar -xzf zulu21.40.17-ca-jdk21.0.6-linux_aarch64.tar.gz\n      export PATH=\"$(pwd)/zulu21.40.17-ca-jdk21.0.6-linux_aarch64/bin:$PATH\"\n\n- **x86_64**:  \n  Download from:  \n  https://cdn.azul.com/zulu/bin/zulu21.40.17-ca-jdk21.0.6-linux_x64.tar.gz  \n  Then extract and add the `bin` folder to your PATH:\n  \n      tar -xzf zulu21.40.17-ca-jdk21.0.6-linux_x64.tar.gz\n      export PATH=\"$(pwd)/zulu21.40.17-ca-jdk21.0.6-linux_x64/bin:$PATH\"\n\n\n## Web Server (Under Development)\n\nThe repository includes a web server component intended for map plugins (such as DynMap or Pl3xMap). **However, this part is currently under development and not yet usable.** We are exploring faster and more modern solutions—potentially migrating to an **nginx**-based setup—but for now, focus on the `./start.sh` script for running your server.\n\n## Configuration\n\nThe server is pre-configured with optimized settings files and dynamic configuration scripts:\n- **Server Settings:** Optimized for best performance on a Raspberry Pi.\n- **Plugin Settings:** Use the `scripts/configure-settings.sh` script to adjust server and plugin configurations as needed.\n\nTo update or customize your configurations:\n\n    ./scripts/configure-settings.sh\n\n## Usage\n\n### Starting the Server\n\nRun the following command to start your server:\n\n    ./start.sh\n\nThis script will:\n- Check for and auto-install missing dependencies (including Azul Java JDK).\n- Download and verify the PaperMC jar if not found.\n- Start the server in a tmux session.\n- Provide log file locations in case of errors.\n\n### Stopping the Server\n\nTo stop the server, simply press `Ctrl+C` in the terminal where the server is running, or attach to the tmux session and then stop the server gracefully.\n\n## Supported Minecraft Version\n\n- Currently, this server supports **Minecraft 1.21.4**.\n\n## Disclaimer\n\nThis project is experimental and still under active development. Expect bugs and incomplete features. Contributions, bug reports, and feedback are highly appreciated.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstensel8%2Fpicraft-raspberry","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstensel8%2Fpicraft-raspberry","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstensel8%2Fpicraft-raspberry/lists"}