dev

Support me: Learn how you can support more updates to mastercomfig!

How to install: Instructions on setting up mastercomfig initially and get it working with your custom files.

How to update: Instructions on updating mastercomfig after you've already installed it.

---

This is the latest automated dev build.

Docs

---

View the code changes

9.10.3

Highlights: optimizations for 64-bit and bug fixes

Support me: Learn how you can support more updates to mastercomfig!

How to install: Instructions on setting up mastercomfig initially and get it working with your custom files.

How to update: Instructions on updating mastercomfig after you've already installed it.

---

What's changed

comfig 10 is coming soon...

Click to watch the video on YouTube.

New comfig server available

This server is a vanilla TF2 server with some experimental settings and optimizations for testing purposes.

Connect and play using https://comfig.app/connect/ or connect tf.comfig.app in console.

Comfig Base

• Updated the default webpage for mastercomfig from mastercomfig.com to comfig.app. mastercomfig.com will be slowly phased out in the coming months, in favor of comfig.app, which has better performance and support for more features.
• Removed -noquicktime from launch options, as QuickTime support has been removed from the game
• Further optimized occlusion settings
  • Respect mapmaker optimizations, while giving a worthwhile floor to ensure we are not aggressive with culling out occluders.
• Increased heap size from 320MB to 720MB
  • With 64-bit, we can use the larger heap size without worrying about out of memory scenarios.
• Changed max capture resolution from 4096 to 2048 for monitors and water to be more friendly with the GPU
• Enabled early Z pass, improving GPU performance
  • Improved CPU headroom from the 64-bit update makes this more worthwhile to enable globally.
• Enabled mesh buffering on Linux
  • This was disabled by the game due to issues with ToGL, now that the game uses Vulkan on Linux, this can be enabled for improved performance.
• Fixed some app configs executing twice
• Fixed crackling on certain audio interfaces
• Fixed some bugs with the config template
• Removed the modules template as the app replaces it
• Completely removed OpenGL optimizations as it is replaced by Vulkan

Modules

Lighting

• Disabled z-buffer light cache due to performance and memory changes made to the base game
  • z-buffer cache used a memory location in the hunk to create a coarse memory lookup for lighting values. This improved performance but also reduced lighting quality. However, the tradeoffs have changed with the 64-bit update, and besides making characters hard to see, this doesn't give the performance increase it used to.
• Restored blocky lightmaps functionality for very_low and low
  • 9.9.2 disabled this functionality due a bug in the base game, which has now been fixed.

Decals

• Reduced max decal count for ultra from 2048 to 512
  • People were encountering rare crashes with the increased amount.

FPS Cap

• Changed default from 1000 FPS to 400 FPS to strike a balance between load times and hitting the cap
  • During loading screens, the engine typically hits the cap constantly, and it is wasteful on resources to render 1000 FPS on loading screens, causing slow downs for map loading as well.

HUD Player Model

• Contributed a performance optimization to the HUD player model to the base game, which removes almost all of its overhead. You can feel free to use it if you were disabling it for performance reasons. It's also been enabled by default on the Medium and Medium High presets.

Addons

OpenGL

• Removed as Vulkan support replaces ToGL

No Tutorial addon

• Updated the list of maps to skip tutorial videos to the latest available maps

Comfig App

• Upgraded the app to a PWA, which improves load times and ensures reliable loading of the latest version of the app
• Fixed an issue where in a random hour each day, the app would fail to download files for a few minutes
• Added screenshot previews to module options
• Added a navigation selector to easily swap between the app, HUDs, and hits
• Updated the homepage for better navigation to the different parts of the site
• Fixed various visibility and styling issues on the site
• Massive performance improvements and usability improvements
• Upgraded font technology for more advanced typography

Binds

• Added a visual layout for mouse
• Fixed an issue with mouse4 and mouse5 binds being flipped
• Fixed a bug with some binds applying incorrectly
• Various minor usability improvements

Crosshairs

• Added crosshair scale and color preview
• Added zoom-specific crosshair for the Sniper Rifle
• Fixed some crosshair options not displaying or applying correctly

Comfig HUDs

• Added Trending, Alphabetical and Editor's Choice pages for improved discovery
• Added support for verified HUDs, which automatically approve their releases. Other HUDs will auto-update to show a pre-release for any not yet approved version.
• Improved submission process
• Improved search bar

Comfig Docs

• Updated Russian translations extensively
• Updated installation instructions for Steam UI updates
• Removed recommendation to "Disable Visual Effects" on Windows for slow PCs, as it changes the compositor and may have bad side effects
• Updated ways to support me
• Added mat_use_compressed_hdr_textures 0 to misconceptions
• Improved how translations are handled
• Updated various docs for the latest updates
• Fixed issues with some notes content
• Fixed typos

Dev

• Updated copyright year to 2024
• Improved builds for docs PRs
• Improved stacktraces for Sentry
• Moved app to TypeScript and increased linting strictness
• Updated prettier settings to improve import control
• Updated dependencies

---

View the code changes

9.10.2

Highlights: performance optimizations and various adjustments

Support me: Learn how you can support more updates to mastercomfig!

How to install: Instructions on setting up mastercomfig initially and get it working with your custom files.

How to update: Instructions on updating mastercomfig after you've already installed it.

---

What's changed

Comfig Base

• Optimized occlusion settings, as previous change was overly broad
• Reduced heap size from 512MB to 320MB
  • This should help with some rare out of memory scenarios we were seeing with the last update.
• very_low_reset now better explains what it has done when run

Modules

Shadows

• Adjusted the robot/Halloween boss shadow distance to be higher on medium and virtually unlimited on ultra
• Increased ultra shadows to have a limit of 160 shadows, which should suffice for all players and other entity objects

Effects

• Now adjusts monitor resolution.
  • Monitors are now functional in TF2, and their resolution is adjustable. A monitor is essentially a camera display of another part of the map, which mapmakers can use for storytelling or gameplay.

Water

• Now adjusts water render resolution. Squeeze out extra performance and memory efficiency on lower settings, and get super detailed, crisp water reflections on higher settings.
• Totally reworked how cheap water is applied, to make it less annoying for the medium settings. Cheap water distance was way too short before and would be detrimental in many situations on many maps.

Post Processing

• Adjusted the way color is calculated into brightness using a more accurate relative luminance formula

Characters

• Adjusted how facial animation smoothing is applied

Decals

• Increased ultra decal limit from 256 to 2048
• Fixed a bug with module echos which didn't print out the level correctly

Model Decals

• Increased ultra decal limit from 32 to 50 per model

Props

• Increased prop distance from 2000 to 8592 for ultra settings, with 400 fade distance instead of 100
  • This should get rid of annoying/noticeable pop-in for grass on ultra settings.
• Increased prop LOD transition dist from 5000 to 5400, to 5000 to 8192 distance

Ragdolls

• Increased fade time of ragdolls on ultra from 10 to 15 seconds, to align with cosmetic fade time

Ropes

• Increased wind simulation distance from 1000 to 8192 for ultra

Voice Chat

• Added hidden level, which allows for muting voice chat without disabling it. Disabling voice chat requires a reconnect to re-enable, so this was added for convenience.

App

• Added HUD, hitsound and killsound directories, to succeed the now offline HUDS.TF
• Added new binds
• Fixed support for spectator/dual action keys for attack and other binds
• Fixed various bind bugs, especially for custom binds
• Fixed incorrect weapon configurations
• Improved security and caching of the website and app
• Tuned the look and feel of the app
• Improved performance with downloading/direct install
  • Parallel download of content
  • Streaming responses
  • Used more efficient data access for files
• Improved error handling and display for downloading
• Fixed app not initializing correctly in some cases
• Fixed scrollbar being tiny on tiny displays like the Steam Deck
• Added backwards compat with Firefox ESR
• Updated explosion screenshots
• Added an Invisible explosion particle option (duck_collect_trail_special_red)
• Updated Tob's crosshairs to the latest available

Docs

• Updated the grammar and style of all of the docs to be more clear and concise
• Migrated docs from huds.tf forums and resources to mastercomfig docs
• Fixed the link for the latest version when on an older version
• Reduced the file size of the screenshots
• Updated Linux optimization instructions to be fully up to date
• Reorganized the credits and see also pages
• Improved documentation for string commands

Dev

• Updated to Contributor Covenant 2.1
• Added debug_skipwaiting to skip waiting for players stage on local servers
• Added debug_lookdev to hide viewmodel and HUD for screenshots and comparing graphics
• Fixed debug_bots not correctly assigning bots on reset sometimes

---

View the code changes

9.10.1

Highlights: performance improvements and new app customization features

Support me: Learn how you can support more updates to mastercomfig!

How to install: Instructions on setting up mastercomfig initially and get it working with your custom files.

How to update: Instructions on updating mastercomfig after you've already installed it.

---

Comfig Base

• Optimized occlusion tweaks to pull back in strictness
• Removed deprecated apply_user, use apply_overrides instead
• Fixed -dxlevel starting the game in a low resolution
• Fixed Intel workaround not being applied to Intel cards properly, removed it from base config
• Renamed post_comfig.cfg to setup_hook.cfg

Modules

Bandwidth

• Removed deprecated 8.0Mbps, use 6.0Mbps instead

Props

• Increased detail prop visibility and reduce detail prop fade on high and ultra

Anti-aliasing

• Added documentation that it may cause rendering errors with Wayland on Linux

Addons

OpenGL

• Disabled base frame sync in favor of native glFlush
• Added comments to OpenGL addon

App

• Enhanced crosshair selector UI to use a searchable, categorized dropdown
• Added previews for weapon customization
• Added Leth, Tob, wavesui, Quake, CPMA crosshair packs
• Added per-class crosshair scale and color customization
• Added support for multiple binds on the same key
• Added download progress bar/text
• Refreshed the app styling to be more modern
• Replaced +showscores with the shorter and equivalent +score command for the "Show scoreboard" action
• Fixed a case where weapon crosshairs wouldn't be used because cl_crosshair_file was set
• Fixed cases of weapon customizations not working properly in-game
• Added better download errors/failures better
• Fixed animation on Customize button arrows not working
• Cleaned up various text instructions for enhanced usability/clarity
• Fixed the "view larger" popup not working on the homepage

Docs

• Updated credits
• Added documentation for all string cmds
• Added documentation for smaller resolution launch options
• Updated hidden cvars
• Updated some documentation to be more in line with the current comfig
• Fixed duplicate search results
• Fixed some images being missing
• Fixed some typos

---

View the code changes

9.10.0

Highlights: app weapons customization and class binds, minor optimizations

Support me: Learn how you can support more updates to mastercomfig!

How to install: Instructions on setting up mastercomfig initially and get it working with your custom files.

How to update: Instructions on updating mastercomfig after you've already installed it.

---

What's Changed

Presets

Low

• Cleaned up texture rendering to be smoother by default, due to the near zero performance benefit and higher usage of texture filtering
  • Turned on texture filtering (textures bumped up from very_low to low)
  • Bumped up texture_filter to trilinear from bilinear

Modules

Packet Size

• Re-enabled packet compression on all levels, due to the potential benefit during connection and near zero gameplay cost
• Renamed packet_size=speed to packet_size=large, due to the change in compression settings
• Removed packet_size=saver, since packet_size=large is equivalent, due to the change in compression settings

App

• Improved instructions to force update the app
• Added weapons customization
  • Customize crosshairs and explosion effects
  • Enable/disable muzzle flashes, tracers and shell ejections
• Added class specific binds support. Automatically manages default vs. class binds
• Added ZIP file downloads when not using Direct Install
• Added download retry and failure handling, to work around intermittent download failures
• Fixed a modules customization navigation error

Docs

• Added translations to navigation
• Enhanced search functionality
• Added linux-tkg to Linux OS optimizations
• Updated various outdated/incomplete information on modules
• Fixed various formatting issues
• Fixed outdated external links
• Fixed redirects from old pages not working
• Added Turkish translations by @patrn27 in #665
• Fixed various typos by @treacherousfiend in #656 and by @Sloofy in #658

Dev

• Added docs linting in GitHub Actions
• Improved build time on dev docs builds
• Remove sider entirely by @micwoj92#2656 in #659

New Contributors

• @Sloofy made their first contribution in #658
• @patrn27 made their first contribution in #665

---

View the code changes

9.9.3

Highlights: bug fixes and ultra textures support

Support me: Learn how you can support more updates to mastercomfig!

How to install: Instructions on setting up mastercomfig initially and get it working with your custom files.

How to update: Instructions on updating mastercomfig after you've already installed it.

---

What's Changed

Comfig Base

• Removed support for the user folder, please use the new overrides folder instead
  • The user folder was deprecated on April 9, 2022 in 9.8.0.
  • This change was made because of the existence of the cfg/user.scr file, which appears as user on some systems, causing confusion.
• Added support for upcoming app customization features
• Fixed bullet impact sounds not being precached
• Fixed a bug where hitsounds may not have played accurately on extremely high framerates

Modules

Textures

• Added ultra level, default on Ultra preset. This uses mat_picmip -10 for highest quality textures.

Docs

• Discord is now the only official help channel due to the support availability on there vs. other sites
• Improved Linux optimizations with more tweaks and better instructions
• Added Windows Defender performance bug fix
• Added documentation for optimizing things other than TF2 (for now Epic Games Store)
• Organized launch options documentation better
• Improved wording of various descriptions across the documentation
• Improved how update dates are calculated on each doc page
• Fixed various Steam Support links to use the new site
• Documented more misconceptions
• Fixed a few bugs with how docs were being deployed
  • Fixed a redirect loop on some browsers
• Updated the custom config list

App

• Improved Direct Install instructions

Development

• Fixed syntax highlighting of .res files on GitHub

---

View the code changes

9.9.2

Highlights: bug fixes

Support me: Learn how you can support more updates to mastercomfig!

How to install: Instructions on setting up mastercomfig initially and get it working with your custom files.

How to update: Instructions on updating mastercomfig after you've already installed it.

---

What's Changed

Comfig

• Updated vote menu configuration for the June 21 patch

Modules

Bandwidth

• Deprecated bandwidth=8.0Mbps. No longer selectable in the UI, and existing usages will redirect to bandwidth=6.0Mbps
  • Just because this is a valid value within Source's raw limits, it does not mean it is a valid value for actual usage. We have observed many problems stemming from this value being too large, and CS:GO which provides bandwidth customization only goes up to 6.0Mbps.

Snapshot Buffer

• Removed snapshot_buffer=low. No longer selectable in the UI, and existing usages will no longer select the module level, and instead default to snapshot_buffer=auto. However, snapshot_buffer_low is still available to manually use: alias snapshot_buffer snapshot_buffer_low.
  • Having an accessible way to set this option didn't make sense, as it was confusing to many people whose network/server conditions would actively make it harmful to select this option. This option should only be reserved for people who are explicitly knowing what they're setting. At this current time, we recommend snapshot_buffer=auto in all cases except for LAN gameplay. This is because it reduces snapshot buffer where it is decently safe and beneficial to do so, while taking advantage of the safer lag compensation of higher values otherwise.

Lighting

• Fixed cases on certain system configurations where certain long stutters in-game (mostly from freezecams) would enter a feedback loop with mastercomfig's workaround to enable blocky lighting (on lighting=very_low and lighting=low).
  • Blocky lighting will no longer work automatically anymore. You will have to enter mat_filterlightmaps 1;mat_filterlightmaps 0 in console yourself every time you join a new map/server.

App

• Improved instructions for when the app needs an update
• Fixed default not being selected when the current user selection doesn't exist

Documentation

• Increased suggested requirements for using -no_texture_stream
• Added information about IO schedulers to the Linux optimization suggestions
• Slightly improved wording/information about native libraries on Linux optimizations

---

View the code changes

9.9.1

Highlights: FPS increases, Spy hitreg improvements, visibility tweaks

Support me: Learn how you can support more updates to mastercomfig!

How to install: Instructions on setting up mastercomfig initially and get it working with your custom files.

How to update: Instructions on updating mastercomfig after you've already installed it.

---

What's changed

Base

• Optimized asset precache to be more aggressive, to reduce stuttering
• Fixed the TF2 bug where taunt models would not appear
• Optimized custom occlusion settings for some edge cases where occluders would not be picked up properly
• Disabled threading affinity, so that the OS can better allocate threads adaptively for the situation
• Tweaked sound cache to opportunistically play sounds within a buffer chunk
• Readded game_overrides_once_c based on community request

Modules

Snapshot Buffer

• Tweaked networking for Spy to hopefully improve hit registration in a variety of sensitive scenarios. Does not fully apply if you use snapshot_buffer=low.
• Added a new level, snapshot_buffer=anim, for those who prefer smoother NPC animation at the cost of reduced competitive viability.

Lighting

• lighting=medium and higher levels no longer use the depth cache, as cached lighting could be inaccurate and cause players to be darker than expected

Docs

• Added new Windows optimization documentation regarding:
  • Disabling NVIDIA Low Latency mode for TF2
  • Fully optimizing performance power plans for better CPU usage
  • Disabling Discord overlay
  • Enabling Image Scaling in your driver
• Reorganized Windows optimizations in order of relevance
• Documentation is now hosted on CloudFlare Pages, like the app. Should reduce downtime and improve speeds.
• Fixed outdated Discord channel name
• Updated Russian translations

App

• Migrated the web app to an entirely new framework, Astro and React
  • This enables faster development, potential for new features and better load times
• Refreshed styling, colors and icons across the app, powered by new updates to core visual frameworks
• Refreshed various parts of the app and website to be more functional
• Improved visibility of the download buttons
• Migrated styling customization to Scss, which makes styling more consistent across the app, especially for customization controls
• Optimized load times through two new technologies: bundling and hydration
  • Bundling optimizes the app so that it only loads what it needs to, and loads things more efficiently
  • Hydration prefills critical data instead of processing during loading
• Fixed the app not receiving updates on some PCs
• Fixed many bugs and errors with app functionality

Known issues

• Offline support has been temporarily removed as we move over to the new system, and will be back, better than ever!
• There may be issues with some browsers or in some loading cases. Please be sure to let me know of anything you encounter!

Upcoming features

Like previously mentioned, this new framework allows app development to introduce new features much more easily and unlocks a lot of potential for the app.

In the next release of mastercomfig 9, barring any more patches, you can expect to see support for class configs, crosshair customization, weapon customization and more advanced keybind setups.

These features are already near completion and are in the polish stage for bug fixing and visual enhancement. I can't wait to see what the community thinks about this, and hope the app becoming a one-stop shop for all TF2 customization provides value to all of you. I'm always open to feedback and new ideas, just let me know what you're thinking of!

---

View the code changes

9.9.0

Highlights: FPS increases, stability improvements and bug fixes

Support me: Learn how you can support more updates to mastercomfig!

How to install: Instructions on setting up mastercomfig initially and get it working with your custom files.

How to update: Instructions on updating mastercomfig after you've already installed it.

---

What's Changed

Comfig base

• Improved config documentation
• Improved server privacy settings
• Slightly optimized cmd ordering for usage priority-based fast path
• Re-introduced prop occlusion optimizations with a tweaked strategy
  • This is the old mastercomfig optimization which chose the top occluders and gathered most relevant occludees
  • Improved filtering of occluders (works around some screen size evaluation bugs)
  • Chooses top 2 occluders (other occluders can sneak in for some reason, so keeping it low to prevent an explosion of occluders)
  • Filters all occludees over 10% screen size (found to be best for relevance)
• Disabled fast Z reject
  • A full z prepass isn't really preferred based upon several factors with TF2.
• Fixed a brightness bug on some drivers when higher post processing is enabled (particularly Intel integrated graphics)

Modules

Snapshot Buffer

• Changed default to auto, to return to a more familiar approach for interp
• Added custom level, which prevents mastercomfig from messing with your interp

Model Quality

• Changed the display name of Level of Detail to Model Quality to reduce confusion

Lighting

• Optimized lighting to use the GPU more than CPU for some glow tests

Particles

• Disabled testing to enable low quality particles, as the test could be more expensive than the rendering of particles

HUD Achievements

• Now disabled by default again, for parity with other configs

Ping Tolerance

• Removed, you can customize it in the menu

Documentation

• Improve documentation for the -dxlevel launch option
  • Also added -dxlevel 90 as a documented option
• Fixed a few outdated things in the Russian translation
• Fixed some 404 errors with some old links not redirecting properly
• Added -disable_d3d9_hacks to the silly launch options, as it has been suggested erroneously/vaguely

App

• Added a notice for outdated browsers, as they are not compatible with the app in various functionality
• Updated the icons/text for downloads vs direct install
• Fixed Download customizations not being enabled if binds were the only thing customized

---

View the code changes

9.8.1

Highlights: performance improvements

Support me: Learn how you can support more updates to mastercomfig!

How to install: Instructions on setting up mastercomfig initially and get it working with your custom files.

How to update: Instructions on updating mastercomfig after you've already installed it.

---

What's Changed

Comfig base

• Cleaned up a few settings/comments which were unnecessary compared to their defaults
• Reduced overhead in network packet processing
• Fixed missing graphics optimization available on Windows which was mistakedly moved to OpenGL addon
• Enhanced local server security
• Added support for playing MvM alone in a local server
• Local server settings are now applied when joining a local server, rather than on startup
• Disabled console output for missing captions

Presets

• High and Ultra now set romevision=off, like lower quality presets
  • Romevision isn't necessarily higher quality. It just provides alternative models which don't meet the original theme or optimization of base MvM.

Modules

Lighting Ex

• Now sets bumpmaps and specular as well, as these are related to the phong fast path

Effects

• Optimized tempent collision on effects=high

Addons

Low Memory

• Reduced memory usage of console

App

• Added a "Skip to download" link
• Instructions for the overrides folder now updates based on the version downloaded
• Improved the instructions for Direct Install
• Made the customizations tab bar more visible
• Fixed transitions on click to expand buttons being unsmooth
• Fixed scrolling being offset under navbar
• Fixed docs link for Ping Tolerance (Matchmaking) module not linking correctly

---

View the code changes