Skip to content

fatalis/hammer-surf-tools

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

82 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Surf Tools for Hammer++ (Build 8870)

A mod of Hammer++ with surf-related features.

Features

Clip Angle Measurer

  • When using the clipping tool, it will show the surf angle if it's surfable.
  • Toggle: press o.

Ramp Angle Measurer

  • When selecting a solid (not an entity or group), it will show the surf angle for each surfable face.

Curved Ramp Generator

  • Generates a curved ramp from a start segment and inputting curve, direction, degrees, and number of segments.
  • Usage: Select a start segment that’s not rotated, then press Alt + Shift + R.

Trigger Generator

  • Creates triggers by extruding from selected faces.
  • For now they are hardcoded to be 2 unit tall trigger_teleport.
  • You can press Alt + Enter after to set the teleport destination in bulk.
  • Usage: Select some faces with the texture tool, then press Alt + Shift + T.

Angle Fix

  • Requires compiling with vbspplusplus.exe from the Tools++ compilers (for func_detail_illusionary)
  • Usage: Select worldbrush rotated ramps and press Alt + Shift + A.

Face Extruder

  • Allows you extend a brush by face. Useful for extending rotated ramps.
  • Usage: Point at the end of a ramp in 3D view and press Alt + Shift + E. Move the mouse in either 3D or 2D views to extrude. Press the hotkey again to stop. Intrude/shrinking isn't currently supported.

About Angle Steepness Rating

When you see ratings like 5/10 with the angle measure tools:

  • 5/10 → "Sweet spot" (~50 degrees)
  • 0/10 → Just barely surfable
  • 10/10 → Ranges from "probably too steep to be fun" all the way to "almost too steep to stay on the ramp"
  • This may be tweaked in the future.

Notes

  • There’s also a context menu in Tools → Surf Tools and in the right-click context menu.
  • Support for Hammer++ builds beyond 8870 will be added when they're released.

Installation

  1. Make sure you have Hammer++ Build 8870.
  2. Download the latest hammer-surf-tools_*.zip file from https://github.com/fatalis/hammer-surf-tools/releases/latest
  3. Extract version.dll to the directory where you have hammerplusplus.exe.

Linux

  • Use this environment variable:
WINEDLLOVERRIDES="version=n,b"

Preview Build (Latest Commit)

https://nightly.link/fatalis/hammer-surf-tools/workflows/build/main

About

Surf Tools for Hammer++

Resources

License

Stars

Watchers

Forks

Contributors