You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
chore: remove KROSSHAIR_SCALE, clean up README and install messages
Drop the KROSSHAIR_SCALE env var (hardcode scale to 1). Rewrite README
to focus on crosshair-maker integration, remove nixos/requirements
sections, and update AUR install messages to match.
Copy file name to clipboardExpand all lines: README.md
+23-11Lines changed: 23 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,27 +5,39 @@ A crosshair overlay for games on linux using vulkan.
5
5

6
6
7
7
## Installation
8
-
`make && make install`
9
8
10
-
On nixos-unstable: Add `krosshair` (or clone and add `(callPackage <local krosshair repo path>/derivation.nix { })`) to packages and `nixos-rebuild switch`.
Simply start the your game with `KROSSHAIR=1` set. When using steam, put `KROSSHAIR=1 %command%` into the launch options of your game. Additionally you can use the following variables to customize your crosshair.
14
-
-`KROSSHAIR_IMG=/path/to/crosshair-image.png` (i've provided some crosshairs in [here](https://github.com/krob64/krosshair/tree/main/crosshairs), copy them wherever you like)
15
-
- alternatively you can use a [crosshair generator site](https://crosshair.themeta.gg/) (or [this one](https://guywiddacaptain.github.io/aimX/))
24
+
25
+
```bash
26
+
export KROSSHAIR=1
27
+
your-game
28
+
```
29
+
30
+
For Steam games, add `KROSSHAIR=1 %command%` to launch options.
31
+
16
32
## crosshair-maker integration
17
33
18
-
If you have [crosshair-maker](https://github.com/fibsussy/crosshair-maker) installed, krosshair automatically uses your currently selected crosshair — no configuration needed. The currently active project's exported PNG (`~/.config/crosshair-maker/projects/current.png`) is loaded as the overlay. You can still override this with `KROSSHAIR_IMG` if you want.
34
+
krosshair works out of the box with [crosshair-maker](https://github.com/fibsussy/crosshair-maker), a crosshair overlay creator with SVG rendering and preview. The currently selected crosshair is automatically exported to `~/.config/crosshair-maker/projects/current.png`, which krosshair picks up as its default — just launch your game with `export KROSSHAIR=1` and go.
19
35
20
-
-`KROSSHAIR_SCALE=1.0` (scaling the scrosshair may make it look blurry, i'd suggest to just create a bigger/smaller crosshair)
36
+
You can override the image with `export KROSSHAIR_IMG=/path/to/crosshair.png` if you want to use a custom file.
21
37
22
38
## Can i get banned for this?
23
39
I don't know, use at your own risk. I've only used it in Quake Champions and STRAFTAT, both of which don't really have an anticheat.
24
40
25
-
## Setting up requirements
26
-
Needs Vulkan libs to build.
27
-
All requirements can be set up with `nix-shell' when nix is installed.
28
-
29
41
## Issues
30
42
As of now, the overlay leaks a bit of memory everytime you alt-tab out of/into the game, as well as everytime the window is being resized and upon resolution changes. It's not a big leak and shouldn't cause any problems, but it's still worth noting.
31
43
I've tried fixing it multiple times but have always hit a dead-end. If someone more experienced with vulkan wants to help, take a look at [this issue](https://github.com/krob64/krosshair/issues/1). I know it's a bit of a mess, this whole project is based on a morally questionable apex legends project which i'm unsure if i should link to it here, coupled with me jumping into it right after completing the vulkan tutorial.
0 commit comments