HomeJavaModsLegendGuns (Free Edition)
LegendGuns (Free Edition)
ModsJava

LegendGuns (Free Edition)

Paid version at: A nice weapon system for your server! Friendly to both regular survival servers and mini-game servers! Screenshots BELOW! It has…

⬇ Download on Spigot
logo.png

Paid version at: https://www.spigotmc.org/resources/legendguns.48696/

A nice weapon system for your server!
Friendly to both regular survival servers and mini-game servers!
Screenshots BELOW! ;)



It has (available in FREE EDITION):
- Fully customizable weapon system
- Custom effect system (limits to 10 of them maximumly)
- Recoil system, you head will shake when shooting (will NOT stop you when walking!! )
- Scoping support
- Night-vision support for scoped weapons!
- Java API to create your own mechanism EASILY
- Enable crafting recipes using LegendGunsCrafting (FREE)
- Full I18N and custom text, 100% customizable

How to create a custom weapons/effects/magaines?
EASY! Just choose a template from sample config!
check out sample configurations here:
https://github.com/DragonetMC/LegendGuns-Sample-Config

What options you can customize for weapons?
Spoiler
simple but powerful weapon configurations
Code (Text):

# the Java class drives this weapon
# weapon type for the base class
base: NormalWithAmmo

display: "&e&lRifle Gun"

# Material from Bukkit API
material: GOLD_BARDING
# Lore for the weapon
lore:
  - "&eThis is a rifle weapon"

# base class specific settings
# in this situation, we need set the parameters for Normal
settings:
  loadup:
    effects:
      start: load-start
      done: load-done
    delay: 25
  shooting:
    effect: shoot
    # NOTICE: this delay is in microseconds
    delay-ms: 200
    # the angle from 0.0-1.0
    recoil:
      # rotate upwards, it will *NOT* interupt the player's movement
      rotate-vert: -1.0
      # max delta value of the horizontal rotation, should be ±N
      rotate-hori-max: 2.0
    burst-shot:
      enabled: true
      count: 3
      delay: 2
  scoping:
    enabled: false
    # zoom stages, value means slowness amplifier
    zoom-stages: []
    # stage indexes that enabled night-vision
    # index starts from 0
    night-vision-stages: []
  # ammunition settings
  ammunition:
    # what types of magazines can be used
    accepted-magazines: [dot55]
    # effect for the weapon when out of ammo
    no-ammo-effect: no-ammo
  bullet:
    # Projectile EntityType from Bukkit API
    projectile: SNOWBALL
    # bullet speed
    speed: 4
    damage:
      # damage type: SINGLE or BLAST
      type: SINGLE
      # use radius if using BLAST type
      # radius: 4
      value: 2.0
    # gravity affected or not?
    # set false for flying objects,
    # for example rockets can run slot but don't drop
    # also if wanna make it weird, set to true
    gravity: false
    effect: bullet
    hit-effect: bullet-hit
    bullets-per-shot: 1
    randomness: 0.01
    # how many ticks before check and remove bullets?
    clear-up:
      # check interval in ticks
      interval: 100
      # bullet time-to-live in microseconds
      ttl-ms: 10000
 

Pre-made configurations?
Sure, a plenty of them are available!
https://github.com/DragonetMC/LegendGuns-Sample-Config

==== Unique Features ====
Recoil Mechanism (UNIQUE)
Recoil to the player without interuptting their movements by network packets manipulation. Implemented in base class "Normal", check out the configuration section
Spoiler
Code (Text):

base: Normal
# ...
settings:
  #...
  shooting:
  # ...
    recoil:
      # rotate upwards, it will *NOT* interupt the player's movement
      rotate-vert: -1.0
      # max delta value of the horizontal rotation, should be ±N
      rotate-hori-max: 2.0
# ...
 

Grenade Throwing Strength (UNIQUE)
Implemented in abstract Java class "Throwable", available in base class " ThrowableExplosive"!
Right click to increase strength, then left click to throw it!
More strength = Further it will fly!
FULLY CUSTOMIZABLE!

Customize Effects (UNIQUE)
check out those two simple examples, see more in the sample configuration repo!
Spoiler
- Example for a moving object, adding a heart trail.
Code (Text):

components:
  just-a-name-for-this-particle:
    category: PARTICLE
    type: REDSTONE
    delay: 0
    repeat-interval: 1
  beautiful-hearts:
    category: PARTICLE
    type: HEART
    repeat-interval: 2
 
- Example for a single-time effect, effect when out of ammo.
Code (Text):

components:
  base-sound:
    category: SOUND
    type: BLOCK_GLASS_PLACE
  high-sound:
    category: SOUND
    type: BLOCK_LEVER_CLICK
 

Installation
Spoiler
General installation steps:
1. Install ProtocolLib on your server (of course)
2. Put `LegendGuns-x.x-xx.jar` into your plugins folder
3. Start your server and shut it down (yea! why not! )
4. Write your configurations about effects/weapons/magazines.
You can start with editing the pre-made templates/examples from:
https://github.com/DragonetMC/LegendGuns-Sample-Config
5. Start your server again

then, for survival servers
- Install LegendGunsCrafting to enable crafting recipes for weapons!

or, for minigame servers
- Install a minigame plugin utilizes LegendGuns
(I will make one very soon! )

Admin Commands:
/wgive - not available in free edition
/mgive <Player> <Magazine Name> - Give a magazine!

More deeper
A base class is a Java implementation of weapon mechanisms.
And in configurations you just set parameters like a pro!
You can also create your own base classes using API!
Current built-in base classes:

Normal - with this you can create almost all shooting weapons
NormalWithAmmo - added ammo support, you can define magazines from configurations!
ThrowableExplosive - make something like grenades

With the free developer API, you can:
- Create your own complex mecanisms by extending a simple Java class.
- Make mini-games EASILY!
- Integrate with your server seamlessly!


Dependencies:
ProtocolLib

Find a bug? Server crashes?

Contact?
Join our Discord server: https://discord.gg/CmkxTz2
Or use our ISSUE TRACKER system. ;)

Official Wiki (very detailed tutorials)
https://github.com/DragonetMC/LegendGuns/wiki

Screenshots (PAID VERSION):
[​IMG]
[​IMG]
[​IMG]
[​IMG]

Please don't make bad reviews if you don't enjoy the free version, it should have limits because it's free! ;)

Errors are expected sometimes!

The icon of this resource is credited to http://www.freepik.com using license Creative Commons BY 3.0.

Commands

Plugin details

Read from the plugin's own plugin.yml.

Quick facts

Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.

LegendGuns (Free Edition) is a free Minecraft Java mod. Compatible with Minecraft 1.9, 1.11, 1.12. Downloaded 197 times (via Spigot). Download it and open it directly in the game.

Explore more