SoF Buddy 🚀

A modern enhancement suite for Soldier of Fortune 1 — scaling, fixes, and quality-of-life improvements for the best SoF experience.

---

✨ Features

Click to expand

• 🔠 Font Scaling — Crisp, readable fonts at any resolution: 1x, 2x, 3x, 4x, etc.
• 🖥️ HUD Scaling — Scale the HUD independently from the font for perfect UI balance.
• 🎯 Crosshair Scaling — Scale crosshair textures independently for improved visibility.
• 🎯 Restored cl_maxfps in Singleplayer — Enjoy smooth, uncapped framerates without legacy workarounds.
• ⚡ Stable Framerate & CPU Saver — Uses QueryPerformanceCounter for precise timing and energy savings. New cvar: _sofbuddy_sleep.
• 🖱️ Raw Mouse Input — Direct hardware input bypassing Windows acceleration. All original sensitivity cvars still work!
• 🏷️ Widescreen Teamicons GlitchFix — Team icons are always correctly positioned, even in widescreen.
• 🖼️ HD Texture Support — Native support for high-res .m32 textures. Learn more
• 🌙 Lighting Blend Mode Adjustment — Experience WhiteMagicRaven's lighting tweaks (optional).
• 🖲️ Console Size Adjustment — Set how much of the screen the console covers, for any setup.
• 🔄 VSync Reliability — gl_swapinterval is applied on every vid_restart for hassle-free vsync.
• 🛠️ Sane Defaults on First Run — Fixes bad config defaults after hardware changes.
• 🛡️ Console Overflow/Crash Fixes — No more crashes from large pastes or ultra-wide resolutions.

---

🚀 Installation

Click to expand

1. Get SoF Buddy

• Option A: Download pre-compiled release
• Option B: Compile from source:

  make              # Release build (optimized)
  make debug        # Debug build (with logging)
  make debug-gdb    # Debug build with GDB breakpoint function
  make debug-collect # Debug build with func_parents collection

  See docs/DEBUGGING.md for details on build configurations.

2. Prepare Your Game Folder

• Recommended: Delete your User/config.cfg for optimal defaults.
• Extract the release .zip directly into your SoF root (where SoF.exe lives). It contains:
  • sof_buddy.dll (goes in the SoF root)
  • sof_buddy/ folder (created under the SoF root)
    • sof_buddy/funcmaps/ (contains JSON function maps)
    • Windows: sof_buddy/enable_*.cmd scripts and sof_buddy/patch_sof_binary.ps1
    • Linux/Wine: sof_buddy/enable_*.sh scripts and sof_buddy/patch_sof_binary.sh
• Use the helper scripts to patch SoF.exe to load different DLLs:
  • enable_sofplus_and_buddy.cmd → Loads sof_buddy.dll (recommended: SoF Buddy + optional SoF Plus)
  • enable_sofplus.cmd → Loads spcl.dll (SoF Plus only, disables SoF Buddy)
  • enable_vanilla.cmd → Loads WSOCK32.dll (vanilla SoF, no mods)
• SoF Buddy auto-loads spcl.dll if present, so it works with SoF Plus.

---

🕹️ Usage

Click to expand

Enable SoF Buddy (Recommended)

• Windows: Run sof_buddy/enable_sofplus_and_buddy.cmd
• Linux/Wine: Run sof_buddy/enable_sofplus_and_buddy.sh
• This enables SoF Buddy and optionally loads SoF Plus (if spcl.dll is present)

Enable SoF Plus Only

• Windows: Run sof_buddy/enable_sofplus.cmd
• Linux/Wine: Run sof_buddy/enable_sofplus.sh
• This disables SoF Buddy and uses only SoF Plus

Restore Vanilla SoF

• Windows: Run sof_buddy/enable_vanilla.cmd
• Linux/Wine: Run sof_buddy/enable_vanilla.sh
• This removes all mods and restores the original game

---

🍷 Wine/Proton (Linux)

Click to expand

• Recommendation: Use Wine for best fullscreen experience and fewer visual glitches.
• Launch Example:

  wine SoF.exe +set console 1 +set cddir CDDIR #%command%

• Proton Note: Proton ≤ 4.11-13 recommended. Otherwise, adjust sound frequency each startup.
• Raw Mouse Input (_sofbuddy_rawmouse): For true raw mouse input (bypassing system acceleration), you need Proton ≥ 9.0 or GloriousEggroll's custom Proton builds. Standard Wine/wine-staging may still apply system mouse acceleration.
• Optimal FPS Tweaks: Add to base/autoexec.cfg:

  cl_quads 0
  ghl_light_method 0
  ghl_shadows 0
  

  (Note: cl_quads 0 disables many effects.)

---

⚙️ Cvars (Configuration Variables)

Click to expand

Cvar	Default	Description
_sofbuddy_classic_timer	0	Use classic timer (set at launch, for vsync/old systems)
_sofbuddy_high_priority	1	Set process priority to HIGH (set to 0 for NORMAL)
_sofbuddy_font_scale	1	Font scaling multiplier (1x, 2x, 3x, ...)
_sofbuddy_hud_scale	1	HUD scaling multiplier
_sofbuddy_crossh_scale	1	Crosshair scaling multiplier
_sofbuddy_console_size	0.35	Console height as % of screen (0-1, 1=fullscreen)
_sofbuddy_sleep	1	Enable CPU-saving sleep
_sofbuddy_sleep_jitter	0	Frame squashing for missed frames (desperate use only)
_sofbuddy_sleep_busyticks	2	1ms busyloop ticks (lower = less CPU, 0 = stutter)
_sofbuddy_minfilter_unmipped	—	Texture filtering
_sofbuddy_magfilter_unmipped	—	Texture filtering
_sofbuddy_minfilter_mipped	—	Texture filtering
_sofbuddy_magfilter_mipped	—	Texture filtering
_sofbuddy_minfilter_ui	—	Texture filtering
_sofbuddy_magfilter_ui	—	Texture filtering
_sofbuddy_lighting_overbright	0	Enable overbright lighting (1 = on)
_sofbuddy_lighting_cutoff	64	Lighting cutoff value (float)
_sofbuddy_water_size	64	warp polygon size - energy swirl frequency (polygonsize smaller=faster) (minimum: 16)
_sofbuddy_lightblend_dst	GL_SRC_COLOR	Lightmap blend func (see OpenGL docs)
_sofbuddy_lightblend_src	GL_ZERO	Lightmap blend func (see OpenGL docs)
_sofbuddy_shiny_spherical	1	should shiny gl_detailtexturing change with viewangles?
_sofbuddy_rawmouse	0	Enable raw mouse input (1 = on, bypasses Windows acceleration)

• See OpenGL glBlendFunc docs for blend values.
• If _sofbuddy_lighting_overbright is enabled, it overrides blend cvars.

---

🤝 Credits

• WhiteMagicRaven — Lighting blend mode
• d3nd3 — Project lead
• Community — Bug reports, testing, and support

---

📄 License

This project is licensed under the MIT License. See LICENSE for details.

---

💬 Need Help?

• Open an issue
• SoF1.org Forums
• Discord Server: Join our Discord

---

SoF Buddy is not affiliated with Raven Software or Activision. Soldier of Fortune is © their respective owners.