version-image-link: https://tc-new.z.wiki/autoupload/f/XTxqEIEXt3ek2iMfNVy0xHr9SBDGMOz2CzLFKIoBJwSyl5f0KlZfm6UsKj-HyTuv/20251001/ebND/1170X500/image.png server-jar: https://piston-data.mojang.com/v1/objects/11e54c2081420a4d49db3007e66c80a22579ff2a/server.jar translator: 最亮的信标
[!DEVNOTE] 你知道 Minecraft:Java 版支持上百种语言吗?并且这些全都归功与你、我们的社区,以及你们对翻译项目运行做出的不可忽视的贡献。如果你想要帮助我们翻译游戏,可以在Crowdin上加入我们。国际翻译日快乐!
增加了铜火把
增加了铜栏杆
增加了铜链
增加了铜灯笼
增加了一个服务器管理 API (JSON-RPC over WebSocket) 用于专用服务器
此 API 默认禁用,可以由服务器 properties 文件启用
management-server-enabled=truemanagement-server-host=localhostmanagement-server-port=25585当启用时 API 可以通过 ws://<management-server-host>:<management-server-port> 访问
支持查询以及更新服务器状态(玩家、白名单、操作员、设置、游戏规则)
在状态更改时发送通知 (如:玩家加入、游戏规则更新)
调用 {"id":1,"method":"rpc.discover"} 返回一个包含了当前运行的服务器支持的方法以及通知的 API schema
数据生成器在报表输出文件夹中提供一个 API schema (json-rpc-api-schema.json) 反映了 rpc.discover 方法返回的内容
API 遵守 JSON-RPC 2.0 规范
使用带有命名空间的方法,并且保留的命名空间为 minecraft (如:minecraft:players,minecraft:allowlist/add)以及 notification (如 notification:players/joined)
核心方法组: 玩家、白名单、操作员、服务器(保存、停止)、服务器设置、游戏规则
方法调用示例:
请求:
{
"method": "minecraft:allowlist/add",
"id": 1,
"params": [ [{ "name": "jeb_" }] ]
}
响应:
{
"jsonrpc": "2.0",
"id": 1,
"result": [{ "id": "853c80ef-3c37-49fd-aa49-938b674adae6", "name": "jeb_" }]
}
通知示例:
{
"jsonrpc": "2.0",
"method": "notification:players/joined",
"params": [{ "id": "853c80ef-3c37-49fd-aa49-938b674adae6", "name": "jeb_" }]
}
错误示例:
{"method": "minecraft:foo/bar","id": 1}响应:
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"jsonrpc": "2.0",
"id": 1,
"error": {
"code": -32601,
"message": "Method not found",
"data": "Method not found: minecraft:foo/bar"
}
}
}
错误以及错误代码遵守 JSON-RPC 2.0 错误对象格式
如果聊天被强制关闭,未发送的聊天信息现在会被存为聊天草稿
任何存在的聊天草稿将会在下一次聊天栏打开时提前填充到消息框
草稿文字有着灰色外观,直到其恢复
在聊天设置菜单中增加了一个选项,默认情况下保存未发送的聊天消息
当连接到服务器时,现在会显示服务器行为准则屏幕。
enable-code-of-conduct 添加入了 server.properties
true 将会使服务器在与 server.properties 所在文件夹中的名为 codeofconduct 子文件夹中寻找行为准则文件<language_code>.txt 格式
en_us 的行为准则en_us 也不存在,则会匹配任意文件为允许在服务器运行时更改设置,若干服务器属性被移除改为游戏规则。
allow-nether,改用新的游戏规则 allowEnteringNetherUsingPortalsspawn-monsters,改用新的游戏规则 spawnMonstersenable-command-block,改用新的游戏规则 commandBlocksEnabledpvp,改用新的游戏规则 pvpmanagement-server-enabled 控制是否启用 Minecraft 服务端管理协议
falsemanagement-server-port 控制 Minecraft 服务端管理协议端口
0,每次启动分配可用端口management-server-host 控制 Minecraft 服务端管理协议主机
localhostmanagement-server-tls-enabled 控制 Minecraft 服务端管理协议是否使用 TLS
truemanagement-server-tls-keystore 控制 TLS keystore 文件路径
management-server-tls-keystore-password 控制 TLS keystore 密码
status-heartbeat-interval 控制管理服务器向已连接客户端发送心跳通知的间隔
enable-code-of-conduct
spawnChunkRadius 游戏规则pvp 游戏规则控制玩家是否可以对其他玩家造成伤害
trueallowEnteringNetherUsingPortals 游戏规则控制下界是否可通过传送门进入
truespawnMonsters 游戏规则控制怪物是否自然生成
truecommandBlocksEnabled 游戏规则控制命令方块是否启用
truespawnerBlocksEnabled 游戏规则控制刷怪笼是否启用
truepack.mcmeta 格式已更新:
supported_formats 字段
pack_format 字段现在可选
min_format —— 指定支持的最小版本
[74, 1]74 与 [74, 0] 相同max_format —— 指定支持的最大版本
[74, 1]0x7fffffffformats 字段
min_format 与 max_format,其格式与上述字段相同-DMC_DEBUG_ENABLED 或 -DMC_DEBUG_ENABLED=true 启用全局调试标记-DMC_DEBUG_BRAIN 或 -DMC_DEBUG_BRAIN=true-DMC_DEBUG_PRINT_PROPERTIES 可获取所有可用调试属性列表fetchprofile 命令以下载玩家档案chain 重命名为 iron_chain增加了一种新的技术性实体,名为 minecraft:mannequin,仅能通过命令生成。
below_name 记分栏位处显示一个“NPC”文本minecraft:profile 组件数据字段:
profile - 在实体上显示的档案。可以是玩家档案(与 minecraft:profile 组件格式相同),或一个有下列字段的玩家模型档案:
texture - 要使用的皮肤纹理的带有命名空间的 ID
texture 文件夹的路径区分,带有 .png 后缀entity/player/wide/steve 会使用默认史蒂夫皮肤cape - 可选的要使用的披风的命名空间 ID
texture 字段相同格式elytra - 可选的要使用的鞘翅的命名空间 ID
texture 字段相同格式module - 可选的模型类别,wide 或 slim
widehidden_layers - 隐藏的皮肤层列表
cape、 jacket、 left_sleeve、 right_sleeve、 left_pants_leg、 right_pants_leg、 hatmain_hand - 玩家模型的主手——left 或 rightobject 文本组件objectobject: 对象的类型,字符串,值见下方<type-specific>: 由对象类型决定的可选字段nbt 文本组件相似,object 字段可省略
atlas 对象类型object 组件有相同的行为,但现在其分离为一个对象类型player 对象类型minecraft:profile 组件相同方式解析player: 玩家档案
name: 玩家名称,可选字符串id: 玩家 UUID,可选 UUIDproperties: 档案属性,可选映射hat: 控制是否渲染帽子层,布尔,默认 falserun_command 点击事件/say、 /me、 /msg、 /tell、 /w、 /teammsg、 /tm),它会自动放弃summon 命令现在在尝试在和平难度召唤怪物时会失败spawnpoint 和 setworldspawn 命令现在可以控制完整的玩家视角方向
angle 参数被移除rotation 参数,要求同时指定 yaw 与 pitchsetworldspawn 命令不再限制在主世界
fetchprofile因为这个操作可能需要一些时间,它在工作时为异步进行
在成功完成后,会显示一条消息以让用户复制的完全储存的 minecraft:profile 组件内容,或有着 said 组件的 /give @s minecraft:player_head
因为命令执行不会立即产生结果,这个指令返回值恒为 1
语法:
fetchprofile name <player name> - 返回由玩家名(大小写不敏感)解析的档案fetchprofile id <uuid> - 返回由 id 解析的档案minecraft:profile这意味着这个组件现在有两个行为:
静态: 当其存在 properties 字段时,或 name 和 id 均设置或均未设置时
properties 字段缺省,会使用默认皮肤(由 id 决定,与离线模式相同)动态: 当没有 name 或 id 时(但不是两个都没有)
注:如果玩家在游戏运行时更改了皮肤,其更改不可见直到客户端重启
在解析时可能会造成延迟,在这时物品会渲染为默认皮肤
当存在时,物品名称将会替换档案名称
只有 id 的物品会显示默认名称
具有动态档案的物品会用提示栏与静态物品区分
物品堆叠基于精确的内容,所以即使动态组件与静态组件解析结果完全一样,它们也不会堆叠
在以前的地图上的未被新版本加载的玩家的头通常将会转为动态内容
minecraft:skullprofile 字段被修改以匹配 minecraft:profile 组件
minecraft:entity_interact 战利品表类型,参数:
target_entity 被交互的实体interacting_entity 可选,与 target_entity 交互的实体tool 用于交互的工具minecraft:block_interact 战利品表类型,参数:
block_state 被交互的方块实体的方块状态block_entity 可选,被交互的方块实体interacting_entity 可选,与 block_state 交互的实体tool 可选,用于与 block_state 交互的工具entity_properties.entity)现在还可以指定 target_entity 与 interacting_entity 参数类型charged_creeper/root 战利品表用于被闪电苦力怕击杀时的掉落
charged_creeper/piglincharged_creeper/creepercharged_creeper/skeletoncharged_creeper/wither_skeletoncharged_creeper/zombiebrush/armadillo 战利品表用于对犰狳刷子时的掉落gameplay/turtle_grow 战利品表用于海龟长大为成年时的掉落harvest/beehive 战利品表用于使用剪刀收获蜂箱或蜂巢时的掉落harvest/cave_vine 战利品表用于交互收获有发光浆果的洞穴藤蔓时的掉落harvest/sweet_berry_bush 战利品表用于交互收获有浆果的浆果丛时的掉落carve/pumpkin 战利品表用于使用剪刀雕刻南瓜时的掉落minecraft:fill_player_headentity 字段现在接受新的实体上下文值:
target_entityinteracting_entityminecraft:set_loreentity 字段现在接受新的上下文值:
target_entityinteracting_entityminecraft:copy_custom_datasource 字段现在接受新的上下文值:
target_entityinteracting_entityminecraft:copy_namesource 字段现在接受新的上下文值:
direct_attackertarget_entityinteracting_entityminecraft:copy_componentssource 字段现在接受新的上下文值:
thisattackerdirect_attackerattacking_playertarget_entityinteracting_entitytoolminecraft:entity_scoresentity 字段现在接受新的实体上下文值:
target_entityinteracting_entityminecraft:entity_propertiesentity 字段现在接受新的实体上下文值:
target_entityinteracting_entityexplode 效果新字段: block_effects —— 指定每种方块的粒子。每个方块粒子会随机地基于权重选择。在每一个爆炸刻会生成一系列的方块粒子
格式: 一个入口点列表:
weight: 代表随机选择的权重的非负整型particle: 要生成的粒子scaling: 可选的在爆炸中心与方块位置之间的缩放,默认为 1.0speed: 可选的粒子速度倍数,默认为 1.0noise_settings 定义中的 initial_density_without_jaggedness 字段被 preliminary_surface_level 字段替换
initial_density_without_jaggedness 是一个三维密度函数,通过扫描第一个密度大于 0.390625 的点来决定一个近似的表面高度preliminary_surface_level 是一个二维密度函数,应产生近似表面的 y 级别minecraft:find_top_surface 密度函数可用于复现之前的扫描增加 minecraft:find_top_surface —— 近似给定密度函数的最上层表面
字段:
density - 要近似表面的密度函数upper_bound - 提供最高可能 y 值的二维密度函数lower_bound - 整数,最低可能 y 值cell_height - 正整数,定义扫描使用的网格分辨率增加 minecraft:invert —— 解析为 1/argument
字段:
argument - 密度函数max_distance_from_center 字段现在可以为竖直轴与水平轴指定不同限制
horizontal - 1 到 128 的必需整数vertical - 1 到 4096 的可选整数(默认 4096)"max_distance_from_center": { "horizontal": 20, "vertical": 500 }#copper_chests - 所有铜箱方块#copper - 所有铜方块#incorrect_for_copper_tool - 使用铜工具不会掉落物品的方块#copper_golem_statues - 所有铜傀儡像方块#chains - 所有锁链方块#lanterns - 所有灯笼方块#bars - 所有金属栏杆方块#copper_chests - 所有铜箱方块物品#copper - 所有铜方块物品#copper_tool_materials - 所有铜工具材料#repairs_copper_armor - 所有修复铜护甲的物品#copper_golem_statues - 所有铜傀儡像方块物品#chains - 所有锁链方块物品#lanterns - 所有灯笼方块物品#bars - 所有金属栏杆方块物品#shearable_from_copper_golem - 所有可以使用剪刀从铜傀儡的头部槽移除的物品#cannot_be_pushed_onto_boats - 不能被推上船的生物,包括 枯焦、玩家 以及 所有非两栖水生生物#accepts_iron_golem_gift - 会接受铁傀儡递交物品的生物#candidate_for_iron_golem_gift - 铁傀儡会尝试递交物品的生物,但不一定接受(见 #accepts_iron_golem_gift)dragon_breath 现在可选地使用 power 参数(浮点,默认 1.0),在全部随机进行后乘到其初速度上instant_effect 与 effect 现在可选地使用 power(浮点,默认 1.0)与 color(RGB,默认 0xFFFFFF)参数flash 现在需要 color 参数(ARGB)on_shelf
增加了新方块的精灵图:
coppercopper_leftcopper_rightexposed_copperexposed_copper_leftexposed_copper_rightweathered_copperweathered_copper_leftweathered_copper_rightoxidized_copperoxidized_copper_leftoxidized_copper_rightacacia_shelfbamboo_shelfbirch_shelfcherry_shelfcrimson_shelfdark_oak_shelfjungle_shelfmangrove_shelfoak_shelfpale_oak_shelfspruce_shelfwarped_shelfcopper_barscopper_chaincopper_lanterncopper_torchexposed_copper_barsexposed_copper_chainexposed_copper_lanternexposed_copper_torchoxidized_copper_barsoxidized_copper_chainoxidized_copper_lanternoxidized_copper_torchweathered_copper_barsweathered_copper_chainweathered_copper_lanternweathered_copper_torch增加了新物品的精灵图:
copper_axecopper_bootscopper_chestplatecopper_golem_spawn_eggcopper_helmetcopper_hoecopper_leggingscopper_nuggetcopper_pickaxecopper_shovelcopper_swordcopper_chaincopper_lanternexposed_copper_chainexposed_copper_lanternoxidized_copper_chainoxidized_copper_lanternweathered_copper_chainweathered_copper_lanternenvironment/end_flash.pnggui/container/villager.png 的输出槽向上移动了一个像素block.copper_chest.openblock.copper_chest.closeblock.copper_chest_weathered.openblock.copper_chest_weathered.closeblock.copper_chest_oxidized.openblock.copper_chest_oxidized.closeentity.copper_golem.stepentity.copper_golem.hurtentity.copper_golem.deathentity.copper_golem.spinentity.copper_golem_weathered.stepentity.copper_golem_weathered.hurtentity.copper_golem_weathered.deathentity.copper_golem_weathered.spinentity.copper_golem_oxidized.stepentity.copper_golem_oxidized.hurtentity.copper_golem_oxidized.deathentity.copper_golem_oxidized.spinitem.armor.equip_copperentity.copper_golem.spawnentity.copper_golem.no_item_getentity.copper_golem.no_item_not_getentity.copper_golem.item_dropentity.copper_golem.item_no_dropentity.copper_golem_become_statueblock.copper_golem_statue.breakblock.copper_golem_statue.placeblock.copper_golem_statue.hitblock.copper_golem_statue.fallblock.copper_golem_statue.stepblock.shelf.activateblock.shelf.deactivateblock.shelf.multi_swapblock.shelf.place_itemblock.shelf.single_swapblock.shelf.take_itemweather.end_flashcopper_fire_flame[!DEVNOTE] 虽然在资源包中可以做到,覆盖核心着色器被视为不受支持并非预期的资源包特性。这些着色器是游戏内部实现的一部分,因此可能会随着内部演进随时改变。我们理解覆盖核心着色器被用于很多很酷的资源包特性,其中很多缺乏受支持的替代方案。我们希望未来提供更好且受支持的替代方案。
core/position_color_lightmap.vshcore/position_color_lightmap.fshcore/position_color_tex_lightmap.vshcore/position_color_tex_lightmap.fshPER_FACE_LIGHTING 被添加到下列着色器:
core/entity.vshcore/entity.fsh150 bump 至 330core/screenquad.vsh 替换:
core/blit_screen.vshpost/blit.vshpost/blur.vshpost/invert.vshpost/sobel.vshpost/screenquad.vshgl_VertexID 指定顶点坐标