我的世界中国版 Wiki

主题

自定义流体 ​

概述 ​

自定义流体需要设置两个方块，一个静态流体，一个动态流体。液体在流动过程中最外层是动态流体，其他都是静态流体，二者会相互转换。当流体扩散完毕后可见的均已转化为静态流体，可以通过设置不同颜色来观察动态流体与静态流体之间的相互转换。

base_block设置 ​

  • 自定义流体的base_block，静态流体需要设为liquid，动态流体需要设为flowing_liquid
  • 命名规则，因为静态流体与动态流体是相互转换的，在引擎层通过flowing去定位，所以需要注册一对才能正常使用
    • 静态流体——命名空间:流体方块名，例如customLiquid:red_water
    • 动态流体——命名空间:flowing_流体方块名，例如customLiquid:flowing_red_water

动画纹理 ​

  • 流体需要在resource/textures/flipbook_textures.json中配置动画纹理使其贴图拥有动态流动效果，属于微软功能。

流体方块介绍 ​

  • 可在netease:liquid中设置流体方块的流动速度、流动范围、颜色以及能否使船浮起来
  • 流体方块与原版水一致，如图所示：

special-4

netease:liquid ​

键类型默认值解释
liquid_colorarray[255, 255, 255, 255]可选，流体颜色，4个数依次对应RGBA，取值范围均为0-255。透明度只有在开启了“精美图像”选项时生效。
spread_rangeint8可选，流体范围，以动态流体为中心往外扩散的格数，取值范围1-8，仅动态流体有效
spread_delayint5可选，流体扩散刻数，每经过该刻数扩散一格，每秒20刻，仅动态流体有效
spread_fireboolfalse可选，是否传播火，可参考岩浆效果
can_float_boatbooltrue可选，流体是否能浮起船来，动态流体及静态流体均需要设置
bucket_namestring"water_bucket"可选，空桶对水源使用使获得的物品，默认是原版的水桶（如果是自定义物品需带上命名空间，输入完整的物品id）
water_splashstring"minecraft:water_splash_particle_manual"可选，实体进入流体时会播放对应的粒子特效，在玩家所在位置附近随机播放若干该特效，特效需采用微软特效
mob_effectsarray(dict)[]可选，实体进入流体时添加状态效果，会触发对应的添加/刷新状态效果的事件
remove_effectsarray(string)[]可选，实体进入流体时移除状态效果，会触发对应的移除状态效果的事件
  • 如果没有注册该组件，液体颜色、范围及扩散延迟默认和原版水一样，但是将无法使船浮起来

添加状态效果mob_effects各字段配置如下：

键类型解释
effect_namestring状态效果名称
durationint状态效果持续时间
amplifierint状态效果倍率，比等级小1，例如力量II的倍率为1
show_particlebool是否显示状态效果的粒子效果，默认不显示

自定义流体方块相关特性 ​

  • 可以在游戏内通过指令/setblock放置方块，静态方块放置后不会向周围扩散，当其周围方块发生变化时会转变成流动方块，继承流动特性
  • 继承自原版水，因此会有原版水的特性，例如和岩浆有互动、玩家进入会有流动效果、溺水、与海绵互动等。
  • 用水桶装载后会生成普通水桶，通过配置bucket_name可实现生成别的物品，可结合自定义桶实现自定义流体的装载与倒出

示例 ​

动态流体：

json
{
    "format_version": "1.16.0",
    "minecraft:block": {
        "description": {
            "identifier": "customblocks:flowing_green_water",
            "base_block": "flowing_liquid"
        },
        "components": {
            "netease:liquid": {
                "liquid_color": [ 0, 128, 0, 254 ],
                "spread_range": 4,
                "spread_delay": 5,
                "bucket_name": "customBucket:green_bucket",
                "spread_fire": true,
                "mob_effects": [
                    {
                        "effect_name": "slowness",
                        "duration": 3,
                        "amplifier": 1,
                        "show_particle": true
                    },
                    {
                        "effect_name": "weakness",
                        "duration": 1,
                        "amplifier": 4
                    }
                ],
                "remove_effects": [ "speed", "jump_boost" ]
            }
        }
    }
}

静态流体：

json
{
    "format_version": "1.16.0",
    "minecraft:block": {
        "description": {
            "identifier": "customblocks:green_water",
            "base_block": "liquid"
        },
        "components": {
            "netease:liquid": {
                "liquid_color": [ 0, 128, 0, 254 ],
                "bucket_name": "customBucket:green_bucket",
                "spread_fire": true,
                "mob_effects": [
                    {
                        "effect_name": "slowness",
                        "duration": 3,
                        "amplifier": 1,
                        "show_particle": true
                    },
                    {
                        "effect_name": "weakness",
                        "duration": 1,
                        "amplifier": 4
                    }
                ],
                "remove_effects": [ "speed", "jump_boost" ]
            }
        }
    }
}