This repository contains the configuration for automatically deploying and managing a Minecraft server using GitHub Actions, playit.gg, and Cloudflare Tunnel.
- Automated server deployment with GitHub Actions
- Easy server management and monitoring through GitHub Actions
- Remote access using playit.gg tunneling service
- Secure access via Cloudflare Tunnel
- Fork this repository to your GitHub account.
-
FINE_GRAINED_PAT
:- Generate a Fine-Grained Personal Access Token (PAT) with full read and write access to the repository.
- Navigate to GitHub Settings > Developer Settings > Personal Access Tokens > Fine-grained tokens.
- Create a new token with appropriate permissions.
- Copy the generated token.
- In your forked repository, go to Settings > Secrets and variables > Actions.
- Create a new repository secret named
FINE_GRAINED_PAT
and paste the token as its value.
-
PLAYIT_SECRET
:- Install and run the playit.gg tunnel service on your local machine.
- Extract the data from the generated
playit.toml
file. - In your forked repository, go to Settings > Secrets and variables > Actions.
- Create a new repository secret named
PLAYIT_SECRET
and paste the extracted data as its value.
-
Cloudflare Tunnel Setup:
-
Generate a Cloudflare Tunnel certificate:
- Follow the Cloudflare Tunnel documentation to generate a certificate.
-
Retrieve your Cloudflare Tunnel UUID:
- Obtain the UUID from the Cloudflare dashboard or using the Cloudflare Tunnel CLI.
-
Extract the credentials content:
- Generate or retrieve the Cloudflare Tunnel credentials file content.
-
In your forked repository, create the following repository secrets:
CF_CERT
: Paste the Cloudflare Tunnel certificate data.CF_TUNNEL_UUID
: Paste the UUID of your Cloudflare Tunnel.CF_TUNNEL_UUID_CONTENT
: Paste the content for the Cloudflare Tunnel credentials file.
-
- Modify the
server.properties
file according to your preferences.
- Push your changes to the repository to trigger the GitHub Actions workflow.
- The server will automatically start when you push changes to the repository or based on the scheduled workflow.
- Manage the server using GitHub Actions workflows in the "Actions" tab.
- Access your server using the playit.gg tunnel address provided in the workflow logs.
- The server will commit and push changes every 30 seconds and automatically clean up old workflow runs to maintain repository health.
- Public repositories get 16 GB of memory for GitHub Actions, while private repositories only get 8 GB.
- The setup supports both public and private repositories. For private repositories, additional configuration might be required to handle server data.
- BungeeCord: githubservers.org or 147.185.221.21:57738
- Normal: Coming soon
Contributions are NOT allowed.
This project is not licensed. Use it as you wish.