Tiếng Việt (README.vi.md) · RPG API Explorer · Ecosystem Atlas · Diagnostics Lab · Documentation Wiki · npm
Offline Minecraft plugin engineering catalog, 10 /mc:* agent skills for Claude Code and Codex, interactive web explorers, and a zero-dependency stdio MCP server by SalyVn / Salyyy.
- Offline RPG & Plugin Bytecode API Catalog: 4,947 plugin-owned types and 41,887 bytecode-verified members across 10 major RPG and server plugins (
ModelEngine,MMOItems,MMOCore,MMOInventory,MMOProfiles,MythicCrucible,MythicDungeons,MythicEnchants,MythicRPG,CoreTools), plus 103 curated Paper/Folia/Fabric/NeoForge/Velocity/pack GitHub sources and 901 Mojang release/snapshot version records. - 10
/mc:*Engineering Agent Skills: Specialized routing skills and slash commands for Claude Code and OpenAI Codex covering Paper/Folia runtime contracts (mc:core), Gradle/Kotlin builds (mc:build), RPG integrations (mc:rpg), packets (mc:protocol), NMS adapters (mc:nms), resource/data packs (mc:pack), Blockbench rigs (mc:model), shaders (mc:shader), dialogs (mc:dialog), and client projections (mc:client). - Interactive Web Explorers: Zero-backend browser tools for instant symbol lookup, version capability inspection, and workflow search.
- Built-In Stdio MCP Server: Pure Python 3.10+ JSON-RPC 2.0 Model Context Protocol server (
scripts/mcp_server.pyandminecraftkit mcp) for Cursor, Windsurf, Claude Desktop, and Claude Code.
Install the canonical skill and all 10 mc:* domain wrappers for both Claude Code and Codex (works cross-platform on Windows, Linux, and macOS via PowerShell or the built-in Node.js SHA-256 verified installer):
npx minecraftkit install --target bothInstall for a single agent target or install the CLI globally:
npx minecraftkit install --target claude
npx minecraftkit install --target codex
npm install -g minecraftkit
minecraftkit doctorPrint a ready-to-paste configuration snippet tailored to your local environment:
npx minecraftkit mcp --print-configOr add minecraftkit directly to .cursor/mcp.json, .mcp.json, or claude_desktop_config.json:
{
"mcpServers": {
"minecraftkit": {
"command": "npx",
"args": ["-y", "minecraftkit", "mcp"]
}
}
}If you cloned this repository or installed the skill locally, you can also invoke scripts/mcp_server.py directly with zero npm startup overhead:
{
"mcpServers": {
"minecraftkit": {
"command": "python3",
"args": ["-B", "/path/to/minecraftkit/scripts/mcp_server.py"]
}
}
}| Tool | Purpose |
|---|---|
mc_search_api |
Search 41,800+ offline classes, interfaces, methods, fields, and constructors by terms, plugin, kind, and limit. |
mc_list_plugins |
List all 10 indexed RPG plugins with versions, class-file targets, symbol counts, API boundaries, and integration risks. |
mc_search_sources |
Filter 103 curated upstream Minecraft, Paper, Folia, protocol, shader, and pack GitHub repositories with pinned commit SHAs. |
mc_version_capabilities |
Query Mojang version history (901 versions), Java requirements, protocol numbers, and resource/data pack formats (including 26.2). |
mc_route_skill |
Recommend primary and secondary /mc:* engineering skills, reference handbooks, and verification checklists for a task. |
mc_folia_migration_advisor |
Audit Java/Kotlin snippets or Bukkit API symbols for Folia regionized threading hazards and output RegionScheduler / EntityScheduler / teleportAsync replacements. |
mc_diagnose_server_log |
Analyze Paper, Folia, Purpur, and Velocity crash logs, watchdog stalls, classloader/shading collisions, and JVM classfile mismatches. |
mc_inspect_type |
Inspect the full bytecode hierarchy of any indexed RPG plugin class, interface, enum, or record, including superclass, interfaces, indexed subtypes, constructors, methods, fields, and minimum Java version. |
mc_audit_gradle_build |
Audit build.gradle.kts / build.gradle and paper-plugin.yml / plugin.yml for bundled server APIs, un-relocated shadowJar packages, Paperweight mapping mismatches, Java toolchain gaps, and isolated classloader join-classpath issues. |
mc_audit_paper_plugin_yml |
Validate paper-plugin.yml (and optional dual plugin.yml) across Paper 1.19 through 26.3+ for YAML float truncation (1.20 -> 1.2), illegal legacy root keys (commands, depend, libraries), bootstrapper / loader / main class collisions, bootstrap vs server dependency graph ordering conflicts, isolated classloader join-classpath visibility, and Folia flags. |
mc_generate_pack_overlay |
Generate client- and server-validated pack.mcmeta files and overlays.entries manifests for resource packs and data packs spanning 1.20.1 through 26.3+ (enforcing supported_formats pre-minor clamping at 64/81, min_format/max_format [major, minor] tuples, OverlayMetadataSection directory naming rules, and breaking-epoch splits). |
mc_audit_server_properties |
Audit server.properties alongside optional config/paper-global.yml, spigot.yml, and JVM flags for network-compression-threshold double-compression and sub-64-byte CPU burn hazards, Velocity/BungeeCord forwarding authentication mismatches, Netty EventLoop thread starvation or oversubscription, quadratic (2d + 1)^2 simulation-distance chunk budgets, RCON plaintext exposure, resource-pack SHA-1/UUID contracts, Paper 26.3 schema drift, and Java 25 GC flags. |
mc_validate_item_components |
Validate Minecraft and Paper 1.20.5 through 26.3+ structured item data components, component patches, and companion client assets/<namespace>/items/<id>.json definitions (custom_model_data typed channels, tooltip_display vs removed show_in_tooltip, food/consumable/use_remainder splits, equippable.asset_id renames, max_damage + max_stack_size mutual exclusion, and client selector channel index bounds). |
mc_diagnose_crash_report |
Parse and triage Minecraft server and client crash reports (Vanilla, Paper, Folia, Fabric, Forge, NeoForge) for ticking entities (exact block coords and /minecraft:kill commands), ticking block entities (/setblock air), mixin application conflicts, classloader NoSuchMethodError/NoClassDefFoundError linkage faults, JVM OOM/Metaspace exhaustion, and corrupted chunk I/O boundaries with optional OASIS SARIF v2.1.0 output. |
mc_audit_datapack |
Audit Minecraft 1.20.5 through 26.3+ datapacks for pack.mcmeta format compliance (pack_format 41 through 97, integer or [min, max] range tuples), modern recipe component syntax (replacing legacy result.item and raw tag strings with structured component patches), recipe pattern bounds, cyclical tag reference graph loops, namespace validity, and .mcfunction command hygiene. |
mc_audit_spark_flamegraph |
Parse collapsed flamegraph stacks and indented Spark/JFR call-trees (SPARK-001 through SPARK-008), compute deduplicated inclusive and child-subtracted exclusive self weights, demangle JDK 21+ hidden lambdas, attribute hotspots back to initiating plugins (including indexed RPG plugins), and separate genuine async worker pool starvation (HikariPool, socket stalls, lock convoys, nested future deadlocks) from benign idle worker parking, with optional OASIS SARIF v2.1.0 output. |
mc_analyze_folia_scheduler_trace |
Verify Folia 4-domain scheduler thread-affinity contracts (REGION, ENTITY, GLOBAL, ASYNC, plus NETTY) across stack traces and multi-thread dumps (FOLIA-TRC-001 through FOLIA-TRC-007), catching GlobalRegionScheduler spatial escapes, async world/entity mutations, Netty packet-thread world access, blocking CompletableFuture.join() barrier deadlocks, synchronous teleports, and missing EntityScheduler retired callbacks, with optional OASIS SARIF v2.1.0 output. |
mc_audit_packet_codec |
Audit Minecraft 1.20.5 through 26.3+ StreamCodec, CustomPacketPayload, PacketEvents/ProtocolLib listeners, and Velocity plugin messaging channels (NETTY-001 through NETTY-008), computing exact LEB128 VarInt and worst-case UTF-8/collection wire-byte budgets against 32,767 B serverbound and 1,048,576 B clientbound caps, catching unbounded decode DoS, asymmetric read/write order, ByteBuf ref-count leaks, invalid ResourceLocation channels, and plain FriendlyByteBuf registry-codec mismatches, with optional OASIS SARIF v2.1.0 output. |
mc_audit_sql_persistence |
Audit Paper, Folia, and Velocity plugin SQL persistence layers and HikariCP configurations (SQL-001 through SQL-007), computing fleet MySQL connection budgets and maxLifetime vs wait_timeout safety margins, and catching synchronous tick-thread JDBC calls, SQLite multi-pool SQLITE_BUSY contention without WAL, unclosed JDBC resource leaks, SQL string interpolation, and direct Bukkit/Folia mutations inside async DB completion callbacks, with optional OASIS SARIF v2.1.0 output. |
- MCP Resources (
resources/list&resources/read): Exposesminecraftkit://catalog/overview(application/json),minecraftkit://catalog/paper-26.3-item-components(application/json), and 21 offline engineering handbooks (minecraftkit://references/*.md) covering Paper/Folia threading, Gradle/Shadow builds, Netty packets, Mojang mappings, GLSL shaders, dialogs, and RPG plugin boundaries. - MCP Prompts (
prompts/list&prompts/get): Exposes all 10/mc:*domain workflows (mc-core,mc-build,mc-rpg,mc-protocol,mc-nms,mc-pack,mc-model,mc-shader,mc-dialog,mc-client) as native parameterized MCP prompts.
minecraftkit install [codex|claude|both] [--dry-run] [--version x.y.z]
minecraftkit update [codex|claude|both]
minecraftkit mcp [--print-config] [--root <dir>]
minecraftkit doctor [--json]
minecraftkit commands [--json]
minecraftkit wiki
minecraftkit version
| Route | Focus |
|---|---|
/mc:core |
Paper, Folia, Purpur, Velocity, Fabric, NeoForge runtime and version contracts |
/mc:build |
Kotlin/Java Gradle builds, Shadow relocation, HikariCP/SQLite/MySQL, CI publishing |
/mc:rpg |
RPG system architecture and verified bytecode integrations across 10 RPG plugins |
/mc:protocol |
Netty pipelines, StreamCodec, packet listeners, and version-safe wire contracts |
/mc:nms |
Mojang-mapped internals, Paperweight userdev, and multi-version adapter isolation |
/mc:pack |
Resource packs, data packs, custom fonts/glyphs, item models, and delivery contracts |
/mc:model |
Blockbench .bbmodel rigs, hitbox budgets, animations, and ModelEngine pipelines |
/mc:shader |
Vanilla core/post GLSL shaders, uniforms, render targets, and client boundaries |
/mc:dialog |
Server-driven dialogs, validated click actions, and form payload safety |
/mc:client |
Client mod boundaries vs vanilla-client display/entity/pack projections |
- RPG API Explorer: Search indexed plugin classes, methods, fields, and architectural insights in the browser.
- Diagnostics Lab: Run client-side Spark flamegraph hotspot classification (
SPARK-001..SPARK-008), Folia 4-domain scheduler trace verification (FOLIA-TRC-001..FOLIA-TRC-007), NettyStreamCodecwire-byte budget and HikariCP/SQLite persistence audits (NETTY-001..NETTY-008,SQL-001..SQL-007), and SARIF v2.1.0 export with zero uploads. - Minecraft Ecosystem Atlas: Browse 103 reviewed upstream repositories, Mojang version history, and release capability profiles.
- Bilingual Wiki (VI/EN): Step-by-step installation guides, route overviews, and engineering checklists.
| Tool | Purpose |
|---|---|
| foliascan | Static bytecode and taint-flow verifier for Folia regionized multithreading (action.yml + browser JAR scanner). |
| serverdoctor | Offline post-mortem diagnostics across server logs, configs, JVM flags, crash reports, worlds, and access lists (CLI + mcp). |
| pluginscope | Static plugin JAR packaging, Paper API compatibility, multi-plugin stack conflict, and resource pack auditor (CLI + mcp). |
| mcstage | Standalone integration runner that boots a real Paper, Folia, or Purpur server, installs your plugin, drives the console, and asserts on logs. |
| glyphsmith | Compiler that turns PNGs and pixel coordinates into exact Minecraft font glyphs, ascent/advance metrics, negative-space shifts, and resource packs. |
Review NOTICE.md before redistributing third-party-derived API metadata or catalog artifacts.