Primary goal of this mod was to implement a better substitute for apugli's custom_footstep power, but I plan to expand with new powers, actions and conditions when I come up with some cool ideas.

I plan to make some of it a part of Apoli for Origins 1.20.1 later on :>

Features

1. Power Types

• Replace Sound Emission (techo:replace_sound_emission)
• Replace Sound Reception (techo:replace_sound_reception)

1. Entity Action Types

• Play Sound (techo:play_sound) - adds new fields to original apoli:play_sound entity action type.

1. A way to pass Resource power values as uniforms to post-processing shaders (via Resource Value Provider data type)

Power Types

Replace Sound Emission

Replaces a sound emissed by power holder with a different sound.

Type ID: techo:replace_sound_emission

Fields

Examples

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

This example will replace entity.player.burp and entity.generic.eat sound events with empty, which will mute every eating sound coming from the power holder (minecraft namespace can be omitted).

{
    "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"
                }
            ]
        }
    }
}

This example will replace any stepping sound coming from the power holder with a breaking sound used by the same block that was stepped upon (unless that block is a wool).

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

This example will make all the sounds emitted by power holder have pitch set to 0.5 making them sound slow and low.

{
    "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
}

This example will replace power holder's death and hurt sounds with the corresponding sound from axolotl or wither (50% chance for either). The result sounds will be slowed 50% ("pitch": 0.5) and will be heard in distance of 32 blocks ("volume": 2, so 2 * 16 = 32 blocks)

History

Replace Sound Reception

Replaces a sound recepted by power holder with a different sound.

Type ID: techo:replace_sound_reception

Fields

Examples

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

This example will mute everything the power holder hears, except for UI sounds (ex. it won't mute minecraft:ui.button.click)

History

Entity Actions Types

Play Sound

Plays a sound either at the entity's position or coming from the entity.

Type ID: techo:play_sound

!!! Note

The value of the volume field is used to multiply the base distance of the sound event, which is 16 blocks (1.0).

Fields

Examples

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

This example will play the pigstep music disc that will be heard by all players in the dimension it was played if they are close enough to the entity that played this sound.

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

This example will play the sound of creating end portal all around the dimension with all the players hearing it just as loud (1e9001 yields special float value: Infinity).

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

This example plays cave ambient only for this entity.

History

Data Types

Weighted Sound

An Object representing a sound that can have volume and pitch. If in an Array it can also have weight that determines how likely it is to be chosen.

Used in Replace Sound Emission to provide a sound replacement.

Fields

Examples

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

This example will return either entity.villager.yes or entity.villager.no with the same probability for both.

History

Resource Value Provider

Provides a scaled value from a Resource power (in order to convert an integer resource value to a fraction float).

Can be passed instead of any float value of a uniform vector/matrix in a post shader

Fields

Examples

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"
    }
  ]
}

This example will let the example:intensity resource power control the intensity of a Chromatic Aberration shader

History

Credits

• Chris The Big! - for inspiring me to do this mod in the first place (he needed this functionality in one of his datapacks)
• Robin - for giving the idea for power's syntax
• Overgrown - for giving the idea for weighted sound list (TBA)
• apoli:replace_loot_table power from Apoli mod - for letting me borrow its code