mcdev

Skill de Claude Code que lo convierte en experto en desarrollo de Minecraft Java construido con Gradle: plugins, proxies y mods. Stack fijo: solo Java + Gradle. Nada de Maven ni Kotlin salvo que lo pidas explícitamente.

Qué cubre

• Plugins: Bukkit / Spigot / Paper / Purpur / Folia (threading regionizado).
• Proxies / legacy: BungeeCord, Velocity, versiones antiguas, plugin messaging proxy↔backend.
• Mods Java: Fabric / Forge / NeoForge con Gradle (registries, side client/server, mappings).
• Transversal: estructura Gradle, shading/relocation, comandos, listeners, config, storage, PDC, scheduler, async, lifecycle, performance, debugging y release.

Cómo funciona

Tres capas:

• skills/mcdev/SKILL.md — router + reglas invariantes + decision gates (obliga a preguntar versión de MC, plataforma, versión de Java y si el objetivo es Folia antes de asumir).
• skills/mcdev/reference/ — 8 módulos densos cargados bajo demanda: platforms, folia, gradle, plugins, mods, proxy-legacy, debugging, checklist.
• skills/mcdev/assets/ — plantillas copiables (build.gradle Groovy, manifests, Java mínimo) para plugin, proxy Bungee y mod Fabric.

Y tres subagents especializados:

Agent	Para
mcdev-scaffolder	Generar el esqueleto Gradle de un proyecto nuevo desde una spec
mcdev-reviewer	Auditar código (Folia-safety, threading, perf, leaks, manifests)
mcdev-debugger	Analizar un crash/stacktrace/lag → causa raíz + fix

Instalar

Como plugin (recomendado)

En Claude Code:

/plugin marketplace add Light0mxph/mcdev-skill
/plugin install mcdev@mcdev

Manual

git clone https://github.com/Light0mxph/mcdev-skill
cd mcdev-skill
cp -r skills/mcdev   ~/.claude/skills/
cp    agents/mcdev-*.md ~/.claude/agents/
cp    commands/mcdev.md  ~/.claude/commands/

Usar

Activación explícita con el comando:

/mcdev crea un plugin Paper 1.21.4 con sistema de kits y cooldowns

$ARGUMENTS = tu tarea → activa y ejecuta en un paso. O escribe /mcdev solo para activar y dar el prompt después. También auto-activa cuando el mensaje es claramente desarrollo de Minecraft.

El primer turno te preguntará lo crítico que falte (versión exacta de MC, plataforma, Java, Folia sí/no) antes de generar. Si ya lo das en el prompt, no pregunta.

Reglas de diseño

• Solo Java + Gradle. Maven/Kotlin solo bajo petición explícita.
• No asume compatibilidad entre APIs de plataformas distintas ni inventa firmas.
• Bloquea lo inseguro en Folia/legacy y ofrece la alternativa correcta.
• Rendimiento y thread-safety primero; sin leaks; orientado a producción.
• Subagents divididos por workflow (review/debug/scaffold), no por plataforma — la plataforma es un parámetro, no un flujo de trabajo.

Notas

• Las plantillas de assets/ están verificadas a mano, no build-testeadas. Las versiones sensibles (coordenadas de Fabric, patch exacto de paper-api, API de Item.Settings) están marcadas con comentario para confirmar contra la fuente oficial.
• La skill es viva: actualiza la matriz de versiones en reference/platforms.md y las versiones de plugins de Gradle en reference/gradle.md cuando cambien.

Licencia

MIT — ver LICENSE.