GModPatchTool _{Formerly GModCEFCodecFix}

GModPatchTool does what Facepunch don't!

Created by Solstice Game Studios (www.solsticegamestudios.com)

🛠️ Patches We Apply

All Platforms

• Fixes various launch/missing main menu issues on macOS and Linux
• Adds -chromium_fps_max Launch Option for GMod
  • Allows setting a maximum internal FPS limit for ALL CEF web panels
  • May improve game framerate in exchange for less web content framerate
  • Default is 60
• Improves the Legacy VGUI Theme with our custom SourceScheme.res
• Replaces Debug/Console fonts with PT Mono to improve consistency/readability across platforms
  • This is particularly important for Proton, where text using those fonts are broken/tiny out of the box (no Lucida Console)
  • If you don't like the theme changes or the font replacement, you can disable those patches by using the --no-sourcescheme argument when running the tool

In-Game Web Browser (Chromium Embedded Framework, aka CEF)

• Updates CEF to 137.0.10 (Chromium 137.0.7151.69)
• Enables Proprietary Video/Audio codec, like H.264 (MP4) and AAC, support
• Enables Widevine support (but no VMP, so Netflix et al. don't work currently...)
• Enables Software WebGL
• Enables partial GPU acceleration
• Improves performance for texture updates
• Disables Hardware Media Keys control of media
• Re-enables Site Isolation (security feature; some sites require it to function)

Linux

• Can fix Steam Overlay/MangoHud/etc not working
  • Put GMOD_ENABLE_LD_PRELOAD=1 %command% in GMod's Launch Options to try it!
  • This is disabled by default because it could just crash GMod instead
• Sets mesa_glthread=true for more OpenGL performance with Mesa drivers
• Sets DRI_PRIME=1 to automatically use the Dedicated GPU with Mesa drivers in Laptops
  • For Nvidia proprietary driver users: Please use the prime-run command, or look at hl2.sh after patches are applied
• Sets ulimit -n $(ulimit -Hn) to fix issues opening/mounting many files (many addons, Lua autorefresh, etc)

❓ Players: How to use

Download the Latest Release and run the application.

Need a more in-depth guide? Take a look at https://www.solsticegamestudios.com/fixmedia/

👩‍💻 Developers: How to use

Direct players to follow the Players' instructions above. This patch is CLIENTSIDE only!

To Detect Patched CEF: Check out our Lua detection example.

Warning

Our CEF builds have Site Isolation enabled, which means you must pay attention to where you're calling JavaScript-related DHTML functions!

If you call DHTML.AddFunction, DHTML.QueueJavascript, or DHTML.RunJavascript before the page begins loading, it WILL NOT WORK! Make sure you're calling them in DHTML.OnBeginLoadingDocument or later.

Site Isolation destroys JavaScript state is on navigation like how real web browsers work.

This tool includes a patch for mainmenu.lua that addresses GMod's own issues not using the correct approach, but this is a breaking change for any addon that doesn't handle HTML panel states properly for JS.

If you want to go more in-depth: Check out our fork of gmod-html and our CEF build scripts.

📢 Need Help / Contact Us

• Read the FAQ: https://www.solsticegamestudios.com/fixmedia/faq/
• Discord: https://www.solsticegamestudios.com/discord/
• Email: [email protected]

💖 Help Support Us

This project is open source and provided free of charge for the Garry's Mod community.

If you like what we're doing here, consider throwing a few dollars our way! Our work is 100% funded by users of the tool!