{"id":14969641,"url":"https://github.com/officialrealtm/mcserver_installer","last_synced_at":"2026-04-05T11:01:41.638Z","repository":{"id":65369359,"uuid":"501074579","full_name":"officialrealTM/mcserver_installer","owner":"officialrealTM","description":"A powerful bash script for easy installation of a Minecraft server (Vanilla, Forge, Spigot, Paper \u0026 Leaf)","archived":false,"fork":false,"pushed_at":"2026-03-18T20:41:22.000Z","size":242,"stargazers_count":55,"open_issues_count":0,"forks_count":19,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-03-19T09:44:50.857Z","etag":null,"topics":["bash-script","debian","java","minecraft","minecraft-forge","minecraft-paper","minecraft-papermc-server","minecraft-server","papermc","papermc-minecraft-server","papermc-server","python","shell","shell-script","spigot","spigot-server","spigotmc","ubuntu"],"latest_commit_sha":null,"homepage":"https://github.com/officialrealTM/mcserver_installer","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/officialrealTM.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":"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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":["officialrealTM"]}},"created_at":"2022-06-08T02:38:05.000Z","updated_at":"2026-03-18T20:38:56.000Z","dependencies_parsed_at":"2024-07-30T13:27:10.034Z","dependency_job_id":"f9147f5c-d578-4b81-aee4-01fa35ed42b4","html_url":"https://github.com/officialrealTM/mcserver_installer","commit_stats":{"total_commits":126,"total_committers":7,"mean_commits":18.0,"dds":0.6984126984126984,"last_synced_commit":"ed5f9f0a5130519f2cc9d729f7fcb69e0f172a3b"},"previous_names":[],"tags_count":60,"template":false,"template_full_name":null,"purl":"pkg:github/officialrealTM/mcserver_installer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/officialrealTM%2Fmcserver_installer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/officialrealTM%2Fmcserver_installer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/officialrealTM%2Fmcserver_installer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/officialrealTM%2Fmcserver_installer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/officialrealTM","download_url":"https://codeload.github.com/officialrealTM/mcserver_installer/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/officialrealTM%2Fmcserver_installer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31433044,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-05T08:13:15.228Z","status":"ssl_error","status_checked_at":"2026-04-05T08:13:11.839Z","response_time":75,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["bash-script","debian","java","minecraft","minecraft-forge","minecraft-paper","minecraft-papermc-server","minecraft-server","papermc","papermc-minecraft-server","papermc-server","python","shell","shell-script","spigot","spigot-server","spigotmc","ubuntu"],"created_at":"2024-09-24T13:42:09.526Z","updated_at":"2026-04-05T11:01:41.628Z","avatar_url":"https://github.com/officialrealTM.png","language":"Shell","funding_links":["https://github.com/sponsors/officialrealTM","https://www.buymeacoffee.com/realtm"],"categories":[],"sub_categories":[],"readme":"\n  \n  \n# Minecraft Server Installer Script (Vanilla, Forge, Spigot, Paper \u0026 Leaf) 1.7.X - 26.X+\n## \u003cu\u003eAbout the project\u003c/u\u003e\n\nWith this project, my goal was to make installing Minecraft servers, no matter if they are Vanilla, Forge, Spigot, Paper and Leaf, as easy and beginner-friendly as possible. \nAfter making some Tutorials on my [YouTube Channel](https://youtube.com/realtm_csgo) and providing a detailed Documentation for them, there were still questions and problems on how to install a Minecraft Server on a Linux-Server.\nThats why I created this All-in-One solution for installing a Minecraft Server (Forge, Vanilla, Spigot, Paper \u0026 Leaf).\n\n\n\n## Support the Project\n\nThis project was started with a simple goal: to make installing and managing a Minecraft server as easy and beginner-friendly as possible. Your contribution directly supports the project's future by helping to cover:\n\n* **Continuous Development:** Keeping the installer compatible with the latest versions of Minecraft, Java, and all supported server platforms.\n* **Infrastructure Costs:** Paying for the servers needed for testing, version checks, API and other backend features.\n\nIf you find this tool useful, please consider showing your support. Every little bit helps and is greatly appreciated!\n\n[❤️ Sponsor on GitHub](https://github.com/sponsors/officialrealTM)\n\n[☕ Buy Me A Coffee](https://www.buymeacoffee.com/realtm)\n\n## Supported Distros\n - Debian 10\n - Debian 11\n - Debian 12\n - Debian 13\n - Ubuntu 18.04\n - Ubuntu 20.04\n - Ubuntu 22.04\n - Ubuntu 24.04\n\n\n## Requirements\n\n - SSH-Connection to your server\n - Root Access to server (Script need to be executed as root)\n - Linux-based operating systems (only on [Supported Distros](https://github.com/officialrealTM/mcserver_installer#supported-distros))\n - Git needs to be installed on the server --\u003e [Installation](https://github.com/officialrealTM/mcserver_installer#installation)\n\n\n\n# Features\n### General Features:\n- Graphical User Interface (GUI)\n- Easy-to-Use (even for beginners!)\n- Automatic installation of required programs/packages\n- Automatic installation of Java Versions for different Minecraft Versions (Including Java 8, Java 16, Java 17, Java 21 and Java 25)\n- Creating Minecraft Server start-scripts (including a check if the correct Java Version is selcted)\n- Adjustable RAM-Allocation when installing a Minecraft Server\n- Installed Servers are stored in Sub-Folders, to install more than one instance\n- Support for multiple Linux Distributions (Ubuntu \u0026 Debian)\n\n### Minecraft Vanilla Features:\n- Supported Minecraft Vanilla Versions: Minecraft 1.7.X - 26.X (including Snapshots and Pre-releases)\n\n### Minecraft Forge Features:\n- Supported Minecraft Forge Versions: Minecraft 1.7.10 - 26.X\n- Installing a specific Forge Version. (A Version Overview can be found [here](https://files.minecraftforge.net/net/minecraftforge/forge/))\n\n### Minecraft Spigot Features:\n- Supported Minecraft Spigot Versions: 1.8.X - 26.X\n- Using Spigot's offical [BuildTools](https://www.spigotmc.org/wiki/buildtools/) to compile the spigot.jar(s)\n- Caching of already compiled spigot.jar(s) to avoid unneccessary re-compilation of already compiled spigot.jar(s)\n\n### Minecraft Paper Features:\n- Supported Minecraft Paper Versions: 1.8.X - 26.X\n- Possibility to install every existing build of Paper\n- Show list of available builds for each version to select from\n- Using Paper's official [Downloads API](https://fill.papermc.io) (v3) to obtain available builds\n- Adjusted Sub-Folder Naming (including the build-number)\n\n### Minecraft Leaf Features:\n- Supported Minecraft Leaf Versions: 1.19.2 - 1.21.X\n- Possibility to install every existing build of Leaf\n- Show list of available builds for each version to select from\n- Automatic distinction between direct download versions and versions with build selection.\n- Using Leaf's official [API](https://api.leafmc.one/docs/swagger-ui/index.html) for versions that support build selection.\n- Adjusted Sub-Folder Naming (including the build-Number)\n- Important: The Leaf developers recommend using version 1.21.4 or newer. Older versions are not recommended for production use.\n\n\n\n## Installation\n\nPrerequisites:\n\n```bash\napt install git\n```\n\nDownloading the script:\n```bash\ngit clone https://github.com/officialrealTM/mcserver_installer.git\n```\n\n## Run the Script\n\nGo into the downloaded folder:\n```bash\ncd mcserver_installer\n```\n\nStart the Script:\n```bash\n./mcserver_installer.sh\n```\n## FAQ\n\n#### **Can I use this Script on other Distros?**\n\nNo. At least not yet. The Script has been developed and tested on --\u003e [Supported Distros](https://github.com/officialrealTM/mcserver_installer#supported-distros).\nTo disable the Distro check see: [Experimental Settings](https://github.com/officialrealTM/mcserver_installer#experimental-settings)\n#### **Where are my Serverfiles located?**\n\nYou Minecraft Server files will get stored in `/Servers/Minecraft-\u003cversionnumber\u003e`  \n\nWhen installing multiple servers of the same type (e.g. two Minecraft 1.8.9 Servers) the second folder will be called `Minecraft-\u003cversionnumber\u003e-1` (or 2 and so on)  \n\n#### **Can I run more than one server at once?**\n\nYes. But here you need to keep a few things in mind:\n- Your Linux server need to be powerfull enough\n- You need to adjust the Port of the second/third/etc. Minecraft server (because Port 25565 is already in use.) This can be adjusted in the `server.properties` file  \n\n#### **Can I change the amount of RAM allocated to my Minecraft Server after the installation?**\n\nYes. To do so go to your Server folder (`cd /Servers/Minecraft-\u003cversionnumber\u003e`) and open the `start.sh`file.  \nIn the last line of this file you can adjust the number after `-Xmx` to adjust more or less ram.\n\n#### **Can I use this script to install Snapshot Versions of Minecraft?**\n\n**Yes.** You can install Snapshot and Pre-release versions for Minecraft Vanilla by simply typing the snapshot name (e.g., `13w36a` or `26.1-pre-3`) when prompted for the version.\n\n#### **I've accidentally closed my Minecraft console. How can I open it again?** \nDont worry, the console will kept open in the background using *screen*.  \nUse this command, to show all active screen sessions:`screen -ls`  \n\nIf only one Sessions is active you can use this command, to open it: `screen -rx`\nIf multiple Sessions are active use this command: `screen -rx \u003cName of screen session\u003e`\n\n#### **How to close (detach)  my console?**\nTo close (detach) you Minecraft Console press **[CTRL]**+**[A]** and than **[CTRL]**+**[D]**\n\n#### **More questions?**\nFeel free to ask me questions on my [Discord](https://realtm.link/discord).\n\n## Contributing\n\nYou are very welcome to contribute to this project!\n\nTo do so, just create a Pull Request and describe your additions as accurate as possible!  \nFeel free to join my [Discord](https://realtm.link/discord) to ask questions about the code's structure etc.\n\n\n## Roadmap\n\n- Commenting \u0026 cleaning the sourcecode\n\n\n\n## Tech Stack\nThese are all the packages used in this script:\n\n**Used Packages:** dialog, sudo, wget, screen, jq, Python3, Python3-pip, Pip3-Packaging\n\n**Python Script:** mcurlgrabber.py (Thanks to [Christian](https://github.com/christian-thiele)!)\n\n## Telemetry / API\nThis script sends anonymous telemetry data (such as your OS information, script version, and installed Minecraft version) to an API. This data is used purely for internal development purposes to help improve the installer and understand which platforms are most used. Absolutely no personal or identifiable information is collected or stored. If you still wish to opt out, you can disable this function by creating a `.disable_telemetry` file as described in the **Experimental Settings** below.\n\n## Experimental Settings\n**Important:** With these experimental settings you can **disable** certain functions of the script.\nUse them at your own risk and **only** if you know what you are doing!\n\n**How to use:**\nAll these commands must be executed in the homedirectory of the script, namely: `/mcserver_installer`\n\n Disable Distro-check:\n```bash\ntouch .skip_distro_check\n```\n  Disable Script Version check:\n```bash\ntouch .skip_version_check\n```\n Disable Installed-check:\n ```bash\ntouch .installed\n```\n Disable caching/archiving of compiled Spigot.jar(s):\n ```bash\ntouch .disable_spigot_archive\n```\n Disable Telemetry (API data sending):\n ```bash\ntouch .disable_telemetry\n```\n Enable future pre-release installations (versions beyond current max supported):\n ```bash\ntouch .enable_future_pre_releases\n```\n\n### Undo experimental settings\nEnable Distro-check:\n```bash\nrm .skip_distro_check\n```\n  Enable Script Version check:\n ```bash\n rm .skip_version_check\n ```\nEnable Installed-check (can also be used to re-check installed packages):\n```bash\nrm .installed\n```\nEnable caching/archiving of compiled Spigot.jar(s):\n```bash\nrm .disable_spigot_archive\n```\nEnable Telemetry (API data sending):\n```bash\nrm .disable_telemetry\n```\nDisable future pre-release installations:\n```bash\nrm .enable_future_pre_releases\n```\n\n## Support\n\nFor support, join my [Discord](https://realtm.link/discord) and create a Ticket.  \n(*Support in German and English*)\n\n## License\n\nShield: [![CC BY-NC-SA 4.0][cc-by-nc-sa-shield]][cc-by-nc-sa]\n\nThis work is licensed under a [Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License][cc-by-nc-sa].\n\n[![CC BY-NC-SA 4.0][cc-by-nc-sa-image]][cc-by-nc-sa]\n\n[cc-by-nc-sa]: http://creativecommons.org/licenses/by-nc-sa/4.0/\n[cc-by-nc-sa-image]: https://licensebuttons.net/l/by-nc-sa/4.0/88x31.png\n[cc-by-nc-sa-shield]: https://img.shields.io/badge/License-CC%20BY--NC--SA%204.0-lightgrey.svg\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fofficialrealtm%2Fmcserver_installer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fofficialrealtm%2Fmcserver_installer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fofficialrealtm%2Fmcserver_installer/lists"}