内容
# minecraft-skills
[](https://www.npmjs.com/package/minecraft-skills)
[](https://www.npmjs.com/package/@minecraft-skills/data)
[](https://www.npmjs.com/package/@minecraft-skills/catalog)
[](https://www.npmjs.com/package/@minecraft-skills/rcon)
[](https://www.npmjs.com/package/@minecraft-skills/mcp)
Minecraft 创作事实、智能体技能、命令行界面（CLI）和 MCP 工具，用于创建或审查 Java 数据包、Java 资源包和 Paper 插件。
该项目帮助智能体在编写代码或打包文件之前检查真实的版本数据。它提供：
- 数据包、资源包和 Paper 插件创作的技能文件夹。
- 用于版本、打包格式、命令、原版路径、JSON/模型形状、Paper API 索引和 Paper 事件的 CLI/API/MCP 查询。
- 关于需要验证的内容、所需证据和如何表达未知信息的创作指南。
- 捆绑的 Java 1.13+ 数据，以及较重的生成曲面的缓存下载。
## 开始使用
对于支持 MCP 的智能体客户端，请从 MCP 服务器开始。它直接向代理公开版本数据、创作上下文、提示和查询工具：
```json
{
"mcpServers": {
"minecraft-skills": {
"command": "npx",
"args": ["-y", "@minecraft-skills/mcp"]
}
}
}
```
然后，当您的 AI 工具支持外部技能时，添加智能体技能文件夹。使用您工具的安装程序语法，并指向以下存储库文件夹之一：
- `skills/minecraft-datapacks`
- `skills/minecraft-resourcepacks`
- `skills/minecraft-paper-plugins`
手动安装和运行：
```sh
npx minecraft-skills minecraft latest
npx -y @minecraft-skills/mcp
```
有用的第一个命令：
```sh
minecraft-skills plugin paper context 26.2
minecraft-skills plugin paper search "event listener" --kind authoring-recipe
minecraft-skills plugin paper search-scenarios "Paper event listener"
minecraft-skills plugin paper plan paper-event-listener-review 26.2
minecraft-skills datapack recipes
minecraft-skills datapack classify-files data/example/advancement/root.json
minecraft-skills datapack migration-plan 1.20.6 1.21 data/example/advancement/root.json
minecraft-skills datapack commands 26.2 --prefix execute
minecraft-skills resourcepack vanilla-paths 26.2 --contains models/item
minecraft-skills resourcepack file-schema 26.2 assets/example/items/widget.json
minecraft-skills plugin paper members 26.2 --type org.bukkit.entity.Player --contains sendMessage
```
有关完整的 CLI、MCP 工具、包 API、缓存行为和创作工作流，请参阅 [docs/USAGE.md](docs/USAGE.md)。按版本划分的覆盖范围在 [docs/VERSION_SUPPORT.md](docs/VERSION_SUPPORT.md) 中总结。
RCON 设置和权限预设在 [docs/RCON.md](docs/RCON.md) 中记录。
发布说明在 [CHANGELOG.md](CHANGELOG.md) 中跟踪。
## 源策略
主要支持从 Java 版 1.13 开始。可重新分发的事实应来自官方 Mojang 元数据、提取的原版客户端/服务器数据、PaperMC API 工件和文档、结构化社区数据集、`sya-ri/spigot-event-list` API 合同或审查的原始指南。
Minecraft Wiki 是本项目的纯人工后台。AI 工作流不应获取、爬取、总结或引用 Wiki 页面；相反，应使用捆绑数据、Mojang/Paper 源、源报告和允许的结构化数据集。
有关源级别、社区结构化数据集和验证规则，请参阅 [源策略](docs/SOURCE_STRATEGY.md)。
## 软件包
- `packages/data`：规范的版本 JSON/文本数据，可作为 `@minecraft-skills/data` 发布。
- `packages/catalog`：ArkType 验证的读取 API，可作为 `@minecraft-skills/catalog` 发布。
- `packages/rcon`：RCON 配置、权限和执行实用程序，可作为 `@minecraft-skills/rcon` 发布。
- `packages/cli`：公共 CLI，可作为 `minecraft-skills` 发布。
- `packages/mcp`：MCP 服务器，可作为 `@minecraft-skills/mcp` 发布。
- `packages/maintainer`：私有维护者验证和生成工具。
## 开发
此存储库使用 mise、pnpm 工作区、TypeScript、ArkType、tsdown、tsgo、Vitest、Biome 和 sherif。
```sh
mise trust
mise install
mise exec -- pnpm install
CI=true mise exec -- pnpm run check
```
有关维护者工作流、发布检查和数据再生命令，请参阅 [CONTRIBUTING.md](CONTRIBUTING.md)。
