转载 开源 游戏模式 六块石头 1.0

[MD]
# 六块石头（SixStones）

SixStones 是一款 Minecraft 服务端玩法插件。服务器管理者可以在世界中随机“投放”或生成六块石头；持有石头的玩家将获得不同的正面状态效果，例如生命提升或力量。

玩家需要在世界中探索、争夺石头，并可组建队伍共同收集。当同一名玩家集齐全部六块石头时，即可“结束”服务器的本局玩法。

## 玩家目标

玩家可以自由组队，目标是收集全部六块石头并结束本局游戏。所有玩家或队伍都会围绕石头展开探索、竞争与争夺。

## 石头效果一览

| 石头 | 效果 |
|---|---|
| 闪耀钻石（Dazzling Diamond） | 生命提升 II，额外增加 5 点生命值（2.5 颗心） |
| 卓越下界合金（Notable Netherite） | 力量 II |
| 重要铁锭（Important Iron） | 抗性提升 II |
| 闪光黄金（Gleaming Gold） | 急迫 II |
| 极速红石（Rapid Redstone） | 速度 I、跳跃提升 I |
| 神秘绿宝石（Enigmatic Emerald） | 生命恢复 II |

以上效果后续可能调整。

## 石头放置与丢弃限制

石头无法被丢弃，也无法被放入容器中。插件会拦截以下常见操作：

- 与副手交换或放入副手
- 使用数字键与快捷栏交换或放置
- 拾取物品时的放置或交换操作
- 按住 Shift 点击物品

这些限制应覆盖绝大多数转移石头的方式。

## 持有石头时死亡

当玩家持有石头死亡时，将发生以下操作：

1. 石头会从死亡玩家的掉落物中移除。
2. 插件会在玩家死亡位置生成一个箱子，并将石头放入其中。
3. 死亡地点会发射烟花，提醒附近玩家。

> 通过虚空死亡时无法正常处理石头，因为箱子会被尝试放置在 `Y=0` 高度。

## 定位石头

### 石头初始位置

服务器投放石头时，会通过标题消息显示石头的大致坐标。除此之外，暂时没有其他方式可追踪尚未被玩家获取的石头，建议及时记录坐标。

### 追踪持有者

当有玩家获得石头后，其他玩家可以使用指南针追踪该石头的持有者。

- 指南针可在主世界、下界和末地中使用。
- 需要右键使用指南针进行追踪。
- 为平衡玩法，指南针不会显示准确的 Y 坐标。
- 在有人集齐全部石头前，追踪结果为近似位置；持有石头越多，定位越精确。

| 持有石头数量 | 定位误差 |
|---:|---:|
| 1 块 | ±45 格 |
| 2 块 | ±35 格 |
| 3 块 | ±25 格 |
| 4 块 | ±15 格 |
| 5 块 | ±5 格 |
| 6 块 | ±0 格，完全准确 |

# 服务器管理

## 安装

1. 从 Modrinth 下载与服务器 Minecraft 版本相匹配的插件版本。
2. 将下载的 `.jar` 文件放入服务器的 `plugins` 文件夹。
3. 启动服务器，让插件自动生成所需文件。

## 配置

目前插件暂不提供配置选项，后续版本可能会加入。

## 权限

| 权限节点 | 用途 |
|---|---|
| `sixstones.drop` | 使用石头投放命令 |
| `sixstones.recover` | 使用石头恢复命令 |
| `sixstones.giveallstones` | 使用获取全部石头命令 |

## 命令

命令参数说明：

- `<参数>`：必填参数
- `[参数]`：可选参数

### 随机投放石头

```text
/stone <stone> drop [include] [exclude]
```

权限：`sixstones.drop`

在随机位置生成一块石头，并将其放入箱子中。

- 未填写 `include` 和 `exclude` 时：将在世界边界范围内随机生成。
- 仅填写 `include` 时：将在世界中心至 `include` 指定半径之间生成。
- 同时填写 `include` 与 `exclude` 时：将在以世界原点为中心、半径介于 `exclude` 和 `include` 之间的区域生成。

### 恢复石头

```text
/stone <stone> recover <player>
```

权限：`sixstones.recover`

仅供服务器管理员使用。当石头因漏洞或异常被删除时，可使用此命令将指定石头补发给目标玩家。

### 转交石头

```text
/stone <stone> give <player>
```

权限：所有玩家均可使用。

将指定石头转交给另一名玩家。执行命令的玩家必须持有该石头；石头会从执行者背包中移除，并交给命令指定的目标玩家。

### 获取追踪指南针

```text
/stone <stone> locate
```

权限：所有玩家均可使用。

为执行命令的玩家提供一个特殊指南针，用于指向持有指定石头的玩家。

### 获取全部石头

```text
/giveallstones
```

权限：`sixstones.giveallstones`

此命令仅建议用于测试，会将全部六块石头给予命令执行者。

## 石头投放建议

如果服务器不采用固定场次玩法，建议在开服约三天后开始投放石头。这样能为玩家预留时间，用于收集资源、制作护甲和武器。
[/MD]