Skip to main content
← back to extensions

@keeb/minecraft

v2026.04.22.3

Minecraft server control + installer + metrics collection (https://github.com/keeb/swamp-minecraft)

Repository

https://github.com/keeb/swamp-minecraft

Platforms

linux-x86_64linux-aarch64darwin-x86_64darwin-aarch64

Labels

minecraftgamingserver

Quality score

How well-documented and verifiable this extension is.

91%

Grade A

  • Has README or module doc2/2earned
  • README has a code example1/1earned
  • README is substantive1/1earned
  • Most symbols documented1/1earned
  • No slow types0/1missing
  • Has description1/1earned
  • At least one platform tag (or universal)1/1earned
  • Two or more platform tags (or universal)1/1earned
  • License declared1/1earned
  • Verified public repository2/2earned

Install

$ swamp extension pull @keeb/minecraft

Security Notice

This extension includes AI agent skills that can modify AI assistant behavior. Review the skill files before installing.

@keeb/start-minecrafte85aaef3-20fd-4cf9-b255-e9cf895d4066

Start a Minecraft server by VM name

mainAuth, start VM via fleet, then start Minecraft server
1.authkeebDev02.auth— Authenticate with Proxmox via keebDev02
2.ensure-vm-runningfleet.start— Start VM if stopped and wait for IP
3.start-minecraftminecraftGame.startMinecraftServer— Start Minecraft server and wait for ready
4.annotategrafanaHub.createAnnotation— Create Grafana annotation
@keeb/stop-minecraft4e11e3ef-8854-4d31-a980-fd572f97c3e0

Stop a Minecraft server by VM name

mainAuth, look up VM via fleet, warn players, stop Minecraft, stop VM
1.authkeebDev02.auth— Authenticate with Proxmox via keebDev02
2.lookupfleet.lookup— Find VM by name and populate vmid/IP
3.warn-playersminecraftGame.warnShutdown— Broadcast shutdown warning to Minecraft players
4.stop-minecraftminecraftGame.stopMinecraftServer— Gracefully stop Minecraft server process
5.stop-vmfleet.stop— Shut down the VM
6.annotategrafanaHub.createAnnotation— Create Grafana annotation
@keeb/reboot-minecraft7d166515-1eb3-4128-9c64-3249bc3cd645

Reboot a Minecraft server by VM name

mainAuth, gracefully stop Minecraft, stop VM, restart and start Minecraft
1.authkeebDev02.auth— Authenticate with Proxmox via keebDev02
2.lookupfleet.lookup— Find VM by name and populate vmid/IP
3.warn-playersminecraftGame.warnShutdown— Broadcast shutdown warning to Minecraft players
4.stop-minecraftminecraftGame.stopMinecraftServer— Gracefully stop Minecraft server process
5.stop-vmfleet.stop— Shut down the VM
6.ensure-vm-runningfleet.start— Start VM and wait for IP
7.start-minecraftminecraftGame.startMinecraftServer— Start Minecraft server and wait for ready
8.annotategrafanaHub.createAnnotation— Create Grafana annotation
@keeb/status-minecraftb1dc5f5d-baec-4b33-818a-59df0501469b

Check Minecraft server status by VM name

mainAuth, lookup VM IP, then check Minecraft server status
1.authkeebDev02.auth— Authenticate with Proxmox
2.lookup-vmfleet.lookup— Look up VM IP from fleet
3.check-statusminecraftGame.status— Check Minecraft server status
@keeb/minecraft-install7469bfde-1b52-4b7f-a3a5-1aa8200077f0

Install and start a Minecraft server from a server pack zip on any VM

mainInstall deps, upload pack, extract, configure, start server
1.authkeebDev02.auth— Authenticate with Proxmox
2.lookup-vmfleet.lookup— Lookup target VM to populate fleet resource
3.install-depsminecraftInstaller.installDeps— Install JDK, tmux, bash, curl, unzip on the VM
4.upload-packminecraftInstaller.upload— Upload server pack zip to the VM
5.extract-packminecraftInstaller.extract— Extract server pack and discover modloader config
6.configure-serverminecraftInstaller.configure— Configure JVM memory, EULA, and server variables
7.start-serverminecraftGame.startMinecraftServer— Start the Minecraft server in a tmux session
8.enable-monitoringmonitoringAgent.enableTextfileCollector— Enable node-exporter textfile collector for metrics
@keeb/collect-game-metricsd417e25d-e8df-468b-95f6-2d03739c82a8

Collect player metrics from all configured game servers

collectAuth, sync fleet, collect metrics from each game server
1.authkeebDev02.auth— Authenticate with Proxmox
2.sync-fleetfleet.sync— Sync all VMs into fleet (populates IPs)
3.collect-allthemonsallthemonsMinecraft.collectMetrics— Collect Minecraft player metrics from allthemons
4.collect-calamitycalamityTerraria.collectMetrics— Collect Terraria player metrics from calamity
5.collect-infinityinfinityMinecraft.collectMetrics— Collect Minecraft player metrics from infinity

minecraft1 file