TEcho 插件

TEcho 插件

Technicmans Origins 附加组件——一个简单的 apoli 附加组件,为起源数据包制作者提供新的能力类型,用于修改和替换声音事件。新增能力:替换声音发射

工具

本模组的主要目标是为 apugli 的 custom_footstep 能力实现一个更好的替代品,但我计划在想到一些很酷的点子时,用新的能力、操作和条件来扩展它。

我计划之后将其中一部分并入 Origins 1.20.1 的 Apoli :>

特性

  1. 能力类型
  • 替换声音发出(techo:replace_sound_emission)
  • 替换声音接收(techo:replace_sound_reception)
  1. 实体操作类型
  • 播放声音(techo:play_sound)—— 为原版 apoli:play_sound 实体操作类型添加了新字段。
  1. 一种将 Resource 能力值作为 uniform 传递给后处理着色器的方式(通过 资源值提供器 数据类型)

能力类型

替换声音发出

将能力持有者发出的声音替换为不同的声音。

类型 ID:techo:replace_sound_emission

字段

字段 类型 默认值 描述
sounds 对象 一个包含 "key": "value" 键值对的对象,用于确定哪个声音("key")将被替换为新声音("value")。"value" 可以是 字符串、加权声音 或 加权声音 的 数组 支持正则匹配(并可在替换中引用捕获组)以及资源包声音
replace 布尔值 true 正确匹配的声音是替换旧声音,还是与旧声音一起播放。如果为 false,则新旧声音都会播放
entity_action 实体操作 可选 如果指定,则在成功替换(或匹配)声音后对玩家执行此操作
priority 整数 0 确定能力的应用优先级。如果多个能力匹配该声音,只有 priority 最高且 replace 为 true 的能力会替换声音,而 priority 更高但 replace 为 false 的能力会一并播放其声音

示例

{
    "type": "techo:replace_sound_emission",
    "sounds": {
        "minecraft:entity.player.burp": "empty",
        "entity.generic.eat": "minecraft:empty"
    }
}

此示例会将 entity.player.burp 和 entity.generic.eat 声音事件替换为 empty,从而使能力持有者发出的所有进食声音静音(minecraft 命名空间可以省略)。

{
    "type": "techo:replace_sound_emission",
    "sounds": {
        "block.([a-z|0-9|-|_]*).step": "block.$1.break"
    },
    "condition": {
        "type": "apoli:on_block",
        "inverted": true,
        "block_condition": {
            "type": "apoli:and",
            "conditions": [
                {
                    "type": "apoli:in_tag",
                    "tag": "minecraft:wool"
                }
            ]
        }
    }
}

此示例会将能力持有者发出的任何踩踏声音替换为所踩方块使用的破坏声音(除非该方块是羊毛)。

{
    "type": "techo:replace_sound_emission",
    "sounds": {
        "(.*)": {
            "id": "$1",
            "pitch": 0.5
        }
    }
}

此示例会将能力持有者发出的所有声音的音调设为 0.5,使它们听起来缓慢而低沉。

{
    "type": "techo:replace_sound_emission",
    "sounds": {
        "entity.player.(hurt|death)": [
            {
                "id": "minecraft:entity.axolotl.$1",
                "volume": 2,
                "pitch": 0.5,
                "weight": 1
            },
            {
                "id": "minecraft:entity.wither.$1",
                "volume": 2,
                "pitch": 0.5,
                "weight": 1
            }
        ]
    },
    "entity_action": {
        "type": "apoli:execute_command",
        "command": "say bleh XP"
    },
    "priority": 1
}

此示例会将能力持有者的死亡和受伤声音替换为来自美西螈或凋灵的对声音(各有 50% 概率)。结果声音会减慢 50%("pitch": 0.5),并可在 32 格距离内听到("volume": 2,即 2 * 16 = 32 格)

历史

版本 变更
1.0.0 添加了该能力
1.1.0 添加了新字段:replace、entity_action、priority。sounds 中的值现在接受 加权声音

替换声音接收

将能力持有者接收的声音替换为不同的声音。

类型 ID:techo:replace_sound_reception

字段

字段 类型 默认值 描述
sounds 对象 一个包含 "key": "value" 键值对的对象,用于确定哪个声音("key")将被替换为新声音("value")。"value" 可以是 字符串、加权声音 或 加权声音 的 数组 支持正则匹配(并可在替换中引用捕获组)以及资源包声音
replace 布尔值 true 正确匹配的声音是替换旧声音,还是与旧声音一起播放。如果为 false,则新旧声音都会播放
entity_action 实体操作 可选 如果指定,则在成功替换(或匹配)声音后对玩家执行此操作
priority 整数 0 确定能力的应用优先级。如果多个能力匹配该声音,只有 priority 最高且 replace 为 true 的能力会替换声音,而 priority 更高但 replace 为 false 的能力会一并播放其声音

示例

{
    "type": "techo:replace_sound_reception",
    "sounds": {
        "(?!.*:ui\\.).*": "empty"
    }
}

此示例会将能力持有者听到的一切声音静音,但 UI 声音除外(例如,它不会静音 minecraft:ui.button.click)

历史

版本 变更
1.2.0 添加了该能力

实体操作类型

播放声音

在实体位置播放声音,或使声音从实体处传来。

类型 ID:techo:play_sound

!!! 注意

volume 字段的值用于乘以声音事件的基础距离,即 16 格(1.0)。

字段

字段 类型 默认值 描述
sound 标识符 要播放的声音的 ID。
category 字符串 可选 如果指定,则指定该声音所属的类别和选项。否则,使用调用此操作的实体所指定的类别。接受 "master"、"music"、"record"、"weather"、"block"、"hostile"、"neutral"、"players"、"ambient" 或 "voice"。
volume 浮点数 1.0 声音的音量。
pitch 浮点数 1.0 声音的音调。
follow_entity 布尔值 false 声音是否应在实体移动时从实体位置被听到。
global 布尔值 follow_entity 的值 维度内的所有玩家是否都应注册此声音为正在播放,即使在其范围之外。如果为 false,玩家即使进入范围也听不到。
注意:这不会让所有玩家听到的声音都一样响亮。
internal 布尔值 false 是否只有播放此声音的实体能听到。

示例

"entity_action": {
    "type": "techo:play_sound",
    "sound": "music_disc.pigstep",
    "follow_entity": true
}

此示例会播放猪步音乐唱片,所在维度内的所有玩家只要离播放此声音的实体足够近就能听到。

"entity_action": {
    "type": "techo:play_sound",
    "sound": "block.end_portal.spawn",
    "volume": 1e9001
}

此示例会在整个维度播放创建末地传送门的声音,所有玩家听到的声音都一样响亮(1e9001 会产生特殊浮点值:Infinity)。

"entity_action": {
    "type": "techo:play_sound",
    "sound": "ambient.cave",
    "internal": true
}

此示例仅为该实体播放洞穴环境音。

历史

版本 变更
1.0.0 添加了该操作
1.2.0 添加了新字段:internal

数据类型

加权声音

一个表示可具有音量和音调的声音的 对象。如果位于 数组 中,它还可以具有权重,用于确定被选中的可能性。

用于 替换声音发出 以提供声音替换。

字段

字段 类型 默认值 描述
id 标识符 要播放的声音的 ID。可以包含匹配的正则组的反向引用($1、$2 等)
volume 浮点数 1.0 声音的音量。
pitch 浮点数 1.0 声音的音调。
weight 正整数 1 声音的权重。声音被选中的概率由权重除以所有权重之和确定(weight / sumOfAllWeights = chance)。

示例

[
    {
        "id": "entity.villager.yes",
        "weight": 1
    },
    {
        "id": "entity.villager.no",
        "weight": 1
    }
]

此示例会返回 entity.villager.yes 或 entity.villager.no,两者的概率相同。

历史

版本 变更
1.1.0 添加了该数据类型

资源值提供器

提供来自 Resource 能力的缩放值(以便将整数资源值转换为小数字浮点值)。

可以代替后着色器中 uniform 向量/矩阵的任何浮点值传入

字段

字段 类型 默认值 描述
resource 标识符 将从中设置 uniform 值的资源能力的 ID。
scale 浮点数 0.01 可以代替 min 和 max 对定义。资源提供的值将乘以该值。
min 浮点数 资源的 min 边界应映射到的值。如果与 max 一起定义,将代替 scale 使用。
max 浮点数 资源的 max 边界应映射到的值。如果与 min 一起定义,将代替 scale 使用。

示例

assets/example/shaders/post/chromatic_aberration.json

{
  "targets": [
    "swap"
  ],
  "passes": [
    {
      "name": "deconverge",
      "intarget": "minecraft:main",
      "outtarget": "swap",
      "uniforms": [
        {
          "name": "ConvergeX",
          "values": [ 0.0,  0.0,  0.0 ]
        },
        {
          "name": "ConvergeY",
          "values": [  0.0, 0.0,  0.0 ]
        },
        {
          "name": "RadialConvergeX",
          "values": [  {"resource": "example:intensity", "min": 0.9, "max": 1.0},  {"resource": "example:intensity", "min": 1.02, "max": 1.0},  {"resource": "example:intensity", "min": 1.02, "max": 1.0} ]
        },
        {
          "name": "RadialConvergeY",
          "values": [  {"resource": "example:intensity", "min": 0.9, "max": 1.0},  {"resource": "example:intensity", "min": 1.02, "max": 1.0},  {"resource": "example:intensity", "min": 1.02, "max": 1.0} ]
        }
      ]
    },
    {
      "name": "blit",
      "intarget": "swap",
      "outtarget": "minecraft:main"
    }
  ]
}

此示例将让 example:intensity 资源能力控制色差着色器的强度

历史

版本 变更
1.2.0 添加了该数据类型

致谢

  • Chris The Big! —— 最初激励我做这个模组(他在他的一个数据包中需要这个功能)
  • Robin —— 提供了能力语法的想法
  • Overgrown —— 提供了加权声音列表的想法(待定)
  • Apoli 模组中的 apoli:replace_loot_table 能力 —— 让我借用其代码