← Older editNewer edit →
VisualWikitext
Xarkanoth (talk | contribs)
designer, regimentsupport, Administrators, wikieditor
1,221 edits
No edit summary
Xarkanoth (talk | contribs)
designer, regimentsupport, Administrators, wikieditor
1,221 edits
No edit summary
Line 1: Line 1:
<div class="hf-relpage">
<div class="hf-relpage">
{{Release_page_header|title=Known Issues & Solutions}}
{{Release_page_header|title=Tech Support}}
<div class="hf-relpage-body">
<div class="hf-relpage-body">
{{Release_TOC|content=
{{Release_TOC|content=
Line 34: Line 34:


<h3>2. Error Logging & Console Access</h3>
<h3>2. 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:''' Your crash data is stored at <code>%userprofile%\AppData\LocalLow\Anvil Game Studio\Holdfast NaW\Player.log</code>.
Line 47: Line 48:
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!  
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!  


<!-- KI 1 -->
<h3>Known Issue 1 - Black Screen on Launch (Audio/Music Playing)</h3>
<h3>Known Issue 1 - Black Screen on Launch (Audio/Music Playing)</h3>
'''Status:''' GPU Scaling & Handshake Conflict  
'''Status:''' GPU Scaling & Handshake Conflict  
Line 86: Line 86:
* Launch the game; once the visuals appear, you can safely re-enable these settings in the console menu.
* Launch the game; once the visuals appear, you can safely re-enable these settings in the console menu.


<!-- KI 2 -->
<h3>Known Issue 2 - High Polling Rate Stutter (Mouse Lag)</h3>
<h3>Known Issue 2 - High Polling Rate Stutter (Mouse Lag)</h3>
<h3>High Polling Rate Stutter (Mouse Lag)</h3>
'''Status:''' Unity Engine Constraint (Input Thread Saturation)
'''Status:''' Unity Engine Constraint (Input Thread Saturation)


Line 98: Line 98:
* '''The Fix:''' Open your mouse software (Razer Synapse, Logitech G Hub) and lower the Polling Rate to '''1,000Hz''' or '''500Hz'''.
* '''The Fix:''' Open your mouse software (Razer Synapse, Logitech G Hub) and lower the Polling Rate to '''1,000Hz''' or '''500Hz'''.


<!-- KI 3 -->
<h3>Known Issue 3 - Cannot Hear Others Or Speak Through VoIP (Opus.dll & Others)</h3>
<h3>Known Issue 3 - Cannot Hear Others Or Speak Through VoIP (Opus.dll & Others)</h3>
'''Status:''' Dependency / System Priority Error
'''Status:''' Dependency / System Priority Error
Line 110: Line 109:
* '''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.
* '''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.


<!-- KI 4 -->
<h3>Known Issue 4 - Crashing on Launch / Splash Screen Freeze</h3>
<h3>Known Issue 4 - Crashing on Launch / Splash Screen Freeze</h3>
'''Status:''' Software Conflict / File Corruption
'''Status:''' Software Conflict / File Corruption


Line 125: Line 124:
* '''Admin Mode:''' Right-click <code>Holdfast NaW.exe</code> in the installation folder and select '''Run as Administrator'''.
* '''Admin Mode:''' Right-click <code>Holdfast NaW.exe</code> in the installation folder and select '''Run as Administrator'''.


<!-- KI 5 -->
<h3>Known Issue 5 - Cannot See Servers In Lobby (PC & Console)</h3>
<h3>Known Issue 5 - Cannot See Servers In Lobby (PC & Console)</h3>
'''Status:''' Ongoing (Master Server Congestion / Routing Error)
'''Status:''' Ongoing (Master Server Congestion / Routing Error)
Line 171: Line 169:
* '''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.
* '''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 -->
<h3>Known Issue 6 - Black/Green Screen Artifacts (PS5/Xbox)</h3>
<h3>Known Issue 6 - Black/Green Screen Artifacts (PS5/Xbox)</h3>
'''Status:''' Post-Processing Desync  
'''Status:''' Post-Processing Desync  
Line 182: Line 179:
* '''Xbox Series S Fix:''' If the game crashes specifically on the Series S, disable '''High Quality Textures''' to prevent VRAM overflow.
* '''Xbox Series S Fix:''' If the game crashes specifically on the Series S, disable '''High Quality Textures''' to prevent VRAM overflow.


<!-- KI 7 -->
<h3>Known Issue 7 - Reload Animation State Lock</h3>
<h3>Known Issue 7 - Reload Animation State Lock</h3>
'''Status:''' Animation Buffer Error  
'''Status:''' Animation Buffer Error  
Line 192: Line 188:
* '''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:''' 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.


<!-- KI 8 -->
<h3>Known Issue 8 - Screen Flickering / Unresponsive When Minimizing (Alt-Tab)</h3>
<h3>Known Issue 8 - Screen Flickering / Unresponsive When Minimizing (Alt-Tab)</h3>
'''Status:''' Display Mode Conflict  
'''Status:''' Display Mode Conflict  
Line 206: Line 201:
** '''Windows 11/12 Fix:''' Ensure "Optimizations for windowed games" is '''Enabled''' in your Windows System Settings (''Settings > System > Display > Graphics > Change default graphics 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 -->
<h3>Known Issue 9 - Level 1 / Rank Progress Reset</h3>
<h3>Known Issue 9 - Level 1 / Rank Progress Reset</h3>
'''Status:''' Cloud-Sync Dela
'''Status:''' Cloud-Sync Dela
Line 216: Line 210:
* '''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.
* '''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.


<!-- KI 10 -->
<h3>Known Issue 10 - Stuck on Map Loading Screen</h3>
<h3>Known Issue 10 - Stuck on Map Loading Screen</h3>
'''Status:''' Asset Loading Desync
'''Status:''' Asset Loading Desync
Line 228: Line 221:
* '''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.
* '''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>
<h3>Known Issue 11 - Fatal Crash on Startup (Citrix Workspace Conflict)</h3>
'''Status:''' Software Conflict (Citrix Indirect Display Adapter)
'''Status:''' Software Conflict (Citrix Indirect Display Adapter)


Line 259: Line 252:
*# The Store version uses a different driver architecture that does not conflict with the Unity engine in 2026.
*# The Store version uses a different driver architecture that does not conflict with the Unity engine in 2026.


<!-- KI 12 -->
<h3>Known Issue 12 - Fatal Crash on Startup (Virtual Desktop & VR Drivers)</h3>
<h3>Known Issue 12 - Fatal Crash on Startup (Virtual Desktop & VR Drivers)</h3>
'''Status:''' GPU Initialization Conflict
'''Status:''' GPU Initialization Conflict
Line 294: Line 285:
# 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.
# 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.


<!-- KI 13 -->
<h3>Known Issue 13 - Cannot Join Modded Server (Connection/Download Error)</h3>
<h3>Known Issue 13 - Cannot Join Modded Server (Connection/Download Error)</h3>
'''Status:''' Workshop Handshake & Sync Conflict
'''Status:''' Workshop Handshake & Sync Conflict
Line 310: Line 300:
'''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.
'''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.


<!-- KI 14 -->
<h3>Known Issue 14 - No Main Menu (Camera Stuck on Cannon/Howitzer Background)</h3>
<h3>Known Issue 14 - No Main Menu (Camera Stuck on Cannon/Howitzer Background)</h3>
'''Status:''' UI Layer Initialization Error
'''Status:''' UI Layer Initialization Error
Line 337: Line 326:
* 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.
* 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.


<!-- KI 15 -->
<h3>Known Issue 15 - Microphone Not Working (VOIP / Proximity Chat)</h3>
<h3>Known Issue 15 - Microphone Not Working (VOIP / Proximity Chat)</h3>
'''Status:''' Audio Device Handshake / OS Privacy Conflict
'''Status:''' Audio Device Handshake / OS Privacy Conflict
Line 365: Line 353:
'''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.
'''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.


<!-- KI 16 -->
<h3>Known Issue 16 - Game Stuck on Map Load</h3>
<h3>Known Issue 16 - Game Stuck on Map Load</h3>
'''Status:''' Asset Synchronization or Network Timeout
'''Status:''' Asset Synchronization or Network Timeout
Line 400: Line 387:
# Change your Primary DNS to 8.8.8.8 and Secondary to 1.1.1.1.
# Change your Primary DNS to 8.8.8.8 and Secondary to 1.1.1.1.


<!-- KI 17 -->
<h3>Known Issue 17 - Reginald 'One Eyed' Fitzgerald Head Not Unlocking</h3>
<h3>Known Issue 17 - Reginald 'One Eyed' Fitzgerald Head Not Unlocking</h3>
'''Status:''' Legacy Method Deprecated (Switch to Code Challenge)
'''Status:''' Legacy Method Deprecated (Switch to Code Challenge)
Line 423: Line 409:
|title=Steam Related Issues
|title=Steam Related Issues
|content=
|content=
<!-- Steam 1 -->
<h3>Steam Known Issue 1 - Steam Content File Locked / Write Error</h3>
<h3>Steam Known Issue 1 - Steam Content File Locked / Write Error</h3>
'''Status:''' File Permission Conflict
'''Status:''' File Permission Conflict
Line 444: Line 429:
|title=Game Tips
|title=Game Tips
|content=
|content=
<!-- Tip 1 -->
<h3>Game Tip 1 - Orbit Camera (Look Around) Not Working</h3>
<h3>Game Tip 1 - Orbit Camera (Look Around) Not Working</h3>
'''Status:''' Updated for Cross-Platform
'''Status:''' Updated for Cross-Platform
Line 454: Line 438:
* '''The Fix:''' Go to Settings > Keys and rebind Orbit Camera to <code>Left Alt</code> or <code>Caps Lock</code>.
* '''The Fix:''' Go to Settings > Keys and rebind Orbit Camera to <code>Left Alt</code> or <code>Caps Lock</code>.


<!-- Tip 2 -->
<h3>Game Tip 2 - Auto Bayonet Switch (Melee Conflict)</h3>
<h3>Game Tip 2 - Auto Bayonet Switch (Melee Conflict)</h3>
'''Status:'''  Highly Recommended for Competitive Play
'''Status:'''  Highly Recommended for Competitive Play
Line 462: Line 445:
* '''The Fix:''' Go to Settings > Game > search for "Auto Switch Bayonet" and set it to OFF.
* '''The Fix:''' Go to Settings > Game > search for "Auto Switch Bayonet" and set it to OFF.


<!-- Tip 3 -->
<h3>Game Tip 3 - Melee Fluidity & "Smooth" vs. "Raw" Input</h3>
<h3>Game Tip 3 - Melee Fluidity & "Smooth" vs. "Raw" Input</h3>
'''Status:''' Engine Feature
'''Status:''' Engine Feature
Line 477: Line 459:
'''Sensitivity Tip:''' Set your Melee Combat Sensitivity to at least 2.0 (PC) or 2.2 (Console) to remain competitive in 360-degree combat.
'''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 -->
<h3>Game Tip 4 - Recording & Shadowplay (NVIDIA App)</h3>
<h3>Game Tip 4 - Recording & Shadowplay (NVIDIA App)</h3>
'''Status:''' Parameter Update Warning
'''Status:''' Parameter Update Warning


Line 491: Line 473:
# 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.
# 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.


<!-- Tip 5 -->
<h3>Game Tip 5 - Stuttering, G-Sync, and NVIDIA Reflex</h3>
<h3>Game Tip 5 - Stuttering, G-Sync, and NVIDIA Reflex</h3>
'''Status:''' Standard V-Sync
'''Status:''' Standard V-Sync
Line 513: Line 494:
|title=Server-Side Issues
|title=Server-Side Issues
|content=
|content=
<!-- Server 1 -->
<h3>Known Issue (Server) - Your Server Is Experiencing Latency Issues</h3>
<h3>Known Issue (Server) - Your Server Is Experiencing Latency Issues</h3>
Take note of the following points if the server you are hosting is experiencing latency issues.
Take note of the following points if the server you are hosting is experiencing latency issues.

Revision as of 02:03, 29 June 2026

Tech Support

Contents
On this page

About This Page

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.

Note: This page does not document gameplay bugs. To submit a bug report, please do so via the official Holdfast Discord: discord.gg/holdfastgame.

Essential Diagnostics

Before submitting a ticket to the Official Discord, you must perform these steps to rule out local data corruption.

1. Integrity Validation (Steam)

Asset corruption is the #1 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.
  • Note: Steam will automatically re-acquire any file that fails the SHA check.

2. Error Logging & Console Access

  • F2 Console: Press F2 in-game. Red lines are fatal errors; Yellow lines are warnings.
  • Local Logs: Your crash data is stored at %userprofile%\AppData\LocalLow\Anvil Game Studio\Holdfast NaW\Player.log.
  • Critical: You must copy this file immediately after a crash. Relaunching the game overwrites it.

For any queries, please reach out to Tech Support in the official Holdfast Discord: discord.gg/holdfastgame.

Critical Known Issues (PC & Console)

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!

Known Issue 1 - Black Screen on Launch (Audio/Music Playing)

Status: GPU Scaling & Handshake Conflict

Affected Platforms: PC, Xbox Series X

Steam Related Issues

Steam Known Issue 1 - Steam Content File Locked / Write Error

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.

Affected Platforms: PC

  • The Fix:

Phase 1: Restart your PC: This is the most effective way to clear a "locked" file state.

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".

Game Tips

Game Tip 1 - Orbit Camera (Look Around) Not Working

Status: Updated for Cross-Platform

The Cause: If the tilde ~ key is unresponsive, it is likely due to a regional keyboard conflict (common with UK/EU layouts).

Affected Platforms: PC

  • The Fix: Go to Settings > Keys and rebind Orbit Camera to Left Alt or Caps Lock.

Game Tip 2 - Auto Bayonet Switch (Melee Conflict)

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.

  • The Fix: Go to Settings > Game > search for "Auto Switch Bayonet" and set it to OFF.

Game Tip 3 - Melee Fluidity & "Smooth" vs. "Raw" Input

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.

  • The Fix:
  1. Go to Settings > Game > Advanced Settings.
  2. Look for Melee Sensitivity Type.
  3. Raw: Best for "Spinners" and high-level players. It removes all camera smoothing.
  4. Smooth (Legacy): Better for beginners who find the camera too jittery during 4-directional blocking.

Sensitivity Tip: Set your Melee Combat Sensitivity to at least 2.0 (PC) or 2.2 (Console) to remain competitive in 360-degree combat.

Game Tip 4 - Recording & Shadowplay (NVIDIA App)

Status: Parameter Update Warning

The Cause: Do NOT use -window-mode exclusive This parameter causes the game to crash when Alt-Tabbing and interferes with NVIDIA Reflex.

Affected Platforms: PC

  • The Fix:
  1. Set the game to Borderless Window in the video settings.
  2. Open the NVIDIA App (formerly Geforce Experience) and ensure "Desktop Capture" is enabled in the Privacy settings.
  3. 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.

Game Tip 5 - Stuttering, G-Sync, and NVIDIA Reflex

Status: Standard V-Sync

The Cause: Considered a secondary fix for the smoothest experience

Affected Platforms: PC, Xbox Series X

Server-Side Issues

Known Issue (Server) - Your Server Is Experiencing Latency Issues

Take note of the following points if the server you are hosting is experiencing latency issues.

The documentation for hosting a server can be found down below.

Host Your Own Game Server! - Documentation

Take note of the following:

  1. 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.
  2. 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!
  3. Make sure that you have the latest Windows updates installed on your machine. This is very important.
  4. 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.
  5. Make sure that you port forward the game ports from your firewall and router, (outbound and inbound), on UDP.
  6. Don’t rename the ‘Holdfast NaW.exe’ executable.
  7. Don’t switch between Naval and Army based game modes.
Last edited by Xarkanoth on 15:10, 7 July 2026Version History