Guide for using Held features - DeeCaaD/CrackShotPlus_V2 GitHub Wiki

    Held:
        Custom_Held_Sound: <String>-<Double>-<Double>,<etc.>
        Weapon_Weight: <Double>
        Hide_Attributes: <Boolean>
        Durability: <Integer>
        Custom_Model_Data: <Integer>
        Update_Lore:
            Use_One_Line_For_Attachments: <Boolean>
            Maxium_Attachments_Per_Line: <Integer>
            New_Line_Format: <String>
            Lore:
            - <String>
            - <etc.>
        Copy_Weapon_To_Off_Hand: <Boolean>
        Soulbound:
            Enable: <Boolean>
            Allow_Owner_Change: <Boolean>
        Held_Particle:
            Particle: <String>
            Shape: <String>
        Firemode:
            Next_Weapon: <String>
            Change_Delay: <Integer>
            Deny_Changing_While_Reloading: <Boolean>
            Deny_Changing_While_Zooming: <Boolean>
            Deny_Changing_While_Weapon_Not_Empty: <Boolean>
            Changed:
                Sound: <String>-<Double>-<Double>,<etc.>
                Message: <String>
            Unable_To_Change:
                Sound: <String>-<Double>-<Double>,<etc.>
                Because_Of_Reload: <String>
                Because_Of_Delay: <String>
                Because_Of_Zoom: <String>
                Because_of_Weapon_Not_Empty: <String>

Custom_Held_Sound

Plays custom sound at player's location.
Note: <Sound>,<Volume>,<Pitch>

Weapon_Weight

Changes weapon's weight.
Note: Value between 0.03 and -0.03 is recommended.

Hide_Attributes

Determines if weapon's attributes such as unbreakable tag should be hidden.

Durability

Changes weapon durability and adds unbreakable tag.
Note: Don't use skins when using this nor the other way around.

Custom_Model_Data

Changes weapon custom model data.
Note: Don't use skins when using this nor the other way around.
Note: This feature was added in Minecraft 1.14.

Update_Lore

Example from AK-47:

        Update_Lore:
            Use_One_Line_For_Attachments: false
            Maxium_Attachments_Per_Line: 2
            New_Line_Format: "&7✴   &c➣ &7#ATTACHMENTS#"
            Lore:
            - "&7✴ ✴ ✴ ✴ ✴ ✴ ✴ ✴ ✴ ✴ ✴ ✴ ✴ ✴ ✴ ✴ ✴  "
            - "&7✴ &c➣ &7Attachments #ATTACHMENTS#"
            - "&7✴ &c➣ &7Skin &c⟹ &7#SKIN#"
            #- "&7✴ &c➣ &7StatTrak &c⟹ &7#STATTRAK#"
            - "&7✴ &c➣ &7#DAMAGE# &c&l⟸&r &7Damage"
            - "&7✴ &c➣ &7#WEIGHT# &c&l⟸&r &7Weight"
            #- "&7✴ &c➣ &7#SPREAD# &c&l⟸&r &7Spread"
            - "&7✴ &c➣ &7#PROJECTILE_SPEED# &c&l⟸&r &7Projectile Speed"
            - "&7✴ &c➣ &7#RELOAD_DURATION# &c&l⟸&r &7Reload Duration"
            - "&7✴ &c➣ &7#RELOAD_AMOUNT# &c&l⟸&r &7Reload Amount"
            #- "&7✴ &c➣ &7#EXPLOSION_RADIUS# &c&l⟸&r &7Explosion Radius"
            - "&7✴ ✴ ✴ ✴ ✴ ✴ ✴ ✴ ✴ ✴ ✴ ✴ ✴ ✴ ✴ ✴ ✴  "

Determines new lore for weapon.
This node is called when changing held slot to weapon and adding/changing Skin, Attachment, Trail, Visual Reload or when adding StatTrak point.
Note: You might want to use variables with this node.
Note: Supports PlaceholderAPI.

Copy_Weapon_To_Off_Hand

If true weapon is copied to offhand. I recommend to use Require Both Hands.
Note: Doesn't copy weapon to offhand if offhand has item.
Note: Used with dual wield weapons. Take example from default weapon Desert Eagle.

Soulbound

If Enable is true then if played dies having this weapon in invetory, weapon will not drop and will be given back to player when respawning.
Note: Soulbound is updated when changing held item slot to weapon
Note: If Allow_Owner_Change is true then weapon's owner can change if another player rehovers over item

Held_Particle

Particle is the particle there should be used. Shape has to be multi_circle or weird_circles or multi_position_circles.

Requested and paid by RiZzerFX and Dams678. Their server ip: play.metrolia.fr

Firemode

This is intended to be used for changing weapon firemodes using F (hand item swap key) key. Try to use as similar weapons as possible when you look at weapon's item name. Try not to change firearm action or reload amount in firemode rotation because this may cause issues.

Next_Weapon determines the next weapon name in firemode rotation. It has to be some other CrackShot weapon.
Change_Delay is the delay in millis that player has to wait till changing is available again. 1000 = 1 second
Deny_Changing_While_Reloading is simply used to deny changing while reloading.
Deny_Changing_While_Zooming denies changing firemode while zooming if true.
Deny_Changing_While_Weapon_Not_Empty denies changing firemodes while weapon has has ammo left. This is used to allow making different kind of ammo types (e.g. explosive rounds, normal rounds, incendiary rounds).

Rest of the options are simple messages in action bar or bukkit sound plays.

Example how this could be used:

Single_Weapon:
    Held:
        Firemode:
            Next_Weapon: "Burst_Weapon"
            Change_Delay: 2000
            Deny_Changing_While_Reloading: true
            Deny_Changing_While_Zooming: true
            Deny_Changing_While_Weapon_Not_Empty: false
            Changed:
                Sound: "BLOCK_ANVIL_USE-1-1"
                Message: "&7Burst mode activated"
            Unable_To_Change:
                Sound: "ENTITY_VILLAGER_NO-1-1"
                Because_Of_Reload: "&7You can't switch firemode while reloading."
                Because_Of_Delay: "&7Wait few moments till trying that again..."
                Because_Of_Zoom: "&7You can't switch firemode while zooming."

Burst_Weapon:
    Held:
        Firemode:
            Next_Weapon: "Single_Weapon"
            Change_Delay: 2000
            Deny_Changing_While_Reloading: true
            Deny_Changing_While_Zooming: true
            Deny_Changing_While_Weapon_Not_Empty: false
            Changed:
                Sound: "BLOCK_ANVIL_USE-1-1"
                Message: "&7Single mode activated"
            Unable_To_Change:
                Sound: "ENTITY_VILLAGER_NO-1-1"
                Because_Of_Reload: "&7You can't switch firemode while reloading."
                Because_Of_Delay: "&7Wait few moments till trying that again..."
                Because_Of_Zoom: "&7You can't switch firemode while zooming."

Requested and paid by Darkman_Bree. Server ip: purpurmc.enviromc.net

⚠️ **GitHub.com Fallback** ⚠️