https://github.com/sparrowworks/vanguard
2D Weapon system for Godot games
https://github.com/sparrowworks/vanguard
2d godot godot-library gun-system library melee melee-system shooting vanguard weapon weapon-system
Last synced: 9 months ago
JSON representation
2D Weapon system for Godot games
- Host: GitHub
- URL: https://github.com/sparrowworks/vanguard
- Owner: Sparrowworks
- License: mit
- Created: 2024-10-05T11:01:42.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-07-09T12:15:06.000Z (12 months ago)
- Last Synced: 2025-07-23T11:58:41.786Z (11 months ago)
- Topics: 2d, godot, godot-library, gun-system, library, melee, melee-system, shooting, vanguard, weapon, weapon-system
- Language: GDScript
- Homepage:
- Size: 1.03 MB
- Stars: 7
- Watchers: 1
- Forks: 2
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# Vanguard
## An Open-Source 2D Weapon system for Godot Games.
Vanguard is a library of simple 2D weapon system catered to hobbyists, begginers and alike. It provides a collection of classes to:
* Build ranged weapons (like guns and bows) using [Ranged](https://github.com/VargaDot/Vanguard/blob/main/blueprints/ranged/ranged.gd).
* Create arrows, bullets and all sorts of projectiles using [Projectile](https://github.com/VargaDot/Vanguard/blob/main/blueprints/projectile/projectile.gd).
* Create explosion, noise and status-effect inducing (poison, burning...) areas with [Field](https://github.com/VargaDot/Vanguard/blob/main/blueprints/field/field.gd).
* Register, equip and unequip weapon modification using [kits](https://github.com/VargaDot/Vanguard/tree/main/kits).
* Build upon a core [Weapon](https://github.com/VargaDot/Vanguard/blob/main/blueprints/weapon/weapon.gd) class and create your own custom classes and weapon types.
* Copy and "mass produce" like [Melee](https://github.com/VargaDot/Vanguard/blob/main/blueprints/melee/melee.tscn), [Hitbox](https://github.com/VargaDot/Vanguard/blob/main/blueprints/hitbox/hitbox.gd) and [Hurtbox](https://github.com/VargaDot/Vanguard/blob/main/blueprints/hurtbox/hurtbox.gd).
## How to use
* Open the blueprints folder.
* Open the desired folder of your choice.
* Right click on the scene.
* Click on "Inherit New Scene".
* Enjoy.
The codebase is pretty small and I've included documentation for everything. If you have a question, feel free to create an issue with the "Question" label.
## Download Guide
Click on "releases" on the right and download
## Found a bug?
See that beautiful (just like you) issue tab? click on it and submit an issue with the red label "bug" and we'll take it from there!
## Known issues
"I shot my weapon and the field doesn't work"
- you need to set a collisionshape2D manually, i don't know how you'd like your area of field to look like so i left it empty.
## Assets & Libraries
**Sprites used**:
* [Pistol](https://opengameart.org/content/gun-glock-26-gen5-9mm-vector)
* [Sword](https://opengameart.org/content/2d-pixel-weapons)
**Libraries used**:
* [Composer](https://github.com/Sparrowworks/ComposerGodot)