fuwafuwalabs/minecraft-pdb-mgr
Watch
3
0
Fork
You've already forked minecraft-pdb-mgr
 0
Code Issues 1 Pull requests Projects Releases Packages Wiki Activity Actions
Prevent your K8s-managed Minecraft server from shutting down when players are connected.
161 commits 1 branch 3 tags 423 KiB
  • Rust 76.1%
  • Dockerfile 12.7%
  • Makefile 11.2%
Find a file
Exact
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Renovate Bot bbd317f236
All checks were successful
ci/woodpecker/pr/build Pipeline was successful
Details
ci/woodpecker/pull_request_closed/build Pipeline was successful
Details
ci/woodpecker/push/build Pipeline was successful
Details
ci/woodpecker/cron/build Pipeline was successful
Details
chore(deps): lock file maintenance
2026-08-24 00:50:23 +00:00
.woodpecker chore(deps): update woodpeckerci/plugin-kaniko docker tag to v2.3.2 2026-06-06 15:19:23 +00:00
src Simplify initial last has players logic 2025-06-19 14:03:11 -04:00
.gitignore Initial commit 2025-06-19 01:40:16 -04:00
Cargo.lock chore(deps): lock file maintenance 2026-08-24 00:50:23 +00:00
Cargo.toml fix(deps): update rust crate kube to 4.2.x 2026-07-22 09:05:02 +00:00
Containerfile chore(deps): update docker.io/library/rust docker tag to v1.98.0 2026-08-20 20:05:40 +00:00
LICENSE.md Initial commit 2025-06-19 01:40:16 -04:00
Makefile Use fuwafuwalabs project for container 2025-06-27 11:19:27 -04:00
README.md Add min players options to readme 2025-06-19 16:26:37 -04:00
renovate.json renovate: automerge lockFileMaintenance 2026-07-05 23:43:35 -04:00

README.md

minecraft-pdb-mgr

minecraft-pgb-mgr watches a Minecraft server for connected players and updates a Kubernetes PodDisruptionBudget to prevent server shutdowns when players are connected.

How?

Deploy minecraft-pdb-mgr to your cluster (only one replica is needed) and set the following environment variables:

  • POD_NAMESPACE - the namespace the pod runs in. You should use valueFrom.fieldRef.fieldPath: metadata.namespace for this.
  • RUST_LOG (optional) - the log level (i.e. info, debug,, warn, error)
  • UPDATE_INTERVAL - how often in seconds to check for players and to patch the PDB. The default value is 10.
  • PDB_NAME - the name of the PBB object in the same namespace as the pod to update. You need to create this PDB yourself.
  • SERVER_HOST - the hostname or IP address of the Minecraft server to monitor.
  • SERVER_PORT - the port of the Minecraft server to monitor.
  • MIN_PLAYERS - the minimum number of online players to consider when updating the PDB. Default is 1.
  • MIN_PLAYERS_PERCENT - a floating point value (0.0 - 1.0) representing the percent of online players to the maximum number of players to consider when updating the PDB. This takes precedence over MIN_PLAYERS.

License

See LICENSE.md.