<WRAP group>
<WRAP round box twothirds column>
{{ :systems:xash_logo.png?nolink&100 |}}
{{ https://raw.githubusercontent.com/fabricecaruso/es-theme-carbon/master/art/logos/xash3d_fwgs.svg?nolink&360 }}

====== Xash3D FWGS ======

[[https://github.com/FWGS/xash3d-fwgs|Xash3D FWGS]] is a fork of the original Xash3D Engine by Unkle Mike. It allows you to play certain Source engine games such as Half-Life.

This system scrapes metadata for the "xash3d_fwgs" group(s) and loads the ''xash3d_fwgs'' set from the currently selected theme, if available.

Grouped with the "ports" group of systems.
</WRAP>

<WRAP third column>
{{ https://raw.githubusercontent.com/fabricecaruso/es-theme-carbon/master/art/consoles/xash3d_fwgs.png?nolink&350 |}}
</WRAP>
</WRAP>

==== Quick reference ====

  * **Emulator:** [[#xash3d_fwgs|Xash3D_FWGS]]
  * **Folder:** ''/userdata/roms/halflife'' (''/userdata/roms/xash3d_fwgs'' up to Batocera 42)
  * **Accepted ROM formats:** ''.game''

===== BIOS =====

No Xash3D-FWGS emulator in Batocera needs a BIOS file to run.

===== Game files =====

Xash3D-FWGS supports the following games:

  * Half-Life, including Blue Shift and Opposing Force.
  * Deathmatch Classic.
  * Several other mods: https://github.com/FWGS/hlsdk-xash3d/blob/mobile_hacks/dlls/moddef.h

<WRAP center round important>
You will need to have a working copy already installed on your Steam account on a computer.
</WRAP>

  - Navigate to the game's data folder, eg. for Half-Life this would be ''Steam/steamapps/common/Half-Life/<game data>/''
  - Copy it to ''/userdata/roms/halflife/<game data>/'' on your Batocera machine
  - Create an empty folder named ''<game folder>.game'' and place it in the ''/userdata/roms/halflife/'' folder alongside the folder you just copied over, eg. ''Half-Life.game''.
  - Finally, download https://github.com/FWGS/xash-extras/releases/latest/download/extras.pak and copy it to ''/userdata/roms/halflife/extras.pak''.

An example folder structure with a bunch of games installed might look like this:

<code>
roms/
└─ halflife/
   ├─ bshift/
   │  └─ (all of Blueshift's data)
   ├─ bshift.game/
   │  └─ (completely empty)
   ├─ cstrike/
   │  └─ (all of Counter Strike's data)
   ├─ cstrike.game/
   │  └─ (completely empty)
   ├─ Half-Life/
   │  └─ (all of Half-Life's data)
   ├─ Half-Life.game/
   │  └─ (completely empty)
   ├─ valve/
   │  └─ (all of valve game's data)
   ├─ valve.game/
   │  └─ (completely empty)
   ├─ _info.txt   
   ├─ extras.pak
   └─ gamelist.xml
</code>

===== Controls =====

Here are the default Xash3D-FWGS's controls shown on a [[:configure_a_controller|Batocera Retropad]]:

{{ https://raw.githubusercontent.com/batocera-linux/batocera-controller-overlays/master/solid-4k/xash3d_fwgs.png }}

===== Troubleshooting =====

==== Further troubleshooting ====

For further troubleshooting, refer to the [[:support|generic support pages]].