Skip to content

Status Transfer

Provismet edited this page Jun 20, 2023 · 5 revisions

Bientity Action Type

Transfers status effects from the actor entity to the target entity. Optionally removing those status effects from the actor or modifying their efficacy on the target.

Type ID: proviorigins:transfer_status

Note
The effect as it currently exists on the actor is used for this action; for example if the actor is poisoned for 15 seconds, waits 5 seconds, then uses this action on the target: the action will only consider 10 seconds worth of poison to apply to the target.

Fields

Field Type Default Description
status_types Array of Strings Optional Accepted types are "beneficial", "neutral", and "harmful". Types described in the array are applied by this action.
effects Array of Identifiers Optional Each entry must be an identifier for a status effect. The effects listed will be applied by this action.
cleanse_self Boolean Whether or not effects inflicted by this action should also be removed from the user.
amplifier_multiplier Float 1.0 The amplifier of the effect given to the target is multiplied by this value.
duration_multiplier Float 1.0 The duration of the effect given to the target is multiplied by this value.

Examples

{
    "type": "origins:action_on_hit",
    "bientity_action": {
        "type": "proviorigins:transfer_status",
        "status_types": ["harmful"],
        "cleanse_self": true,
        "amplifier_multiplier": 2,
        "duration_multiplier": 1.2
    },
    "damage_condition": {
        "type": "origins:name",
        "name": "player"
    }
}

This example will grant the player the ability to send all of their harmful effects (such as poison and wither) to a target that they hit. The effects given to the target are doubled in amplification and multiplied by 1.2 in remaining duration.
If this player had 20 seconds of Poison II and hit another entity, then the player would lose the poison and the target would gain Poison IV for 24 seconds.

"bientity_action": {
    "type": "proviorigins:transfer_status",
    "status_types": ["beneficial"],
    "effects": ["minecraft:poison", "minecraft:wither"]
    "cleanse_self": false
}

This example will share all beneficial status effects the user has with other nearby entities. Poison and wither effects will also be shared if they are present.

Clone this wiki locally