FriendlyHUD for KF2: Commands, Presets and Layout Settings

FriendlyHUD (FHUD) is a Workshop mod that shows your teammates' health, armor and buffs on screen. Its settings are all console commands, run with the tilde key or F3. This page condenses the mod's command documentation. For other console usage see the console command reference and the UKFP options reference, which can also load FriendlyHUD with ?LoadFHUD=1.

Testing your layout offline

1. In the console load a solo game: open KF-Nuked?mutator=FriendlyHUD.FriendlyHUDMutator
2. Enable god mode: enablecheats|god|togglezedsignoreme
3. Spawn bots where you look: DebugFHUDSpawnBot. Pressing F4 pauses all game logic (including FHUD) so the bots are not attacked.

You can also edit My Documents\My Games\Killing Floor 2\Config\KFFriendlyHUD.ini (close the game first).

General settings

Command	Default	Meaning
SetFHUDEnabled <bool>	true	Enable or disable FHUD
SetFHUDOnlyForMedic <bool>	false	Visible only when you play as Medic
SetFHUDIgnoreSelf <bool>	true	Hide your own health bar
SetFHUDIgnoreDeadTeammates <bool>	true	Hide dead teammates
SetFHUDMinHealthThreshold <float>	1.0	Hide players above a health ratio
SetFHUDSortStrategy <strategy> <descending>	none, false	Sort by none, health or healthregen
SetFHUDOpacity <float>	1.0	Opacity multiplier for all colors (most colors have alpha 192, so 1.33 reaches full)
SetFHUDDynamicOpacity <P1> <P0> <T0> <T1>	1.0 1.0 4.0 0.0	Lowers the opacity of full-health players on a cubic curve, e.g. 0.6 1.0

Presets

• Colors: LoadFHUDColorPreset <name> with default (green health, navy armor), classic (light blue health, saturated blue armor), red (beta-style red health), purple, blood (red health, dark red armor), redregen and gradient (red-yellow-green dynamic colors).
• Layout: LoadFHUDPreset <name> with default, 1080_l4d, 1440_l4d, 1080_column2, 1440_column2, 1080_left, 1440_left, 1080_topright, 1440_topright, 1080_right and 1440_right. The 1080_ presets are meant for 1080p but work on any resolution; use 1440_ for 1440p and above.
• Bars: LoadFHUDBarPreset <name> with default, 1080_block5, 1440_block5, 1080_block10, 1440_block10, 70-30, barcode and stairs.

Color settings

Each takes <R> <G> <B> <A = 192> bytes: SetFHUDShadowColor (0 0 0 192), SetFHUDIconColor, SetFHUDNameColor, SetFHUDFriendIconColor, SetFHUDFriendNameColor (51 222 44 255), SetFHUDArmorColor (0 100 210), SetFHUDHealthColor (0 192 0), SetFHUDHealthRegenColor (0 70 0), SetFHUDBuffColor, the BG colors (SetFHUDArmorBGColor, SetFHUDHealthBGColor, the Empty BG variants; 16 16 16 192), and SetFHUDCDReadyIconColor (0 210 120) and SetFHUDCDNotReadyIconColor (255 0 0). SetFHUDFriendNameColorEnabled <bool> (false) switches the friend name color on.

Dynamic colors

• SetFHUDDynamicColorsStrategy <lerp|static|unset> controls health color transitions; SetFHUDDynamicRegenColorsStrategy <lerp|lerpregen|static|unset> does the same for regenerating health.
• AddFHUDColorThreshold <float> <R> <G> <B> <A> adds or sets a transition point; SetFHUDRegenColorThreshold, RemoveFHUDColorThreshold, MoveFHUDColorThreshold <old> <new> and ClearFHUDColorThresholds manage them.

Bar settings

By default health and armor bars are one block each. SetFHUDBlockCount splits them; lower the block size so the bar does not fill the screen. Prefix block commands with health or armor (for example SetFHUDArmorBlockSize, SetFHUDHealthBlockSize) to control each bar separately.

Main commands: SetFHUDBarGap (-1), SetFHUDBlockProportions <width> <ratios> (for example 200 0.7,0.3 or 200 0.2,0.2,0.2,0.2,0.2), SetFHUDBlockSize <w> <h> [index] (200 8), SetFHUDBlockWidth, SetFHUDBlockHeight, SetFHUDBlockRatio <ratio> <index> (use SetFHUDDrawDebugRatios 1 to see them), SetFHUDBlockCount (1), SetFHUDBlockGap (2), SetFHUDBlockAlignY (top, bottom, middle), SetFHUDBlockOffsetX/Y, SetFHUDBlockRoundingStrategy (default, round, ceil, floor) and SetFHUDBlockOutline (one to four values). Icon and name: SetFHUDIconSize (32), SetFHUDIconOffset, SetFHUDIconGap (4), SetFHUDNameScale, SetFHUDNameMarginX/Y, SetFHUDFriendIconEnabled, SetFHUDFriendIconSize (24), SetFHUDFriendIconGap, SetFHUDFriendIconOffsetY, SetFHUDBarWidthMin (122). The ClearFHUDBlockDimensions, ClearFHUDBlockRatios and ClearFHUDBlockOffsets commands remove overrides.

Buff settings

SetFHUDBuffLayout (none, left, right, top, bottom; default left), SetFHUDBuffSize (8), SetFHUDBuffMargin (2), SetFHUDBuffGap (3), SetFHUDBuffOffset (0), SetFHUDBuffCountMax (3) and SetFHUDForceShowBuffs <bool> (shows buffed players even above the min health threshold).

Layout settings

SetFHUDScale (1), SetFHUDLayout (bottom, left, right), SetFHUDFlow (column or row), SetFHUDItemsPerColumn (3), SetFHUDItemsPerRow (5), SetFHUDMaxItemCount (-1, useful with sorting), SetFHUDReverseX, SetFHUDReverseY, SetFHUDItemMarginX (14), SetFHUDItemMarginY (5), SetFHUDOffsetX and SetFHUDOffsetY. Items flow left to right and off screen unless you set ItemsPerRow to 1 and ReverseX to true.

Miscellaneous

SetFHUDShowHelpNotification (false), SetFHUDUpdateInterval (0.5 s), SetFHUDNameTruncationEnabled (true), SetFHUDEmptyBlockThreshold (0) and SetFHUDSelfSortStrategy (first, last, unset).

Manual mode

Press K to toggle manual mode, then W, A, S and D change the selection, hold Shift to move the selected player's element, press Ctrl to toggle its visibility, and hold Alt to override visibility outside manual mode. You can override the default binds with config files: extract the author's default config archive to My Documents and edit My Games\KillingFloor2\Binaries\cfg\. OnLoadFHUD.cfg runs when joining a server with FHUD and OnUnloadFHUD.cfg runs when leaving (optional, for restoring binds).

Compatibility

• Unofficial Mod: SetFHUDUMCompatEnabled (true) overrides its HMTech cooldown HUD to prevent layout conflicts, so re-enable that setting manually with UMHMTechChargeHUD 0; SetFHUDUMColorSyncEnabled (true) syncs its color scheme.
• Controlled Difficulty: SetFHUDCDCompatEnabled (true; supported by Akathiiro313's CD build and Controlled Difficulty Eternal) and SetFHUDCDOnlyTraderTime (false) to show FHUD only during trader time.

Debug and reset

Debug: SetFHUDDrawDebugLines, SetFHUDDrawDebugRatios, SetFHUDDebugForceFriend, DebugFHUDSpawnBot <name> <perkIndex> <isEnemy> <godMode>, DebugFHUDSetArmor <armor> [max] and DebugFHUDSetHealth <health> [max] (cheats only).

Reset: ResetFHUDConfig (everything), ResetFHUDLayout, ResetFHUDColors and ResetFHUDBar.