|
|
| (9 intermediate revisions by the same user not shown) |
| Line 4: |
Line 4: |
| {{Release_TOC|content= | | {{Release_TOC|content= |
| <div class="hf-toc-category">On this page</div> | | <div class="hf-toc-category">On this page</div> |
| | <div>[[#about|About This Page]]</div> |
| <div>[[#essential-diagnostics|Essential Diagnostics]]</div> | | <div>[[#essential-diagnostics|Essential Diagnostics]]</div> |
| <div>[[#critical-issues|Critical Known Issues]]</div> | | <div>[[#critical-issues|PC & Console Troubleshooting]]</div> |
| <div>[[#steam-issues|Steam Related Issues]]</div> | | <div>[[#steam-issues|Steam Related Issues]]</div> |
| | <div>[[#linux-troubleshooting|Linux Troubleshooting]]</div> |
| <div>[[#game-tips|Game Tips]]</div> | | <div>[[#game-tips|Game Tips]]</div> |
| <div>[[#server-issues|Server-Side Issues]]</div> | | <div>[[#server-issues|Server-Side Issues]]</div> |
| Line 16: |
Line 18: |
| |title=About This Page | | |title=About This Page |
| |content= | | |content= |
| The purpose of this page is to document solutions to various common problems with ''Holdfast: Nations at War.'' These are well-established and common problems that players may encounter with the game. As a first port of call, please consult this page before reaching out to Tech Support on the official Discord.
| | This page collects common fixes for ''Holdfast: Nations at War'' across PC, Linux, Steam Deck, Xbox Series X/S, and PS5. Start here before opening a support ticket, especially if the issue involves crashing, missing servers, VoIP, black screens, loading problems, or Steam file errors. |
|
| |
|
| '''Note:''' This page does ''not'' document gameplay bugs. To submit a bug report, please do so via the official Holdfast Discord: [https://discord.com/invite/holdfastgame discord.gg/holdfastgame].
| | For any query that is not solved here, reach out to Tech Support in the official Holdfast Discord: [https://discord.com/invite/holdfastgame discord.gg/holdfastgame]. |
| }} | | }} |
|
| |
|
| Line 25: |
Line 27: |
| |title=Essential Diagnostics | | |title=Essential Diagnostics |
| |content= | | |content= |
| Before submitting a ticket to the Official Discord, you must perform these steps to rule out local data corruption. | | Before submitting a ticket, run these checks first. They rule out local corruption, missing dependencies, and lost crash logs. |
|
| |
|
| <h3>1. Integrity Validation (Steam)</h3> | | <h3>Integrity Validation (Steam)</h3> |
| Asset corruption is the #1 cause of "Pink Textures" (missing materials) and map load crashes. | | Asset corruption is a common cause of pink textures, missing materials, and map load crashes. |
|
| |
|
| * '''Procedure:''' Right-click '''Holdfast: Nations at War''' in Steam > '''Properties''' > '''Installed Files''' > '''Verify Integrity of Game Files'''. | | * '''Procedure:''' Right-click '''Holdfast: Nations at War''' in Steam > '''Properties''' > '''Installed Files''' > '''Verify integrity of game files'''. |
| * '''Note:''' Steam will automatically re-acquire any file that fails the SHA check. | | * '''Note:''' Steam will re-acquire any file that fails validation. |
|
| |
|
| <h3>2. Error Logging & Console Access</h3> | | <h3>Error Logging & Console Access</h3> |
| * '''F2 Console:''' Press <code>F2</code> in-game. '''Red lines''' are fatal errors; '''Yellow lines''' are warnings. | | * '''F2 Console:''' Press <code>F2</code> in-game. '''Red lines''' are fatal errors. '''Yellow lines''' are warnings. |
| * '''Local Logs:''' Your crash data is stored at <code>%userprofile%\AppData\LocalLow\Anvil Game Studio\Holdfast NaW\Player.log</code>. | | * '''Local Logs:''' Crash data is stored at <code>%userprofile%\AppData\LocalLow\Anvil Game Studio\Holdfast NaW\Player.log</code>. |
| * '''Critical:''' You must copy this file '''immediately''' after a crash. Relaunching the game overwrites it. | | * '''Critical:''' Copy <code>Player.log</code> immediately after a crash. Relaunching the game overwrites it. |
|
| |
|
| '''For any queries, please reach out to Tech Support in the official Holdfast Discord: [https://discord.com/invite/holdfastgame discord.gg/holdfastgame].''' | | <h3>Drivers & System Checks</h3> |
| | * '''NVIDIA:''' Update through the NVIDIA App or [https://www.nvidia.com/drivers nvidia.com/drivers]. |
| | * '''AMD:''' Update through AMD Software: Adrenalin Edition or [https://www.amd.com/en/support amd.com/support]. |
| | * '''Intel:''' Update through Intel Driver & Support Assistant or [https://www.intel.com/content/www/us/en/download-center intel.com/download-center]. |
| | * '''Windows:''' Install pending Windows updates, then restart before testing again. |
| }} | | }} |
|
| |
|
| {{Release_section | | {{Release_section |
| |id=critical-issues | | |id=critical-issues |
| |title=Critical Known Issues (PC & Console) | | |title=PC & Console Troubleshooting |
| |content= | | |content= |
| Here's a list of known issues within the game which we're already aware of. You can rest assured that we're doing our best to solve them and please do get in touch with us if you ever face any issues whilst playing the game!
| | <div class="mw-collapsible mw-collapsed hf-issue-block"> |
| | <div class="hf-issue-heading">Issue 1 - Black Screen on Launch (Audio or Music Playing)</div> |
| | <div class="mw-collapsible-content"> |
| | '''Status:''' GPU scaling and display handshake conflict |
|
| |
|
| <!-- KI 1 -->
| | '''Affected Platforms:''' PC, Xbox Series X/S, PS5 |
| <h3>Known Issue 1 - Black Screen on Launch (Audio/Music Playing)</h3>
| |
| '''Status:''' GPU Scaling & Handshake Conflict | |
|
| |
|
| '''Affected Platforms:''' PC, Xbox Series X|S , PS5 | | '''The Issue:''' The game is running and audio is playing, but the display remains black or shows no signal. |
|
| |
|
| '''The Cause:''' This occurs when the game's internal resolution doesn't match the display's scaling parameters, causing the monitor to receive no signal while the game runs in the background. | | '''The Cause:''' The game's internal resolution can disagree with display scaling, VRR, 120Hz output, or fullscreen mode. |
|
| |
|
| '''The Fix PC:''' | | '''The Fix PC:''' |
| | * '''NVIDIA App:''' Open '''NVIDIA App''' > '''Graphics''' > '''Global Settings'''. Set '''Image Scaling''' to '''Off'''. |
| | * '''NVIDIA Control Panel:''' Right-click Desktop > '''NVIDIA Control Panel''' > '''Adjust desktop size and position'''. Under scaling mode, choose '''No Scaling''' and click '''Apply'''. |
| | * '''AMD Software:''' Open '''AMD Software''' > '''Gaming''' > '''Games''' > '''Holdfast: Nations At War'''. Under '''Display''', set '''Scaling Mode''' to '''Preserve Aspect Ratio'''. |
| | * '''AMD Integer Scaling:''' Set '''Integer Scaling''' to '''Disabled'''. |
| | * '''Alt + Enter:''' If the screen is black but audio is playing, press '''Alt + Enter''' to force Windows to toggle display mode. |
|
| |
|
| '''NVIDIA Phase 1. NVIDIA GPU Scaling (NVIDIA App / Control Panel''') | | '''Manual Resolution Reset (PC):''' |
| | | # Press <code>Win + R</code>, type <code>%localappdata%low</code>, and open <code>Anvil Game Studio > Holdfast NaW</code>. |
| * '''NVIDIA App Path:''' Open the '''NVIDIA App''' > '''Graphics''' tab > '''Global Settings'''. Ensure '''Image Scaling''' is '''Off'''.
| |
| * '''Legacy Control Panel Path:''' Right-click Desktop > '''NVIDIA Control Panel''' > '''Adjust desktop size and position'''. Under "Select a scaling mode," choose '''No Scaling'''. Click '''Apply'''.
| |
| | |
| '''AMD Phase 1. AMD GPU Scaling (AMD Software: Adrenalin Edition)'''
| |
| | |
| * '''The Path:''' Open '''AMD Software''' > '''Gaming''' > '''Games''' > '''Holdfast: Nations At War'''.
| |
| * '''The Fix:''' Under the '''Display''' section on the right, set '''Scaling Mode''' to '''Preserve Aspect Ratio'''.
| |
| * '''Important:''' Ensure '''Integer Scaling''' is set to '''Disabled''', as this often causes "Out of Range" black screens on 1440p and 4K monitors in the current build.
| |
| | |
| '''Phase 2. Manual Resolution Reset (PC)'''
| |
| | |
| If the scaling fix doesn't work, you must force the game into a Windowed state to reset the engine's display handshake:
| |
| | |
| # Press <code>Win + R</code>, type <code>%localappdata%low</code>, and navigate to <code>Anvil Game Studio > Holdfast NaW</code>. | |
| # Open <code>HoldfastOptions.ini</code> with Notepad. | | # Open <code>HoldfastOptions.ini</code> with Notepad. |
| # Find the line <code>fullscreenMode</code> and change the value to <code>1</code> (Windowed). | | # Find <code>fullscreenMode</code> and change the value to <code>1</code> for Windowed mode. |
| # Save the file and relaunch the game. Once the image appears, you can change your resolution in the in-game settings and switch back to Fullscreen. | | # Save the file and relaunch the game. Once the image appears, set your preferred resolution in-game. |
|
| |
|
| '''Phase 3. The "Alt + Enter" Force-Refresh (PC)''' | | '''The Fix Console:''' |
| | * '''Xbox:''' Settings > TV & Display Options > '''Video Modes'''. Uncheck '''Allow Variable Refresh Rate'''. |
| | * '''PS5:''' Settings > Screen and Video > '''Video Output'''. Set '''VRR''' and '''120 Hz Output''' to '''Off'''. |
| | * Launch the game. Once visuals appear, you can test re-enabling those settings. |
| | </div></div> |
|
| |
|
| If the screen is black but you hear music, press '''Alt + Enter''' on your keyboard. This forces the Windows OS to toggle the display mode. This often "wakes up" the GPU driver and forces it to render the frame buffer correctly.
| | <div class="mw-collapsible mw-collapsed hf-issue-block"> |
| | <div class="hf-issue-heading">Issue 2 - High Polling Rate Stutter (Mouse Lag)</div> |
| | <div class="mw-collapsible-content"> |
| | '''Status:''' Input thread saturation |
|
| |
|
| * '''The Fix Console:''' This is usually a conflict with '''VRR (Variable Refresh Rate)''' or '''120Hz Output''' handshakes.
| | '''Affected Platforms:''' PC |
| * '''Xbox:''' Settings > TV & Display Options > '''Video Modes'''. Uncheck '''Allow Variable Refresh Rate'''.
| |
| * '''PS5:''' Settings > Screen and Video > '''Video Output'''. Set '''VRR''' and '''120 Hz Output''' to '''Off'''.
| |
| * Launch the game; once the visuals appear, you can safely re-enable these settings in the console menu.
| |
|
| |
|
| <!-- KI 2 -->
| | '''The Issue:''' The camera hitches or FPS drops hard when moving the mouse, even on strong hardware. |
| <h3>Known Issue 2 - High Polling Rate Stutter (Mouse Lag)</h3>
| |
| '''Status:''' Unity Engine Constraint (Input Thread Saturation) | |
|
| |
|
| '''The Issue:''' Your camera "hitches" or FPS drops drastically when moving the mouse, even on high-end PCs. | | '''The Cause:''' Mouse polling rates at '''4,000Hz''' or '''8,000Hz''' can flood the engine with input events. |
|
| |
|
| '''The Cause:''' Mouse set to '''4,000Hz or 8,000Hz''' polling rates flood the engine with interrupt requests. | | '''The Fix:''' Open your mouse software, such as Razer Synapse or Logitech G Hub, and lower the polling rate to '''1,000Hz''' or '''500Hz'''. |
| | </div></div> |
|
| |
|
| '''Affected Platforms:''' PC | | <div class="mw-collapsible mw-collapsed hf-issue-block"> |
| | <div class="hf-issue-heading">Issue 3 - Cannot Hear Others Or Speak Through VoIP</div> |
| | <div class="mw-collapsible-content"> |
| | '''Status:''' Dependency, audio device, or system chat conflict |
|
| |
|
| * '''The Fix:''' Open your mouse software (Razer Synapse, Logitech G Hub) and lower the Polling Rate to '''1,000Hz''' or '''500Hz'''.
| | '''Affected Platforms:''' PC, Xbox Series X/S, PS5 |
|
| |
|
| <!-- KI 3 -->
| | '''The Issue:''' You cannot hear players, transmit voice, or have other players hear your custom midi music. On PC, the F2 console may show <code>DllNotFoundException: opus</code>. |
| <h3>Known Issue 3 - Cannot Hear Others Or Speak Through VoIP (Opus.dll & Others)</h3>
| |
| '''Status:''' Dependency / System Priority Error | |
|
| |
|
| '''The Issue:''' You cannot hear others, and the F2 console says <code>DllNotFoundException: opus</code>. | | '''The Fix PC:''' |
| | * Install the latest Microsoft Visual C++ Redistributable. |
| | * Make sure Windows microphone access is enabled: Settings > Privacy & Security > Microphone. |
| | * Ensure '''Let desktop apps access your microphone''' is enabled for Holdfast. |
| | * Press <code>Win + R</code>, type <code>mmsys.cpl</code>, open your microphone properties, then disable '''Allow applications to take exclusive control of this device'''. |
| | * If VoIP still fails, test disabling IPv6 on your active network adapter. |
| | * If custom midi music still cannot be heard by other players after the normal music checks, your account may be VoIP muted. To appeal a mute, use the [https://discord.com/channels/306195621373542400/1422135634889543741 Holdfast: Official Discord appeal channel] with your Steam profile or SteamID and a short explanation. |
|
| |
|
| '''Affected Platforms:''' PC, Xbox Series X|S , PS5 | | '''The Fix Console:''' |
| | * Switch from Party Chat to '''Game Chat'''. |
| | * Hold '''Y''' on Xbox or '''Triangle''' on PS5 to transmit. Holdfast uses push-to-talk. |
| | * '''Xbox:''' Settings > Network > Advanced > Alternate MAC Address > Clear. This restarts the console and resets the VoIP handshake. |
| | </div></div> |
|
| |
|
| * '''The Fix PC:''' Download the latest Microsoft Visual C++ Redistributable. Missing <code>Opus.dll</code> files prevent voice initialization
| | <div class="mw-collapsible mw-collapsed hf-issue-block"> |
| * '''The Fix Console:''' Ensure your console is set to '''Game Chat''', not Party Chat.
| | <div class="hf-issue-heading">Issue 4 - Crashing on Launch or Splash Screen Freeze</div> |
| * '''The Fix Xbox:''' If VOIP fails on Xbox, go to '''Network Settings > Advanced > Alternate MAC Address > Clear'''. This restarts the console and resets the VOIP handshake.
| | <div class="mw-collapsible-content"> |
| | | '''Status:''' Software conflict or file corruption |
| <!-- KI 4 --> | |
| <h3>Known Issue 4 - Crashing on Launch / Splash Screen Freeze</h3> | |
| '''Status:''' Software Conflict / File Corruption | |
|
| |
|
| '''Affected Platforms:''' PC | | '''Affected Platforms:''' PC |
|
| |
|
| '''The Issue:''' The 3.X engine is highly sensitive to corrupted shaders and virtual display drivers. | | '''The Issue:''' The game crashes during startup, freezes on the splash screen, or fails before the menu appears. |
|
| |
|
| '''The Fix:''' | | '''The Fix:''' |
| | * '''Verify Files:''' Run Steam file validation from '''Properties''' > '''Installed Files'''. |
| | * '''Mono Cleanup:''' Go to <code>\Steam\steamapps\common\Holdfast Nations At War</code>, delete the <code>MonoBleedingEdge</code> folder, then verify game files. |
| | * '''Citrix Conflict:''' If you use Citrix Workspace, disable '''Citrix Indirect Display Adapter''' in Windows Device Manager. |
| | * '''Virtual Display Drivers:''' Disable Virtual Desktop, Meta Quest Link, or Pico virtual display adapters if they are active. |
| | * '''Overlays:''' Close MSI Afterburner, RivaTuner, Discord Overlay, Steam Overlay, and similar software while testing. |
| | * '''Admin Mode:''' Right-click <code>Holdfast NaW.exe</code> and select '''Run as administrator'''. |
| | </div></div> |
|
| |
|
| * '''Mono Cleanup:''' Navigate to <code>\Steam\steamapps\common\Holdfast Nations At War</code>. '''Delete''' the <code>MonoBleedingEdge</code> folder. Go to Steam > Right-click Holdfast > '''Properties''' > '''Installed Files''' > '''Verify Integrity of Game Files'''.
| | <div class="mw-collapsible mw-collapsed hf-issue-block"> |
| * '''Citrix Conflict:''' If you use '''Citrix Workspace''', you must disable the "Citrix Indirect Display Adapter" in your Windows '''Device Manager'''. This driver blocks Unity's GPU initialization.
| | <div class="hf-issue-heading">Issue 5 - Cannot See Servers In Lobby</div> |
| * '''Hardware Monitoring:''' Close software like '''MSI Afterburner''' or '''RivaTuner'''. These overlays frequently cause "DirectX Device Lost" errors in the 2026 build.
| | <div class="mw-collapsible-content"> |
| * '''Admin Mode:''' Right-click <code>Holdfast NaW.exe</code> in the installation folder and select '''Run as Administrator'''.
| | '''Status:''' Master server, routing, filter, or authentication issue |
|
| |
|
| <!-- KI 5 -->
| | '''Affected Platforms:''' PC, Xbox Series X/S, PS5 |
| <h3>Known Issue 5 - Cannot See Servers In Lobby (PC & Console)</h3>
| |
| '''Status:''' Ongoing (Master Server Congestion / Routing Error) | |
|
| |
|
| '''The Issue:''' The lobby appears empty, or you are stuck on "Connecting." | | '''The Issue:''' The server browser appears empty, does not populate, or remains stuck on connecting. |
|
| |
|
| '''Affected Platforms:''' PC, Xbox Series X|S , PS5 | | '''Phase 1: Soft Refresh''' |
| | * Click '''Refresh''' several times. |
| | * Make sure '''Hide Empty''' and '''Hide Full''' are unchecked. |
| | * Move the '''Max Ping''' slider all the way right. |
|
| |
|
| * '''The Fix:'''
| | '''Phase 2: Network & Security (PC)''' |
| | * Temporarily disable antivirus tools such as AVG, Avast, or McAfee. |
| | * Check Windows Defender Firewall rules for Holdfast. |
| | * Disable VPN software. If the issue persists, test a VPN in another region to rule out ISP routing. |
| | * Power cycle your router by unplugging it for 30 seconds. |
|
| |
|
| '''Phase 1: The Soft Refresh:''' | | '''Phase 3: Join Custom Server Bypass''' |
| | # Open the '''Server Browser'''. |
| | # If the list is empty, click '''Join Custom Server'''. |
| | # '''PC:''' Look for an official server dropdown or official server option, then connect directly. |
| | # '''Console:''' Use the simplified custom server menu and fetch the official list using the on-screen prompt. |
|
| |
|
| Before checking hardware or network settings, try the internal UI reset.
| | '''Phase 4: Platform Authentication''' |
| | * '''PC (Steam):''' Log out of Steam fully, then log back in to refresh your Steam ticket. |
| | * '''Xbox/PS5:''' Fully shut down the console instead of using Sleep or Rest mode. |
| | * '''Friend Join:''' Join a friend directly through Steam, Xbox, or PlayStation friends list. |
| | * '''Mobile Hotspot Test:''' If servers appear on hotspot but not Wi-Fi, your ISP or router may be blocking the connection. |
| | </div></div> |
|
| |
|
| * '''Refresh Loop:''' Click the '''Refresh''' button (bottom left) 3–5 times. In the 2026 build, the Master Server often requires multiple handshakes to authenticate your session.
| | <div class="mw-collapsible mw-collapsed hf-issue-block"> |
| * '''Filter Check:''' Ensure "Hide Empty" and "Hide Full" are '''Unchecked'''. Set the "Max Ping" slider to the far right.
| | <div class="hf-issue-heading">Issue 6 - Black or Green Screen Artifacts</div> |
| | <div class="mw-collapsible-content"> |
| | '''Status:''' Post-processing desync |
|
| |
|
| '''Phase 2: Network & Security (PC Only):''' | | '''Affected Platforms:''' PS5, Xbox Series X/S |
|
| |
|
| If the browser is still empty, external software is likely blocking the game's outgoing UDP requests.
| | '''The Issue:''' Flickering colors or black/green artifacts appear, often when switching between first and third person or during heavy naval combat. |
|
| |
|
| * '''Disable Anti-Virus:''' Temporarily disable software like '''AVG, Avast, or McAfee'''.
| | '''The Fix:''' |
| * '''Disable Firewall:''' Turn off the Windows Defender Firewall specifically for Holdfast.
| | * Go to '''Settings''' > '''Video'''. |
| * '''Disable VPN:''' Applications like '''NordVPN, ExpressVPN, or BullGuard''' often mask your Steam/Console ticket, preventing the lobby from verifying you. | | * Disable '''Motion Blur''' and '''Depth of Field'''. |
| * '''Reset Internet:''' Power cycle your router (unplug for 30 seconds). | | * '''Xbox Series S:''' If crashes continue, disable '''High Quality Textures''' to reduce memory pressure. |
| | </div></div> |
|
| |
|
| '''Phase 3: The "Join Custom Server" Bypass (PC & Console):''' | | <div class="mw-collapsible mw-collapsed hf-issue-block"> |
| | <div class="hf-issue-heading">Issue 7 - Reload Animation State Lock</div> |
| | <div class="mw-collapsible-content"> |
| | '''Status:''' Animation buffer error |
|
| |
|
| If the standard browser list fails to populate, use this direct handshake method:
| | '''Affected Platforms:''' PC, Xbox Series X/S, PS5 |
|
| |
|
| # Open the '''Server Browser''' from the main menu.
| | '''The Issue:''' Your character has ammunition but refuses to start reloading. |
| # Look at the bottom left. If the list is empty, click '''Join Custom Server'''.
| |
| # '''On PC:''' A prompt will appear. Instead of typing an IP, look for a '''Dropdown Menu''' or '''Toggle''' that says '''"Official Servers."''' Select an Official Server (e.g., ''Official EU1'') and hit '''Connect'''.
| |
| # '''On Console (Xbox/PS5):''' The "Join Custom Server" button opens a simplified menu. Press the '''Y button (Xbox)''' or '''Triangle (PS5)''' to "Fetch Official List." This initiates a direct call to the Anvil Games Server, bypassing the community browser cache that often freezes.
| |
|
| |
|
| '''Phase 4: Platform-Specific Authentication:''' | | '''The Fix:''' Quickly open and close text chat. Use '''Enter''' on PC, '''View Button''' on Xbox, or '''Touchpad''' on PS5. This forces the character back to an idle state and clears the reload block. |
| | </div></div> |
|
| |
|
| * '''PC (Steam):''' Log out of Steam entirely ('''Change Account > Log Out'''), then log back in. This forces a fresh "Steam Ticket" generation.
| | <div class="mw-collapsible mw-collapsed hf-issue-block"> |
| * '''Console (Xbox/PS5):''' Fully shut down your console (do not use Sleep/Rest mode). This clears the cache and forces a new handshake with the AGS Master Server.
| | <div class="hf-issue-heading">Issue 8 - Screen Flickering or Unresponsive After Alt-Tab</div> |
| * '''The VPN Flip:''' If your VPN was already disabled, try '''enabling it''' and selecting a different region.
| | <div class="mw-collapsible-content"> |
| | '''Status:''' Display mode conflict |
|
| |
|
| '''Phase 5: Social & Connection Workarounds:''' | | '''Affected Platforms:''' PC |
|
| |
|
| * '''The "Friend Join" Trick:''' On both Steam and Console (Xbox/PS Friends), the most reliable 100% workaround is to '''Join Session''' directly through your platform's friend list. This completely bypasses the in-game browser.
| | '''The Issue:''' The game flickers, becomes unresponsive, or gets stuck after minimizing or alt-tabbing. |
| * '''Alternative Connection:''' If possible, test your connection using a '''Mobile Hotspot'''. If servers appear on the hotspot but not your Wi-Fi, your ISP is likely blocking the game's port.
| |
|
| |
|
| <!-- KI 6 --> | | '''The Fix:''' |
| <h3>Known Issue 6 - Black/Green Screen Artifacts (PS5/Xbox)</h3> | | * Set '''Window Mode''' to '''Borderless Window''' in video settings. |
| '''Status:''' Post-Processing Desync | | * Disable Discord Overlay and Steam Overlay while testing. |
| | * In Windows, enable '''Optimizations for windowed games''' under Settings > System > Display > Graphics > Change default graphics settings. |
| | * Avoid using <code>-window-mode exclusive</code> in launch options. |
| | </div></div> |
| | |
| | <div class="mw-collapsible mw-collapsed hf-issue-block"> |
| | <div class="hf-issue-heading">Issue 9 - Level 1 or Rank Progress Reset</div> |
| | <div class="mw-collapsible-content"> |
| | '''Status:''' Cloud sync delay |
|
| |
|
| '''The Issue:''' Flickering colors often occur when switching between 1st and 3rd person or during heavy naval combat. | | '''Affected Platforms:''' PC, Xbox Series X/S, PS5 |
|
| |
|
| '''Affected Platforms:''' PS5, Xbox Series X|S | | '''The Issue:''' Your rank appears as Level 1 despite having previous progress. |
|
| |
|
| * '''The Fix:''' Go to '''Settings > Video''' and disable '''Motion Blur''' and '''Depth of Field'''. This stabilizes the rendering stack on console hardware.
| | '''The Fix:''' Do not reinstall. Join an '''Official Server''' and play one full round. The server should force-fetch your profile and restore your rank at the end of the match. |
| * '''Xbox Series S Fix:''' If the game crashes specifically on the Series S, disable '''High Quality Textures''' to prevent VRAM overflow.
| | </div></div> |
|
| |
|
| <!-- KI 7 --> | | <div class="mw-collapsible mw-collapsed hf-issue-block"> |
| <h3>Known Issue 7 - Reload Animation State Lock</h3> | | <div class="hf-issue-heading">Issue 10 - Stuck on Map Loading Screen</div> |
| '''Status:''' Animation Buffer Error | | <div class="mw-collapsible-content"> |
| | '''Status:''' Asset loading or network desync |
|
| |
|
| '''The Issue:''' Your character has ammunition but refuses to start the reload animation. | | '''Affected Platforms:''' PC, Xbox Series X/S, PS5 |
|
| |
|
| '''Affected Platforms:''' PC, Xbox Series X|S , PS5 | | '''The Issue:''' The loading bar reaches 90-100% but the game never enters the spawn menu. |
|
| |
|
| * '''The Fix:''' Quickly open and close the '''Text Chat''' (View Button on Xbox / Touchpad on PS5 / Enter on PC). This forces the character's animation state to "Idle," clearing the reload block.
| | '''The Fix PC:''' |
| | * Verify game files in Steam. |
| | * If joining modded servers, clear or re-download workshop content. |
| | * Move the game to an SSD if it is installed on an older HDD. |
| | * Test VPN off and on, since routing issues can block the final server handshake. |
|
| |
|
| <!-- KI 8 -->
| | '''The Fix Console:''' |
| <h3>Known Issue 8 - Screen Flickering / Unresponsive When Minimizing (Alt-Tab)</h3>
| | * Install the game on the internal SSD. |
| '''Status:''' Display Mode Conflict | | * '''Xbox:''' Do not use Quick Resume. Highlight the game tile > Menu Button > Quit, then relaunch. |
| | * '''Xbox:''' Settings > Network > Advanced Settings > Alternate MAC Address > Clear. |
| | * '''PS5:''' Boot into Safe Mode and use '''Clear Cache and Rebuild Database''' if specific maps always freeze. |
| | * If official servers fail, test DNS such as Primary <code>8.8.8.8</code> and Secondary <code>1.1.1.1</code>. |
| | </div></div> |
|
| |
|
| '''The Issue:''' This occurs when the game and Windows disagree on how to handle the display buffer during a task switch. | | <div class="mw-collapsible mw-collapsed hf-issue-block"> |
| | <div class="hf-issue-heading">Issue 11 - Fatal Crash on Startup (Citrix Workspace)</div> |
| | <div class="mw-collapsible-content"> |
| | '''Status:''' Citrix virtual display conflict |
|
| |
|
| '''Affected Platforms:''' PC | | '''Affected Platforms:''' PC |
|
| |
|
| * '''The Fix:'''
| | '''The Cause:''' Citrix Workspace installs virtual display components that can block Unity's GPU initialization. |
| ** Go to '''Settings > Video''' in-game.
| |
| ** Set your '''Window Mode''' to '''Borderless Window'''. This is the most stable setting for 2026; it allows for instant Alt-Tabbing without desyncing the GPU or getting stuck on a black screen.
| |
| ** '''Disable Overlays:''' Flickering is frequently caused by the '''Discord Overlay''' or '''Steam Overlay''' fighting for control of the window. Disable these in their respective app settings.
| |
| ** '''Windows 11/12 Fix:''' Ensure "Optimizations for windowed games" is '''Enabled''' in your Windows System Settings (''Settings > System > Display > Graphics > Change default graphics settings'').
| |
|
| |
|
| <!-- KI 9 --> | | '''How To Confirm:''' |
| <h3>Known Issue 9 - Level 1 / Rank Progress Reset</h3> | | # Press <code>Win + R</code>, type <code>%localappdata%low</code>, and open <code>Anvil Game Studio > Holdfast NaW</code>. |
| '''Status:''' Cloud-Sync Dela
| | # Open <code>Player.log</code>. |
| | # If you see <code>GfxDevice: creating device client; threaded=1</code> followed by a crash, Citrix may be the cause. |
|
| |
|
| '''The Issue:''' Your rank appears as Level 1 despite previous progress. | | '''The Fix:''' |
| | | * '''Option A:''' Device Manager > Display adapters > Disable '''Citrix Indirect Display Adapter'''. |
| '''Affected Platforms:''' PC, Xbox Series X|S , PS5 | | * '''Option B:''' Device Manager > System devices > Disable '''Citrix Virtual Bus Enumerator'''. |
| | * '''Option C:''' Install the Microsoft Store version of Citrix Workspace, which uses a different driver setup. |
|
| |
|
| * '''The Fix:''' This is a visual desync where the client fails to fetch your profile. '''Do not reinstall.''' Join an '''Official Server''' and play for one full round. The server will force-fetch your data and restore your rank at the end of the match.
| | You may need to re-enable these devices later for work remote desktop sessions. |
| | </div></div> |
|
| |
|
| <!-- KI 10 --> | | <div class="mw-collapsible mw-collapsed hf-issue-block"> |
| <h3>Known Issue 10 - Stuck on Map Loading Screen</h3> | | <div class="hf-issue-heading">Issue 12 - Fatal Crash on Startup (Virtual Desktop & VR Drivers)</div> |
| '''Status:''' Asset Loading Desync
| | <div class="mw-collapsible-content"> |
| | | '''Status:''' GPU initialization conflict |
| '''The Issue:''' The game reaches 90-100% on the loading bar but never enters the spawn menu.
| |
| | |
| '''Affected Platforms:''' PC, Xbox Series X|S , PS5
| |
| | |
| * '''The Fix PC:''' This is usually caused by a single corrupted map asset. Go to Steam > Right-click Holdfast > Properties > Installed Files > Verify Integrity of Game Files.
| |
| * '''The Fix Console:''' On PS5 and Xbox, ensure the game is installed on the Internal SSD. Running Holdfast from an external HDD will cause "Infinite Loading" or "Map Hangs" due to slow read speeds.
| |
| * '''The Fix Xbox:''' If stuck on a load screen, go to Network Settings > Advanced Settings > Alternate MAC Address > Clear. This restarts the console and flushes the temporary data that causes map desyncs.
| |
| | |
| <!-- KI 11 -->
| |
| <h3>Known Issue 11 - Fatal Crash on Startup (Citrix Workspace Conflict)</h3>
| |
| '''Status:''' Software Conflict (Citrix Indirect Display Adapter) | |
| | |
| '''The Cause:''' If you use '''Citrix Workspace''' for work, it installs a virtual display driver that frequently causes Unity games to crash immediately upon initialization.
| |
|
| |
|
| '''Affected Platforms:''' PC | | '''Affected Platforms:''' PC |
|
| |
|
| * '''The Fix:'''
| | '''The Issue:''' Virtual Desktop, Meta Quest Link, Pico Connect, or similar software can create a virtual monitor that the game tries to initialize instead of the physical GPU. |
|
| |
|
| '''Phase 1.''' To confirm this is the cause, check your error log: | | '''The Fix:''' |
| | | * Device Manager > Display adapters > Disable '''Virtual Desktop Monitor''', '''Meta Quest Link Display''', or '''Pico Virtual Display'''. |
| # Press <code>Win + R</code>, type <code>%localappdata%low</code>, and navigate to <code>Anvil Game Studio > Holdfast NaW</code>.
| | * Fully close VR streamer apps before launching Holdfast. |
| # Open <code>Player.log</code>. If you see '''"GfxDevice: creating device client; threaded=1"''' followed immediately by '''"Crash!!!"''', Citrix is the culprit.
| | * Disable '''Hardware-accelerated GPU scheduling''' under Windows Settings > System > Display > Graphics > Change default graphics settings, then restart. |
| | |
| '''Phase 2'''. You do not need to uninstall Citrix. Try these steps in order:
| |
| | |
| * '''Option A: Disable the Virtual Adapter (Recommended):'''
| |
| *# Right-click the '''Start button''' and select '''Device Manager'''. | |
| *# Expand '''Display adapters'''.
| |
| *# Right-click '''Citrix Indirect Display Adapter''' and select '''Disable device'''.
| |
| *# You can now launch Holdfast. ''Note: You may need to re-enable this later for your work remote desktop to function.''
| |
| * '''Option B: Disable the Bus Enumerator:'''
| |
| *# In '''Device Manager''', expand '''System devices'''.
| |
| *# Locate '''Citrix Virtual Bus Enumerator'''. | |
| *# Right-click and select '''Disable device'''. This often resolves the crash without needing to touch the display drivers. | |
| * '''Option C: The Windows Store Version:'''
| |
| *# Uninstall your current Citrix Workspace app.
| |
| *# Download the '''Citrix Workspace''' app directly from the '''Microsoft Store'''.
| |
| *# The Store version uses a different driver architecture that does not conflict with the Unity engine in 2026.
| |
|
| |
|
| | '''Log Clue:''' If <code>Player.log</code> shows <code>GfxDevice: creating device client; threaded=1</code> followed by <code>Crash!!!</code> or <code>Device Lost</code>, an active virtual display driver is likely involved. |
| | </div></div> |
|
| |
|
| <!-- KI 12 --> | | <div class="mw-collapsible mw-collapsed hf-issue-block"> |
| <h3>Known Issue 12 - Fatal Crash on Startup (Virtual Desktop & VR Drivers)</h3> | | <div class="hf-issue-heading">Issue 13 - Cannot Join Modded Server</div> |
| '''Status:''' GPU Initialization Conflict | | <div class="mw-collapsible-content"> |
| | | '''Status:''' Workshop handshake or sync conflict |
| '''The Issue:''' Users of Virtual Desktop, Meta Quest Link, or Pico Connect may experience an instant crash upon launching the game.
| |
| | |
| '''The Cause:''' The game engine attempts to initialize on the "Virtual Monitor" created by your VR software rather than your physical GPU.
| |
|
| |
|
| '''Affected Platforms:''' PC | | '''Affected Platforms:''' PC |
|
| |
|
| * '''The Fix:'''
| | '''The Cause:''' The client and server cannot synchronize required mod files. |
|
| |
|
| '''Phase 1.''' You do not need to uninstall your VR software. Try these steps in order: | | '''The Fix:''' |
| | # In Steam, go to '''Settings''' > '''Downloads''' > '''Clear Download Cache'''. |
| | # Close Holdfast and Steam. Go to <code>Steam\userdata\[YourSteamID]\ugc\workshop</code> and delete <code>subscriptions.vdf</code>. |
| | # If a specific mod is stuck, go to <code>Steam\steamapps\workshop\content\589290</code> and delete the affected content so Steam can redownload it. |
| | </div></div> |
|
| |
|
| * '''Option A: Disable the Virtual Monitor (Recommended):'''
| | <div class="mw-collapsible mw-collapsed hf-issue-block"> |
| *# Right-click the '''Start button''' and select '''Device Manager'''.
| | <div class="hf-issue-heading">Issue 14 - No Main Menu</div> |
| *# Expand '''Display adapters'''.
| | <div class="mw-collapsible-content"> |
| *# Look for '''Virtual Desktop Monitor''', '''Meta Quest Link Display''', or '''Pico Virtual Display'''.
| | '''Status:''' UI layer initialization error |
| *# Right-click and select '''Disable device'''.
| |
| *# Launch Holdfast. You can safely re-enable the driver once you are done playing.
| |
| * '''Option B: Power Cycle the Streamer:'''
| |
| ** Ensure your VR Streamer app (on your PC) is '''completely closed''' and not just minimized to the system tray before launching Holdfast. If the streamer is active, it "claims" the display buffer, preventing ''Holdfast'' from opening in Fullscreen mode.
| |
| * '''Option C: Disable "HAGS" (Windows 11/12):'''
| |
| ** '''Hardware-Accelerated GPU Scheduling (HAGS)''' is known to cause fatal conflicts between Unity and VR drivers.
| |
| ** Go to '''Settings > System > Display > Graphics > Change default graphics settings''' and toggle '''Hardware-accelerated GPU scheduling''' to '''Off'''. Restart your PC and try launching the game again.
| |
|
| |
|
| '''Phase 2. Identifying the Conflict in Logs''' | | '''Affected Platforms:''' PC, Xbox Series X/S, PS5 |
|
| |
|
| If you aren't sure if a VR driver is the cause:
| | '''The Issue:''' The background scene loads, but the Join Game, Armoury, and Settings buttons never appear. |
|
| |
|
| # Open your <code>Player.log</code> in <code>%localappdata%low\Anvil Game Studio\Holdfast NaW\</code>. | | '''The Fix PC:''' |
| # Look for the line: <code>GfxDevice: creating device client; threaded=1</code>. | | # Close the game. |
| # If the very next line is <code>Crash!!!</code> or <code>Device Lost</code>, an active virtual display driver (VR or Citrix) is almost certainly the cause. | | # Press <code>Win + R</code>, type <code>%localappdata%low</code>, and open <code>Anvil Game Studio > Holdfast NaW</code>. |
| | # Delete <code>HoldfastOptions.ini</code>. |
| | # Relaunch the game so the file is regenerated. |
|
| |
|
| <!-- KI 13 --> | | '''UI Safe Mode (PC):''' |
| <h3>Known Issue 13 - Cannot Join Modded Server (Connection/Download Error)</h3> | | * Steam > Holdfast > '''Properties''' > '''Launch Options'''. |
| '''Status:''' Workshop Handshake & Sync Conflict
| | * Add <code>-screen-width 1920 -screen-height 1080</code>. |
| | * Relaunch and remove the launch option after the menu is fixed. |
|
| |
|
| '''The Cause:''' The client and server cannot synchronize the required modification files. | | '''Console Language Test:''' On Xbox or PS5, set the console language to English as a test if the menu still fails to appear. |
| | </div></div> |
|
| |
|
| '''Affected Platforms:''' PC | | <div class="mw-collapsible mw-collapsed hf-issue-block"> |
| | <div class="hf-issue-heading">Issue 15 - Microphone Not Working</div> |
| | <div class="mw-collapsible-content"> |
| | '''Status:''' Audio device handshake or OS privacy conflict |
|
| |
|
| * '''The Fix:'''
| | '''Affected Platforms:''' PC, Xbox Series X/S, PS5 |
|
| |
|
| '''Phase 1.''' In Steam, go to '''Settings > Downloads > Clear Download Cache'''. Steam will restart. This forces the client to re-check all <code>modlist.txt</code> requirements for Holdfast. | | '''The Fix PC:''' |
| | * Windows Settings > Privacy & Security > Microphone. Turn on microphone access. |
| | * Enable '''Let desktop apps access your microphone'''. |
| | * Press <code>Win + R</code>, type <code>mmsys.cpl</code>, and open your microphone's advanced properties. Disable exclusive mode. |
| | * If VoIP fails on some routers, test disabling IPv6 on your active adapter. |
|
| |
|
| '''Phase 2.''' Close Holdfast and Steam. Navigate to: <code>Steam\userdata\[YourSteamID]\ugc\workshop</code>. Delete the <code>subscriptions.vdf</code> file. Relaunch Steam; this forces a full re-sync of every mod you are subscribed to, fixing 99% of "Version Mismatch" errors. | | '''The Fix Console:''' |
| | * Switch from Party Chat to Game Chat. |
| | * Hold '''Y''' on Xbox or '''Triangle''' on PS5 to transmit. |
| | * If the mic works elsewhere but not in Holdfast, clear Alternate MAC Address on Xbox. |
| | </div></div> |
|
| |
|
| '''Phase 3.''' If a specific mod is stuck, go to <code>Steam\steamapps\workshop\content\589290</code> and delete the contents. Steam will re-download the clean versions next time you try to join a modded server. | | <div class="mw-collapsible mw-collapsed hf-issue-block"> |
| | <div class="hf-issue-heading">Issue 16 - Game Stuck on Map Load</div> |
| | <div class="mw-collapsible-content"> |
| | '''Status:''' Asset synchronization or network timeout |
|
| |
|
| <!-- KI 14 -->
| | '''Affected Platforms:''' PC, Xbox Series X/S, PS5 |
| <h3>Known Issue 14 - No Main Menu (Camera Stuck on Cannon/Howitzer Background)</h3>
| |
| '''Status:''' UI Layer Initialization Error | |
|
| |
|
| '''The Cause:''' The game loads the background scene, but the buttons (Join Game, Armoury, Settings) never appear. | | '''The Fix PC:''' |
| | * Verify game files through Steam. |
| | * If this happens mostly on modded servers, refresh workshop content. |
| | * Move the game to an SSD if installed on an HDD. |
| | * Test VPN off and on to rule out routing issues. |
|
| |
|
| '''Affected Platforms:''' PC, Xbox Series X|S , PS5 | | '''The Fix Console:''' |
| | * '''Xbox:''' Fully quit the game instead of using Quick Resume. |
| | * '''Xbox:''' Clear Alternate MAC Address from network settings. |
| | * '''PS5:''' Clear cache and rebuild database if the same maps repeatedly freeze. |
| | * '''DNS:''' If official servers are affected, test Primary DNS <code>8.8.8.8</code> and Secondary DNS <code>1.1.1.1</code>. |
| | </div></div> |
|
| |
|
| * '''The Fix:'''
| | <div class="mw-collapsible mw-collapsed hf-issue-block"> |
| | <div class="hf-issue-heading">Issue 17 - Reginald 'One Eyed' Fitzgerald Head Not Unlocking</div> |
| | <div class="mw-collapsible-content"> |
| | '''Status:''' Legacy unlock method replaced |
|
| |
|
| '''Option A: The Configuration Reset (PC):''' | | '''Affected Platforms:''' PC, Xbox Series X/S, PS5 |
|
| |
|
| # Close the game.
| | '''The Cause:''' Rewards are no longer tracked through local Discord app detection. You must link your game profile to Discord in-game. |
| # Press <code>Win + R</code>, type <code>%localappdata%low</code>, and navigate to <code>Anvil Game Studio > Holdfast NaW</code>.
| |
| # '''Delete''' the file named <code>HoldfastOptions.ini</code>.
| |
| # Relaunch the game. The engine will generate a fresh, default configuration file, which forces the UI layer to re-anchor to your current resolution.
| |
|
| |
|
| '''Option B: UI Safe-Mode (PC):''' | | '''The Fix:''' |
| | # Join the [https://discord.com/invite/holdfastgame Official Holdfast Discord]. |
| | # Open Holdfast and go to '''Armoury''' > '''Social'''. |
| | # Select '''Link Discord''' and copy the challenge code. |
| | # Go to the Discord channel used for game profile linking and follow the bot instructions. |
| | # Return to the Armoury once the bot confirms the link. |
| | </div></div> |
| | }} |
|
| |
|
| * If the menu is still missing, go to Steam > Right-click Holdfast > '''Properties'''.
| | {{Release_section |
| * In '''Launch Options''', type: <code>-screen-width 1920 -screen-height 1080</code>.
| | |id=steam-issues |
| * This forces a standard aspect ratio that often "pops" the UI back into the visible frame if it was bugged by an ultrawide or custom resolution.
| | |title=Steam Related Issues |
| | |content= |
| | <div class="mw-collapsible mw-collapsed hf-issue-block"> |
| | <div class="hf-issue-heading">Steam Issue - 1 - Content File Locked or Write Error</div> |
| | <div class="mw-collapsible-content"> |
| | '''Status:''' File permission conflict |
|
| |
|
| '''Option C: Language Sync Fix (Console):''' | | '''Affected Platforms:''' PC |
|
| |
|
| * On '''Xbox''' and '''PS5''', this is often caused by a mismatch between the console's system language and the game's supported localization. Ensure your console language is set to '''English (US or UK)''' as a test to see if the menu returns.
| | '''The Cause:''' Windows, Steam, or antivirus software is preventing Steam from modifying the game after a patch. |
|
| |
|
| <!-- KI 15 -->
| | '''The Fix:''' |
| <h3>Known Issue 15 - Microphone Not Working (VOIP / Proximity Chat)</h3>
| | * Restart your PC to clear locked file handles. |
| '''Status:''' Audio Device Handshake / OS Privacy Conflict | | * Steam > Settings > Downloads > '''Clear Download Cache'''. |
| | * Right-click Steam > Properties > Compatibility > enable '''Run this program as an administrator'''. |
| | * Temporarily disable antivirus software while updating, then re-enable it after the update completes. |
| | </div></div> |
|
| |
|
| '''The Cause:''' This occurs when the game cannot claim the "Exclusive Mode" of your microphone or is being blocked by system-level privacy settings.
| | <div class="mw-collapsible mw-collapsed hf-issue-block"> |
| | <div class="hf-issue-heading">Steam Issue - 2 - Workshop Mods Causing Issues</div> |
| | <div class="mw-collapsible-content"> |
| | * Clear Steam's download cache. |
| | * Delete stuck workshop content from <code>Steam\steamapps\workshop\content\589290</code>. |
| | * Rejoin the server so Steam downloads clean mod files. |
| | </div></div> |
|
| |
|
| '''Affected Platforms:''' PC, Xbox Series X|S, PS5 | | <div class="mw-collapsible mw-collapsed hf-issue-block"> |
| | <div class="hf-issue-heading">Steam Issue - 3 - EAC (Easy Anti-Cheat) Errors</div> |
| | <div class="mw-collapsible-content"> |
| | * Navigate to the game's install folder and run the EAC setup tool manually. |
| | * Close third-party software that may interfere with EAC, including some RGB, macro, or overlay tools. |
| | </div></div> |
| | }} |
|
| |
|
| * '''The Fix PC:'''
| | {{Release_section |
| | |id=linux-troubleshooting |
| | |title=Linux Troubleshooting |
| | |content= |
| | Holdfast is not a native Linux title and generally requires Steam Play with Proton. Proton support can vary by distribution, driver stack, and filesystem. Some distributions include Proton support by default, while others require additional setup. If Proton is not available in Steam, install and enable Steam Play first. A community guide for installing Proton is available here: [https://www.youtube.com/watch?v=xWuY59JVOts Installing Proton]. |
|
| |
|
| '''Privacy Toggle:''' Go to Windows Settings > Privacy & Security > Microphone. Ensure "Microphone Access" is ON and specifically that "Let desktop apps access your microphone" is toggled ON for Holdfast. | | <div class="mw-collapsible mw-collapsed hf-issue-block"> |
| | <div class="hf-issue-heading">Linux Issue - 1 - Game Does Not Launch Under Proton</div> |
| | <div class="mw-collapsible-content"> |
| | '''Status:''' Proton compatibility, runtime, or local file issue |
|
| |
|
| '''The IPv6 Fix''': A specific bug in the 3.X engine's Vivox integration causes VOIP to fail on certain routers using IPv6. | | '''Affected Platforms:''' Linux PC, Steam Deck, SteamOS |
|
| |
|
| # Go to Control Panel > Network and Sharing Center > Change adapter settings.
| | '''Try This First:''' |
| # Right-click your connection > Properties.
| | * '''Verify Files:''' Steam > Holdfast > '''Properties''' > '''Installed Files''' > '''Verify integrity of game files'''. |
| # Uncheck "Internet Protocol Version 6 (TCP/IPv6)". Click OK and relaunch.
| |
|
| |
|
| '''Exclusive Mode:''' Press <code>Win + R</code>, type <code>mmsys.cpl</code>. Under the Recording tab, right-click your mic > Properties > Advanced. Uncheck "Allow applications to take exclusive control of this device". | | '''Force A Proton Version:''' |
| | # Open your Steam Library and right-click '''Holdfast: Nations At War'''. |
| | # Select '''Properties''' > '''Compatibility'''. |
| | # Enable '''Force the use of a specific Steam Play compatibility tool'''. |
| | # Try '''Proton Experimental''', '''Proton 8.0''', or '''GE-Proton'''. |
| | # Restart Steam, then launch the game again. |
|
| |
|
| * '''The Fix Console:''' | | '''Optional Proton-GE Setup:''' |
| | * Download GE-Proton from [https://github.com/GloriousEggroll/proton-ge-custom GloriousEggroll/proton-ge-custom]. |
| | * Place it in <code>~/.steam/root/compatibilitytools.d/</code>. |
| | * Restart Steam and select GE-Proton from '''Properties''' > '''Compatibility'''. |
| | </div></div> |
|
| |
|
| '''Party Chat Conflict:''' If you are in a PlayStation or Xbox Party, the game’s Push-to-Talk (PTT) will be muted by the OS. You must switch to Game Chat in your console's Quick Menu. | | <div class="mw-collapsible mw-collapsed hf-issue-block"> |
| | <div class="hf-issue-heading">Linux Issue - 2 - Steam Runtime Or Dependency Problems</div> |
| | <div class="mw-collapsible-content"> |
| | '''Status:''' Missing Steam Linux Runtime components |
|
| |
|
| '''PTT Indicator:''' On console, Holdfast uses Push-to-Talk only. Hold Y (Xbox) or Triangle (PS5). If the microphone icon does not appear above your health bar, your mic is not being detected at the hardware level. | | '''The Issue:''' Proton gets stuck, fails to install dependencies, or the game exits before opening. |
|
| |
|
| '''Alternate MAC Address (Xbox):''' If your mic works in other games but not Holdfast, go to Settings > Network > Advanced > Alternate MAC Address > Clear. This clears the network cache associated with the VOIP handshake. | | '''The Fix:''' |
| | * Search your Steam Library for '''Steam Linux Runtime - Sniper'''. |
| | * Search your Steam Library for '''Steam Linux Runtime - Soldier'''. |
| | * Make sure both runtimes are downloaded and installed on the same drive as Holdfast. |
| | * Restart Steam after installing or moving runtime components. |
| | </div></div> |
|
| |
|
| <!-- KI 16 --> | | <div class="mw-collapsible mw-collapsed hf-issue-block"> |
| <h3>Known Issue 16 - Game Stuck on Map Load</h3> | | <div class="hf-issue-heading">Linux Issue - 3 - exFAT, NTFS, Or Permission Issues</div> |
| '''Status:''' Asset Synchronization or Network Timeout | | <div class="mw-collapsible-content"> |
| | '''Status:''' Proton filesystem incompatibility |
|
| |
|
| '''The Cause:''' This occurs when the client fails to download the final map metadata or cannot handshake with the server's instance after the map has loaded. | | '''The Issue:''' If Holdfast is installed on an exFAT or NTFS Steam library, Proton may fail silently or close immediately. |
|
| |
|
| '''Affected Platforms:''' PC, Xbox Series X|S, PS5 | | '''The Fix:''' |
| | * Move the game to a native Linux filesystem such as '''ext4''', '''btrfs''', or '''xfs'''. |
| | * Use your distribution's partition manager, such as GParted, if you need to create or resize Linux partitions. |
| | * Steam > Holdfast > '''Properties''' > '''Installed Files''' > '''Move Install Folder'''. |
| | </div></div> |
|
| |
|
| * '''The Fix PC:'''
| | <div class="mw-collapsible mw-collapsed hf-issue-block"> |
| | <div class="hf-issue-heading">Linux Issue - 4 - Steam Overlay Or Gamemode Crash</div> |
| | <div class="mw-collapsible-content"> |
| | '''Status:''' Overlay preload or launch wrapper conflict |
|
| |
|
| '''Verify Workshop Integrity:''' Map loading freezes are almost always caused by a corrupted map file (especially on modded servers). | | '''Common Log Error:''' |
| | <code>ERROR: ld.so: object 'gameoverlayrenderer.so' ... wrong ELF class</code> |
|
| |
|
| # Close Holdfast.
| | '''The Fix:''' |
| # Go to Steam > Right-click Holdfast > Properties > Installed Files > Verify Integrity of Game Files.
| | * Disable the Steam Overlay for Holdfast: Steam > Right-click Holdfast > '''Properties''' > disable '''Steam Overlay'''. |
| | * If Gamemode is injecting incorrectly, add this launch option: |
| | <code>gamemoderun=0 %command%</code> |
|
| |
|
| '''SSD Requirement:''' If the game is installed on an older HDD, the engine may timeout during asset decryption. Moving the game to an SSD is the primary fix for "Infinite Loading." | | '''Gentoo Note:''' Unity games may fail when Steam's overlay preloads 32-bit libraries on Gentoo. Disabling the Steam Overlay is the recommended first test. |
| | </div></div> |
|
| |
|
| '''The VPN Toggle:''' While old advice said "Disable it," 2026 routing is complex. If you are stuck on a load screen: | | <div class="mw-collapsible mw-collapsed hf-issue-block"> |
| | <div class="hf-issue-heading">Linux Issue - 5 - Corrupted Proton Prefix</div> |
| | <div class="mw-collapsible-content"> |
| | '''Status:''' Broken Proton compatibility prefix |
|
| |
|
| # If VPN is OFF: Try turning it ON to a different region to bypass an ISP routing bottleneck.
| | '''The Issue:''' Corrupted prefixes can cause silent crashes or repeat startup failures. |
| # If VPN is ON: Turn it OFF, as some VPNs block the specific UDP ports (7777-7780) used for the final server handshake.
| |
|
| |
|
| * '''The Fix Console:'''
| | '''The Fix:''' |
| | # Close Holdfast and Steam. |
| | # Delete this folder: <code>~/.steam/steam/steamapps/compatdata/589290/</code>. |
| | # Relaunch Holdfast so Proton rebuilds a clean prefix. |
| | </div></div> |
|
| |
|
| '''The Quick Resume Bug (Xbox):''' This is the #1 cause of stuck loading screens on Xbox. Never use Quick Resume for Holdfast. Always highlight the game tile > Menu Button > Quit, then relaunch. | | <div class="mw-collapsible mw-collapsed hf-issue-block"> |
| | <div class="hf-issue-heading">Linux Issue - 6 - Missing Vulkan Drivers</div> |
| | <div class="mw-collapsible-content"> |
| | '''Status:''' Missing 32-bit or 64-bit Vulkan stack |
|
| |
|
| '''Alternate MAC Address (Xbox):''' If stuck at 99%, go to Settings > Network Settings > Advanced Settings > Alternate MAC Address > Clear. This clears the temporary network cache that often holds a "stale" connection to the previous map. | | '''The Issue:''' Holdfast runs on Unity through Proton and requires working Vulkan drivers. Missing 32-bit Vulkan support can cause instant launch failures. |
|
| |
|
| '''Rebuild Database (PS5):''' If certain maps (like ''Palisade'') always freeze, boot your PS5 into Safe Mode (hold power for 2 beeps) and select Option 5: Clear Cache and Rebuild Database. | | '''Arch / CachyOS:''' |
| | * <code>sudo pacman -S vulkan-icd-loader lib32-vulkan-icd-loader</code> |
|
| |
|
| * '''The Fix PC/Console:''' DNS Handshake
| | '''Fedora / Nobara:''' |
| | * <code>sudo dnf install vulkan-loader.i686 vulkan-loader.x86_64</code> |
|
| |
|
| # If you are stuck on the loading screen only when joining Official Servers, your ISP is likely failing to resolve the AGS API.
| | '''Ubuntu / Mint:''' |
| # Change your Primary DNS to 8.8.8.8 and Secondary to 1.1.1.1.
| | * <code>sudo apt install mesa-vulkan-drivers mesa-vulkan-drivers:i386</code> |
|
| |
|
| <!-- KI 17 --> | | '''Gentoo Multilib Setup:''' |
| <h3>Known Issue 17 - Reginald 'One Eyed' Fitzgerald Head Not Unlocking</h3> | | * <code>eselect profile list</code> |
| '''Status:''' Legacy Method Deprecated (Switch to Code Challenge)
| | * <code>eselect profile set <multilib profile></code> |
|
| |
|
| '''The Cause:''' As of the 3.X build, rewards are no longer tracked by local Discord app detection. You must now manually link your game profile to your Discord account via the in-game Armoury. | | '''Gentoo Vulkan Packages:''' |
| | * <code>emerge -av media-libs/mesa</code> |
| | * <code>emerge -av media-libs/mesa[abi_x86_32]</code> |
| | * <code>emerge -av media-libs/vulkan-loader</code> |
| | * <code>emerge -av media-libs/vulkan-loader[abi_x86_32]</code> |
|
| |
|
| '''Affected Platforms:''' PC, Xbox Series X|S, PS5 | | '''Gentoo NVIDIA:''' |
| | * Install <code>nvidia-drivers</code>. |
| | * Make sure the relevant USE flags are enabled, including <code>opengl</code>, <code>X</code>, <code>tools</code>, and <code>abi_x86_32</code>. |
|
| |
|
| * '''The Fix:'''
| | '''Gentoo AMD:''' |
| | * Use Mesa with <code>vulkan-radeon</code> and <code>abi_x86_32</code> enabled. |
| | </div></div> |
|
| |
|
| '''Join the Discord''': If you haven't already, join the [[/discord.gg/holdfastgame|Official Holdfast Discord]]. | | <div class="mw-collapsible mw-collapsed hf-issue-block"> |
| | <div class="hf-issue-heading">Linux Issue - 7 - Wayland, Citrix, Or Startup Conflicts</div> |
| | <div class="mw-collapsible-content"> |
| | '''Status:''' Display server or injected library conflict |
|
| |
|
| '''Generate Your Code:''' Open Holdfast and navigate to Armoury > Social. Click the Link Discord button. The game will provide you with a unique Challenge Code. | | '''Wayland Test:''' |
| | * Some Unity games fail under certain Wayland compositor setups. |
| | * Try running Steam from an X11 session. |
| | * As a test, add this launch option: <code>PROTON_USE_WINED3D=1 %command%</code>. |
|
| |
|
| '''Bot Verification:''' Go to the Official Holdfast Discord and find the <code>#link-game-profile</code> channel. Follow the instructions. | | '''Citrix Workspace Conflict:''' |
| | * Citrix Workspace can inject libraries that cause fatal Unity startup crashes. |
| | * If Citrix is installed, remove it using your distribution's package manager. |
| | * Debian / Ubuntu example: <code>sudo apt remove icaclient</code>. |
| | * Gentoo example: <code>emerge -C icaclient</code>. |
| | </div></div> |
|
| |
|
| '''Claim Reward:''' Once the bot confirms the link, return to the in-game Armoury. | | <div class="mw-collapsible mw-collapsed hf-issue-block"> |
| }}
| | <div class="hf-issue-heading">Linux Issue - 8 - Diagnostic Logs</div> |
| | <div class="mw-collapsible-content"> |
| | '''Status:''' Use logs to identify the actual failure |
|
| |
|
| {{Release_section
| | '''Enable Proton Logs:''' |
| |id=steam-issues
| | # Open Steam > Holdfast > '''Properties''' > '''General'''. |
| |title=Steam Related Issues
| | # In '''Launch Options''', add <code>PROTON_LOG=1 %command%</code>. |
| |content=
| | # Launch the game and allow it to fail. |
| <!-- Steam 1 --> | | # Check your Home directory for <code>steam-589290.log</code>. |
| <h3>Steam Known Issue 1 - Steam Content File Locked / Write Error</h3> | |
| '''Status:''' File Permission Conflict
| |
|
| |
|
| '''The Cause:''' This occurs when Windows or an overzealous Anti-Virus prevents Steam from modifying the game's executable after a patch. | | '''Run Steam From Terminal:''' |
| | # Open a terminal. |
| | # Run <code>steam</code>. |
| | # Launch Holdfast and watch the terminal output. |
|
| |
|
| '''Affected Platforms:''' PC | | '''Useful Errors To Look For:''' |
| | | * Missing Vulkan ICDs. |
| * '''The Fix:''' | | * <code>wrong ELF class</code> overlay preload errors. |
| | | * Proton prefix corruption. |
| '''Phase 1:''' Restart your PC: This is the most effective way to clear a "locked" file state.
| | * Unity crash signatures. |
| | | </div></div> |
| '''Phase 2:''' Clear Download Cache: In Steam, go to Settings > Downloads > Clear Download Cache.
| |
| | |
| '''Phase 3'''. Run as Admin: Right-click the Steam Shortcut on your desktop > Properties > Compatibility > Check "Run this program as an administrator".
| |
| }} | | }} |
|
| |
|
| Line 444: |
Line 581: |
| |title=Game Tips | | |title=Game Tips |
| |content= | | |content= |
| <!-- Tip 1 --> | | <div class="mw-collapsible mw-collapsed hf-issue-block"> |
| <h3>Game Tip 1 - Orbit Camera (Look Around) Not Working</h3> | | <div class="hf-issue-heading">Game Tip 1 - Orbit Camera Not Working</div> |
| '''Status:''' Updated for Cross-Platform
| | <div class="mw-collapsible-content"> |
| | | '''Status:''' Regional keyboard conflict |
| '''The Cause:''' If the tilde <code>~</code> key is unresponsive, it is likely due to a regional keyboard conflict (common with UK/EU layouts). | |
|
| |
|
| '''Affected Platforms:''' PC | | '''Affected Platforms:''' PC |
|
| |
|
| * '''The Fix:''' Go to Settings > Keys and rebind Orbit Camera to <code>Left Alt</code> or <code>Caps Lock</code>.
| | '''The Cause:''' If the tilde <code>~</code> key is unresponsive, it may be due to a regional keyboard layout. |
|
| |
|
| <!-- Tip 2 --> | | '''The Fix:''' Go to Settings > Keys and rebind Orbit Camera to <code>Left Alt</code>, <code>Caps Lock</code>, or another comfortable key. |
| <h3>Game Tip 2 - Auto Bayonet Switch (Melee Conflict)</h3> | | </div></div> |
| '''Status:''' Highly Recommended for Competitive Play
| |
|
| |
|
| '''The Cause:''' If you find yourself accidentally stabbing when you meant to fire, the "Auto Bayonet Switch" is likely active. | | <div class="mw-collapsible mw-collapsed hf-issue-block"> |
| | <div class="hf-issue-heading">Game Tip 2 - Auto Bayonet Switch</div> |
| | <div class="mw-collapsible-content"> |
| | '''Status:''' Recommended setting check |
|
| |
|
| * '''The Fix:''' Go to Settings > Game > search for "Auto Switch Bayonet" and set it to OFF.
| | '''The Cause:''' If you stab when you meant to fire, '''Auto Switch Bayonet''' may be enabled. |
|
| |
|
| <!-- Tip 3 -->
| | '''The Fix:''' Go to Settings > Game and set '''Auto Switch Bayonet''' to '''Off'''. |
| <h3>Game Tip 3 - Melee Fluidity & "Smooth" vs. "Raw" Input</h3>
| | </div></div> |
| '''Status:''' Engine Feature | |
|
| |
|
| '''The Cause:''' If melee feels "stiff" or "restrictive," it is often due to the new Melee Sensitivity Type introduced in the 3.X engine. | | <div class="mw-collapsible mw-collapsed hf-issue-block"> |
| | <div class="hf-issue-heading">Game Tip 3 - Melee Fluidity and Input Type</div> |
| | <div class="mw-collapsible-content"> |
| | '''Status:''' Engine feature |
|
| |
|
| * '''The Fix:'''
| | '''The Cause:''' If melee feels stiff or restrictive, check the melee sensitivity type. |
|
| |
|
| # Go to Settings > Game > Advanced Settings. | | '''The Fix:''' |
| # Look for Melee Sensitivity Type. | | # Go to Settings > Game > Advanced Settings. |
| # Raw: Best for "Spinners" and high-level players. It removes all camera smoothing. | | # Find '''Melee Sensitivity Type'''. |
| # Smooth (Legacy): Better for beginners who find the camera too jittery during 4-directional blocking. | | # '''Raw:''' Best for high-level players who want direct camera control. |
| | | # '''Smooth:''' Better for newer players who find melee camera movement too jittery. |
| '''Sensitivity Tip:''' Set your Melee Combat Sensitivity to at least 2.0 (PC) or 2.2 (Console) to remain competitive in 360-degree combat.
| |
|
| |
|
| <!-- Tip 4 -->
| | '''Sensitivity Tip:''' Set melee combat sensitivity high enough that you can comfortably block in all directions. Many players prefer at least 2.0 on PC or slightly higher on console. |
| <h3>Game Tip 4 - Recording & Shadowplay (NVIDIA App)</h3> | | </div></div> |
| '''Status:''' Parameter Update Warning
| |
|
| |
|
| '''The Cause:''' Do NOT use <code>-window-mode exclusive</code> This parameter causes the game to crash when Alt-Tabbing and interferes with NVIDIA Reflex.
| | <div class="mw-collapsible mw-collapsed hf-issue-block"> |
| | <div class="hf-issue-heading">Game Tip 4 - Recording & Shadowplay</div> |
| | <div class="mw-collapsible-content"> |
| | '''Status:''' Capture setup note |
|
| |
|
| '''Affected Platforms:''' PC | | '''Affected Platforms:''' PC |
|
| |
|
| * '''The Fix:'''
| | '''The Fix:''' |
| | | * Set the game to '''Borderless Window''' in video settings. |
| # Set the game to Borderless Window in the video settings.
| | * Open the NVIDIA App and ensure '''Desktop Capture''' is enabled in privacy settings. |
| # Open the NVIDIA App (formerly Geforce Experience) and ensure "Desktop Capture" is enabled in the Privacy settings.
| | * Do not use <code>-window-mode exclusive</code>. It can cause crashes when alt-tabbing and interfere with capture tools. |
| # The NVIDIA App recognizes Holdfast’s 3.X engine natively; if it fails to record, simply Verify Integrity of Game Files to refresh the API handshake.
| | * If capture fails after an update, verify game files to refresh the local install. |
| | | </div></div> |
| <!-- Tip 5 --> | |
| <h3>Game Tip 5 - Stuttering, G-Sync, and NVIDIA Reflex</h3>
| |
| '''Status:''' Standard V-Sync
| |
| | |
| '''The Cause:''' Considered a secondary fix for the smoothest experience
| |
|
| |
|
| '''Affected Platforms:''' PC, Xbox Series X|S, PS5 | | <div class="mw-collapsible mw-collapsed hf-issue-block"> |
| | <div class="hf-issue-heading">Game Tip 5 - Stuttering, G-Sync, and NVIDIA Reflex</div> |
| | <div class="mw-collapsible-content"> |
| | '''Status:''' Performance tuning |
|
| |
|
| * '''The Fix PC (NVIDIA):'''
| | '''Affected Platforms:''' PC, Xbox Series X/S, PS5 |
|
| |
|
| # Enable NVIDIA Reflex (On + Boost) in the Video settings. This automatically caps your FPS and minimizes input lag better than V-Sync.
| | '''The Fix PC (NVIDIA):''' |
| # Disable in-game VSYNC.
| | * Enable '''NVIDIA Reflex''' in video settings if available. |
| | * Disable in-game V-Sync while testing. |
| | * Use a frame cap below your monitor refresh rate if G-Sync or FreeSync is active. |
|
| |
|
| * '''The Fix PC (AMD):''' Enable Radeon Anti-Lag+ and set a frame cap 3 FPS below your monitor's refresh rate.
| | '''The Fix PC (AMD):''' |
| | * Enable Radeon Anti-Lag if available. |
| | * Set a frame cap slightly below your monitor refresh rate. |
|
| |
|
| * '''The Fix Console:''' Go to Settings > Video and toggle Performance Mode. This targets 60 FPS (up to 120 FPS on supported displays) by dynamically scaling resolution.
| | '''The Fix Console:''' |
| | * Use Performance Mode in video settings if available. |
| | * Disable VRR or 120Hz output temporarily if the display becomes unstable. |
| | </div></div> |
| }} | | }} |
|
| |
|
| Line 513: |
Line 659: |
| |title=Server-Side Issues | | |title=Server-Side Issues |
| |content= | | |content= |
| <!-- Server 1 --> | | <div class="mw-collapsible mw-collapsed hf-issue-block"> |
| <h3>Known Issue (Server) - Your Server Is Experiencing Latency Issues</h3> | | <div class="hf-issue-heading">Server Issue - 1 - Server Latency Issues</div> |
| Take note of the following points if the server you are hosting is experiencing latency issues.
| | <div class="mw-collapsible-content"> |
| | If the server you are hosting is experiencing latency problems, check the following before escalating. |
|
| |
|
| The documentation for hosting a server can be found down below. | | The server hosting documentation can be found here: |
|
| |
|
| '''[[Server_Hosting|Host Your Own Game Server! - Documentation]]''' | | '''[[Server Hosting|Host Your Own Game Server - Documentation]]''' |
|
| |
|
| '''Take note of the following:''' | | '''Take note of the following:''' |
| # Make sure that your CPU has a core speed of at least 3.6 GHz and that you’re not exceeding your bandwidth. You should also run your game server on a single physical and logical core. | | # Make sure your CPU has a core speed of at least 3.6 GHz. |
| # Make sure that your server box's 'Power Options' are set to '''High Performance''' on Windows. By default, this is set to 'Balanced'. Please change this! | | # Avoid exceeding your available bandwidth. |
| # Make sure that you have the latest Windows updates installed on your machine. This is very important. | | # Run the game server on a single physical and logical core. |
| # Make sure that you follow the folder structure as defined in the documentation. Copy over the ‘holdfast_naw_public_servers’ folder over to your root drive then include the contents of the game from Steam in the ‘holdfast_naw_public_server’ folder. | | # Set the server machine's Windows Power Options to '''High Performance'''. |
| # Make sure that you port forward the game ports from your firewall and router, (outbound and inbound), on UDP. | | # Install the latest Windows updates. |
| # Don’t rename the ‘Holdfast NaW.exe’ executable. | | # Follow the documented folder structure. Copy <code>holdfast_naw_public_servers</code> to your root drive, then include the game files inside <code>holdfast_naw_public_server</code>. |
| # Don’t switch between Naval and Army based game modes. | | # Port forward the game ports through firewall and router, both outbound and inbound, over UDP. |
| | # Do not rename <code>Holdfast NaW.exe</code>. |
| | # Do not switch the same running server between Naval and Army game modes. |
| | </div></div> |
| | |
| | <div class="mw-collapsible mw-collapsed hf-issue-block"> |
| | <div class="hf-issue-heading">Server Issue - 2 - High Ping / Rubberbanding</div> |
| | <div class="mw-collapsible-content"> |
| | * Connect to servers in your region. |
| | * Test with Ethernet instead of Wi-Fi. |
| | * Close downloads, streams, and cloud sync tools while playing. |
| | * If the server is community-hosted, test another server to rule out host-side issues. |
| | </div></div> |
| | |
| | <h3>Server Administration</h3> |
| | * For server hosting guides and configuration, see [[Server Hosting]] and [[Server Configuration]]. |
| | * Custom map rotations and game mode settings can be configured with the documented server configuration files. |
| }} | | }} |
|
| |
|