https://github.com/vargadot/vanguard

2D Weapon system for Godot games
https://github.com/vargadot/vanguard

2d godot godot-library gun-system library melee melee-system shooting vanguard weapon weapon-system

Last synced: 4 months ago
JSON representation

2D Weapon system for Godot games

• Host: GitHub
• URL: https://github.com/vargadot/vanguard
• Owner: Sparrowworks
• License: mit
• Created: 2024-10-05T11:01:42.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2025-06-17T09:56:51.000Z (about 1 year ago)
• Last Synced: 2025-07-08T11:44:40.941Z (12 months ago)
• Topics: 2d, godot, godot-library, gun-system, library, melee, melee-system, shooting, vanguard, weapon, weapon-system
• Language: GDScript
• Homepage:
• Size: 261 KB
• Stars: 6
• Watchers: 1
• Forks: 2
• Open Issues: 11
• 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"

![image](https://github.com/user-attachments/assets/51e59518-6309-498b-80ab-9323f0fb9423)

- 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)