================================================================================
Luxury Visuals - TSO (Texture Streaming Optimizations) for Oblivion Remastered
Version: 1.0
Author: Daemondred
Nexus Mods Page: https://www.nexusmods.com/oblivionremastered/mods/3031
================================================================================

Thank you for downloading Luxury Visuals - TSO! This mod aims to significantly improve texture streaming performance and reduce visible pop-in for Virtual Textures (VT) in Oblivion Remastered, providing a more stable and immersive visual experience, especially on higher-end systems.

This mod achieves its effects by providing modified core engine INI files within a .pak archive.

--------------------------------------------------------------------------------
CONTENTS
--------------------------------------------------------------------------------
1. Overview
2. Requirements
3. Installation
4. Key Changes Made by This Mod
5. Compatibility & Important Notes
6. Uninstallation
7. Feedback and Support
8. Future Plans (Luxury Visuals Series)
9. Permissions and Credits
10. Changelog

--------------------------------------------------------------------------------
1. OVERVIEW
--------------------------------------------------------------------------------
Oblivion Remastered, while visually impressive, can suffer from noticeable texture pop-in, especially in complex areas, due to its Virtual Texturing system. This mod, "Luxury Visuals - TSO," directly addresses these issues by:

* **Optimizing Virtual Texture (VT) Streaming:** Key console variables are adjusted to increase VT tile upload throughput and better manage VT resources.
* **Enhancing VT Pool Sizes:** Default Virtual Texture memory pools are significantly increased to provide more VRAM for VT operations, reducing thrashing.
* **Managing Texture Demand:** Selectively applies LOD Bias to certain broad environmental texture groups to reduce the demand for unnecessarily high-resolution distant textures, helping the VT system keep up.
* **Improving Traditional Texture Streaming:** Increases the pool size for traditional (non-VT) textures for higher quality settings.

This mod is the result of extensive testing to find a stable configuration that provides approximately an 80% improvement over vanilla texture streaming in problematic areas. While it aims to drastically reduce visible pop-in, some very fast tile loading may still be briefly perceptible in the busiest scenes due to the reactive nature of Virtual Texturing.

--------------------------------------------------------------------------------
2. REQUIREMENTS
--------------------------------------------------------------------------------
* Oblivion Remastered.
* **Recommended VRAM:** While this mod aims for stability, the increased texture pool sizes and throughput settings are best suited for GPUs with **12GB of VRAM or more**.

--------------------------------------------------------------------------------
3. INSTALLATION
--------------------------------------------------------------------------------
1. Use Vortex for easy installation or Download the `LuxuryVisuals-TSO_P.pak` archive from Nexus Mods.
2. Extract the `.pak` file into your Oblivion Remastered Paks directory. This is typically:
`...\Oblivion Remastered\OblivionRemastered\Content\Paks\`
3. **Important:** This mod directly overwrites core configuration files. It is not compatible with other mods that change the same configuration files.

--------------------------------------------------------------------------------
4. KEY CHANGES MADE BY THIS MOD (v1.0)
--------------------------------------------------------------------------------
This mod includes modified versions of the following internal game INI files:
* `OblivionRemastered/Config/DefaultDeviceProfiles.ini`
* `OblivionRemastered/Config/DefaultEngine.ini`

**A. From `DefaultDeviceProfiles.ini` ([Windows DeviceProfile] section):**
* `t.MaxFPS=0` (Uncaps framerate)
* **Virtual Texturing Overrides:**
* `r.VT.MaxUploadsPerFrame.Streaming=64` (Increased from vanilla 4)
* `r.VT.MaxUploadsPerFrame=64`
* `r.VT.MaxTilesProducedPerFrame=60` (Increased from vanilla 30)
* **TextureLODGroups:**
* `LODBias=1` applied to `TEXTUREGROUP_Project02` (DirtMask), `TEXTUREGROUP_Project05` (TileableBaseColor), `TEXTUREGROUP_Project06` (TileableNNR), `TEXTUREGROUP_Project07` (LandscapeBaseColor), `TEXTUREGROUP_Project08` (LandscapeNNR) to reduce demand from broad environmental textures.
* Other groups (World, Character, Weapon, Foliage, etc.) generally maintain `LODBias=0` for sharpness, with `MipFilter=point` (vanilla default for these specific `+TextureLODGroups` lines).

**B. From `DefaultEngine.ini`:**
* **`[/Script/Engine.VirtualTexturePoolConfig]`:** Significantly increased default VT pool sizes for various texture formats (e.g., PF_BC7/DXT5/DXT1 to 256-512MB each, PF_BC5 to 256MB, etc., totaling over 2GB for VT).
* **`[SystemSettings]`:**
* `r.Streaming.PoolSize=4096` (Default traditional streaming pool, may be overridden by WindowsScalability.ini)
* `r.Streaming.MaxTempMemoryAllowed=256`
* VSync related cvars for VRR: `r.GTSyncType=2`, `rhi.SyncInterval=0`, `r.D3D12.UseAllowTearing=1`

--------------------------------------------------------------------------------
5. COMPATIBILITY & IMPORTANT NOTES
--------------------------------------------------------------------------------
* **BETA / EXPERIMENTAL:** This is v1.0 of a complex set of engine tweaks. While stable on my system after extensive testing, stability and performance may vary on other hardware configurations. Use at your own risk.
* This mod directly modifies core configuration files (`DefaultDeviceProfiles.ini`, `DefaultEngine.ini`, `WindowsScalability.ini`) via a `.pak` file. It **WILL CONFLICT** with any other mod that attempts to modify these same internal INI files. Choose only one such mod.

--------------------------------------------------------------------------------
6. UNINSTALLATION
--------------------------------------------------------------------------------
1. **Using a Mod Manager:** Disable and uninstall/remove the mod through your mod manager.
2. **Manual Uninstallation:** Delete the `LuxuryVisuals-TSO_P.pak` (or the specific name you give this pak) from:
`...\Oblivion Remastered\OblivionRemastered\Content\Paks\` (or `...\Paks\~mods\`)

--------------------------------------------------------------------------------
7. FEEDBACK AND SUPPORT
--------------------------------------------------------------------------------
Please provide feedback, report any instability, or share your experiences (including your system specs and in-game quality settings) in the Posts or Bug Reports section on the Nexus Mods page. This will help improve future versions.
[Link to your TSO mod page or the existing LV HDR page if you add it as a separate file]

Thank you for trying Luxury Visuals - TSO!