TheTimesweeper-HitboxViewerMod icon


Shows you Hitboxes and Hurtboxes. Now with CharacterMotors! Melee attacks, Projectiles, DOT zones, Blast attacks, Bullet attacks, oh my!

Last updated 4 months ago
Total downloads 3832
Total rating 3 
Categories Mods Tools Client-side
Dependency string TheTimesweeper-HitboxViewerMod-1.5.3
Dependants 0 other mods depend on this mod

This mod requires the following mods to function

bbepis-BepInExPack-5.4.9 icon

Unified BepInEx all-in-one modding pack - plugin framework, detour library

Preferred version: 5.4.9
RiskofThunder-HookGenPatcher-1.2.3 icon

MMHOOK generation at runtime.

Preferred version: 1.2.3


look at em

acrid hitboxes you can now


  • Puts cubes on OverlapAttack hitboxes, so melee attacks and most projectiles.
  • Puts spheres where BlastAttacks happen.
  • Puts cylinders along the paths of BulletAttacks (yes they have a width).
  • Puts all kinds of shapes on character's hurtboxes. (disabled by default)
  • Puts a cylinder at your character's CharacterMotor (their collision with the environment and other characters
  • Can toggle hitboxes and hurtboxes separately.
  • Can press semicolon key(configurable) to temporarily disable all.

How to Use

  • Just install and you'll see hitboxes!
  • Use configs to enable or disable hitboxes and hurtboxes individually.
  • use the command: show_hurtboxes 1 to enable, show_hurtboxes 0 to disable, or simply show_hurtboxes to toggle
    • likewise for the command: show_hitboxes
    • likewise likewise for the command: 'show_motors`
  • By default attack Hitboxes are on and character Hurtboxes are off.
  • If you have the mod RiskOfOptions installed, you can simply toggle these options in the settings menu!
  • Press semicolon to override settings and disable all hitboxes and hurtboxes temporarily.


  • Make sure you press semicolon key to disable hitboxes later in runs when the framerate starts to howl in agony
  • By default, Merc's hitboxes (and some other characters) are toned down for safety for your eyes (you can turn this off in config (don't if you have epilepsy)).
  • Blast attacks are only active for one frame, but the sphere will linger for a bit
    • Same with bulletattacks
  • Use Lingering Bullets mode to examine things like bullet spreads
    • or just grab 100 syringes and paint a pretty picture c:

Any feedback/issues, ping/message me (TheTimesweeper#5727) on the ror2 modding discord or the enforcer discord (, love ya



  • CUM2 coolfix, post R2API
  • added commands back
  • fixed compatibility with RiskOfOptions
  • separated CharacterMotor to its own setting/command/config


  • CUM2 hotfix, pre R2API
    • removed commands
    • added configs in their place
  • added support for CharacterMotors. Shares settings with hurtboxes


  • fixed bullet hit points shrinking before disappearing when not in linger mode
  • removed annoying bullet hit points that happen at the very beginning of the bullet attack
  • updated bullet cylinder model with an empty starting face
  • added some optimized sphere and cylinder hitbox meshes for when hitboxes are really small and don't need the detail
  • adjust stuff idk


  • fixed bullet attacks not actually being as thicc as they're supposed to be
  • added hit points to bulletattacks
    • added lingering bullet mode (Slash key)
  • added some configs for bullet attack colors
  • added optimized hurtboxes config
  • changed config section names
    • highly I recommend deleting existing configs cause they'll get real messy
  • removed some funny spaghetti code


  • added bulletattacks cause I'm working on enforcer's guns but don't tell anybody
    • I really thought overlapattacks, blastattacks, hurtboxes covered like everything, what else?
    • someone fork this and do buffwards for me
  • added descriptions to RiskOfOptions options


  • moved back to r2api now that the CUM storm has blown over
  • didn't fix RiskOfOptions compat cause already workin who knew
  • fucked with the icon's colors again as I've done like every release for no reason :P


  • anniversary update, moved over to new api
  • moved RiskOfOptions to a soft dependency and added console commands in its place
  • but that mod conflicts with enigmaticthunder so right now I have a soft dependency that doesn't do anything


  • after testing, it did not improve performance, everything i know is a lie, removed object pools for now
  • added ursa to default toned down characters


  • blast hitbox revealers are now pooled, should improve performance
  • added chat log to hitbox toggle key


  • fixed blastattackhitboxes not lingering as i said it would so i lied i'm sorry pls forgive me


  • added blastattacks
  • I really thought i'd just shit out the overlapattack hitboxes and just not get around to the others for a while, suddenly 1.0 who'da thought


  • added risk of options menu (thanks Rune for the help (and for your mod in general))
  • removed "show hurtbox" from config since it's in the settings menu now
  • retconned changelog version numbers to make a lil more sense


  • added hurtboxes


  • c:
  • (fixed up configs and released)


  • tried and failed to make an object pool (look at the code on github and laugh. LAUGH)


  • added hitboxes

Available versions

Please note that the install buttons only work if you have compatible client software installed, such as the Thunderstore Mod Manager. Otherwise use the zip download links instead.

Upload date Version number Downloads Download link  
2022-3-14 1.5.3 776 Version 1.5.3 Install
2022-3-3 1.5.2 404 Version 1.5.2 Install
2021-10-5 1.5.1 756 Version 1.5.1 Install
2021-9-4 1.5.0 291 Version 1.5.0 Install
2021-9-3 1.4.0 74 Version 1.4.0 Install
2021-4-16 1.3.1 409 Version 1.3.1 Install
2021-4-1 1.3.0 284 Version 1.3.0 Install
2021-2-6 1.0.1 347 Version 1.0.1 Install
2021-2-4 1.0.0 141 Version 1.0.0 Install
2021-2-3 0.3.0 127 Version 0.3.0 Install
2021-2-3 0.0.4 119 Version 0.0.4 Install
2021-2-2 0.0.3 104 Version 0.0.3 Install