Repository navigation
Releases
KotOR VR 1.0.3 — sharper picture
A sharper picture. If KotOR VR looked blurry, jagged or pixelated, this update is for you — sorry, that was my
setup leaving KotOR's graphics at its defaults.
Install / update
Download KotorVR-1.0.3.zip below, unzip it, run KotorVR-Setup.exe and press Install (it updates any
earlier version in place; your settings are kept). Then start KotOR VR from the desktop shortcut with your headset
connected.
What's fixed
- Resolution and image quality. The headset gets KotOR's picture at the size of the game window. The setup now
picks the biggest 4:3 window your monitor and display scaling allow and turns on 4× anti-aliasing and 16×
anisotropic filtering. It never lowers settings you already raised, and uninstall puts your own back.
Don't want to update? Close the game, open <your KotOR folder>\swkotor.ini and under [Graphics Options] set
Anti Aliasing=4 and Anisotropy=16, and raise Width / Height to the biggest 4:3 size your monitor offers that
fits on screen (e.g. 1920 / 1440 on a 4K monitor). On Link / Air Link, a higher encode bitrate in the Meta app
helps too.
Also in 1.0.2 (if you skipped it): first-person cameras for everyone and windowed mode that really applies.
Known
- Virtual Desktop: its OpenXR runtime still ends the headset session a few seconds in — use Meta Link / Air Link
for now. SteamVR: one report of Steam closing when the game starts; under investigation. - Still stuck? Open a bug report with
kvr\probe.logandkvr\host.logfrom your KotOR folder.
KotOR VR 1.0.2 — first-person hotfix
⚠️ Blurry or jagged picture? → Get 1.0.31.0.3 sets KotOR up for a sharp headset picture (the biggest window your monitor allows, anti-aliasing, texture
filtering) and includes everything in this release.
Hotfix: first-person view, and windowed mode that really applies. If KotOR VR showed you a third-person camera,
characters and objects flickering out of existence, a frozen image in the headset, or a black headset with only
sound, this update fixes it. Sorry to everyone who hit this — it was a file that only existed on my own PC.
Install / update
Download KotorVR-1.0.2.zip below, unzip it, run KotorVR-Setup.exe and press Install (it updates
1.0.0 / 1.0.1 in place; your settings are kept). Then start KotOR VR from the desktop shortcut with your headset
connected. If you deleted any of KotOR's movies while troubleshooting, put them back first: Steam → KotOR →
Properties → Installed Files → Verify integrity of game files.
What's fixed
- First-person cameras for everyone. The mod needs KotOR's cameras set up for VR (at your head, with a wide view
the game culls with). That file only ever existed on the developer's PC, so players got KotOR's third-person
camera, things vanishing as you looked around, and sometimes a frozen headset. The setup now builds it from your
own game files (and removes it again if you uninstall). - Windowed mode really applies. KotOR ignores
FullScreen=0unlessAllowWindowedMode=1is set too; 1.0.1 only
set the first, so on most PCs KotOR stayed fullscreen and the headset stayed black. The setup now sets both. - The VR tutorial cards describe the current controls.
Also in 1.0.1 (if you skipped it): the Windows 10 fix for the 3D world reaching the headset, kvr\host.log for bug
reports, and a few launcher fixes.
Known
- Virtual Desktop: its OpenXR runtime still ends the headset session a few seconds in — use Meta Link / Air Link
for now. SteamVR: one report of Steam closing when the game starts; under investigation. - Still stuck? Open a bug report with
kvr\probe.logandkvr\host.logfrom your KotOR folder.
KotOR VR 1.0.1 - black headset hotfix
⚠️ Third-person view, things vanishing, or a black headset? → Get 1.0.21.0.2 fixes the first-person cameras (they were missing for every player but me — sorry) and makes windowed mode
actually apply, which fixes the black headset. Earlier releases are kept only for reference.
Hotfix for black or flashing headsets. If 1.0.0 gave you sound but a black (or flashing) headset, or only the
menus in the headset with the game on your monitor, this update is for you. Thank you to everyone who reported it —
and sorry for the trouble.
Install / update
Download KotorVR-1.0.1.zip below, unzip it, run KotorVR-Setup.exe and press Install (it updates 1.0.0
in place; your settings are kept). Then start KotOR VR from the desktop shortcut with your headset connected.
What's fixed
- Fullscreen KotOR left the headset black. KotOR's default fullscreen mode minimizes itself the moment it loses
focus, and a minimized game has nothing to send to the headset. The setup now switches KotOR to a window (at least
1280×960) and puts your own display settings back if you uninstall. - Windows 10: only the menus reached the headset. One of the hooks the mod uses to draw the 3D world never
attached on Windows 10 (its GLU32 library is built slightly differently from Windows 11's), so the world stayed on
the monitor. Fixed. - Better bug reports: the VR host now writes
<KotOR>\kvr\host.log(the VR runtime it's using, the headset
session and any frame errors). If something's still wrong, attach it together withkvr\probe.log. - The mod logs a clear warning when the game window is minimized; the KotOR VR shortcut replaces a stuck VR host left
over from an earlier session; your own held weapons are recognized exactly again.
Don't want to update? You can fix the fullscreen black screen by hand: close the game, open
<your KotOR folder>\swkotor.ini in Notepad and under [Graphics Options] set FullScreen=0, AllowWindowedMode=1,
Width=1280, Height=960. (The Windows 10 fix needs the update.)
Known
- Virtual Desktop: its OpenXR runtime still ends the headset session a few seconds in. Use Meta Link / Air Link
for now; a fix is being worked on. - AMD GPUs and Windows 10 are newly supported and have only been tested by one player so far —
tell me how it goes.
KotOR VR 1.0
⚠️ Third-person view, things vanishing, or a black headset? → Get 1.0.21.0.2 fixes the first-person cameras (they were missing for every player but me — sorry) and makes windowed mode
actually apply, which fixes the black headset. Earlier releases are kept only for reference.
Star Wars: Knights of the Old Republic in virtual reality — first person in KotOR's own engine, physical
swordplay, hand-aimed blasters and Force powers by gesture. Free, unofficial fan mod.
▶ Trailer: KotorVR_trailer_v1.mp4 below.
Install
- You need KotOR on Steam (PC, Windows 10/11) and a PC VR headset with an OpenXR runtime (built and tested on
Quest 3 over Air Link). - Download
KotorVR-1.0.0.zipbelow, unzip it, runKotorVR-Setup.exeand press Install. It builds the
VR assets from your own game files — the mod ships none of BioWare's. - Connect your headset, start KotOR VR from the desktop shortcut, and press the right thumbstick to recenter.
How to play — every control, combat, the Force, settings
· Known issues
What's in 1.0
- First person in KotOR's own engine: your head drives the camera; cutscenes stay in your eyes whenever you can
see what they show. - Real swordplay: your blade hits what it touches. An enemy that's open to a cut shows a gold ring on its chest;
block its blows on a glowing bar, parry, deflect bolts with a saber. - Blasters aimed with your hand: the barrel lies on your pointing ray; a white-hot burst shows when you've really
done damage. - Force powers by gesture: gather, then push, lift, hold or unleash lightning.
- Your character's own hands with your real equipped weapons; conversations in front of whoever you're talking
to; the HUD on your wrist. - Played and tested end to end, with an automated playthrough of the whole Endar Spire on every build.
Feedback
This is v1 — tell me how it plays.
🐞 Report a bug (attach
<KotOR>\kvr\probe.log) · 💡 Suggest a feature
· 💬 Discussions
Not affiliated with Lucasfilm, Disney, BioWare or Aspyr. MIT licensed.