/HollowKnight.BenchwarpMod

Mod to adjust bench respawn location ingame

Primary LanguageC#GNU Lesser General Public License v2.1LGPL-2.1

HollowKnight.BenchwarpMod

Mod which creates a clickable menu on the pause screen to alter your current bench respawn point. Use warp button (or save and quit) after selection to travel to new bench. By default, only benches visited after installing the mod can be destinations.

Options

  • Warp Only: removes bench selection menu
  • Unlock All: enables all benches on the selection menu
  • Show Room Name: displays the name of the current room from the game code in the bottom left
  • Max Displayed Room Names: if Show Room Name is enabled, show up to this many additional loaded rooms
  • Use Room Names: bench menu uses room names from the game code instead of descriptive names
  • Enable Deploy: adds a menu to place a custom bench point
  • Always Toggle All: all bench menus are displayed by default
  • Doorwarp: replaces bench menu with a menu for selecting scene transitions (area=>room=>door).
    • While active, the Warp button can only be used to warp to the selected transition, and will not warp to respawn.
    • The Flip button is used to change selection to the (vanilla) target of the currently selected transition.
  • Enable Hotkeys: lets you warp to benches by typing a short key sequence rather than clicking the menu

Deploy

  • Deploy button: places a bench at the current location
  • Set: alters your respawn/warp point to be your currently deployed bench
  • Near Style: select your preferred bench sprite which fades in when the hero is near the bench
  • Far Style: select your preferred bench sprite which shows when the hero is away from the bench
    • For safety, styles cannot be changed while benched.
  • Options:
    • Cooldown: adds a 300s cooldown to the deploy button
    • Noninteractive: deployed bench cannot be interacted with, except via warping (e.g. preventing use during boss fights)
    • No Mid-Air Deploy: the game must recognize the player as grounded in order to deploy
    • No Dark Rooms or Dream Rooms: prevents use of deploy in Dream World rooms, and if the player does not have lantern, prevents use of deploy in rooms which are dark
    • [Obsolete] Reduce Preloads: when the game starts up, only the selected style is preloaded. To use other styles, the player must restart the game.
      • As of version 3.0, Reduce Preloads is no longer a setting, and only one bench is preloaded by default.
    • No preloads: no bench styles are preloaded. The deploy button instead will create a respawn marker. To deploy benches, the player must change the setting and restart the game.
    • Apply Style To All: applies the selected styles to base game benches. Requires a scene reload to take effect. Not all benches are supported.

Bench Hotkeys

  • Each of the following combinations is equivalent to clicking the corresponding bench button, and then the Warp button in Bench Warp mode. In other words, a code for an unselectable bench will result in warping to the current respawn. Hotkeys only perform bench warps; this holds even if the current setting is set to Door Warp mode.
  • NM: Nailmaster Mato
  • DM: DirtMouth
  • FC: Forgotten Crossroads Stag
  • FS: Forgotten Crossroads Hot Springs
  • SM: Ancestral (Shaman) Mound
  • SA: SAlubra
  • BE: Black Egg
  • GW: Greenpath Waterfall
  • SS: Stone Sanctuary
  • GT: Greenpath Toll
  • GP: GreenPath Stag
  • LU: Lake of Unn
  • NS: Nailmaster Sheo
  • TA: Teacher's Archives
  • QS: Queen's Station
  • LE: Leg Eater
  • BR: BRetta
  • MV: Mantis Village
  • CQ: City Quirrel
  • CT: City Toll
  • CS: City Storerooms
  • WS: Watcher Spire
  • KS: King's Station
  • PH: Pleasure House
  • WW: WaterWays
  • GA: Godhome Atrium
  • GR: Godhome Roof
  • HG: Hall of Gods
  • DS: Deepnest Hot Springs
  • FT: Failed Tramway
  • BD: Beast's Den
  • BT: Basin Toll
  • HS: Hidden Station
  • NO: Nailmaster Oro
  • EC: Edge Camp
  • CF: Colosseum of Fools
  • BB: Hive (bee-bee)
  • PD: Peak Dark Room
  • CG: Crystal Guardian
  • RG: Resting Grounds Stag
  • GM: Grey Mourner
  • QC: Queen's Gardens Cornifer
  • QT: Queen's Gardens Toll
  • QG: Queen's Gardens Stag
  • PE: Palace Entrance
  • PA: Palace Atrium
  • PB: Palace Balcony
  • UT: Upper Tram
  • LT: Lower Tram
  • LB: Last Bench (equivalent to just clicking Warp)
  • SB: Start Bench (equivalent to clicking Set Start, then Warp)
  • WD: Warp to Deployed Bench (equivalent to clicking Set in the Deploy submenu, then Warp)
  • TM: Toggle Menu (equivalent to clicking Show Menu in the Benchwarp submenu in the Mods menu)
  • DW: Door Warp (equivalent to clicking Door Warp in the Settings menu)
  • DB: Deploy Bench (equivalent to clicking Deploy in the Deploy submenu)

Each hotkey can be remapped by modifying the "hotkeyOverrides" dictionary in the mod's global settings file (Benchwarp.GlobalSettings.json, in your saves folder). This dictionary should map the default bindings to their replacements. For example, "hotkeyOverrides": {"BB": "HV"} remaps the Hive bench to use the hotkey "HV". Custom hotkeys must be composed of exactly two uppercase letters.

Credits homothety - main developer PimpasPimpinela - hotkey support! Serena - developed the UI, as part of DebugMod Serena and 5FiftySix6 - developed the Warp method, as part of this mod The Embraced One - originally created the menu assets, as part of DebugMod

Benchwarp is licensed under LGPL. Source code and license can be found at https://github.com/homothetyhk/HollowKnight.BenchwarpMod/