# CBCraft

**Repository Path**: viagrahuang/cbcraft

## Basic Information

- **Project Name**: CBCraft
- **Description**: Minecraft Java 版指令大全，让指令触手可及
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: https://cbcraft.070219.xyz
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-03-13
- **Last Updated**: 2026-03-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CBCraft | MC指令大全

CBCraft 是一个为 Minecraft Java 版玩家提供全面指令参考的文档网站。

- **网站地址**: https://cbcraft.070219.xyz
- **框架**: Astro + Starlight
- **语言**: 简体中文

## 想为 CBCraft 做贡献？

如果您想为文档做贡献，欢迎提交 Pull Request，感激不尽喵。

- 本仓库支持轻量级 PR，您可以直接在 Gitee 上修改并提交 PR。
- 如果有较大改动，建议 fork 项目后在本地进行修改，最后提交 Pull Request。

### 文档目录

文档保存在 `src/content/docs` 目录下，该目录结构及其解释如下：

```
docs
├── basics/      # MC 指令基础知识（指令入门、目标选择器、NBT 基基础等）
├── world/       # 核心世界管理（时间、天气、世界边界等）
├── player/      # 游戏模式与玩家（gamemode、tp、spawnpoint 等）
├── inventory/   # 物品与背包（give、clear 等）
├── entity/      # 实体与生命（summon、kill、effect 等）
├── logic/       # 逻辑与数据（scoreboard、tag、data、execute 等）
├── server/      # 服务器管理（whitelist、ban、op 等）
├── other/       # 其他指令（debug、perf、seed 等）
├── about/       # 本站相关（用户协议、隐私政策、贡献者、赞助）
└── docs-home.md # 网站首页
```

### 文章格式

每篇文章必须包含 YAML Front Matter：

```yaml
---
title: 文章标题
---
```

- `title` 作为文章显示标题和侧边栏文字
- 文章正文从 **H2** 标题开始，无需再写 H1

### 添加新文章

1. 在对应目录下创建 `.md` 文件
2. 文件会自动被 Starlight 的 `autogenerate` 功能识别并添加到侧边栏
3. 无需手动修改 `astro.config.mjs`

### 文件命名规范

- 使用小写字母和连字符
- 指令文档格式：`指令名称-command.md`
- 例如：`gamemode-command.md`、`scoreboard-command.md`

- **在未经作者允许的情况下请勿擅自添加目录**

## 提交 PR 规范

文章完成并确认无误后，请提交 Pull Request 到 **develop** 分支，作者将审核并合并。

PR 应包含以下信息：

```markdown
### 修改/添加的文件
1. xxx
2. xxx

### 修改/添加的内容简述
1. xxx
2. xxx

### 修改/添加的目的
1. xxx
2. xxx
```

## 本地开发

```bash
# 安装依赖
pnpm install

# 启动开发服务器
pnpm dev

# 构建生产版本
pnpm build

# 预览构建结果
pnpm preview
```

## License

Apache-2.0 License