25w17a

Project/libraries/Versions/Snapshot/25w17a.md

@@ -1,7 +1,170 @@
 ---
-version-image-link: null
-not_finished: true
+version-image-link: https://img.picgo.net/2025/04/22/image60513bac9805104a.png
 server-jar: https://piston-data.mojang.com/v1/objects/575756f90e54e5c2cd78997dd9e3579936aa9d6d/server.jar
-translator: null
+translator: 最亮的信标
 cats: ['1.21','1.21.6']
 ---
+
+在经历了一个漫长的周末后我们带着新快照回来了！本周我们将定位栏移出了实验性特性，快来试试并继续向我们提供反馈于 [feedback.minecraft.net](http://feedback.minecraft.net/)。我们也对 Realms UI 做了一些改进，包括选择你的世界所在的地区。祝挖矿愉快！
+
+## 新特性
+
+- 增加了减少云层范围的选项
+- 增加了定位栏，一个新的在多人游戏中展示其它玩家位置的 HUD 元素
+
+### 定位栏
+
+定位栏是一个新的 UI 元素，可以向玩家显示世界中其它玩家的方向。
+
+如果世界中没有其它玩家则经验条会照常显示，否则如果其它玩家在世界中（且其没有隐藏），经验条会在获得经验的时候显示，其余时间将会在同一区域显示定位栏。
+
+- 多人游戏服务器可以使用 `locatorBar` 游戏规则切换定位栏
+- 玩家可通过潜行、头戴生物头颅或雕刻南瓜或使用隐身药水隐藏自己
+- 在旁观者模式下的玩家不会在定位栏中可见
+  - 但旁观者模式下的玩家彼此之间仍可见
+- 摄像机朝向一个 120 度之内的玩家时时定位栏会以带颜色的指示器显示其位置
+  - 当玩家在屏幕的上方或下方时，指示器会显示一个向上或向下的箭头
+  - 指示器会依据其指示玩家的距离来改变不同的图标大小
+  - 指示器颜色对各个玩家时随机的
+    - 服务器可以使用 `/waypoint` 修改指示器颜色
+      - 例如: `/waypoint modify @s color red` 设置指示器为红色
+    - 在队伍中的玩家会以其队伍颜色覆盖其默认指示器颜色
+
+#### 玩家更改
+
+- 潜行将会隐藏玩家，阻止其在其它玩家的定位栏中出现
+- 旁观者模式玩家仅对其它旁观者模式玩家在定位栏中可见
+
+#### 物品更改
+
+- 下列物品装备在头部槽位时会隐藏玩家：
+  - 雕刻南瓜
+  - 骷髅头颅
+  - 凋灵骷髅头颅
+  - 玩家的头
+  - 僵尸的头
+  - 苦力怕的头
+  - 龙首
+  - 猪灵的头
+
+#### 药水更改
+
+- 使用隐身药水会使自身在其它玩家定位栏中隐藏
+
+## 更改
+
+- 改进了 Realms 配置界面
+- 引入了区域偏好设置，允许更精细的控制 Realm 启动区域
+
+### Realms
+
+- 更改 Realms 配置界面外观，使用标签页
+  - 世界标签页包含了对世界槽位的更改，创建新世界以及更改其设置
+  - 玩家标签页可以管理可访问 Realm 的玩家以及其访问等级
+  - 订阅标签页可以管理 Realms 订阅
+  - 设置标签页可以更改 Realm 的设置
+- 引入了区域偏好设置，允许更精细的控制 Realm 启动区域
+- 将关闭/打开 Realm 的措辞更改为 暂时关闭/重新打开 Realm
+
+## 技术性更改
+
+- 数据包版本现在为 74
+- 资源包版本现在为 58
+- 增加了服务器认证的路径点广播系统以控制定位栏对玩家的行为
+
+## 数据包版本 74
+
+### 命令
+
+#### 增加了 `waypoint`
+
+这是一个新的用于查询和更改路径点的指令。
+
+```
+waypoint list
+
+waypoint modify <实体选择器> color <颜色>
+waypoint modify <实体选择器> color hex <16进制颜色>
+waypoint modify <实体选择器> color reset
+waypoint modify <实体选择器> style set <路径点样式/资源>
+waypoint modify <实体选择器> style reset
+```
+
+参数:
+
+- `实体选择器`: 用于选择作为路径点传输的实体(见 `waypoint_transmit_range` 属性)
+- `颜色`: 覆盖此路径点的定位栏图标颜色
+- `hex <16进制颜色>`: web 格式的十六进制颜色参数(RRGGBB)
+  - 红色为 `hex F00` 或 `hex FF0000`
+  - 矢车菊蓝为 `hex 6495ED`
+- `style`: 用于更改图标精灵图集以及选择距离
+  - `set <路径点样式/资源>` 更改样式到在 `waypoint_style/` 下的指定资源
+  - `reset` 将会重置定位栏为默认图标行为
+
+### 路径点样式
+
+这定义了要显示于定位栏以及在 `waypoint_style/` 资源文件夹中的自定义图标。
+
+默认的实现如下所示：
+
+```
+{
+  "near_distance": 128,
+  "far_distance": 332,
+  "sprites": [
+    "minecraft:default_0",
+    "minecraft:default_1",
+    "minecraft:default_2",
+    "minecraft:default_3"
+  ]
+}
+```
+
+- `near_distance` 以及 `far_distance` 是可选的，分别默认为 `128` 以及 `332`。
+  - `far_distance` 距离必须比 `near_distance` 要大
+- 每一个前缀为 `hud/locator_bar_dot/` （在 `textures/gui/sprites/hud/locator_bar_dot` 文件夹里的）的精灵图都会被搜索
+- 一个生成自定义名字为 "Xilefian" 的传播自定义图标路径点的生物的例子:
+  - /summon armor_stand ~ ~ ~ {CustomName:[{text:Xilefian}],attributes:[{id:waypoint_transmit_range,base:1000f}]}
+
+### 游戏规则
+
+#### 增加了 `locatorBar` 
+
+- 默认为开启，启用定位栏
+- 切换到关闭将从所有玩家移除所有存在的路径点
+- 游戏规则从实验性的 `useLocatorBar` 重命名为当前名称。这可能破坏在之前快照中创建的次要的命令相关特性
+
+#### 增加了 `waypoint_transmit_range` 与 `waypoint_receive_range`
+- 默认值：`0.0`，最小值: `0.0`，最大值: `60000000.0`
+- 玩家默认拥有距离为 60,000,000 的收发范围
+- 传输距离为正的生物会向附近的接收者发送路径点包
+- 类似的，接收者只能在接收距离为正的情况下接收，且无法接受超过这个距离的路径点
+
+例如:
+
+- `/attribute @s minecraft:waypoint_transmit_range base set 0` 会阻止玩家传输（隐藏他们）
+- `/attribute @s minecraft:waypoint_transmit_range base set 80` 会仅让玩家传输最远 80 格（对比这个距离远的玩家隐藏）
+- `/attribute @s minecraft:waypoint_receive_range base set 0` 会阻止玩家接收（关闭他们的定位栏）
+- `/attribute @s minecraft:waypoint_receive_range base set 120` 会仅玩家看见 120 格方块内的定位栏点(隐藏远于此距离的所有玩家)
+
+### 路径点广播
+
+定位栏使用服务器控制的路径点系统，路径点由玩家接收，且路径点与玩家之间的连接由多人游戏服务器管理。
+
+- 在默认情况下，所有玩家从自身传输路径点，并且所有玩家会收到所有路径点
+- 可以由 `waypoint_transmit_range` 以及 `waypoint_receive_range` 属性控制个别玩家的传输以及接收范围
+
+### 标签
+
+#### 方块标签
+
+- 增加了 `happy_ghast_avoids` - 快乐恶魂避免靠近的方块
+- 增加了 `triggers_ambient_dried_ghast_block_sounds` - 当失水恶魂放置在其上边时可以触发失水恶魂环境音效的方块
+
+## 资源包版本 58
+
+### 着色器以及后处理器效果
+
+#### `fog` Uniform 块
+
+- `FOG_IS_SKY` 已被移除以拆分天空着色器