needle swapper
A small mod that allows you to change which Needle upgrade Hornet uses.
why?
i want to be able to downgrade my needle so bosses don't die so quickly!
(e.g. cleaning up optional bosses, Godhome)
how?
- with the Needle selected in the Inventory menu:
- use the Sprint input (default:
c; use the Attack input on controller) to "downgrade" the needle
- use the Jump input (default:
z; equivalent on controller) to "upgrade" the needle
- ranges from the following (from downgraded to upgraded):
- unmodded needle (i.e. what you have without the mod) ← default setting
- needle
- sharpened needle
- shining needle
- hivesteel needle
- pale steel needle
- "downgrading" all the way uses your default needle upgrade
- by default, you cannot "upgrade" past your current max upgrade level
- e.g. if you've upgraded to Shining Needle via the Pinmaster (i.e. vanilla), you'll be capped at Shining Needle until you obtain Hivesteel Needle via the Pinmaster
- it (should!) be safe to upgrade your needle as if this was not installed
- e.g. if you have Hivesteel Needle but are using Sharpened Needle via the mod, Pinmaster will still unlock the Pale Steel Needle when you give him Pale Oil
- the mod's internal tracker can still increase to the last possible upgrade, so you may need to hit the "downgrade" input multiple times to see a change
- e.g. if you're capped at Shining Needle but have spammed "upgrade", you may need to "downgrade" multiple times before Shining Needle becomes Sharpened Needle
- this is because the
targetNeedleUpgradeLevel is shared across save files
- this is mostly mitigated by
capTargetToObtainedUpgradeLevel
- you can remove this limit by setting the config option
allowTargetAboveUpgradedLevel to true
Note: config options are only read on game launch, so you may need to relaunch the game to apply changes. Alternatively, you may use the keyboard shortcut home+end (intended for debugging) to reload the config while the game is running.
- only modifies the inventory appearance and damage calculations
- i.e. doesn't (shouldn't) affect completion percentage / game progression; non-permanent
- note: damage calculation is complicated in Silksong because needle damage is multiplied by enemy-specific modifiers dependent on which needle upgrade you have
- this mod should be safe to install and uninstall without affecting your save file at all
- however, you should always make a backup of your save files, just in case
- testing was conducted, but i am only one person
issues? questions? fixes?
- open an issue on the GitHub repository!
- bug reports
- suggestions (e.g. README readability)
- changing BepInEx config options (
BepInEx.cfg) Logging.Console → LogLevels and Logging.Disk → LogLevels to include All allows you to see debug-level logs omitted by the default BepInExPack_Silksong config
- this may be helpful for investigating issues (and attaching
LogOutput.log)
known issues
inconsequential issues (click to show/hide)
- the "Transform" button prompts for "downgrading"/"upgrading" the needle do not update properly if switching between gamepad and keyboard while the needle is selected
- this shouldn't usually come up in regular gameplay, but deselecting and reselecting the needle will resync the prompts with the current control scheme
- there doesn't seem to be a more elegant solution than what is currently implemented
todo
- only allow at bench
- can copy
global::InventoryItemToolManager.CanChangeEquips
- but how implement sit at bench prompt?
- is this even desirable/necessary?
