https://github.com/mmaulwurff/gearbox
Gearbox is an add-on for GZDoom engine that provides more convenient ways to select weapons.
https://github.com/mmaulwurff/gearbox
doom gzdoom m8f-toolbox mod zscript
Last synced: about 1 month ago
JSON representation
Gearbox is an add-on for GZDoom engine that provides more convenient ways to select weapons.
- Host: GitHub
- URL: https://github.com/mmaulwurff/gearbox
- Owner: mmaulwurff
- License: gpl-3.0
- Created: 2020-10-06T15:56:07.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2025-08-24T07:11:48.000Z (9 months ago)
- Last Synced: 2025-08-24T14:09:43.025Z (9 months ago)
- Topics: doom, gzdoom, m8f-toolbox, mod, zscript
- Language: GLSL
- Homepage: https://forum.zdoom.org/viewtopic.php?f=43&t=71086
- Size: 1.56 MB
- Stars: 40
- Watchers: 8
- Forks: 9
- Open Issues: 24
-
Metadata Files:
- Readme: Readme.md
- License: copying.txt
Awesome Lists containing this project
README
Project moved to https://github.com/mmaulwurff/doom-toolbox/
# Gearbox
Gearbox is an add-on for GZDoom engine that provides more convenient ways to
select weapons and items.
(Blocks with [Treasure Tech](https://forum.zdoom.org/viewtopic.php?f=43&t=66995))
[](https://youtu.be/WXZUBtbsY7Y)
(Wheel with Heretic)
## How to Use
GZDoom 4.5 required.
1. open the menu by assigned key, or by next/previous weapon keys, if enabled in
options
2. select the weapon with next/previous weapon keys, or with mouse (wheel only)
3. use the drop weapon or drop inventory keys to drop selected thing
## Features
- Different representations: blocks, wheel, plain text
- Press Fire key to select and Alt Fire key to cancel
- Color and scale options
- Behavior options
- Multiplayer compatible
- Reaction to number keys
- extras.wad icon support for vanilla weapons
- Inventory item selection
- Ability to drop items or weapons from the menu
## Planned
- Patches for weapon icon adjustments
- More representations
- Moving weapon between slots and changing order
## Note for Weapon Mod Authors
If you want Gearbox to support your mod out of the box, assign
Inventory.AltHudIcon for your weapons! Tag property is also nice to have.
## Compatibility Issues
- [PyWeaponWheel v0.3](https://forum.zdoom.org/viewtopic.php?f=43&t=61061)
overrides time freezing. If you are using both mods and want to freeze time
with Gearbox, set PyWeaponWheel's option "Freeze when wheel is open"
(`py_weaponwheel_freeze` CVar) to Off.
Note that PyWeaponWheel may be built in some mods, for example in Project
Brutality. The solution is the same: disable time PyWeaponWheel's time
freezing.
## Known Issues
- Weapon icons in wheel aren't affected by "HUD preserves aspect ration" option.
- Mouse input in wheel in multiplayer causes screen shake.
## License
- code: [GPLv3](copying.txt)
## Acknowledgments
- Thanks to kadu522 for general help and support.
- Blocky view is designed to resemble the weapon menu from Half-Life by Valve.
- Thanks to Marrub for [ZScriptDoc](https://github.com/marrub--/zdoom-doc).
- Thanks to Talon1024 for help with time freezing option.
- Thanks to Player701 for help with key event processing code.
- Thanks to KeksDose for a concept of VM abort handler.
- Thanks to DrPyspy for allowing to use mouse input code from PyWeaponWheel.
- Thanks to Carrascado for bug fixes and new features.
- Thanks to Accensus, Proydoha, mamaluigisbagel, TheRailgunner, Captain J,
Enjay, StroggVorbis, krutomisi, Cutmanmike, StraightWhiteMan, JohnDoe8, HDV,
Zhs2 and Apollucas for feature suggestions.
- Thanks to Accensus, Proydoha, mamaluigisbagel, Ac!d, wildweasel,
Dark-Assassin, rparhkdtp, Samarai1000, Mr. Blazkowicz, lucker42, spectrefps,
Someone64, Lippeth, JMartinez9820, generic name guy and sebastianpanetta for
bug reports.
- Thanks to generic name guy for providing brazilian portuguese localization.
- See also [credits list](credits.md).