Requirements
- Java 8 and above required. (Important) Same for your Hosting Website!
- Always latest build of Vault! Can be found here: > https://dev.bukkit.org/projects/vault/files
- Make sure to download a plugin to register to Vault! i.e Essentials, EssentialsX etc.
- The DsGuns Extras Pack Which is avalible here: http://www.mediafire.com/file/xasurrolajqus4v/DsGuns-Extras.zip
TexturePack Suggestions
- The Official Texture Pack is included in the DsGuns Extras Pack
Other Guides
Getting started
▒▒ Gun Folder and Configurations
First of all, before you create a gun, you have to make sure that guns folder exists inside DSGuns plugin folder. If guns folder does not exist, you create it.
To create a gun, the only thing you have to do is, create a yml file by the guns name inside guns folder. For example glock17.yml.
There will be gun examples that you can download and paste them before you start the server.
Download default gun examples:
This is now included with the .zip file
(This Will Eventually Be Included With The Plugin)
Available Gun Examples:
▒▒ Gun Folder and Configurations
First of all, before you create a gun, you have to make sure that guns folder exists inside DSGuns plugin folder. If guns folder does not exist, you create it.
To create a gun, the only thing you have to do is, create a yml file by the guns name inside guns folder. For example glock17.yml.
There will be gun examples that you can download and paste them before you start the server.
Download default gun examples:
This is now included with the .zip file
(This Will Eventually Be Included With The Plugin)
Available Gun Examples:
-
- python
- m9
- glock17
- g36
- m16a4
- ak47
- flaregun
- rpg
- barrett50cal
▒▒ Gun information
information:
item-name: <name>
item-type: <material>
item-durability: <amount>
item-lore: <line1>|<line2>|<line3>|<line4> ...>
item-name:
The item's display name - the name that the players will see when selecting this item.
Example: By using the color-code for red &c, you can color an item's name: "&c red display name", you can add as many colors you want.
item-type:
The Material of the item's type. For example, if you would like the item to be a Diamond Pickaxe, you would put item-type: DIAMOND_PICKAXE
item-durability:
The durability of the item's time(or data). For example, if your item is a Diamond Pickaxe and your custom textured gun is with another value of this type, you would put item-durability: <amount>.
item-lore:
The item's description. This is what players will see when hovering their mouse over the item. To indicate a new line, use a vertical bar |.
Example: item-lore: "&aThis is line one.|&bThis is line two.|&cThis is line three."
Also has a box character/symbol -> ▉ as a gun description about its statistics if need to. A box can be taken by doing: %box[value]%, e.g if someone wants to have 5 boxes with gray color and 5 other boxes with dark gray color: &7 %box5% &8 %box5%, &7 = Gray, &8 = Dark Gray.
▒▒ Shooting
shooting:
projectile-damage: <amount>
projectile-type: <type>
projectile-distance-removal: <amount | ticks>
projectile-amount: <amount>
projectile-speed: <amount>
projectile-delay-between-shots: <ticks>
shooting-default-sound: <sound>-<volume>-<pitch>
shooting-custom-sound: <custom-sound>
projectile-damage:
The amount of damage each bullet or other type will deal.
projectile-type:
There are three values that you can input: snowball, flare, rocket.
information:
item-name: <name>
item-type: <material>
item-durability: <amount>
item-lore: <line1>|<line2>|<line3>|<line4> ...>
item-name:
The item's display name - the name that the players will see when selecting this item.
Example: By using the color-code for red &c, you can color an item's name: "&c red display name", you can add as many colors you want.
item-type:
The Material of the item's type. For example, if you would like the item to be a Diamond Pickaxe, you would put item-type: DIAMOND_PICKAXE
item-durability:
The durability of the item's time(or data). For example, if your item is a Diamond Pickaxe and your custom textured gun is with another value of this type, you would put item-durability: <amount>.
item-lore:
The item's description. This is what players will see when hovering their mouse over the item. To indicate a new line, use a vertical bar |.
Example: item-lore: "&aThis is line one.|&bThis is line two.|&cThis is line three."
Also has a box character/symbol -> ▉ as a gun description about its statistics if need to. A box can be taken by doing: %box[value]%, e.g if someone wants to have 5 boxes with gray color and 5 other boxes with dark gray color: &7 %box5% &8 %box5%, &7 = Gray, &8 = Dark Gray.
▒▒ Shooting
shooting:
projectile-damage: <amount>
projectile-type: <type>
projectile-distance-removal: <amount | ticks>
projectile-amount: <amount>
projectile-speed: <amount>
projectile-delay-between-shots: <ticks>
shooting-default-sound: <sound>-<volume>-<pitch>
shooting-custom-sound: <custom-sound>
projectile-damage:
The amount of damage each bullet or other type will deal.
projectile-type:
There are three values that you can input: snowball, flare, rocket.
-
- Snowballs are highly recommended for ordinary projectiles.
- Flares, travel in a relatively straight line and burn upon impact. Mostly for Flareguns.
- Rockets, travel in a relatively straight line and explode upon impact. Mostly for Rocket Launchers.
projectile-distance-removal
Set the amount of the distance you want to remove a projectile. Flares and Rockets have different type of a distance removal. The difference between is that snowballs are having ticks. For example, projectile-distance-removal: 50 this is for Flares and Rockets, projectile-distance-removal: 10this is for snowballs. You can also check in the game the difference.
projectile-amount
The number of projectiles that are launched per shot.
projectile-speed:
The speed of the fired projectile. A value from 0.1 - 10 is recommended(3-4 recommended) for snowballs, and 0.1 - 4 for Flares and Rockets(1-2 recommended). Projectiles with a high speed will begin to show signs of path warping due to a visual bug on Minecraft's side.
projectile-delay-between-shots
The delay in ticks that the player must wait before the next shot can be fired.
shooting-default-sound
The sound played whenever the gun is fired. Example, ENTITY_WITHER_DEATH-1-1.
shooting-custom-sound
The custom sound played whenever the gun is fired. Example, note.m4_shoot, note.ak47_shoot.
▒▒ Reload
reload:
starting-amount: <amount>
reload-amount: <amount>
reload-cooldown-delay: <ticks>
reload-remove-type-amount: <amount>
reload-type: <material>
reload-default-sound: <sound>-<volume>-<pitch>
reload-custom-sound: <custom-sound>
starting-amount
The amount of ammo the weapon starts with when it is first spawned. For example, if reload-amount is set to 40, and start-amount is set to 20, then the weapon will start off with 20 out of 40 ammo.
reload-amount
This value essentially determines the magazine capacity of the weapon. In other words, how many bullets can this weapon hold and fire before a reload is required? And how many bullets will be restored to the weapon upon a reload?
reload-cooldown-delay
The amount of time in ticks it will take to completely reload the weapon. Before you set any amount, it already has a delay of 2 seconds.
reload-remove-type-amount
The amount of ammo when the weapon needs to be reloaded. For example, if reload-type is FLINT, and reload-remove-type-amount is set to 1, then the weapon will remove 1 FLINT from your inventory to reload the weapon. If you want your weapon to be infinite, you would put reload-remove-type-amount: 0. Do not remove reload-type.
reload-type
The Material to reload a weapon. For example, if you would like the material to be a Flint, you would put reload-type: FLINT
reload-default-sound
The sound played whenever the gun is reloading. Example, ENTITY_WITHER_DEATH-1-1.
reload-custom-sound
The custom sound played whenever the gun is reloading. Example, note.assault_rifle_reload
Set the amount of the distance you want to remove a projectile. Flares and Rockets have different type of a distance removal. The difference between is that snowballs are having ticks. For example, projectile-distance-removal: 50 this is for Flares and Rockets, projectile-distance-removal: 10this is for snowballs. You can also check in the game the difference.
projectile-amount
The number of projectiles that are launched per shot.
projectile-speed:
The speed of the fired projectile. A value from 0.1 - 10 is recommended(3-4 recommended) for snowballs, and 0.1 - 4 for Flares and Rockets(1-2 recommended). Projectiles with a high speed will begin to show signs of path warping due to a visual bug on Minecraft's side.
projectile-delay-between-shots
The delay in ticks that the player must wait before the next shot can be fired.
shooting-default-sound
The sound played whenever the gun is fired. Example, ENTITY_WITHER_DEATH-1-1.
shooting-custom-sound
The custom sound played whenever the gun is fired. Example, note.m4_shoot, note.ak47_shoot.
▒▒ Reload
reload:
starting-amount: <amount>
reload-amount: <amount>
reload-cooldown-delay: <ticks>
reload-remove-type-amount: <amount>
reload-type: <material>
reload-default-sound: <sound>-<volume>-<pitch>
reload-custom-sound: <custom-sound>
starting-amount
The amount of ammo the weapon starts with when it is first spawned. For example, if reload-amount is set to 40, and start-amount is set to 20, then the weapon will start off with 20 out of 40 ammo.
reload-amount
This value essentially determines the magazine capacity of the weapon. In other words, how many bullets can this weapon hold and fire before a reload is required? And how many bullets will be restored to the weapon upon a reload?
reload-cooldown-delay
The amount of time in ticks it will take to completely reload the weapon. Before you set any amount, it already has a delay of 2 seconds.
reload-remove-type-amount
The amount of ammo when the weapon needs to be reloaded. For example, if reload-type is FLINT, and reload-remove-type-amount is set to 1, then the weapon will remove 1 FLINT from your inventory to reload the weapon. If you want your weapon to be infinite, you would put reload-remove-type-amount: 0. Do not remove reload-type.
reload-type
The Material to reload a weapon. For example, if you would like the material to be a Flint, you would put reload-type: FLINT
reload-default-sound
The sound played whenever the gun is reloading. Example, ENTITY_WITHER_DEATH-1-1.
reload-custom-sound
The custom sound played whenever the gun is reloading. Example, note.assault_rifle_reload
Creating a Gun Signshop
I have to infrom you to not set the price with dots or any other type that is not just a single number.
To apply a gun name, the name should look the same like from guns.yml configuration file.
I have to infrom you to not set the price with dots or any other type that is not just a single number.
To apply a gun name, the name should look the same like from guns.yml configuration file.
Commands
Default
DeadSocietyGuns Aliases: /DeadSocietyGuns, /Dsg
DeadSocietyGunsPermissions Aliases: /DeadSocietyGunsPermissions, /DsgPermissions, /DsgPerms
DeadSocietyGunsReload Aliases: /DeadSocietyGunsReload, /DsgReload
-
- /Dsg - Shows all available commands.
- /DsgPerms- Shows all available permissions.
- /DsgReload - Reload all data related to guns.yml and config.yml configuration files.
Guns
-
- /Guns [give | list] - Give or get the list of all the available guns.
Guns Upgrade
-
- /Upgrade - An option to upgrade guns on the next stage. Gives infinite ammunition and flame powered bullets.
-
- Infinite Ammunition
- Poison-Powered Bullets.
Permissions
Default
Default
-
- dsg.use - Use /Dsg command.
- dsg.permissions - Use /DsgPerms command.
- dsg.reload - Use /DsgReload command.
Guns
-
- dsg.[gun] - Use a specific gun type.
- dsg.guns.* - Use all the guns.
- dsg.gunscmd - Use /Guns command.
Guns Signshop
-
- dsg.signshop.use - Purchase guns.
- dsg.signshop.create - Create signshops.
- dsg.signshop.break - Break signshops.
- dsg.signshop.* - Use all the permissions.
Guns Upgrade
-
- dsg.upgrade - Use /Upgrade command.
All Permissions
-
- dsg.* - Use all the permissions.
TOS
1. Don't Decompile this Plugin
2. Ask for support in my discord not the comments https://discord.gg/6dXZJ6t
3. I Don't Do Custom Stuff
4. Check out geek1243.cf for cool stuff
2. Ask for support in my discord not the comments https://discord.gg/6dXZJ6t
3. I Don't Do Custom Stuff
4. Check out geek1243.cf for cool stuff
