{"id":21553522,"url":"https://github.com/parzival-space/papermc-docker","last_synced_at":"2025-09-01T06:36:10.917Z","repository":{"id":206841113,"uuid":"716996215","full_name":"parzival-space/papermc-docker","owner":"parzival-space","description":"Automated builds for PaperMC docker images","archived":false,"fork":false,"pushed_at":"2024-03-26T22:51:03.000Z","size":57,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"development","last_synced_at":"2025-02-02T12:32:55.944Z","etag":null,"topics":["docker","docker-image","minecraft","minecraft-server","papermc","papermc-server"],"latest_commit_sha":null,"homepage":"https://hub.docker.com/r/parzivalspace/papermc","language":"JavaScript","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/parzival-space.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":"2023-11-10T10:19:37.000Z","updated_at":"2024-06-19T22:21:40.000Z","dependencies_parsed_at":"2024-01-11T15:48:08.152Z","dependency_job_id":"d3640434-64f6-4aef-8264-19939daedffc","html_url":"https://github.com/parzival-space/papermc-docker","commit_stats":null,"previous_names":["parzival-space/papermc-docker"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/parzival-space%2Fpapermc-docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/parzival-space%2Fpapermc-docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/parzival-space%2Fpapermc-docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/parzival-space%2Fpapermc-docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/parzival-space","download_url":"https://codeload.github.com/parzival-space/papermc-docker/tar.gz/refs/heads/development","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246025940,"owners_count":20711576,"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":["docker","docker-image","minecraft","minecraft-server","papermc","papermc-server"],"created_at":"2024-11-24T07:11:05.010Z","updated_at":"2025-03-28T11:45:55.072Z","avatar_url":"https://github.com/parzival-space.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PaperMC Docker Images\n\nThese are automated builds for Docker images for each specific PaperMC Minecraft server version.\nEvery day a new image gets build, if there are any new PaperMC build available.\n\nPaperMC is an optimized Minecraft server with plugin support (Bukkit, Spigot, Sponge, etc.).\nThis image provides a basic PaperMC server. All customizations are left to the user.\n\n## Why?\n\nBecause I was tired of managing multiple Java installations for different server versions.\nAs a bonus, this allows me to incorporate a particular server installation into other Minecraft related projects for reference.\n\n## Usage\n\nYou need a working Docker installation.\nIf that is not the case, go do that and come back once you're done.\n\n### Quick Setup\n\nUsing this image, you can create your own PaperMC server with one simple command.\nWhen you run this command, the image auto-accepts the [Minecraft EULA](https://www.minecraft.net/en-us/eula) for you.\n\n```\n# if you want to use docker hub\ndocker run -it -p 25565:25565/tcp -v -/server:/server parzivalspace/papermc:1.20.2\n\n# if you want to use github container registry\ndocker run -it -p 25565:25565/tcp -v -/server:/server ghcr.io/parzival-space/papermc:1.20.2\n```\n\nThe command above will run a PaperMC 1.20.2 server using the latest available PaperMC build.\nThis will most likely be enougth in most cases, but you can customize the image even further.\n\n### Options\n\nDocker provides many command line options that you can use to customize the behavior of this image.\nI listed some of them you are most likely to be interested in below:\n\n* \u003cb\u003ePort Forwarding\u003c/b\u003e \u003cbr\u003e\n    You certainly want your server to be accessable at some point.\n    The port arguemnt allows you to pass a port from the container to your host machine.\n\n    * ``-p \u003cserver_port\u003e:25565/tcp`` - Will pass the games port to ``server_port`` on your host.\n    * ``-p \u003cserver_port\u003e:25575/tcp`` - Will pass the rcon port to ``server_port`` on your host.\n\n* \u003cb\u003eVolume\u003c/b\u003e \u003cbr\u003e\n    This allows you to make your server storage persistent by mapping a directory in the container to your hosts filesystem.\n\n    * ``-v \u003cdirectory\u003e:/server`` - ``/server`` is where your server stores the game data in the container.\n\n* \u003cb\u003eDetached\u003c/b\u003e \u003cbr\u003e\n    Allows you to run the container detached from the current shell session. No more ``screen``.\n\n    * ``-d`` - Just include this in you ``run`` command instead of using ``screen``.\n\n* \u003cb\u003eInteractive Session\u003c/b\u003e \u003cbr\u003e\n    Makes the current run session interactive.\n    You need this if you want to use the server console.\n\n    * ``-it`` - Makes the session interactive.\n\n* \u003cb\u003eRestart Policy\u003c/b\u003e \u003cbr\u003e\n    Docker has a feature for automatically restarting a container under certain conditions.\n    Please read the documentation about [Restart Policies](https://docs.docker.com/engine/reference/run/#restart-policies---restart).\n    For convenience I am only mentioning ``on-failure`` here.\n\n    * ``--restart on-failure`` - Will automatically restart the server once it crashed.\n\n* \u003cb\u003eName\u003c/b\u003e \u003cbr\u003e\n    You shoul name your container to access it later more easily.\n    This is especially usefull if you want to run the container detached from the current session.\n\n    * ``--name \u003ccontainer_name\u003e`` - Runs the container under the ``\u003ccontainer_name\u003e`` name.\n\n* \u003cb\u003eEnvironment Variables\u003c/b\u003e \u003cbr\u003e\n    You can pass envrionment variables to the container.\n    This is how you can configure this image.\n    More on this topic stands below.\n\n    * ``-e \u003cvariable\u003e=\u003cvalue\u003e`` - Sets the variable ``\u003cvariable\u003e`` to ``\u003cvalue\u003e``.\n\n### Environment Variables\n\nAs mentioned above, you can configure this image even further by providing environment variables.\nThis image currently only accepts 2 variables:\n\n* ``JAVA_ARGS``:\u003cbr\u003e\n    These are variables that are directly passed to the Java runtime:\n    Here you can provide customized launch arguments.\n\n    * ``-e JAVA_ARGS=\"-Xms=4G -Xmx=4G\"`` - This tells the Java runtime to use 4gb of memory.\n\n* ``SERVER_ARGS``:\u003cbr\u003e\n    This variable sets the arguments that are directly passed to PaperMC.\n    To get a full list of available arguments, set this to ``--help``.\n\n    * ``-e SERVER_ARGS=\"--help\"`` - Displays PaperMCs help message.\n\n## Links\n\nDocker Hub: [parzivalspace/papermc](https://hub.docker.com/r/parzivalspace/papermc)\n\nGitHub Package: [ghcr.io/parzival-space/papermc:1.20.2](https://github.com/parzival-space/papermc-docker/pkgs/container/papermc)\n\nGitHub Source: [parzival-space/papermc-docker](https://github.com/parzival-space/papermc-docker)\n\n## License\n\nDistributed under the GNU GPL v3.0 License.\nSee ``LICENSE`` for more information.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fparzival-space%2Fpapermc-docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fparzival-space%2Fpapermc-docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fparzival-space%2Fpapermc-docker/lists"}