Projectile Reflection (Data Type)

An Object that makes a projectile bounce off blocks instead of stopping on them, and off the entities it hits as well when entities is on. It goes in the reflective field of apoli:fire_projectile, as a power or as an entity action.

reflective also takes a Boolean: true bounces with the defaults below, and false doesn't bounce at all. Written that way, max_bounces and bounce_speed can sit next to it on the projectile itself and are read as the fields below.

Fields

Both numbers are worked out at every bounce, with the owner as the entity, so a shot can bounce further or harder while its owner holds a resource.

How it bounces

• The projectile's velocity is mirrored through the face it struck and scaled by speed. A bounce that would leave it almost still ends the shot instead.
• Without entities, hitting an entity isn't a bounce. A reflective projectile still hits the first entity it reaches, subject to bientity_condition, and stops there.
• With entities, the hit runs the shot's hit actions first, then the projectile glances off the side of the entity's hitbox it struck and flies on. It can't hit that entity again until it hits something else, bounces off a block or turns back, so it doesn't rattle around inside one target.
• On a projectile fired with entity_type, bouncing off an entity takes the place of the projectile's own impact, so an arrow that bounces off a zombie deals none of its arrow damage. Deal the damage in bientity_action_on_hit or owner_target_bientity_action_on_hit.
• Every bounce off a block runs block_action_on_hit (and checks block_condition) and then bientity_action_on_bounce. A bounce off an entity runs bientity_action_on_bounce after the hit actions.
• With pierce as well, the projectile bounces off entities while it has bounces left and passes through them after that.
• bientity_action_on_miss waits until the projectile stops for good, so it runs once, on the hit that ends the shot.
• A projectile with a return uses up its bounces first, and the block hit after the last one turns it around.

Examples

A ricochet shot that bounces up to three times and loses a little speed each time:

{
  "type": "apoli:fire_projectile",
  "texture_location": "example:textures/entity/ricochet.png",
  "speed": 1.6,
  "divergence": 0,
  "reflective": {
    "max_bounces": 3,
    "speed": 0.8
  },
  "bientity_action_on_hit": {
    "type": "apoli:damage",
    "amount": 4,
    "damage_type": "minecraft:arrow"
  }
}

A bouncing orb that ricochets forever and relies on max_distance to end the shot:

{
  "type": "apoli:fire_projectile",
  "texture_location": "example:textures/entity/bouncy_orb.png",
  "speed": 1.0,
  "reflective": {
    "max_bounces": -1
  },
  "max_distance": 48
}

A disc that ricochets from one enemy to the next, four times, before it falls:

{
  "type": "apoli:fire_projectile",
  "texture_location": "example:textures/entity/disc.png",
  "speed": 1.1,
  "divergence": 0,
  "max_distance": 30,
  "reflective": {
    "max_bounces": 4,
    "entities": true
  },
  "homing": {
    "range": 8,
    "angle": 80,
    "turn_rate": 12
  },
  "owner_target_bientity_action_on_hit": {
    "type": "apoli:damage",
    "amount": 4,
    "damage_type": "minecraft:thrown"
  }
}

After each bounce, the enemy it just hit is ruled out, so homing picks the next one in front of it.