Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 5 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,16 +31,16 @@
- [Star History](#star-history)

## Overview
PatchOpsIII streamlines the setup and upkeep of Black Ops III by surfacing popular community tools and quality-of-life tweaks in a single polished interface. The Python application ships with dark/light themes, tabbed navigation (Mods, Graphics, Advanced), and PyInstaller builds for Windows with Linux support in active development. Whether you are securing your game with T7 Patch, chasing peak framerates with DXVK, or fine-tuning launch options, PatchOpsIII consolidates every workflow into one cohesive experience.
PatchOpsIII streamlines the setup and upkeep of Black Ops III by surfacing popular community tools and quality-of-life tweaks in a single polished interface. The Python application ships with dark/light themes, tabbed navigation (Mods, Graphics, Advanced), and Nuitka builds for Windows and Linux. Whether you are securing your game with T7 Patch, smoothing shader compilation stutter with DXVK, or fine-tuning launch options, PatchOpsIII consolidates every workflow into one cohesive experience.

## Key Features

### Mods Tab
- **Smart Game Directory Detection:** Automatically locates your Black Ops III installation or lets you browse manually.
- **T7 Patch Management:** Install, update, configure gamertags and colors, apply network passwords, toggle Friends Only mode, deploy LPC fixes, and cleanly uninstall.
- **DXVK-GPLAsync Integration:** Deploy and remove Vulkan-based shader compilation to reduce stutter and latency.
- **DXVK-GPLAsync Integration:** Deploy and remove Vulkan-based shader compilation to smooth frametimes by reducing shader cache stutter.
- **Workshop Helper:** One-click access to curated Steam Workshop mods and documentation.
- **Launch Profiles:** Preset command-line configurations for Offline play, All-around Enhancement Lite, and Ultimate Experience Mod.
- **Launch Profiles:** Preset command-line configurations for Offline play, [All-around Enhancement Lite](https://steamcommunity.com/sharedfiles/filedetails/?id=2994481309), and [Ultimate Experience Mod](https://steamcommunity.com/sharedfiles/filedetails/?id=2942053577).

### Graphics Tab
- **Preset Loader:** Apply curated JSON presets to instantly switch between visual configurations.
Expand Down Expand Up @@ -82,7 +82,7 @@ PatchOpsIII streamlines the setup and upkeep of Black Ops III by surfacing popul
## Quick Start
1. Launch PatchOpsIII and verify your Black Ops III directory.
2. Apply the **T7 Patch** to secure multiplayer connectivity and remove RCE vulnerabilities.
3. Enable **DXVK-GPLAsync** for async shader compilation and reduced stutter.
3. Enable **DXVK-GPLAsync** for async shader compilation and smoother frametimes.
4. Choose a graphics preset or dial in custom display options.
5. Visit the **Advanced** tab to unlock VRAM, tweak frame latency, and set your config to read-only once satisfied.

Expand All @@ -98,7 +98,7 @@ PatchOpsIII streamlines the setup and upkeep of Black Ops III by surfacing popul
</table>

## Known Issues
- Full version of the All-around Enhancement Mod may conflict with certain launch options.
- Full version of the [All-around Enhancement Mod](https://steamcommunity.com/sharedfiles/filedetails/?id=2631943123) currently crashes before the game finishes launching, so it is not exposed as a launch option in PatchOpsIII.
- Launch option stability can vary between systems; experiment to find a stable configuration.
- A few advanced toggles remain in beta testing—report issues via GitHub.

Expand Down
2 changes: 1 addition & 1 deletion main.py
Original file line number Diff line number Diff line change
Expand Up @@ -188,7 +188,7 @@ def _frozen_base_directory():


def resource_path(relative_path):
"""Resolve bundled assets while supporting PyInstaller, Nuitka, and AppImage."""
"""Resolve bundled assets in Nuitka and AppImage builds."""
candidates = []

meipass = getattr(sys, "_MEIPASS", None)
Expand Down
12 changes: 6 additions & 6 deletions wiki/home.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# PatchOpsIII Wiki

## Overview
PatchOpsIII is a Python-based application developed by [boggedbrush](https://github.com/boggedbrush/PatchOpsIII). The project is designed to streamline and optimize operations through a robust and versatile framework. The application features a tabbed interface (`Mods`, `Graphics`, & `Advanced`) with both dark and light mode support. The application is packaged using PyInstaller to support both Linux (coming soon) and Windows environments.
PatchOpsIII is a Python-based application developed by [boggedbrush](https://github.com/boggedbrush/PatchOpsIII). The project is designed to streamline and optimize operations through a robust and versatile framework. The application features a tabbed interface (`Mods`, `Graphics`, & `Advanced`) with both dark and light mode support. The application is packaged using Nuitka to support both Linux and Windows environments.

![Program Screenshot](https://github.com/user-attachments/assets/a79e7273-4274-4a43-8d4d-e81a12cbd1ff)

Expand Down Expand Up @@ -40,11 +40,11 @@ This management only needs to run once and does not require `t7patch.exe` to rem
You can learn more about the T7 Patch [here](https://github.com/shiversoftdev/t7patch).

#### 1.3 DXVK-GPLAsync Management
**Shader compilation stuttering** is a common issue in PC gaming, causing noticeable delays when new shaders are compiled during gameplay. DXVK-GPLAsync offers a solution by converting **DirectX** calls to **Vulkan** with asynchronous shader compilation, reducing stutters and enhancing overall performance.
**Shader compilation stuttering** is a common issue in PC gaming, causing noticeable delays when new shaders are compiled during gameplay. DXVK-GPLAsync offers a solution by converting **DirectX** calls to **Vulkan** with asynchronous shader compilation, reducing stutters for consistently smooth frametimes.

**Feature Highlights:**
- Install/uninstall `dxvk-gplasync`
- Minimize in-game stuttering caused by real-time shader compilation
- Minimize in-game stuttering caused by real-time shader compilation for smoother framerates
- Enhance performance and reduce latency, especially for stutter-prone games

Learn more about [DXVK](https://www.pcgamingwiki.com/wiki/DXVK), [DXVK-GPLAsync](https://gitlab.com/Ph42oN/dxvk-gplasync), and [shader stutter](https://youtu.be/f7yml1y3fDE?si=NpwybZNqIRVhxmL7).
Expand All @@ -53,8 +53,8 @@ Learn more about [DXVK](https://www.pcgamingwiki.com/wiki/DXVK), [DXVK-GPLAsync]
- **Skip All Intro Videos:** Bypass all game intro videos
- **Launch Options:** Support for various mod configurations:
- Play Offline
- All-around Enhancement Lite
- Ultimate Experience Mod
- [All-around Enhancement Lite](https://steamcommunity.com/sharedfiles/filedetails/?id=2994481309)
- [Ultimate Experience Mod](https://steamcommunity.com/sharedfiles/filedetails/?id=2942053577)
- **Clickable Help:** Access detailed information and download links for Steam Workshop mods

### 2. Graphics Tab
Expand Down Expand Up @@ -92,6 +92,6 @@ Displays logs in a terminal view, providing transparency about what operations s
- **Troubleshooting:** Users can easily identify issues through detailed log messages.

### Known Issues
- All-around Enhancement Mod (full version) may have compatibility issues with launch options
- [All-around Enhancement Mod](https://steamcommunity.com/sharedfiles/filedetails/?id=2631943123) (full version) currently crashes before launch, so it is not provided as a PatchOpsIII launch option
- Launch options stability may vary between users
- Some features are still under testing