Advanced

Something harder than basics I guess.

Feels boring with normal guns? Ok I will show you how to make unique guns and make the game funnier!

1. Gun's Effects

1.1. How to add a new effects?

Effects can be added through 'special' section of any gun

For example:

  special: 
    can-pierce: <false/true>
    effect: <replaceme>
    hit-sound: <replaceme>
    droppable: <false/true>
    can-knockback: <false/true>
    effects:
    - '<replaceme>'
    ...

1.2. How to build an effect?

Format

<event>:<type>:<target>:<somethingrequired>

1. Event

Introduce

First, I will introduce about effect's event This help you determine in which situation this effect will be called! Currently available event: ON_HIT, ON_SHOOT, ON_HOLDING

ON_HIT

Called while the bullet hit an entity (must be vulnerable)!

Available target:

• SELF

• ENEMY

• TEAMMATES_IN_RADIUS

• ENEMIES_IN_RADIUS

ON_SHOOT

Called while player shoot a bullet!

Available target:

• SELF

• TEAMMATES_IN_RADIUS

• ENEMIES_IN_RADIUS

ON_HOLDING

Called every 2 ticks while the player is holding this gun! (This mean you should not add too much "ON_HOLDING" effects)

Available target:

• SELF

• TEAMMATES_IN_RADIUS

• ENEMIES_IN_RADIUS

2. Type

STATUS_EFFECT

This give the target some status, maybe negative, maybe positive!

Requirements (can be added after <target>):

• Status

• Duration (in seconds)

Currently available status:

• FIRE

Example: ON_HIT:STATUS_EFFECT:ENEMY:FIRE:5 Explaination: It will ignite the enemy 5 seconds on bullet hit.

POTION_EFFECT

This give the target some potion effects such as speed, haste!

Requirements (can be added after <target>):

• Potion effect type

• Duration (in ticks)

• Amplifier

• Ambient (boolean)

• Particles (boolean)

Currently available Potion effects type:

• 1.8.8

• 1.12.2

Example: ON_HIT:POTION_EFFECT:SELF:SPEED:20:1:false:false Explaination: You will gain SPEED II for 20 ticks (1 sec) with no ambient and no particles on bullet hit.

The seventh argument is ambient while the eighth is particles

INCREASE_DAMAGE

INCREASE_DAMAGE is a special type exclusive for ON_HIT event and it have different structure.

Structure: ON_HIT:INCREASE_DAMAGE:<mode>:<amplifier>

Available mode:

• DISTANCE

Example: ON_HIT:INCREASE_DAMAGE:DISTANCE:2 Explaination: On bullet hit, damage will be increase by 2% per block

3. Target

SELF

The effect will be applied only for player that execute this effect!

ENEMY

Can only be used in ON_HIT event! The effect will be applied for enemy!

AOE

The effect will be applied for group of target in a radius!

Available:

• TEAMMATES_IN_RADIUS

• ENEMIES_IN_RADIUS

But this is just the start, AOE target require some more efforts You have to determine:

• Radius

• Center (Available: SELF)

• Target's Exception

For "TEAMMATES_IN_RADIUS":

It will look like: TEAMMATES_IN_RADIUS_<radius>_<center>_<include self (true/false)>_<include despawnable (true/false)>

Example: TEAMMATES_IN_RADIUS_3_SELF_false_false Explaination: All teammates in radius 3 around executor will be affected by this effect. (not include despawnable and executor too.)

For "ENEMIES_IN_RADIUS":

It will look like: ENEMIES_IN_RADIUS_<radius>_<center>_<include despawnable (true/false)>

Example: ENEMIES_IN_RADIUS_3_SELF_false Explaination: All enemies in radius 3 around executor will be affected by this effect. (not include despawnable)

You cannot skip any effect's argument or that effect will not work!

1.3. Example

You think the guide above is quite complicated to understand? I will provide you some example:

You want a gun that will slowdown when holding:

ON_HOLDING:POTION_EFFECT:SELF:SLOW:2:1:false:false

You want a gun that the farther the bullet flies, the less damage it does:

Step 1: Set the gun damage to the maximum damage this gun can deal

damage: 20

Step 2: Add this effect

ON_HIT:INCREASE_DAMAGE:DISTANCE:-9

By doing so, if you shoot an enemy 5 blocks away, the damage will be reduced by 45%. And the damage now is 11. If the enemy is so far away and if the damage reduction value exceeds 100%, the damage will be set to 0.

2. Gun's particle (bullet's trail)

Advance particles include: REDSTONE, BLOCK_CRACK, BLOCK_DUST, ITEM_CRACK (all of them were added since BETA-1.0.4!)

These particles require a new option called: particles-option (You can add it below 'particles'!)

REDSTONE

Normally you only need 4 argument separated by a space to make it work! Format: 'false <R> <G> <B>' But if you set the first argument to 'true', it require 7: Format: 'true <R1> <G1> <B1> <R2> <G2> <B2>' (Use this if you need transitional particles!)

Example:

particles: REDSTONE
particles-option: 'false 16 1 1'

You can go to this site for RGB color

Others

Include BLOCK_CRACK, BLOCK_DUST, ITEM_CRACK

Format: <material> <data>

Example:

particles: BLOCK_CRACK
particles-option: 'DIRT 0'