# Minecraft Plugin Updater

> Check and update all Minecraft plugin URLs and build numbers in the homelab k8s plugin list. Use this skill whenever the user wants to update Minecraft plugins, check for outdated plugins, refresh plugin versions, or fix a broken plugin download URL. Triggers on phrases like "update plugins", "check plugin versions", "geyser is outdated", "update minecraft plugins", or any mention of a specific plugin being outdated. Use when this capability is needed.

- Skill: `tomevault-io/minecraft-plugin-updater` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/minecraft-plugin-updater`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/minecraft-plugin-updater/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/minecraft-plugin-updater

---


# Minecraft Plugin Updater

Run the update script to check every plugin URL against its upstream API and rewrite `plugins.txt` with the latest versions.

## Usage

```bash
python3 scripts/update-plugins.py \
  /home/develop/homelab/k8s/applications/games/minecraft/plugins/plugins.txt
```

The script:
- Fetches the latest version/build from each plugin's upstream API
- Validates each new URL returns HTTP 200 before accepting it
- Rewrites `plugins.txt` in-place with updated URLs
- Prints a clear diff: what changed and what was already up to date
- Skips any plugin whose API is unreachable and warns instead of aborting

## After running

1. Review the printed diff to confirm the changes look right
2. Run `kustomize build --enable-helm /home/develop/homelab/k8s/applications/games/minecraft` to validate
3. Apply: `kubectl apply -k /home/develop/homelab/k8s/applications/games/minecraft`
4. Delete the pod to pick up the new configmap: `kubectl delete pod -n minecraft minecraft-bedrock-0`

## Plugin sources

| Plugin | Source |
|---|---|
| Geyser, Floodgate | GeyserMC downloads API |
| EssentialsX-GUI, FAWE, EssentialsX, Multiverse, Vault | GitHub Releases |
| LuckPerms | ci.lucko.me Jenkins |
| WildLoaders | hub.bg-software.com Jenkins |
| CustomCommands | Modrinth API |
| BedrockGUI (Spiget) | Static redirect — version not tracked |

---
> Source: [theepicsaxguy/homelab](https://github.com/theepicsaxguy/homelab) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-07-02 -->

