I'm an avid fan of ToxicFrog's GunBonsai, using it pretty much with everything these days, and even having it replace my own personal RPG gameplay mod I used to use. Since ToxicFrog was considerate enough to make it super simple to make addons for it, I figured I'd share what I've made so others can use them as well. I'll be periodically posting the various Addons and Patches I've made as I get them worked into a releasable state.
Addon vs Patch: What's the Difference?
Of note, some of these will be labeled as either an "Addon", or a "Patch". The difference is subtle, but significant. Addons utilize GunBonsai's various built in methods to extend the system, and barring any major revamp of the internal implementation, these should work for all future versions of GunBonsai. A Patch on the other hand relies on GzDoom's method of completely overwriting ZScript files with the same name when loading wads. There are a couple of things I wanted to change about GunBonsai that isn't exposed via the built in systems, so I copied the entire script file and made changes directly to the code. Because of this, a change in GunBonsai's scripting that affects the same files will render the patches obsolete, thus they are only viable for the version used to create the mod. The version they are made for will be reflected both in the file name, as well as in the readme.txt included in the mod.
Usage
Requires GunBonsai: viewtopic.php?t=76080
Load all Addons and Patches after GunBonsai! Options for Addons/Patches with configuration can be found under GunBonsai's submenu at the bottom, unless the mod has it's own menu, in which case, that will be mentioned in the readme!
Notes
I have not tested any of these in multiplayer, and there's a good chance some of them might not work at all. Please let me know if there any issues, and if you have suggestions, I'll see what I can do! Feel free to use my poorly built code for whatever you'd like!
More GunBonsai Content
AugustDrake has been creating a GunBonsai addon specifically for use with DRLA. If you like DRLA and GunBonsai, you should check it out! Find it here: viewtopic.php?t=80989
Changelog
Spoiler:Addons
November 5, 2025:
Added "Mini-Addon: Ultra Crispy RC Lump"
Added "[PATCH 0.10.6] Upgrade - DRLAX Personal ECM Fix"
Updated "[PATCH 0.10.6] Upgrade - Rapid Fire Redux" to Version 1.0.1
+Added Bugfix for CODBW ADS
November 4, 2025:
Added "[PATCH 0.10.6] Upgrade - Rapid Fire Redux"
Added new section "Archives"
Archived "Upgrade - Rapid Swing", "Patch [0.10.6] - LegenDoom Rapid Fire Fix", and "Patch [0.10.6] - DRLA Rapid Fire Fix"
Added "Upgrade - LOL Rocket"
October 19, 2025:
Updated "Addon - Progress Keeper" to Version 1.3
*Bug Fix: Fixed a VM Abort when using with LegenDoom
September 10, 2025:
Updated "Addon - Respec" to Version 1.3
*Bug Fix: VM Abort using "Respec All Weapons" if you had weapons missing from inventory
+Menu Option "Missing Weapon Mode"
August 12, 2025:
Updated "Addon - Progress Keeper" to Version 1.2
*Bug Fix: Reloading a save with AutoAutoSave support enabled, then choosing an upgrade would result in a VM Abort
July 12, 2025:
Updated "Addon - Respec" to Version 1.2
+Option Auto-Clear GB Build at Pistol Start/Inventory Clear
July 11, 2025:
Updated "Addon - Respec" to Version 1.1
+Option to Respec All Weapons
+Option to Clear GunBonsai Data
Jul 3, 2025:
Updated "Addon - Progress Keeper" to Version 1.1
+More options for auto save/load
*Rewrote the save/load code for better functionality
*Bug Fix: Starting a new game within a current play session would corrupt save data
Jul 01, 2025:
Updated "Upgrade: Rapid Swing" to Version 1.4
+Option to select speed increase per level
Updated "Upgrade: Rapid Swing" to Version 1.4.1
*Bug Fix: Forgot to adjust Tooltip display to 2 decimal places
Jun 22, 2025:
Added "Addon - Progress Keeper"
May 24, 2025:
Added "Addon - Respec"
Mar 06, 2025:
Updated "Addon - XP Bonuses" to Version 2.3
+Blacklisted Map "GZAPHUB"
+Toggle for XP Bonuses per Map only on first visit
Mar 01, 2025:
Updated "Addon - XP Bonuses" to Version 2.2
+XP Bonuses per Map
Oct 27, 2024:
Added "Mini-Addon - No Weapon Upgrades"
Aug 18, 2024:
Updated "Upgrade: Rapid Swing" to Version 1.3
*Bug Fix: More VM aborts
Aug 14, 2024:
Added "Patch [0.10.6] - Elemental Upgrade Level Requirements"
Jun 19, 2024:
Added "Patch [0.10.6] - HE Shots Brutal Doom V22 Fix"
May 06, 2024:
Added "Mini-Addon - Elemental Upgrades Only Version"
Added "Patch [0.10.6] - Ammo Leech Compatibility Fix"
Removed "Patch [0.10.6] - Ammo Leech for Project Brutality Fix"
*Made obsolete by "Patch [0.10.6] - Ammo Leech Compatibility Fix"
Apr 24, 2024:
Added "Patch [0.10.6] - Reject Level-Up Settings"
Apr 22, 2024:
Updated "Upgrade: Rapid Swing", "Patch [0.10.6] - LegenDoom Rapid Fire Fix", and "Patch [0.10.6] - DRLA Rapid Fire Fix"
*Bug Fix: Asst. VM aborts
Updated "Patch [0.10.6] - Always Roll Weapon Damage" to Version 1.2
*Bug Fix: Calculation error for Percentage Chance
*Bug Fix: Math is Hard, forgot how to "greater-/less-than"
Apr 20, 2024:
Added "Patch [0.10.6] - DRLA Rapid Fire Fix"
Added "Addon - Upgrade: Powerup Boost"
Updated "Patch [0.10.6] - Always Roll Weapon Damage" to Version 1.1
+Rolling Damage Upgrade as a percentage instead of always
Updated "Addon - Upgrade: Rapid Swing" to Version 1.1
+Bug fixes for DRLA and LegenDoom
+Max Level option for Rapid Fire Upgrade replacement
Apr 14, 2024:
Updated "Addon - XP Bonuses" to Version 2.1
+Starting Weapon Upgrades feature
Apr 13, 2024:
Added "Patch [0.10.6] - LegenDoom Rapid Fire Fix"
Apr 10, 2024:
Added "Patch [0.10.6] - Ammo Leech for Project Brutality Fix"
Apr 09, 2024:
Added "Addon - Starting Player Levels"
Mar 25, 2024:
Initial Release
Added "Addon - Upgrade: Flak Shot"
Added "Addon - Upgrade: Health Boost"
Added "Addon - Upgrade: Rapid Swing"
Added "Addon - PROTOTYPE Upgrade: Ammo Reserves"
Added "Addon - XP Bonuses"
Added "Patch [0.10.6] - XP Formula Variants"
Added "Patch [0.10.6] - Always Roll Weapon Damage"
Added "Mini-Addon - Scavenger uses Angelic Aviary Angelic Shards"
Added "Mini-Addon - War Trophies Ignores DOT Kills"
Added "Mini-Addon - No Elemental Upgrades"
Added "Mini-Addon - No Bandoliers Upgrade"
Upgrade: Flak Shot
Spoiler:Upgrade: Health Boost
SoM GunBonsai Upgrade: Flak Shot Version 1.0
--------------------------------------------
Download: https://drive.google.com/file/d/1RSRThK ... sp=sharing
A modified version of the "Submunitions" upgrade that somewhat mitigates the
problem of the upgrade becoming a level clearing death machine at higher levels.
As a bonus, it is partially configurable!
Changes from the original upgrade include:
-Instead of each level adding to the length of time the bomblets bounce around
before exploding, they have a non-expandable time-to-live (configurable).
-You can configure the starting number of bomblets, as well as modifying the
overall damage each one does upon explosion, should you want to tweak the damage
for balance issues
-Changed the bomblet sprites to the fireball from Super Mario World (SNES),
mostly just for fun.
Usage and Configuration
-----------------------
Load after GunBonsai. Configuration options can be found in the GunBonsai menu
after all the main options. Settings are as follows:
Time to Live (Seconds): Maximum time, in seconds, the bomblets will bounce
around before exploding. Note, this value is randomized so that they all don't
detonate at the same time.
Base Number of Bomblets: The starting number of bomblets to spawn at level 1 of
the upgrade. Each additional level of the upgrade adds one more bomblet.
Damage Multiplier: Modifies the amount of damage done per bomblet, as a simple
way to adjust balance should the need come up.
Notes
-----
Haven't tested this with multiplayer, but I don't see why it wouldn't work. In
the future, I'm considering turning this from a singular upgrade to an upgrade
tree that you can pick and chose what you want to increase (number of bomblets,
time-to-live extension, damage, etc...)
Screenshots
--------------
Bomblets/flaks spewing from dead Zombie Guy:
Weapon Upgrade menu:
Configurable options:
Spoiler:PROTOTYPE Upgrade: Ammo Reserves
SoM GunBonsai Upgrade: Health Boost Version 1.0
-----------------------------------------------
Download: https://drive.google.com/file/d/1EtSnIR ... sp=sharing
A Player Upgrade that increased the player's Max Health each level. The
amount of Max Health gained per level is configurable.
Usage and Configuration
-----------------------
Load after GunBonsai. Configuration options can be found in the GunBonsai menu
after all the main options. Settings are as follows:
Health Boost per Level: As advertised on the tin, this is how much Max Health
you gain per level. Note: If you change this value mid-game, you will have to
toggle the upgrade to recalculate your health.
Notes
-----
Haven't tested this with multiplayer, and it might not work, as the way I coded
the player detection is a tad inelegant.
Screenshots
--------------
Max health boosted in game:
Player upgrade menu:
Configurable options:
Spoiler:XP Bonuses
[PROTOTYPE] SoM GunBonsai Upgrade: Ammo Reserves Version 1.1
------------------------------------------------------------
Download: https://drive.google.com/file/d/154ipjV ... sp=sharing
NOTICE: As this is a prototype that may or may not be integrated into that main mod by ToxicFrog, this addon is offered as-is and will likely only be updated to fix bugs!
An alternative to the Player Upgrade "Bandoliers", which I personally am a fan
of, but due to a lot of mods modifying ammo caps themselves, "Bandoliers" has
a good number of conflicts, prompting a discussion of alternative methods.
The idea of taking some ammo away from the player and storing it into a
"reserve" cropped up, and I really liked the idea, so I hacked together this
prototype. It works by monitoring your ammo, and if your current count is
above the threshold, it will syphon that ammo off into the "reserve".
Conversely, if your current ammo amount is below another threshold, it will pull
as much ammo out as it can to meet the upper threshold. Currently does not
disable "Bandoliers", as they can run together without issues, should you want
to.
Changelog
---------
Version 1.1:
-Fixed an error when if the "Restock" percentage was set to 0%, it would not
trigger the resupply code
Issues
------
The HUD is very basic, and due to how its coded, is NOT multiplayer friendly
(which the entire thing might not be... I'm not great with MP compatibility).
Second, there's almost no sanity checks for the main three settings,
specifically, ammo reserve size per level, and the siphon/restoking percentages
not making any sense. The only thing in place is a simple check, which triggers
if the siphon threshold is equal to or less then the restocking threshold. This
was done to prevent any runaway siphon/restock loops for ammo capacities that
are extremely low. All it does is simply ignore that ammo type for checking
quantities. I didn't implement any lump reading for customizing what qualifies
as a "valid" ammo type for reserves, so there may still be some wonkiness for
certain mods. There's no way to see ammo reserves for weapons you don't have,
or don't currently have ready, and any ammo in a reserve pool cannot be
recovered except through draining your primary ammo amount below the restocking threshold.
Usage and Configuration
-----------------------
Load after GunBonsai. Configuration options can be found in the GunBonsai menu
after all the main options. Settings are as followed:
Reserve Size per Level: Percentage per upgrade level of the current Max Ammo
Capacity to add to the reserve. This capacity is Backpack aware, as well as
capable of reacting to other mods modifying Max Ammo Capacity.
Ammo Siphon Threshold: Percentage of Max Ammo Capacity in which above this
value, ammo will be moved to the "Reserve" pool. Note: If the "Reserve" is
full, your ammo will simply continue to fill as normal.
Ammo Restock Threshold: As above, but if you have ammo in the "Reserve", it will
be replenished up to either the "Siphon Threshold", or however much ammo you
have left in the "Reserve".
Display related settings should be pretty self-explanatory.
Todo
----
-As this is a prototype, and ToxicFrog has mentioned maybe integrating the code
for this in the future, I will not be expanding or updating this mod, aside from
bug fixes
-I will not be adding patched support for any other mods
-If I do revisit this idea in the future, what I'll likely do is make this a
standalone mod and add GunBonsai integration similar to how ToxicFrog added
Indestructible into GunBonsai, but no promises.
Compatibility
-------------
-Haven't tested this with multiplayer, and I don't know if it will work
-There's a lot of edge cases that this likely won't work with out of the box,
and it will likely need a special Lump to solve these issues
-The HUD is also hacked together due to me being tired of fighting with scoping
-As this is a prototype, and ToxicFrog had mentioned perhaps integrating this
into the main mod, this is offered as-is, and will only likely be updated in the
case of major bugs cropping up.
License
-------
You are free to use the code for whatever you like, for any reason, so long as
it doesn't step on GunBonsai's Licence. Parts of the code that are specifically
written by me are exempt from this. Credit is appreciated, but not needed.
Screenshots
--------------
In-Game Clip Reserve, partially full:
Player Upgrade menu:
Configurable Options:
Spoiler:Starting Player Levels
SoM GunBonsai Addon: XP Bonuses Version 2.3
-------------------------------------------
Download: https://drive.google.com/file/d/1gtj-uR ... drive_link
Adds an item "GunBonsai Weapon Upgrade", which when used will automatically
gives your current weapon a level up. You'll be granted these items by clearing
maps. Clearing maps involves finding all secrets, collecting all items, and
killing all monsters. Each of the three requirements can be individually
configured to be completely disabled, modify the percentage of completion, or
grant extra points for being completed. In addition, you can gain extra "All
Clear" points by fully completing a map, as defined by the settings of the three
goals. As you are rewarded upgrade items, you'll be required to obtain more
and more points to get the next item.
Changelog
---------
Version 2.3:
-Added the GZAPHUB map to the blacklist of maps not to process
-Added a toggle to only grant "Map Bonus Items" the first time a map is visited
Version 2.2:
-Added an option to be given a number of weapon upgrades at the start of each
map
Version 2.1:
-Added an option to be given a number of weapon upgrades at the start of a
play through
Version 2.0:
-Initial release
Usage and Configuration
-----------------------
Load after GunBonsai. Configuration options can be found in the "Options" menu
under "SoM GunBonsai XP Bonuses". Settings are as follows:
Enable: Globally toggle the XP Bonus system on or off. The master switch if
you will!
Starting Bonus Items: The number of free weapon upgrades you will receive when
starting a new game. Stacks with "Bonus Items per Map".
Bonus Items per Map: The number of free weapon upgrades you will receive when
starting a map. Stacks with "Starting Bonus Items".
Only give bonus items on first visit: If toggled "On", you will only get "Map
Bonus Items" the first time you visit a map. Note, if set to "Off", it will
continue to track which maps you have visited and if toggled back "On", will
not grant more bonus items on return to a previously visited map. Default "On".
Secrets, Monsters, and Items each have the following individual settings:
Enabled: Toggle the selected goal on or off.
Completion Percent: A percentage setting from 0 to 1 of how much of the goal you
need to complete to be granted your reward.
Points Awarded: How many "Points" you are rewarded toward your next Upgrade
Item. Points are kind of an XP system for the XP Bonus system!
The "All Clear" goal has the following settings:
Enabled: Same as the other's, this will toggle "All Clear" rewards.
Points Awarded: Same as the other goals. Note, these points are rewarded in
addition to the points gained from the other goals!
Display options should be mostly self-explanatory.
Example Configurations
----------------------
Safe Mode: Ignores Items, cause some mods don't flag them correctly, and gives
enough of a buffer for killing monsters and finding secrets to avoid issues.
-Enabled: Monsters, Secrets, and All Clear
-Complete Percent: 0.8
-Points Awarded: 1
All Clear Mode: Only grants points if you fully clear the map. Might be
difficult or impossible for some maps/mods.
-Enabled: Monsters, Secrets, Items, All Clear
-Complete Percent: 1.0
-Points Awarded: Monsters, Secrets, Items = 0, All Clear = 1
Free Mode: You're given points for each map, no requirements. Due to the way
the system works, you will be awarded points right at the start of the map.
-Enabled: All Clear only
-Complete Percent: N/A
-Points Awarded: All Clear = 1 (or whatever)
StainedOfMind's Settings: This is how I usually have my settings.
-Enabled: Monsters, Secrets, All Clear
-Complete Percent: 1.0
-Points Awarded: 1
Todo
----
-I might add alternative "point" scaling modes for gaining weapon upgrades in
the future.
Compatibility
-------------
Haven't tested this with multiplayer, and I'm not sure if it will work.
License
-------
You are free to use the code for whatever you like, for any reason.
Credit is appreciated, but not needed.
Screenshots
--------------
In-Game shot having just found the last secret, and getting the "All Clear" bonus, as all monsters are dead too. Notice the PDA in the corner, the "Weapon Upgrade" item, which I now have 2 of:
Configuration Options:
Spoiler:Upgrade: Powerup Boost
SoM's GunBonsai Addon: Starting Player Levels Version 1.0
---------------------------------------------------------
Download: https://drive.google.com/file/d/13WGYAU ... sp=sharing
Grants you a configurable number of Player Levels at the start of a new game.
Changelog
---------
Version 1.0:
-Initial release
Usage and Configuration
-----------------------
Load after GunBonsai. Configuration options can be found in the GunBonsai menu
after all the main options. Settings are as follows:
Number of Levels: The number of player levels to start the game with.
Todo
----
-Feature complete for now
Compatibility
-------------
-Haven't tested this with multiplayer, and I don't know if it will work
License
-------
You are free to use the code for whatever you like, for any reason.
Credit is appreciated, but not needed.
Screenshots
---------------
Configurable Options
In game shot with starting levels awarded
Spoiler:Respec
SoM GunBonsai Upgrade: Powerup Boost Version 1.0
------------------------------------------------
Download: https://drive.google.com/file/d/1OM0mE2 ... sp=sharing
A Player Upgrade that extends the duration of powerups. The boost duration is
configurable. Do note, powerups that are of the "Additive" type will only be
boosted when first adding the powerup. Any others picked up before the powerup
expires will only extend the time by the default amount. The boost will again
be applied when the powerup fully expires and is recollected. This is a
limitation of how Additive powerups work. Attempting to boost these will cause
the time to multiply each time instead of adding.
Changelog
---------
Version 1.0:
-Initial release
Usage and Configuration
-----------------------
Load after GunBonsai. Configuration options can be found in the GunBonsai menu
after all the main options. Settings are as followed:
Boost Percent Per Level: Percentage per upgrade level to add to the powerup
timer.
Todo
----
I may try to come up with an alternative method of detecting powerup pick ups
that will allow for boosting "Additive" types.
Compatibility
-------------
Not tested in multiplayer, and can't guarantee it will work.
License
-------
You are free to use the code for whatever you like, for any reason, so long as
it doesn't step on GunBonsai's Licence. Parts of the code that are specifically
written by me are exempt from this. Credit is appreciated, but not needed.
Screenshots
--------------
Configurable Options
Player Upgrade Menu
About to pick up a VERY useful Blur Sphere
Powerup timer extended 100% via 4 levels at 25% each! (Powerup Time via Simple HUD Addons viewtopic.php?t=60356)
Spoiler:Progress Keeper
SoM's GunBonsai Addon: Respec Version 1.3
-----------------------------------------
Download: https://drive.google.com/file/d/1sw0vpz ... sp=sharing
Allows you to Respec your currently equipped weapon, All of your weapons, or
your Player Upgrades, should you make a mistake or just want to start over.
You can even completely clear you build and start from scratch! You can also
toggle the option of fully clearing your build on Pistol Start/Inventory Reset.
It works by resetting the weapon, then regiving it XP back based on the number
of levels it had previously. It also temporarily removes and equal amount of
Player XP, which can cause it to go into negative values. This is to prevent
you from gaining free Player XP. This will of course correct itself once you
respend the levels on the weapon.
For Player Respec, it simply resets your Player Level to zero, then gives you
your current Level times the CVar "bonsai_gun_levels_per_player_level". Do note
that you COULD cheat and change the CVar after doing a Player Respec, and thus
get a whole bunch of extra upgrades, but thats on you. Technically, the same
could be done with the Weapon Respecs.
Why a command buried in the GunBonsai menu to activate this? Two reasons,
first, for safety. As much as it doesn't actually cost you anything to Respec,
depending on your settings, you may not be able to get back the exact same
set of Upgrades, so I wanted a way for the user to backout. Second, this was
the easiest option. I could have coded a hotkey with safety checks, or
created an item that sits in your inventory for use, or even hacked the option
into the Status screen, but all those required more work then I wanted to put
into this. Respecing a weapon should be infrequent enough to not make this too
much of an inconveience.
Changelog
---------
Version 1.3:
-Fixed a bug that would cause a VM Abort when trying to Respec All Weapons if
for some reason you didn't have that weapon in your inventory still, ie: pistol
start.
-Added menu option "Missing Weapon Mode"
Version 1.2:
-Added "Auto-Clear GB Data on Pistol Start" option
Version 1.1:
-Added "Respec All Weapons" and "Reset GunBonsai Data" options
Version 1.0:
-Initial release
Usage and Configuration
-----------------------
Load after GunBonsai. Find the menu commands in the GunBonsai Options menu
under "Addon: Respec".
Configurable Options:
Missing Weapon Mode: What to do when using "Respec All Weapons" if you don't
have a weapon in inventory still. "Skip" simply passes over any weapons and
informs you to respec later. "Attempt Rebind" will try to temporarily spawn a
copy of the weapon, and rebind it so that the rest of the reset can proceed. It
will then unbind the weapon and remove it. Should it fail to spawn the exact
same weapon, or fail for any other reason, it skips this weapon and carrys on.
Defaults to "Skip".
Note: I'm not 100% confident on "Attempt Rebind" being stable, so if you're
concerned about it, I would advise using "Skip" mode.
Auto-Clear GB Data on Pistol Start: Toggle to automatically clear your GunBonsai
build with pistol starts, or any other instance where your inventory is cleared.
Works by plopping an Inventory token on the player, and at map load, if it's not
found, it will trigger the clear.
Todo
----
-Feature complete
Compatibility
-------------
Haven't tested this with multiplayer, may not work.
License
-------
You are free to use the code for whatever you like, for any reason.
Credit is appreciated, but not needed.
Screenshots (Outdated)
--------------
Menu Commands
Player and Weapon Upgrades Before Triggering a Respec
GunBonsai HUD After Triggering Weapon Respec
About to Trigger a Player Respec
GunBonsai HUD After Respec
Player and Weapon Upgrades After Both Respecs
Spoiler:LOL Rocket
SoM's GunBonsai Addon: Progress Keeper Version 1.3
--------------------------------------------------
Download: https://drive.google.com/file/d/1PV9wkG ... sp=sharing
Allows you to save and load your GunBonsai build for use in new gameplay
sessions. This will allow you to completely restart maps or even full megawads,
but retain any Player or Weapon upgrades and XP you have accumulated. You
could even play a whole new map set and keep your progress. You can even switch
to a completely new weapon mod, and if/when you go back to previous ones, your
upgrade history will be carried over! The only limit to this is if you switch
iWads, you will have to manually move your progress, as builds are saved via
CVar, which do not carry over to new iWads.
Included are a variety of options to automatically save and load builds.
The system will gracefully (I hope) handle weapon and upgrades that are not
active. In the case of weapons, they will be added to your GunBonsai build, but
of course you will not be able to access them. For Upgrades, unfortunately
they will be lost. In addition, the system will not be able to reimburse you
for those lost points. I would also advise not changing your GunBonsai settings
that calculate XP, levels, etc...
Changelog
---------
Version 1.3:
-Fixed a VM Abort when using with LegenDoom
Version 1.2:
-Fixed a VM Abort when using AutoAutoSave support
Version 1.1:
-Added more options for Auto Save/Load of builds
Version 1.0:
-Initial release
Usage and Configuration
-----------------------
Load after GunBonsai. You can configure a hotkey to pull up the menu from the
"Customize Controls" option, does not have a default binding.
The menu has the following commands:
Save Data: Creates a manual Data Save.
Load Data: Performs a manual Build Load.
Clear Data: Clears the Save Data. Note: This does not reset your current
Build! Recommended to be done before starting a new game.
Configurable Options:
Save at Map End: Automatically saves your current build on leaving the current
map.
Save after Death: Automatically saves your current build on death. Note: While
"Save at Map End" will also save your build after dying, you can continue to
accumulate XP after you have died. This option will save your build immediately
upon dying, thus not preseving anything gained after death. You can have both
enabled, and only one save attempt will be created.
Load at Map Start: Will automatically load your saved build at the start of
every map.
Load at Game Start: Will automatically load your saved build when starting a new
game, or if the map restarts after death should you not have a save file. Note:
having both this and "Load at Map Start" will not trigger load twice, so you can
safely have both options turned on.
Load at Open Save File: Will automatically load your saved build when loading
a save game, either manually, or through automatic loading after death. This
will override the above two settings, so you can safely have all three options
turned on at the same time.
Todo
----
-Feature complete for now.
Compatibility
-------------
Haven't tested this with multiplayer, may not work.
License
-------
You are free to use the code for whatever you like, for any reason.
Credit is appreciated, but not needed.
Screenshots
-----------
Pending, short on time!
Spoiler:Patches
XP Formula Variants 0.10.6
Spoiler:Always Roll Weapon Damage 0.10.6
SoM GunBonsai Patch: XP Formula Variants Version 1.0
----------------------------------------------
PATCH ONLY FOR GUNBONSAI VERSION 0.10.6!
Download: https://drive.google.com/file/d/1WBOMDH ... sp=sharing
A patch that allows for alternative XP Formulas for weapons. Currently has the
following options:
-Linear: Same as the original formula "XP = bonsai_base_level_cost * double(level);"
-Squared: Requires more XP at higher levels! "XP = bonsai_base_level_cost * (double(level) * double(level));"
-Exponential: Quickly ramps up even faster then "Squared"! "XP = bonsai_base_level_cost * double(exp(level - 1));"
-Cubed: AKA: Russian Overkill Mode! Cause sometimes you cause a poop-ton of damage! "XP = bonsai_base_level_cost * (double(level) * double(level) * double(level));"
As my math skills are subpar, I don't have the chops to come up with any better
formulas, so if you have any other ideas or requests, it should be fairly
simple to add more!
Usage and Configuration
-----------------------
Load after GunBonsai. Configuration options can be found in the GunBonsai menu
after all the main options. Settings are as follows:
Xp Growth Type: The XP Formula to use. See Above for details.
Notes
-----
Haven't tested this with multiplayer, but since it's based on the original, I
don't see a reason why it wouldn't work.
Screenshots
--------------
In-Game shot with the Pistol at level 1 using default bonsai_base_level_cost of 1200 and the XP Formula set to "Cubed":
Configuration settings:
Spoiler:Reject Level-Up Settings 0.10.6
SoM GunBonsai Patch: Always Weapon Damage Upgrade Version 1.2
----------------------------------------------
PATCH ONLY FOR GUNBONSAI VERSION 0.10.6!
Download: https://drive.google.com/file/d/1GnEcxn ... sp=sharing
A patch that always rolls the Weapon Upgrade "Damage" for the first slot each
level. I wanted this because sometimes I'm don't want any of the upgrades
rolled for me, nor do I want to reject the level, and I felt like this was a
good compromise. New in Version 1.1, added the option to roll as a percentage
chance, for if you wanted to roll with only playing 1 upgrade per level.
Changelog
---------
Version 1.2:
-Fixed a minor calculation error with the "Percentage Chance" option.
Version 1.1:
-Added "Percentage Chance" option
Version 1.0:
-Initial release
Usage and Configuration
-----------------------
Load after GunBonsai. Configuration options can be found in the GunBonsai menu
after all the main options. Settings are as follows:
Percentage Chance: Chance as a percent to roll "Damage", default 100%.
Todo
----
-Feature complete for now
Compatibility
-------------
Haven't tested this with multiplayer, but since it's based on the original, I
don't see a reason why it wouldn't work.
License
-------
You are free to use the code for whatever you like, for any reason.
Credit is appreciated, but not needed.
Screenshots
--------------
In-Game shot of the Weapon Upgrade screen with "Damage" as the first selection:
Spoiler:Ammo Leech Compatibility Fix 0.10.6
SoM GunBonsai Patch: Reject Levelup Settings Version 1.0
--------------------------------------------------------
PATCH ONLY FOR GUNBONSAI VERSION 0.10.6!
Download: https://drive.google.com/file/d/1U-w3Mf ... sp=sharing
Allows for adjusting how much Player and Weapon XP is lost upon rejecting a
level up, between 0% and 100%.
Changelog
---------
Version 1.0:
-Initial release
Usage and Configuration
-----------------------
Load after GunBonsai. Configurable options are as follows:
"Player XP Loss Amount": Amount of Player XP lost at level up reject, as a
multiplier of the XP needed for that level, from 0.0 to 1.0. Result is rounded.
Set to "0.0" to retain all XP, and "1.0" to lose all XP. Defaults to 0.5, which
is the standard GunBonsai amount.
"Weapon XP Loss Amount": Same as above, but for Weapon XP. Defaults to GunBonsai
standard of 1.0.
Compatibility
-------------
Haven't tested this with multiplayer, but since it's based on the original, I
don't see a reason why it wouldn't work.
License
-------
You are free to use the code for whatever you like, for any reason, so long as
it doesn't step on GunBonsai's License. Parts of the code that are specifically
writen by me are exempt from this. Credit is appreciated, but not needed.
Screenshots
--------------
Configurable Options
Getting ready for a level up
Rejected the level, note that all Weapon XP was retained!
Spoiler:HE Shots Fix for Brutal Doom V22 0.10.6
SoM GunBonsai Fix: Ammo Leech Compatibility Fix Version 1.0
-----------------------------------------------------------
PATCH ONLY FOR GUNBONSAI VERSION 0.10.6!
Download: https://drive.google.com/file/d/1aee7Ky ... sp=sharing
Adds greater flexibility to the code that filters out invalid ammo types for
the "Ammo Leech" Weapon Upgrade. This fixes issues like it not working at all
with Project Brutality, as well as other mods that use alternative methods for
creating ammo types.
I opted to create this as a patch instead of an addon so that users wouldn't
have to fiddle with multiple upgrade id's when using BONSAIRC.
Changelog
---------
Version 1.0:
-Initial release
Usage and Configuration
-----------------------
Load after GunBonsai.
Todo
----
-I may try to come up with a method of adding a default sprite to spriteless
pickups
-Ideally, some way of customizing ammo types that can drop, either via a lump
or dynamic menu, is something I'd like to implement further down the road
Issues and Notes
----------------
-This is still not a perfect system. There are simply too many ways a mod
author can code how ammo works to cover all possibilities.
-The new system will cause false positives for some ammo types, which is
opposite of the false negatives caused by the old system, but occurs much less
frequently. Best example I can think of off the top of my head is the
crossbow ammo from "Dark Passenger"
-The above issue can spawn ammo drops that don't have pickup sprites, however,
from testing, they should still be collectable
Compatibility
-------------
-Haven't tested this with multiplayer, but since it's based on the original code
I don't see why it wouldn't work
License
-------
You are free to use the code for whatever you like, for any reason.
Credit is appreciated, but not needed.
Code adapted from ToxicFrog's GunBonsai, so don't step on that license either.
Screenshots
--------------
None. Works the same as the original, but more compatible.
Spoiler:Elemental Upgrade Level Requirements 0.10.6
SoM GunBonsai Fix: HE Shots Brutal Doom V22 Fix Version 1.0
-----------------------------------------------------------
PATCH ONLY FOR GUNBONSAI VERSION 0.10.6!
Download: https://drive.google.com/file/d/14bGhdU ... sp=sharing
Just discovered a bug with the HE Shots upgrade and Brutal Doom V22, namely, it
lets you one-shot things due to the "headshot" system. Only fully tested against
Baron of Hell, since this was what caused me to realize there was an issue.
Initially, I switched the damage type of "Extreme" to "Explosive", but it still
felt like it did way too much damage, so I created a dummy damage type of called
"heshots", so it just uses the default headshot damage bonus. It's still really
overpowered, but this is as best I can make it without messing around with BDs
headshot system.
Realistically, due to the headshot system, HE Shots is technically not
compatible BDV22, but I like the upgrade too much to just disable it, so I feel
like this is a reasonable compromise.
Changelog
---------
Version 1.0:
-Initial release
Usage and Configuration
-----------------------
Load after GunBonsai.
Todo
----
-Feature complete.
Issues and Notes
----------------
-Changes the damage type from "Extreme" to just "heshots", so it won't cause any
special damage type reactions/deaths/whatever
Compatibility
-------------
-Just changes a damage type, so should be as good as the original code
License
-------
You are free to use the code for whatever you like, for any reason.
Credit is appreciated, but not needed.
Code adapted from ToxicFrog's GunBonsai, so don't step on that license either.
Screenshots
--------------
None, can't really show something like this.
Spoiler:Upgrade - Rapid Fire Redux [0.10.6]
SoM GunBonsai Patch: Elemental Upgrade Level Requirements 1.0
--------------------------------------------------------
PATCH ONLY FOR GUNBONSAI VERSION 0.10.6!
Download: https://drive.google.com/file/d/10XsxDa ... sp=sharing
I like the elemental upgrades, but I often feel like they're available too soon,
so I created this patch to allow for setting a minimum number of Weapon Levels
you need to gain before they become available.
Changelog
---------
Version 1.0:
-Initial release
Usage and Configuration
-----------------------
Load after GunBonsai. Configurable options are as follows:
Minimum Required Weapon Level: Seems self explanatory, but you will not be
offered Elemental Upgrades on a weapon below this settings level.
Compatibility
-------------
Haven't tested this with multiplayer, but since it's based on the original, I
don't see a reason why it wouldn't work.
License
-------
You are free to use the code for whatever you like, for any reason, so long as
it doesn't step on GunBonsai's License. Parts of the code that are specifically
written by me are exempt from this (it's one f*$&%$*ing line). Credit is
appreciated, but not needed.
Screenshots
---------------
None today. Pretty simple mod.
Spoiler:SoM GunBonsai Patch: DRLAX Personal ECM Fix Version 1.0 [0.10.6]
SoM GunBonsai Upgrade: Rapid Fire Redux Version 1.0.1
[PATCH] for GunBonsai 0.10.6 ONLY!
---------------------------------------------------
Download: https://drive.google.com/file/d/1DcfRZv ... sp=sharing
A more polished version of my "Rapid Swing" addon. Not only does this superceed
the original addon, it will be replacing any Rapid Fire related patches for
specific gameplay mods (DRLA and LegenDoom currently). New to Rapid Fire Redux
is the ability to toggle "Melee Detection Mode", between GunBonsai's current
ammo based style, and the actor flag based style that GunBonsai employed in a
previous version.
Rapid Fire Redux adds support for more gradual speed increases, as well as
support for fixing specific gameplay mod related bugs. A new weapon upgrade,
"Rapid Swing" can be enabled for melee only weapons. It is identical to "Rapid
Fire", but has the opposite weapon requirements.
With default settings, Rapid Fire behaves like the official version, adding +50%
speed per level, up to a max of 6x speed. I recommend changing the settings to
Rate = 4 and Max = 20, to slow it down to +25% per level.
Rapid Swing instead adds +20% per level to a max of 2x speed. This somewhat
mitigates the issues ToxicFrog brought up about not wanting to add an official
melee only speed upgrade, citing the lack of ammo consumption would make it too
overpowered.
Configurable options include toggling the Rapid Swing Upgrade, method of
determining weapon eligability, maximum upgrade levels, and rate of speed
increase per level.
Please note, if migrating from the older Rapid Swing Addon, you'll have to
redo your settings.
Bugfixes Implemented
--------------------
DRLA:
-Dropping modded weapons results in mods being lost.
LegenDoom:
-Unable to drop weapons.
Call of Doom: Black Warfare:
-Firing in ADS causes lockups
Changelog
---------
Version 1.0.1:
-Added bugfix for Call of Doom: Black Warfare
Version 1.0:
-Initial release
Usage and Configuration
-----------------------
Load after GunBonsai. Configuration options can be found in the GunBonsai menu
after all the main options. Settings are as followed:
Enable 'Rapid Swing' Upgrade: Toggles offering Rapid Swing as a weapon upgrade.
Note, if disabled after taking levels, it will not disable the upgrades you
currently have, but you will not be offered further levels. Default 'Yes'.
Melee Detection Mode: How weapons are detected as being "Melee". Options are
as follows:
Modern (Ammo Based): If a weapon doesn't use ammo, it is classified as a melee
weapon.
Classic (Flag Based): Uses the "bMELEEWEAPON" flag to decide if a weapon is
melee or not.
GunBonsai currently uses the "Modern" method to decide if Rapid Fire is valid
for a weapon. I prefer using the "Classic" style, as I find it to be more
accurate. Defaults to "Modern".
Rapid Fire Max Level: As advertised, caps the level of "Rapid Fire" to this
value. Defaults to 10, which replicates the original max increase of 6x.
Rapid Swing Max Level: As advertised, caps the level of "Rapid Swing" to this
value. Default 5 to max out at 2x speed.
Note: Rate is how many levels to increase firing by 1x
Eg: For Rate 4, Level 2 = 1.5x, Level 4 = 2x, Level 8 = 3x
Rapid Fire Rate of Increase: Determines how much speed increase per level you
gain, as outlined above. Defaults to 2 (+50%) to replicate original upgrade.
Rapid Swing Rate of Increase: Same as above, but for Rapid Swing.
Defaults to 5 (+20%).
Todo
----
Feature complete for now.
Compatibility
-------------
Haven't tested this with multiplayer, but since it's based on the original, I
don't see a reason why it wouldnt work.
License
-------
So long as you don't step on GunBonsai's Licencing, you are free to use the
code for whatever you like, for any reason. Credit is appreciated, but not
needed.
Screenshots
---------------
Later maybe.
Spoiler:Mini-Addons
SoM GunBonsai Patch: DRLAX Personal ECM Fix Version 1.0
[PATCH] for GunBonsai 0.10.6 ONLY!
-------------------------------------------------------
Download: https://drive.google.com/file/d/1dfjwmZ ... sp=sharing
Fixes a VM Abort with DRLAX and Personal ECM. The simple explaination of the bug
is, DRLAX has an actor called "DRLAX_ObtainFX", which uses the "tracer" pointer
to cause items to fly toward the player. Personal ECM sees this as a projectile
and reassigning the "tracer" field causes the VM Abort, so I just patched in a
check for this actor and ECM now ignores it.
Changelog
---------
Version 1.0:
-Initial release
Usage and Configuration
-----------------------
Load after GunBonsai. No configurable settings. Just load'n'go!
Compatibility
-------------
Haven't tested this with multiplayer, but since it's based on the original, I
don't see a reason why it wouldn't work.
License
-------
You are free to use the code for whatever you like, for any reason, so long as
it doesn't step on GunBonsai's Licence. It's literally just adding a single
check, so... Credit is appreciated, but not needed.
Screenshots
---------------
Nope. Just a bugfix.
Not full blown things, but minor tweaks that mostly leverage special lumps and what not, so no screenshots or readmes and what not.
Spoiler:Archives
GunBonsai Mini-Addon: Scavenger uses Angelic Aviary Angelic Shards
-------------------------------------------------------------
Download: https://drive.google.com/file/d/1h5XX2D ... sp=sharing
Modification to drop Angelic Shards instead of GunBonsai's built in actors for
the Scavenger bonuses. To work, "Use builtin actors for Scavenge drops" in
GunBonsai's setting needs to be "On". Please note, the Angelic Shards are
still subject to the Scavenger's scaling values, despite the Life Shard saying
that it's max value is 250.
GunBonsai Mini-Addon: War Trophies Ignores DOT Kills
----------------------------------------------
Download: https://drive.google.com/file/d/1p4fdJY ... sp=sharing
A simple addon that leverages War Trophies special lump's to not track
damage-over-time kills from GunBonsai's Poison and Acid Elements.
GunBonsai Mini-Addon: No Elemental Upgrades Version 1.0
--------------------------------------------------
Download: https://drive.google.com/file/d/1BNg4vj ... sp=sharing
Simply uses the BONSAIRC lump to disable all of the elemental upgrades, should
you want to play a less "magical" run through.
GunBonsai Mini-Addon: No Bandoliers Upgrade Version 1.0
--------------------------------------------------
Download: https://drive.google.com/file/d/1pemhNo ... sp=sharing
Simply uses the BONSAIRC lump to disable the Player Upgrade "Bandoliers", in
case you're using a gameplay mod that it doesn't work with, or you are using
my Addon "Ammo Reserves", and don't want both upgrades offered.
GunBonsai Addon: Elemental Upgrades Only Version 1.0
----------------------------------------------------
Download: https://drive.google.com/file/d/13eEufY ... sp=sharing
Utilizes the BONSAIRC lump to have it only offer Elemental Upgrades for your
weapons. Does not change available player upgrades.
GunBonsai Addon: No Weapon Upgrades Version 1.0
---------------------------------------------------
Download: https://drive.google.com/file/d/1jnNfGj ... sp=sharing
Leverages the BONSAIRC to disable all weapon upgrades, leaving only Player
upgrades.
GunBonsai Mini-Addon: Ultra Crispy RC Lump Version 1.0
------------------------------------------------------
Download: https://drive.google.com/file/d/1lk3emK ... sp=sharing
Utilizes the BONSAIRC lump to merge single and dual wield weapons. Make sure you
set "Weapon upgrades bind to" to "Weapon Class" in GunBonsai settings.
Things that are no longer being supported, but I will keep around for posterity.
Spoiler:
SoM GunBonsai Upgrade: Rapid Swing Version 1.4: https://drive.google.com/file/d/1b8q7W2 ... sp=sharing
SoM GunBonsai Patch [0.10.6]: LegenDoom Rapid Fire Fix Version 1.1: https://drive.google.com/file/d/1LXzgdP ... sp=sharing
SoM GunBonsai Patch [0.10.6]: DRLA Rapid Fire Fix Version 1.1: https://drive.google.com/file/d/1CanC2k ... sp=sharing
