➤ 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'

PotionEffectType: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/potion/PotionEffectType.html
Example:

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:`

Whether players can pickup the projectiles or not
Options
- ALLOWED
- DISALLOWED
- CREATIVE_ONLY
  - More information: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/entity/AbstractArrow.PickupStatus.html

`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`)

To what color will the arrows emit?
More information: https://helpch.at/docs/1.12.2/org/bukkit/Color.html

`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

➤ Custom Projectiles - ssomar1607/ExecutableItems GitHub Wiki

CUSTOM PROJECTILES

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

IMPORTANT COMMANDS

IMPORTANT INFOS

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

particles:

- particlesType:

- particlesAmount:

- particlesOffSet:

- particlesSpeed:

- redstoneColor: ONLY FOR THE particleType: REDSTONE

'potionEffects'

customNameVisible:

customName:

pickupStatus:

glowing:

bounce:

gravity:

charged: (ONLY FOR THE WITHERSKULL PROJECTILE)

critical: (ONLY FOR THE ARROW PROJECTILE)

incendiary: (ONLY FOR THE FIREBALL PROJECTILE)

damage: (ONLY FOR THE ARROW PROJECTILE)

velocity:

despawnDelay:

knockbackStrength:

pierceLevel: (ONLY FOR THE ARROW PROJECTILE)

radius (ONLY FOR THE FIREBALL AND LINGERING PROJECTILE)

activeColor: (ONLY FOR THE ARROW PROJECTILE)

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

silent: (ONLY FOR THE ARROW PROJECTILE)

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

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

removeWhenHitBlock: