Guns Workshop Origins

# Guns Workshop Origins

Guns Workshop Origins (GWO) is a highly extensible firearm framework for Minecraft, focused on immersive gunplay, modular customization, physical projectiles, advanced optics, and high-fidelity weapon models.

## Features

- Modular firearms and attachment customization
- Data-driven content-pack system
- Detailed first-person and third-person weapon animations
- Physical projectiles, bullet spread, penetration, and tracers
- Configurable recoil and weapon sway
- Red-dot, holographic, magnified, hybrid, and variable-zoom optics
- Tactical stance and multiple fire modes
- PBR materials, transparent components, and emissive textures
- Compatibility with Iris shaders
- Animated magazines, ammunition, spent casings, and muzzle effects
- Melee weapons and firearm melee attacks
- Armor plate system with dedicated animations and HUD
- Dynamic weapon charms and player-avatar charms
- In-game weapon modification interface
- GPU-accelerated glTF weapon rendering

## Requirements

- Minecraft 1.21.1
- NeoForge 21.1.233 or a compatible NeoForge 21.1.x version
- Java 21

## Installation

1. Install NeoForge for Minecraft 1.21.1.
2. Place the GWO JAR file in your `mods` folder.
3. Launch the game once to generate the `gwo` folder.
4. Place compatible GWO content packs inside the generated `gwo` folder.

## Content Packs

GWO is the core firearm framework. Weapon models, animations, sounds, ammunition, and attachments are provided through separate content packs.

Content packs are not included with this CurseForge project and must be obtained separately.

Creators can build their own firearms and attachments without modifying the GWO source code. Complete content-pack documentation is available on the official wiki:

https://wiki.playgwo.com/

## Development Status

GWO is currently under active development. Features, APIs, and content-pack formats may change before the first stable release.

Please report reproducible problems through the project issue tracker.

Internet Connection Required

This build includes encrypted built-in visual assets and requires an internet connection to api.playgwo.com to load them. If the service is unavailable, protected assets cannot be loaded. Players do not need a publisher token.