Skip to content

Commit 9fc5c35

Browse files
committed
docs: add game room creation guide to wiki
1 parent e4b72cf commit 9fc5c35

1 file changed

Lines changed: 48 additions & 0 deletions

File tree

docs/wiki.zh-CN.md

Lines changed: 48 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -355,6 +355,54 @@ MahjongPaper 使用 CraftEngine 处理以下内容:
355355

356356
棋牌室数据保存在 `plugins/MahjongPaper/game-rooms.yml` 中。
357357

358+
### 创建棋牌室
359+
360+
目前棋牌室通过编辑 `plugins/MahjongPaper/game-rooms.yml` 手动创建。文件格式如下:
361+
362+
```yaml
363+
rooms:
364+
my-room: # 棋牌室 ID(小写字母、数字、下划线、短横线)
365+
name: "我的棋牌室" # 显示名称
366+
world: world # 世界名称
367+
minX: -50 # 区域最小 X
368+
minY: -10 # 区域最小 Y
369+
minZ: -50 # 区域最小 Z
370+
maxX: 50 # 区域最大 X
371+
maxY: 20 # 区域最大 Y
372+
maxZ: 50 # 区域最大 Z
373+
owner: "玩家UUID" # 可选,所有者 UUID
374+
```
375+
376+
**创建步骤**:
377+
378+
1. 停止服务器或确保没有活跃牌桌。
379+
2. 打开 `plugins/MahjongPaper/game-rooms.yml`。
380+
3. 在 `rooms:` 下添加一个新条目,按上面的格式填写 ID、名称、世界名和区域坐标。
381+
4. 保存文件,重启服务器或使用 `/mahjong reload` 重载。
382+
383+
**确定区域坐标的方法**:
384+
385+
- 站在你想设为棋牌室的一个角落,记下 `/minecraft:tp ~ ~ ~` 显示的坐标作为 `minX/minY/minZ`。
386+
- 走到对角线的另一个角落,记下坐标作为 `maxX/maxY/maxZ`。
387+
- 两个角定义一个长方体(AABB),牌桌中心必须在这个长方体内才算"在棋牌室内"。
388+
389+
**示例**:创建一个以 (0, 64, 0) 为中心、半径 15、高度 10 的棋牌室:
390+
391+
```yaml
392+
rooms:
393+
main-hall:
394+
name: "主厅"
395+
world: world
396+
minX: -15
397+
minY: 60
398+
minZ: -15
399+
maxX: 15
400+
maxY: 69
401+
maxZ: 15
402+
```
403+
404+
> 后续版本将添加游戏内命令和选区工具来简化棋牌室的创建流程。
405+
358406
## 常见问题
359407

360408
### 为什么我不能创建牌桌?

0 commit comments

Comments
 (0)