![[IMG]](http://proxy.spigotmc.org/bfab17d1200f20cd4be2c6e571e59534b0b59935?url=https%3A%2F%2Fi.ibb.co%2FC25cnbB%2Fimage.png)
MWEPs is a plugin that lets you create your own custom weapons and tools in Minecraft!
Want a stick that shoots 500 tridents or a fully automatic machinegun which uses up ammo? How about a grenade which makes it rain 500 arrows? MWEPs can 100% do all of that!
Video Demonstrations:
![[IMG]](http://proxy.spigotmc.org/a9a606eb7d5ba90a78e9de33ef0eb8d57479a9f9?url=https%3A%2F%2Fi.imgur.com%2FYBKdkj9.gif)
https://streamable.com/mhrhcq
Features:
- 2 Default weapons which showcases possible features
- An in-game editor to create, modify and delete MWEPs
- An in-game instruction booklet to using the editor
- The ability to spawn any entity with NBT, velocity, count and much more!
- Sound effects on weapons!
- Ammo usage system!
- Weapon recoil / weapons that launch players!
- Apply effects to players in a radius with particle trails
- Apply effects to yourself
- Shoot players with effects!
- Track players down with the tracker effect!
- Launch a grenade with the grenade effect!
Spoiler: Commands
/mweps generate <mwep> <count> - generates an MWEP
/mweps give <player> <mwep> <count> - gives an MWEP to the player
/mweps reload - reloads weapons.yml and config.yml
/mweps editor help - gives an instruction booklet to using the editor
/mweps editor new <name> - creates a new mwep
/mweps editor modify <path> <data> - modifies an exisiting mwep path
/mweps editor list - lists all mweps
/mweps editor delete <path> - deletes an mwep path
/mweps editor inject <path> <value> - adds in a new path and value to weapons.yml
/mweps editor view <mwep> - shows all paths for a given mwep
/mweps editor copy <old> <new> - copies all paths under old to new
/mweps give <player> <mwep> <count> - gives an MWEP to the player
/mweps reload - reloads weapons.yml and config.yml
/mweps editor help - gives an instruction booklet to using the editor
/mweps editor new <name> - creates a new mwep
/mweps editor modify <path> <data> - modifies an exisiting mwep path
/mweps editor list - lists all mweps
/mweps editor delete <path> - deletes an mwep path
/mweps editor inject <path> <value> - adds in a new path and value to weapons.yml
/mweps editor view <mwep> - shows all paths for a given mwep
/mweps editor copy <old> <new> - copies all paths under old to new
Spoiler: Tutorial
MWEPs are stored in the weapons.yml file in the MWEPs folder and have the structure of:
ATrident:
Data: '{Enchantments:[{id:"loyalty",lvl:3}]}'
Weapon: TRIDENT
Consumable: false
RightClick:
UseTime: 0
Ammo: ARROW
AmmoUse: 0
AmmoName: trident
Sound:
Name: ENTITY_ARROW_SHOOT
Pitch: 1
Volume: 1
Spawn:
Spread: 5
Count: 50
Name: SPECTRAL_ARROW
Velocity: 5
Data: '{damage:10,life:1180,PierceLevel:100,pickup:2}'
LeftClick:
UseTime: 0
Ammo: ARROW
AmmoUse: 0
AmmoName: trident
Sound:
Name: ITEM_TRIDENT_THUNDER
Pitch: 1
Volume: 1
Spawn:
Spread: 5
Count: 50
Name: TRIDENT
Velocity: 4
Data: '{life:1180}'
ASign:
Data: '{Enchantments:[{id:"knockback",lvl:10}]}'
Weapon: OAK_SIGN
Consumable: false
RightClick:
UseTime: 40
Launch:
Velocity: 2
Asign and ATrident are the names of the MWEP
Consumable determines if the MWEP is used up per use
Data is the NBT data to add to the MWEP
Weapon is the item to generate the MWEP to
UseTime is how fast the MWEP can be used in ticks
RightClick and LeftClick are what to do when a player right or left clicks
Ammo specifies what ammo to use up (must be held in offhand)
AmmoUse specifies how much ammo to use per shot
AmmoName specifies what name the ammo needs to be for it to be used
You can access the in-game editor with the command /mweps editor <help/new/modify/delete/list/inject/view/copy>
help - gives you an instruction booklet
new <name> - creates a blank MWEP template
modify <path> <data>- modifies existing values in an MWEP. Use inject for non-existing values
delete <name/path> - deletes either an entire MWEP or path
ex:
/mweps editor delete ATrident will delete ATrident but /mweps editor delete ATrident.Data will delete data values
list - lists all mweps
inject <path> <data> - allows you to put any value you want into weapons.yml
view <name> - allows you to view all values for an MWEP
copy <existing> <new> - copies over a path or MWEP
Code (Text):
ATrident:
Data: '{Enchantments:[{id:"loyalty",lvl:3}]}'
Weapon: TRIDENT
Consumable: false
RightClick:
UseTime: 0
Ammo: ARROW
AmmoUse: 0
AmmoName: trident
Sound:
Name: ENTITY_ARROW_SHOOT
Pitch: 1
Volume: 1
Spawn:
Spread: 5
Count: 50
Name: SPECTRAL_ARROW
Velocity: 5
Data: '{damage:10,life:1180,PierceLevel:100,pickup:2}'
LeftClick:
UseTime: 0
Ammo: ARROW
AmmoUse: 0
AmmoName: trident
Sound:
Name: ITEM_TRIDENT_THUNDER
Pitch: 1
Volume: 1
Spawn:
Spread: 5
Count: 50
Name: TRIDENT
Velocity: 4
Data: '{life:1180}'
ASign:
Data: '{Enchantments:[{id:"knockback",lvl:10}]}'
Weapon: OAK_SIGN
Consumable: false
RightClick:
UseTime: 40
Launch:
Velocity: 2
Consumable determines if the MWEP is used up per use
Data is the NBT data to add to the MWEP
Weapon is the item to generate the MWEP to
UseTime is how fast the MWEP can be used in ticks
RightClick and LeftClick are what to do when a player right or left clicks
Ammo specifies what ammo to use up (must be held in offhand)
AmmoUse specifies how much ammo to use per shot
AmmoName specifies what name the ammo needs to be for it to be used
You can access the in-game editor with the command /mweps editor <help/new/modify/delete/list/inject/view/copy>
help - gives you an instruction booklet
new <name> - creates a blank MWEP template
modify <path> <data>- modifies existing values in an MWEP. Use inject for non-existing values
delete <name/path> - deletes either an entire MWEP or path
ex:
/mweps editor delete ATrident will delete ATrident but /mweps editor delete ATrident.Data will delete data values
list - lists all mweps
inject <path> <data> - allows you to put any value you want into weapons.yml
view <name> - allows you to view all values for an MWEP
copy <existing> <new> - copies over a path or MWEP
Spoiler: Permissions
cato.mweps.generate - gives permission to the /mweps generate command
cato.mweps.give - gives permission to the /mweps give command
cato.mweps.editor - gives permission to /mweps editor
cato.mweps.editor.new - gives permission to /mweps editor new
cato.mweps.editor.modify - gives permission to /mweps editor modify
cato.mweps.editor.delete - gives permission to /mweps editor delete
cato.mweps.editor.list - gives permission to /mweps editor list
cato.mweps.editor.inject - gives permission to /mweps editor inject
cato.mweps.editor.view - gives permission to /mweps editor view
cato.mweps.editor.copy - gives permission to /mweps editor copy
cato.mweps.reload - gives permission to /mweps editor
cato.mweps.weapon.[Weapon Name] - grants permission for players
to use an MWEP if the setting is enabled in configs
cato.mweps.give - gives permission to the /mweps give command
cato.mweps.editor - gives permission to /mweps editor
cato.mweps.editor.new - gives permission to /mweps editor new
cato.mweps.editor.modify - gives permission to /mweps editor modify
cato.mweps.editor.delete - gives permission to /mweps editor delete
cato.mweps.editor.list - gives permission to /mweps editor list
cato.mweps.editor.inject - gives permission to /mweps editor inject
cato.mweps.editor.view - gives permission to /mweps editor view
cato.mweps.editor.copy - gives permission to /mweps editor copy
cato.mweps.reload - gives permission to /mweps editor
cato.mweps.weapon.[Weapon Name] - grants permission for players
to use an MWEP if the setting is enabled in configs
Spoiler: Config
Default Config values:
Disable-IFrames: true
Require-Perms-to-Use-MWEP: false
Add-Owner-to-Projectiles: true
Disable-Projectiles-Breaking-Hanging-Entities: true
Disable-IFrames - Removes invincibility ticks for entities damaged by an MWEP, allowing them to be hit successively akin to 0 tick pvp.
Require-Perms-to-Use-MWEP - Requires players to have cato.mweps.weapon.[Name] permission to use an MWEP
Add-Owner-to-Projectiles - Adds the user of an MWEP as the owner of the projectile they shoot from it.
Disable-Projectiles-Breaking-Hanging-Entities - Prevents MWEP projectiles from breaking item frames
Disable-IFrames: true
Require-Perms-to-Use-MWEP: false
Add-Owner-to-Projectiles: true
Disable-Projectiles-Breaking-Hanging-Entities: true
Disable-IFrames - Removes invincibility ticks for entities damaged by an MWEP, allowing them to be hit successively akin to 0 tick pvp.
Require-Perms-to-Use-MWEP - Requires players to have cato.mweps.weapon.[Name] permission to use an MWEP
Add-Owner-to-Projectiles - Adds the user of an MWEP as the owner of the projectile they shoot from it.
Disable-Projectiles-Breaking-Hanging-Entities - Prevents MWEP projectiles from breaking item frames
Spoiler: 1.5 Update Effect Feature examples
Code (Text):
Laser-Pistol:
Data: ''
Weapon: GOLDEN_SHOVEL
Consumable: false
RightClick:
UseTime: 10.0
Ammo:
Type: ARROW
Use: 1
Name: Fusion-Cell
Sound:
Name: ENTITY_FIREWORK_ROCKET_BLAST
Pitch: 4
Volume: 3
Effect:
Other:
Aim:
Type: HARM
Amplifier: 1.0
Duration: 1
Icon: false
Particles: false
Range: 100.0
Ray:
Particle: TOTEM
Density: 1
Hit:
Particle: FLASH
Density: 1.0
Beamer:
Weapon: SUNFLOWER
Consumable: false
RightClick:
Effect:
Other:
Sphere:
Type: HARM,POISON
Amplifier: 1,1
Duration: 1,200
Icon: true
Particles: false
Radius: 10.0
Ray:
Particle: DRIP_LAVA
Density: 1
LeftClick:
Effect:
Other:
Sphere:
Type: HEAL,REGENERATION
Amplifier: 1,1
Duration: 1,200
Icon: true
Particles: false
Radius: 10.0
Ray:
Particle: DRIP_WATER
Density: 1
Data: ''
Weapon: GOLDEN_SHOVEL
Consumable: false
RightClick:
UseTime: 10.0
Ammo:
Type: ARROW
Use: 1
Name: Fusion-Cell
Sound:
Name: ENTITY_FIREWORK_ROCKET_BLAST
Pitch: 4
Volume: 3
Effect:
Other:
Aim:
Type: HARM
Amplifier: 1.0
Duration: 1
Icon: false
Particles: false
Range: 100.0
Ray:
Particle: TOTEM
Density: 1
Hit:
Particle: FLASH
Density: 1.0
Beamer:
Weapon: SUNFLOWER
Consumable: false
RightClick:
Effect:
Other:
Sphere:
Type: HARM,POISON
Amplifier: 1,1
Duration: 1,200
Icon: true
Particles: false
Radius: 10.0
Ray:
Particle: DRIP_LAVA
Density: 1
LeftClick:
Effect:
Other:
Sphere:
Type: HEAL,REGENERATION
Amplifier: 1,1
Duration: 1,200
Icon: true
Particles: false
Radius: 10.0
Ray:
Particle: DRIP_WATER
Density: 1
Spoiler: 1.6 Update Tracker/Drop/DisplayCooldown Feature examples
Code (Text):
Player-Finder:
Data: ''
Weapon: SCUTE
Consumable: false
Drop: false
DisplayCooldown: true
RightClick:
Track:
Type: PLAYER
Range: 2000
Ray:
Particle: DRIPPING_OBSIDIAN_TEAR
Density: 25.0
Range: 2
UseTime: 200.0
Data: ''
Weapon: SCUTE
Consumable: false
Drop: false
DisplayCooldown: true
RightClick:
Track:
Type: PLAYER
Range: 2000
Ray:
Particle: DRIPPING_OBSIDIAN_TEAR
Density: 25.0
Range: 2
UseTime: 200.0
Spoiler: 1.7 Grenade Example
Code (Text):
Grenade:
Data: ''
Weapon: SHEARS
Consumable: true
RightClick:
Sound:
Name: ENTITY_ARROW_SHOOT
Pitch: 1
Volume: 1
Spawn:
Count: 1.0
Name: DROPPED_ITEM
Velocity: 1.0
Data: '{PickupDelay:32767,Item:{id:"minecraft:shears",Count:1b}}'
Spread: 0.1
Grenade:
Count: 300.0
Name: ARROW
Velocity: 5.0
Data: '{damage:2,pickup:0,life:1180}'
Spread: 1.0
Timer: 200.0
Explosion:
Power: 2.0
Fire: false
Break: false
UseTime: 3
Data: ''
Weapon: SHEARS
Consumable: true
RightClick:
Sound:
Name: ENTITY_ARROW_SHOOT
Pitch: 1
Volume: 1
Spawn:
Count: 1.0
Name: DROPPED_ITEM
Velocity: 1.0
Data: '{PickupDelay:32767,Item:{id:"minecraft:shears",Count:1b}}'
Spread: 0.1
Grenade:
Count: 300.0
Name: ARROW
Velocity: 5.0
Data: '{damage:2,pickup:0,life:1180}'
Spread: 1.0
Timer: 200.0
Explosion:
Power: 2.0
Fire: false
Break: false
UseTime: 3
Minecraft @ UW MWEPs:
https://pastebin.com/bKenqyWE
Entities names: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/entity/EntityType.html
Sounds names: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Sound.html
Item names: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html
Potion names:
https://hub.spigotmc.org/javadocs/spigot/org/bukkit/potion/PotionEffect.html
Particle names:
https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Particle.html
Any suggestions or bug reports are highly encouraged! This is my very first public plugin!
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.16, 1.17, 1.18
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
MWEPS | Custom Weapon Maker | 100% Free is a free Minecraft Java mod. Compatible with Minecraft 1.16, 1.17, 1.18. Downloaded 20,724 times (via Spigot). Download it and open it directly in the game.