repository·main·Indexed 42 days ago
https://github.com/hzqst/metahooksvA client-side modding framework for SvEngine (Sven Co-op) and other GoldSrc-based games. It enables advanced plugin-based modifications for gameplay, graphics, and UI, featuring a GUI installer and support for plugins like CaptionMod, Renderer.dll, and SCModelDownloader.
CaptionMod is a MetaHook plugin designed for GoldSrc and SvEngine games. It provides a VGUI2-based subtitle system, HUD text translation, support for multi-byte text rendering, and a Source 2007-style chat dialog.
It functions by intercepting engine and client events (such as sound playback, HUD messages, and netmessages) and converting them into translated subtitles or HUD output using a dictionary-based lookup system.
The SteamScreenshots plugin is a specialized screenshot-bridging tool designed exclusively for Sven Co-op.
Its primary function is to intercept the engine's snapshot command, capture the current OpenGL framebuffer, and automatically upload the resulting image to the Steam screenshot manager using the Steamworks ISteamScreenshots interface. This allows in-game screenshots to be managed and shared through the standard Steam ecosystem.
MetaHookSv provides a variety of plugins to enhance the GoldSrc and Sven Co-op experience. Key plugins include:
snapshot commands to Steam's screenshot system.gmr/gsr).hw.dll, GameUI.dll, and ServerBrowser.dll to prevent crashes during exit or hot-restarts.BulletPhysics is the client-side physics plugin for MetaHookSv. It maps GoldSrc/SvEngine entities, Studio models, and the BSP world into a Bullet3 physics world.
Key capabilities include:
The Plugins/SCModelDownloader is an automatic player-model download plugin for the Sven Co-op client. It automates the process of detecting player model changes, downloading new assets asynchronously, validating them, and hot-reloading the models in-game.
scmodel_autodownload cvar.models.json (available models) and versions.json (version mappings)..mdl, .T|t.mdl, and .bmp files are valid before writing to the destination.skippedmodels.txt.rdc-cli is a scriptable CLI wrapper around RenderDoc that converts .rdc captures into Unix text streams (TSV by default, or --json / --jsonl on request). It allows for inspecting shaders, UBO contents, draw state, and render targets directly from the command line using tools like grep, awk, or jq. It is the terminal-based counterpart to the RenderDoc GUI, using the same capture and replay engine.
Key Constraints:
rdc capture uses launch-time injection (ExecuteAndInject). It cannot attach to an already-running game; the target must be started by rdc.metahook.exe loads engine DLLs in-process, so the capture target is metahook.exe itself. You do not need --hook-children for standard MetaHook targets.rdc capture -o frame.rdc -- "D:\Path\to\metahook.exe" -insecure -game cstrikeThe Renderer plugin is the core graphics-enhancement component for MetaHookSv. It provides a modern OpenGL rendering pipeline for GoldSrc engine games, enabling advanced visual effects that are not natively supported by the engine.
.mdl format (characters/weapons)..spr format..bsp format terrain.Build/ directory to GoldSrc or Sven Co-op game directories and provides a visual interface for managing plugins.The UtilHTTPClient_libcurl library is an HTTP client implementation based on libcurl (multi/easy). It provides the IUtilHTTPClient and IUtilHTTPClientFactory interfaces via a DLL.
Key features include:
IUtilHTTPClient::RunFrame(), which should be called from the main engine/plugin loop.InstallDir for Steam games. This is useful for developers or tools that need to identify where specific Steam games are installed on a user's system.