version-image-link: https://tc.z.wiki/autoupload/f/eVhYusBtjOJG2qfZ4rUTz9iO_OyvX7mIgxFBfDMDErs/20251105/CxxM/1170X500/image.jpeg server-jar: https://piston-data.mojang.com/v1/objects/4c0fe96ca002d7049226a740194c8d7114bd5059/server.jar translator: 最亮的信标
blocks 图集拆分到新的独立 items 图集中
blocks 图集的地方,现在需要改为引用 items 图集data/<namespace>/zombie_nautilus_variant/<id>.json 中添加条目,可以以数据驱动方式定义僵尸鹦鹉螺变种model —— 取值之一:normal、warmasset_id —— 此变种资源的命名空间 ID,解析为 assets/<namespace>/textures/<path>.pngspawn_conditions —— 统一的变种选择规则,见下文minecraft:biomebiomes —— 单个条目、列表或一个用于描述群系的标签minecraft:moon_brightnessrange —— 浮点数范围(可为单个数,或形如 {"min": 1, "max": 2} 的对象)minecraft:structuresstructures —— 单个条目、列表或一个用于描述结构的标签minecraft:max_entity_cramming 游戏规则的限制,最小值改为 0minecraft:piercing_weapon 与 minecraft:kinetic_weapon 数据组件现对攻击范围参数增加了边界:
min_reach:有效范围 0.0 至 128.0max_reach:有效范围 0.0 至 128.0hitbox_margin:有效范围 0.0 至 1.0时间线是一个新的实验性概念,定义在数据包的 timeline 注册表下(即位于 data/<namespace>/timeline/<id>.json)。
时间线基于绝对昼夜时间(即 /time set 所设置的时间)来指定游戏行为。时间线可选地指定一个周期,使之循环重复。
时间线的主要用途是作为环境属性的一个来源,从而对环境属性应用修饰符,以修改游戏行为或视觉效果。
格式:包含以下字段的对象
period_ticks:可选整数,定义时间线的循环周期刻数
tracks:可选映射,将环境属性 ID 映射到对应的环境属性轨迹对象
时间线默认不会生效,除非被某个维度引用 —— 见下文“维度类型”。
引入时间线后,环境属性来源的处理顺序如下(从低到高优先级):
时间线可以定义属性轨迹 —— 通过关键帧描述某个环境属性的修饰符随时间如何变化。依据属性不同,关键帧之间可进行插值;若不使用插值,则始终选取前一个关键帧的值。
例如,一个周期为 24000 的时间线可以这样设置:
0, 时间线设置 sky_color = #ff0000 (红色)1000, 时间线设置 sky_color = #ff0000 (红色)6000, 时间线设置 sky_color = #ff00ff (品红色)在 0 到 1000 之间,天空颜色保持红色;在 1000 到 6000 之间,将从红色平滑过渡到品红色;随后从 6000 开始直到时间线循环回到 0,颜色会缓慢回到红色。
注意:不同于生物群系,若时间线使用的是修饰符而非覆盖,插值会作用于修饰符的参数,而不是最终修改后的数值。
时间线中的属性轨迹为如下字段的对象:
ease —— 可选缓动类型,用于在关键帧之间对数值插值进行缓动(见下文)
linearkeyframes —— 关键帧对象列表,必须按 ticks 升序:
ticks —— 整数,位于 0 到 period_ticks(若已指定)之间,表示该关键帧生效的刻value —— 修饰符参数(格式取决于所选修饰符)modifier(或为 override),该字段类型与环境属性本身一致modifier —— 可选 字符串修饰符 ID,依属性类型而定(见下文“通用修饰符”)
override例如,下面这个时间线的周期为 24000,仅包含一个对 minecraft:gameplay/cat_waking_up_gift_chance 进行修改的属性轨迹。由于缓动类型为 constant,因此在 362 到 23667 之间取值为 0.0,而在 23667 到下一个 362 之间取值为 0.7。
与其他环境属性来源一样,轨迹中指定的数值会作为 modifier 的参数,叠加在较低优先级来源之上。本例中修饰符为 maximum,因此该时间线只会把 cat_waking_up_gift_chance 的取值提高到轨迹所给的数值(不会降低)。
{
"period_ticks": 24000,
"tracks": {
"minecraft:gameplay/cat_waking_up_gift_chance": {
"ease": "constant",
"modifier": "maximum",
"keyframes": [
{ "ticks": 362, "value": 0.0 },
{ "ticks": 23667, "value": 0.7 }
]
}
}
}
缓动类型用于通过一条曲线控制两个关键帧之间的插值。内置的缓动类型有:
constant - 永远选择前一个关键帧linearin_backin_bouncein_circin_cubicin_elasticin_expoin_quadin_quartin_quintin_sinein_out_backin_out_bouncein_out_circin_out_cubicin_out_elasticin_out_expoin_out_quadin_out_quartin_out_quintin_out_sineout_backout_bounceout_circout_cubicout_elasticout_expoout_quadout_quartout_quintout_sine你也可以使用三次贝塞尔曲线指定缓动类型,格式:{ "cubic_bezier": [ x1, y1, x2, y2 ] }
x1: 在 0 和 1 之间的浮点数, 第一个控制点的 x 轴坐标y1: 浮点数,第一个控制点的 y 轴坐标x2: 在 0 和 1 之间的浮点数, 第二个控制点的 x 轴坐标y2: 浮点数,第二个控制点的 y 轴坐标[!DEVNOTE]想要尝试并可视化各种缓动,easings.net 与 cubic-bezier.com 是很好的参考!
生物活动:来自内置注册表 minecraft:activity 的字符串 ID。包括:
minecraft:coreminecraft:idleminecraft:workminecraft:playminecraft:restminecraft:meetminecraft:panicminecraft:raidminecraft:pre_raidminecraft:hideminecraft:fightminecraft:celebrateminecraft:admire_itemminecraft:avoidminecraft:rideminecraft:play_deadminecraft:long_jumpminecraft:ramminecraft:tongueminecraft:swimminecraft:lay_spawnminecraft:sniffminecraft:investigateminecraft:roarminecraft:emergeminecraft:digblend_to_gray RGB/ARGB 修饰符 —— 先将颜色转换为灰度,应用亮度修饰,再按给定因子与原色混合
gray = brightness * (0.3 * red + 0.59 * green + 0.11 * blue),result = lerp(factor, subject, [gray, gray, gray])brightness:0 到 1 的浮点数,施加到灰度值的倍率factor:0 到 1 的浮点数,用于混合的因子minecraft:visual/sunrise_sunset_color控制日出与日落效果的颜色与强度。若完全透明,则不会渲染日出或日落。仅在 overworld 天空盒类型下可见。
"#00000000"minecraft:visual/sun_angle太阳的角度,沿东到西顺时针方向,0 代表正上方。仅在 overworld 天空盒类型下可见。
0.0minecraft:visual/moon_angle月亮的角度,沿东到西顺时针方向,0 代表正上方。仅在 overworld 天空盒类型下可见。
0.0minecraft:visual/star_angle星空的角度,沿东到西顺时针方向,0 代表正上方。仅在 overworld 天空盒类型下可见。
minecraft:visual/moon_phase月相。仅在 overworld 天空盒类型下可见。
full_moonwaning_gibbousthird_quarterwaning_crescentnew_moonwaxing_crescentfirst_quarterwaxing_gibbous"full_moon"overrideminecraft:visual/star_brightness天空中星星的亮度,其中 0.5 为夜间正常亮度,0 为完全不可见。仅在 overworld 天空盒类型下可见。
0 和 1 之间的浮点值0.0minecraft:visual/sky_light_color天空光的视觉颜色。对于天空光等级为 0 的方块(或 minecraft:visual/sky_light_factor 为 0),该值无效。此值作为 SkyLightColor 传入 lightmap.fsh 着色器。
minecraft:visual/sky_light_factor天空光的视觉亮度。minecraft:visual/sky_light_color 会与该值相乘。此值作为 SkyFactor 传入 lightmap.fsh 着色器。
对应的游戏性效果完全由 minecraft:gameplay/sky_light_level 控制。
1.0minecraft:audio/firefly_bush_sounds若为 true 且其上方不是不透明方块,则萤火虫灌木丛会播放待机音效。
falseminecraft:gameplay/sky_light_level用于诸如生物生成、阳光探测器等机制的天空的有效光照等级。例如,完全暴露在天空下的方块,会被认为其光照等级恰为此值;在洞穴深处的方块则完全不受影响。
对应的视觉效果完全由 minecraft:visual/sky_light_factor 控制。
15.0minecraft:gameplay/eyeblossom_open若为 true,闭合的眼眸花将在随机刻中逐渐打开;若为 false,张开的眼眸花会反向变化;若为 "default",则无论开闭都保持当前状态。
truefalse"default""default"overrideminecraft:gameplay/turtle_egg_hatch_chance海龟蛋方块在随机刻时进入下一孵化阶段的概率。
0 和 1 之间的浮点值0.0minecraft:gameplay/creaking_active若为 true,嘎枝之心方块(及对应的嘎枝)将进入激活状态;若为 false,则进入休眠状态。
falseminecraft:gameplay/surface_slime_spawn_chance当在带有 #allows_surface_slime_spawns 标签的群系中发生一次史莱姆自然生成尝试时,会额外进行的一次概率检定。
0 和 1 之间的浮点值0.0minecraft:gameplay/cat_waking_up_gift_chance当玩家醒来时,躺在其床上的猫掉落礼物(来自 gameplay/cat_morning_gift 战利品表)的概率。
0.0minecraft:gameplay/bees_stay_in_hive若为 true,蜜蜂会尝试回到蜂巢,除非蜂巢被破坏或旁边有火,否则不会离开。
falseminecraft:gameplay/monsters_burn若为 true,怪物在暴露于天空时会燃烧。
falseminecraft:gameplay/can_pillager_patrol_spawn若为 true,灾厄巡逻队可以生成。
注意:全局天空光照等级还必须大于 11。
true#without_patrol_spawnsminecraft:gameplay/villager_activity控制成年村民的默认 AI 活动。
并非所有活动都受村民 AI 支持 —— 若选择了不受支持的活动,村民将无所事事。支持的活动包括:
corehideidlemeetpanicpre_raidraidrestwork"minecraft:idle"overrideminecraft:gameplay/baby_villager_activity控制幼年村民的默认 AI 活动。
并非所有活动都受村民 AI 支持 —— 若选择了不受支持的活动,村民将无所事事。支持的活动包括:
corehideidlemeetpanicplaypre_raidraidrest"minecraft:idle"overridetimelines,用于指定此维度中激活的时间线
natural 已完全由环境属性 minecraft:gameplay/eyeblossom_open 与 minecraft:gameplay/creaking_active 取代effects 字段,改用以下新字段:
skybox —— 使用的天空盒渲染类型,取值:none(原 minecraft:nether 效果 ID)overworld(原 minecraft:overworld 效果 ID)
overworld 时,以下环境属性会生效:minecraft:visual/sky_color、minecraft:visual/sun_angle、minecraft:visual/sunrise_sunset_color、minecraft:visual/moon_phase、minecraft:visual/moon_angle、minecraft:visual/star_angle、minecraft:visual/star_brightnessend(原 minecraft:end 效果 ID)overworldcardinal_light —— 影响方块的基本光照方向,取值:default(原 minecraft:overworld 与 minecraft:end 效果 ID)nether(原 minecraft:nether 效果 ID)fixed_time 已由布尔值 has_fixed_time 取代(默认 false)
fixed_time 存在而改变的行为,现改为依据 has_fixed_time 布尔值#without_patrol_spawns —— 由环境属性 gameplay/can_pillager_patrol_spawn 替代#spawns_coral_variant_zombie_nautilus —— 可生成珊瑚僵尸鹦鹉螺变种的群系#universal —— 在所有维度中激活的时间线#in_overworld —— 在主世界中激活的时间线#in_nether —— 在下界中激活的时间线#in_end —— 在末地中激活的时间线spear_mobs 触发器,包含字段:
player:可选 实体谓词,使用动能武器的玩家count:可选 整数,单次使用动能武器击中的生物数量blocks 图集中拆分到新的、无 mipmap 的 items 图集
items 或 blocks)blocks 图集item/netherite_horse_armorentity/equipment/zombie_nautilus_coral.pngentity/equipment/horse_body/netherite.pngentity.parrot.imitate.parchedentity.parrot.imitate.zombie_horseentity.parrot.imitate.zombie_nautilus