hyprland-plugins/csgo-vulkan-fix/README.md
2026-05-05 00:35:52 +01:00

1.1 KiB

csgo-vulkan-fix

Originally meant for csgo / cs2, but can work with any app, really.

csgo-vulkan-fix is a way to force apps to a fake resolution without them realizing it.

If you want to play CS2, you're locked to your native res. Other resolutions (especially not 16:9) are wonky.

With this plugin, you aren't anymore.

This is also useful for when you are scaling and want to force any game to a custom resolution.

CS2 launch options:

-vulkan -window -w <RESX> -h <RESY> -vulkan

example plugin config:

plugin {
    csgo_vulkan_fix {
        # Whether to fix the mouse position. A select few apps might be wonky with this.
        fix_mouse = true

        # Add apps with vkfix-app = initialClass, width, height
        vkfix-app = cs2, 1650, 1050
        vkfix-app = myapp, 1920, 1080
    }
}

Lua config:

hl.config({
    plugin = {
        csgo_vulkan_fix = {
            fix_mouse = true,
        },
    },
})

hl.plugin.csgo_vulkan_fix.vkfix_app({ app = "cs2", w = 1650, h = 1050 })
hl.plugin.csgo_vulkan_fix.vkfix_app({ app = "myapp", w = 1920, h = 1080 })

fullscreen the game manually and enjoy.