keeb/swamp-minecraft
1
0
Fork 0
Code Projects Releases Packages Wiki Activity
No description
5 commits 1 branch 0 tags 47 KiB
  • TypeScript 100%
Find a file
Exact
keeb 96acb2fda9 feat: add embedded minecraft skill for AI agents 
Bundle a Claude Code skill in the extension package so AI agents working
against installs of @keeb/minecraft get model docs, method signatures,
workflow inputs, and operational gotchas (Alpine-only installer, 15-min
start timeout, restart-loop defeat, metrics-vs-server resource split)
loaded automatically.

Bumps version to 2026.04.06.1 and adds skills: [minecraft] to manifest.
2026-04-06 18:33:56 -07:00
.claude/skills/minecraft feat: add embedded minecraft skill for AI agents 2026-04-06 18:33:56 -07:00
.swamp/workflows Initial commit: @keeb/$NAME swamp extension 2026-02-27 12:30:56 -08:00
extensions/models Initial commit: @keeb/$NAME swamp extension 2026-02-27 12:30:56 -08:00
workflows Initial commit: @keeb/$NAME swamp extension 2026-02-27 12:30:56 -08:00
.gitignore Initial commit: @keeb/$NAME swamp extension 2026-02-27 12:30:56 -08:00
.swamp.yaml Initial commit: @keeb/$NAME swamp extension 2026-02-27 12:30:56 -08:00
CLAUDE.md Add repository and tags to manifest 2026-03-02 22:01:51 -08:00
manifest.yaml feat: add embedded minecraft skill for AI agents 2026-04-06 18:33:56 -07:00
README.md Initial commit: @keeb/$NAME swamp extension 2026-02-27 12:30:56 -08:00

README.md

@keeb/minecraft

Swamp extension for Minecraft server control, installation, and metrics collection.

Models

minecraft/server

Control a Minecraft server running in a tmux session over SSH.

Method Description
warnShutdown Send in-game countdown warnings before shutdown
startMinecraftServer Start the server in a tmux session and wait for readiness
stopMinecraftServer Gracefully stop the server
status Query player count and server status
say Send an in-game chat message
op Grant operator privileges to a player
deop Revoke operator privileges from a player
collectMetrics Collect player count and write Prometheus textfile metrics

minecraft/installer

Install a Minecraft server from a modpack zip on a remote host.

Method Description
installDeps Install Java and dependencies
upload Upload server pack zip to the VM
extract Extract and configure the server pack
configure Set EULA, JVM flags, and server properties

Workflows

Workflow Description
start-minecraft Start a Minecraft VM + server
stop-minecraft Stop a Minecraft server + VM
reboot-minecraft Stop + start a Minecraft server
status-minecraft Query Minecraft player count
minecraft-install Install a Minecraft server pack on a VM
collect-game-metrics Collect player metrics from all game servers

Dependencies

Install

swamp extension pull @keeb/minecraft

License

MIT