➤ Custom Projectiles - ssomar1607/ExecutableItems GitHub Wiki

CUSTOM PROJECTILES

This page will help you learn more about creating Executable Items' custom projectiles.

We created for you an in-game editor to make the edition simple. (In the version 3.5.5.0 and above)

IMPORTANT COMMANDS

To open the editor : /score projectiles
To create a new custom projectile : /score projectiles-create {projID}
To delete a custom projectile : /score projectiles-delete {projID} and then /score projectiles-delete {projID} confirm


IMPORTANT INFOS

But unfortunately 3 features are not editable in-game yet. (enchantments for Tridents, particles for all, and potionEffects for potions)

YOU DON'T GIVE YOURSELF THE PROJECTILE IN THE SCORE PROJECTILES EDITOR. TO USE THE CUSTOM PROJECTILES, USE THE LAUNCH AND LOCATED_LAUNCH COMMAND


enchantments: (WILL ONLY WORK AT 1.16.4 AND UP) (ONLY FOR THE TRIDENT PROJECTILE)

  • Add enchants to tridents
  • Example:
enchantments:
 enchantment1:
   enchantment: unbreaking
   level: 1
 enchantment3:
   enchantment: mending
   level: 1
 enchantment2:
   enchantment: bunny_hop
   level: 5

particles:

  • To what kind of particle the projectile will emit
  • More Information: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Particle.html

    - particlesType:

      - The type of the particles
    

    - particlesAmount:

      - To how many particles will it emit each time
    

    - particlesOffSet:

      - To how close to the projectile will the particles spawn
    

    - particlesSpeed:

      - To how fast the particles will move (for the particles who don't move like fireball explosion particles, to how big the particles will be)
    

    - redstoneColor: ONLY FOR THE particleType: REDSTONE

      - To change the color of the redstone particle
      - List of Colors: https://helpch.at/docs/1.12.2/org/bukkit/Color.html
    
  • Example:
particles:
  1:
    particlesType: FLAME
    particlesAmount: 10
    particlesOffSet: 1
    particlesSpeed: 2
  2:
    particlesType: REDSTONE
    particlesAmount: 10
    particlesOffSet: 0.2
    particlesSpeed: 0.5
    redstoneColor: GRAY
  
  // .... continue if you want more particles

'potionEffects'

potionEffects:
 1:
  potionEffectType: SPEED
  duration: 20
  amplifier: 2
 2:
  potionEffectType: INCREASE_DAMAGE
  duration: 10
  amplifier: 4

The others features that are editable in-game

customNameVisible:

  • Whether the projectile will have a name or not
  • Options
    • true or false

customName:

  • Add name to the projectile
  • Example
    • customName: Ember Arrow

pickupStatus:

glowing:

  • Whether the projectile will have the glowing effect or not
  • Options
    • true or false

bounce:

  • Whether the projectile will bounce from the entity during it's invulnerable state.
  • Options
    • true or false

gravity:

  • Whether the projectile will fly in a straight line (not affected by gravity) or not
  • Options
    • true or false

charged: (ONLY FOR THE WITHERSKULL PROJECTILE)

  • Whether the WITHERSKULL be in its charged state or not
  • Options
    • true or false

critical: (ONLY FOR THE ARROW PROJECTILE)

  • Whether the ARROW projectile will leave a trail of critical particles (the trail of particles the arrow emits when you shoot with a fully-charged bow)
  • Options
    • true or false

incendiary: (ONLY FOR THE FIREBALL PROJECTILE)

  • Whether the fireball projectile will cause fire or not upon hitting something
  • Options
    • true or false

damage: (ONLY FOR THE ARROW PROJECTILE)

  • To what damage you want the arrow to have
  • Damage Equation for Arrows: (damage x 3 = Arrow Damage)
  • Default value: -1 (Damage is 8)
  • DO NOT USE NEGATIVE VALUE. FOR EXAMPLE: damage: -3 because nothing will change.

velocity:

  • To how fast you want the projectile to be
  • NOTES: THE DAMAGE OF THE ARROW IS AFFECTED BY THIS OPTION
  • Damage Equation for Arrows: (velocity x 1 = Arrow Damage)

despawnDelay:

  • To how long will the projectile's life span will be (in seconds)

knockbackStrength:

  • To how strong the knockback will the projectile inflict to its targets
  • Equation: (knockbackStrength x 3 = The amount of blocks the target gets knocked back)
  • If value is set to -1, it will only inflict the default knockback strength value

pierceLevel: (ONLY FOR THE ARROW PROJECTILE)

  • To how many mobs will get hit in a single projectile before it dissapears
  • Equation: (pierceLeveL + 1 = The amount of mobs that will get hit in a single projectile)
  • If value is set to -1, it will only hit one mob and it will not pierce through

radius (ONLY FOR THE FIREBALL AND LINGERING PROJECTILE)

  • To how large the radius of the effects of the projectile
  • If value is set to -1, its radius will be it's default range.

activeColor: (ONLY FOR THE ARROW PROJECTILE)

  • Whether the arrow will emit the potion particles like how a tipped arrow would emit particles
  • Options
    • true or false

color: (REQUIRED FOR THE activeColor: OPTION TO BE SET TO true)

silent: (ONLY FOR THE ARROW PROJECTILE)

  • Whether the arrow will emit noise
  • Options
    • true or false

visualItem: (ONLY FOR SPECIFIC PROJECTILES) (ONLY 1.14 and +)

  • To what the projectile will it disguise to what item
  • Specific Projectiles
    • EGG
    • ENDER_PEARL
    • SNOWBALL

customModelData: (REQUIRED FOR THE visualItem: OPTION TO BE SET TO true)

  • To what the visual item's custom model data to be

removeWhenHitBlock:

  • Whether the projectile dissappears when it hits a block
  • Options
    • true or false

DEFAULT PROJECTILE FILES

ARROW

type: ARROW
customNameVisible: true
customName: "CustomArrow2"
pickupStatus: DISALLOWED #https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/entity/AbstractArrow.PickupStatus.html
glowing: false
critical: false
bounce: true
gravity: true
damage: -1
knockbackStrength: -1
pierceLevel: -1
despawnDelay: 3
velocity: 1 #you can multiply the velocity (speed) ex velocity: 2.5
silent: false
activeColor: true
color: RED #https://helpch.at/docs/1.12.2/org/bukkit/Color.html
#particlesType: FLAME #https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Particle.html
particlesAmount: 10
particlesOffSet: 0.5
particlesSpeed: 0.3
particlesDelay: 1 #in tick

EGG

type: EGG
bounce: false
despawnDelay: -1
customNameVisible: false
glowing: false
customName: ""
silent: false
gravity: true
velocity: 1 #you can multiply the velocity (speed) ex velocity: 2.5
#visualItem: DIAMOND_SWORD
#customModelData: 5
#particlesType: FLAME #https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Particle.html
particlesAmount: 10
particlesOffSet: 0.5
particlesSpeed: 0.3
particlesDelay: 1 #in tick

ENDERPEARL

type: ENDER_PEARL
bounce: false
despawnDelay: -1
customNameVisible: false
glowing: false
customName: ""
silent: false
gravity: true
velocity: 1 #you can multiply the velocity (speed) ex velocity: 2.5
#visualItem: DIAMOND_SWORD
#customModelData: 5
#particlesType: FLAME #https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Particle.html
particlesAmount: 10
particlesOffSet: 0.5
particlesSpeed: 0.3
particlesDelay: 1 #in tick

FIREBALL

type: FIREBALL
customNameVisible: true
customName: "Fireball2"
glowing: false
bounce: true
despawnDelay: 20
silent: false
radius: -1
incendiary: true
gravity: true
velocity: 1 #you can multiply the velocity (speed) ex velocity: 2.5
#particlesType: FLAME #https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Particle.html
particlesAmount: 10
particlesOffSet: 0.5
particlesSpeed: 0.3
particlesDelay: 1 #in tick

LINGERING

type: SPLASH_POTION
lingering: true
customNameVisible: false
customName: "Lingering"
glowing: true
bounce: true
despawnDelay: 20
silent: false
radius: -1
velocity: 1 #you can multiply the velocity (speed) ex velocity: 2.5
incendiary: false
# only work with 1.16.4 or +
potionEffects:
 1:
  potionEffectType: SPEED
  duration: 20
  amplifier: 2
 2:
  potionEffectType: INCREASE_DAMAGE
  duration: 10
  amplifier: 4
#particlesType: FLAME #https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Particle.html
particlesAmount: 10
particlesOffSet: 0.5
particlesSpeed: 0.3
particlesDelay: 1 #in tick

SHULKER_BULLET

type: SHULKER_BULLET
bounce: false
despawnDelay: -1
customNameVisible: false
glowing: false
customName: ""
silent: false
gravity: true
velocity: 1 #you can multiply the velocity (speed) ex velocity: 2.5
#particlesType: FLAME #https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Particle.html
particlesAmount: 10
particlesOffSet: 0.5
particlesSpeed: 0.3
particlesDelay: 1 #in tick

SNOWBALL

type: SNOWBALL
bounce: false
despawnDelay: -1
customNameVisible: false
glowing: false
customName: ""
silent: false
gravity: true
velocity: 1 #you can multiply the velocity (speed) ex velocity: 2.5
#visualItem: DIAMOND_SWORD
#customModelData: 5
#particlesType: FLAME #https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Particle.html
particlesAmount: 10
particlesOffSet: 0.5
particlesSpeed: 0.3
particlesDelay: 1 #in tick

TRIDENT

type: TRIDENT
customNameVisible: true
customName: "Trident2"
pickupStatus: DISALLOWED  #https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/entity/AbstractArrow.PickupStatus.html
glowing: false
critical: false
bounce: true
gravity: true
damage: -1
velocity: 1 #you can multiply the velocity (speed) ex velocity: 2.5
knockbackStrength: -1
pierceLevel: -1
despawnDelay: 3
# only work with 1.16.4 or +
enchantments:
 enchantment1:
   enchantment: unbreaking
   level: 1
 enchantment3:
   enchantment: mending
   level: 1
 enchantment2:
   enchantment: bunny_hop
   level: 5
#visualItem: DIAMOND_SWORD
#customModelData: 5
#particlesType: FLAME #https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Particle.html
particlesAmount: 10
particlesOffSet: 0.5
particlesSpeed: 0.3
particlesDelay: 1 #in tick

WITHER_SKULL

type: WITHER_SKULL
customNameVisible: true
customName: "CustomWitherSkull1"
glowing: false
incendiary: false
bounce: true
gravity: true
charged: true
despawnDelay: 3 #in seconds
velocity: 1 #you can multiply the velocity (speed) ex velocity: 2.5
silent: false
#particlesType: FLAME #https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Particle.html
particlesAmount: 10
particlesOffSet: 0.5
particlesSpeed: 0.3
particlesDelay: 1 #in tick