Repository navigation
Releases
Releases · Illustar0/usvfs
v0.5.7.2-pr99-alpha.7
[0.5.7.2-pr99-alpha.7] - 2026-11-16
Tip
If you can, please download this release from Nexus Mods — and if it helps you, an Endorse there would mean a lot!
Summary
- Fix: Fixed games and tools started from Mod Organizer sometimes crashing as they close, with exit code
0xC0000005. - Fix: Fixed rare crashes when a game or tool works with files from several threads at once, where two threads could change the state of the virtual file system at the same time.
- Fix: Fixed games and tools not finding, opening or saving mod files whose full path is longer than 260 characters, as can happen with deeply nested mods or a Mod Organizer instance kept deep inside other folders.
- Fix: Fixed some programs, mostly older ones, being told a wrong length for their working folder, which could break the file paths they build from it.
- Fix: Fixed programs that ask for the path of a file they opened getting a wrong one when the game is on a drive made with
subst. - Perf: Threads that only look up files no longer wait for each other in the virtual file system, which can speed up games that load many files from several threads at once.
Details
🚀 Features
- Add a DOS path model built on the ntdll path parser
🐛 Bug Fixes
- Disconnect the VFS on exit only after the other threads have ended
- Resolve and reroute hook paths through the DOS path model
- Report GetCurrentDirectoryA lengths as the native function does
- Log no directory for a buffer too small in GetCurrentDirectoryW
- Name rerouted handles after their closest existing ancestor
- Replace the hook context's benaphore with a recursive SRW lock
🚜 Refactor
- Take write access to remove a mapping
- Follow a moved redirection tree when taking read access
⚡ Performance
- Let readers of the hook context share its lock
🧪 Testing
- Benchmark the hooks from several threads at once
Full Changelog: v0.5.7.2-pr99-alpha.6...v0.5.7.2-pr99-alpha.7
v0.5.7.2-pr99-alpha.6
[0.5.7.2-pr99-alpha.6] - 2026-11-07
Tip
If you can, please download this release from Nexus Mods — and if it helps you, an Endorse there would mean a lot!
Summary
- Fix: Fixed games and tools started from Mod Organizer sometimes freezing and never recovering.
- Fix: Fixed a small leak each time a game or tool ended one of its threads, which could add up over long play sessions.
- Fix: Fixed the DLSS option missing in Community Shaders and Open Shaders when running Mod Organizer on Linux through Wine or Proton. Other programs that look up where a mod's files really are could fail there too.
Details
🐛 Bug Fixes
- Make NtClose erase from the handle registries without waiting
- Stop leaking an Event handle for every exited thread
- Keep NtQueryObject names in the
\??\namespace under Wine
Full Changelog: v0.5.7.2-pr99-alpha.5...v0.5.7.2-pr99-alpha.6
v0.5.7.2-pr99-alpha.5
[0.5.7.2-pr99-alpha.5] - 2026-10-29
Note
The old Nexus Mods page was hidden by moderators because I uploaded it to the wrong category. I've re-uploaded it to the right place here: https://www.nexusmods.com/site/mods/2530
Summary
- Fix: Handle a directory query that succeeds with no data. You won't hit this in practice, but Microsoft's docs say it can happen.
- Feat: Export the usvfs 0.4 function names again, for tools built against 0.4.
Details
🚀 Features
- Export the usvfs 0.4 C API names again
🐛 Bug Fixes
- Stop rereading a source when a query succeeds with no bytes
v0.5.7.2-pr99-alpha.4
[0.5.7.2-pr99-alpha.4] - 2026-10-27
Summary
- Fix: Hooked processes no longer crash when a thread that the Windows loader did not set up opens or closes a file.
- Perf: Listing a virtual directory stops reading a mod's source folder as soon as every file it maps from there is found, instead of reading the whole folder, which speeds up mods with large folders.
- Build: Google Benchmark is now an optional dependency. The directory benchmark only builds with
USVFS_BUILD_BENCHMARKS, which is on in the dev presets. - Tests: Directory enumeration tests now catch hooked queries that write past the caller's buffer, and compare whole listings from several sources against ntdll instead of comparing query by query.
Detailes
🐛 Bug Fixes
- Mark internal scan I/O in a Win32 TLS slot instead of thread_local
⚡ Performance
- Stop reading a source directory once every mapped name is found
🧪 Testing
- Detect directory queries that write past their buffer
- Compare several-source listings as a whole and check the hook's packing
🏗️ Build
- Make Google Benchmark an optional dependency
v0.5.7.2-pr99-alpha.3
[0.5.7.2-pr99-alpha.3] - 2026-10-19
Summary
- Fix: usvfs now runs under Wine/Proton instead of crashing on startup.
Details
🐛 Bug Fixes
- Match names without RtlIsNameInExpression where ntdll lacks it
v0.5.7.2-pr99-alpha.2
[0.5.7.2-pr99-alpha.2] - 2026-10-18
🚀 Features
- Log how directory queries are served and where they fall back
🐛 Bug Fixes
- Rebuild directory scans built under a replaced hook context
⚡ Performance
- Look directories up in the tree before the mode of their handle
🧪 Testing
- Drop directory query tests that later tests cover
- Fold the several-entries listing into the several-sources one
v0.5.7.2-pr99-alpha.1
[0.5.7.2-pr99-alpha.1] - 2026-10-17
🐛 Bug Fixes
- Resolve Clang standard-conformance errors in templates and hooks
- Honor the length of counted FileName patterns
- Forward unsupported information classes to ntdll
- Close the reopened search handle on restart
- Serialize queries on the same directory handle
- Forward asynchronous directory queries to ntdll
- Match native status block contents for empty results
- Let ntdll reject undersized or misaligned buffers
- Keep listing physical entries after a partial record
- Return a partial record for an oversized virtual entry
- Keep virtual entries that do not fit for the next call
- Read the file of a virtual entry whole whatever the buffer
- Return errors from the physical directory read
- Restart the physical scan on SL_RESTART_SCAN
- End an empty restart with STATUS_NO_MORE_FILES
- List case variants in case-sensitive directories
- Drop scan state when a handle value is reissued
- Open mapping sources without re-entering hooks
- Match virtual entries with RtlIsNameInExpression
- Keep the latched pattern on restart without FileName
- Forward unsupported SL_* query flags to ntdll
- Keep the scan's own handles out of the open and close hooks
- List the physical directory at the virtual path
- Fold names with the ntdll upcase table
- Leave directories without a link target to the disk listing
- List only dot entries for purely virtual directories
- Share delete access when the scan opens a directory
- Log why the scan could not open a source directory
- Present virtual entries without 8.3 short names
🚜 Refactor
- Implement both directory query hooks once
- Split directory enumeration out of ntdll.cpp
- Keep directory scans in a dedicated registry
- Build DirectoryScan from its first query
- Turn the query body into DirectoryScan::query
- Extract DirectoryScan::fill
- Return virtual matches from gatherVirtualEntries
- Extract openRegularSource
- Wrap found names in CaseInsensitiveNameSet
- Describe directory records with DirectoryRecord
- Replace file_information_utils.h with DirectoryRecord
- Add DirectoryOutput
- Write regular entries through DirectoryOutput
- Write virtual entries through DirectoryOutput
- Log each directory scan once
- Add a native directory reader for internal queries
- Drop SearchHandleMap bookkeeping
- Filter a read of regular entries in a function of its own
- Test whether the output holds a record with has_value
📚 Documentation
- Explain why the regular reader does not read ahead
⚡ Performance
- Return several virtual entries per call
- Scan each mapping source directory once
- Query single-file mapping sources by name
- Stop copying source directories while gathering them
- Take the file names of virtual entries without converting them twice
- Forward directories without mappings to ntdll
- Copy tree data only while holding the hook context
- Stop calling GetFileType in NtClose
- Hash shadow names and build the set on demand
- Skip deduplicating virtual entries whose names are all ASCII
🧪 Testing
- Move directory query tests into directory_enumeration.cpp
- Compare the regular entries of the hook with ntdll
- Read the name of a virtual file by its length
- Add directory enumeration benchmark
- Benchmark listing an unmapped directory through the hooks
- Spread the folded names over more buckets