<WRAP group>
<WRAP round box twothirds column>

{{:antialiasing:2xsai_example.png?400|}}

====== Catacomb GL ======
CatacombGL is a source port with OpenGL graphics for Catacomb 3D (1991), The Catacomb Abyss (1992), The Catacomb Armageddon (1992) and The Catacomb Apocalypse (1993). 

</WRAP>
</WRAP>

==== Quick reference ====
  * **Accepted ROM formats:** ''.game''
  * **Folder:** ''/userdata/roms/catacomb''
  * **Config:** ''/userdata/system/configs/CatacombGL''
  * **Saves:**  ''/userdata/system/saves/catacomb''

===== ROMs =====
Place your Directory in ''/userdata/roms/catacomb''.

There are strict naming conventions:
Only folders
  - ''Abyss_sw13''
  - ''Abyss''
  - ''Armageddon''
  - ''Apocalypse'' 
  - and ''Cat3D'' are allowed

Then place a ''.game'' file in each folder, this is also very restrictive and **MUST** contain the correct name the main directory name, too
  - ''Abyss_sw13'' --> //Catacomb Abyss_sw.game// (Shareware) 
  - ''Abyss''      --> //Catacomb Abyss.game//
  - ''Armageddon'' --> //Catacomb Armageddon.game//
  - ''Apocalypse'' --> //Catacomb Apocalypse.game//
  - ''Cat3D''      --> //Catacomb Descent.game// or //Catacomb Cat3D.game//

Sidenote: All filenames (gamedata...) have to be be capitalized. So ''cemetry.hnt'' --> ''CEMETRY.HNT'' for example
I've written a small script for this task, it will even create the correct game name for each folder but relies the named directories above do exists.

<code>
#!/bin/bash
# These 5 directories need to be available / crcerror
for i in Abyss_sw13 Abyss Armageddon Apocalypse Cat3D; do
  if pushd /userdata/roms/catacomb/${i} 2>/dev/null; then
    for f in *; do
      mv -v -- "$f" "${f^^}"
    done
    touch "Catacomb ${i}.game" && echo "Created launch-file: Catacomb ${i}.game"
    popd >/dev/null
  else
    echo "couldn't go to dir: '$i'"; continue;
  fi
done
</code>


===== Controls =====
Here are the default CatacombGL controls shown on a [[:configure_a_controller|Batocera RetroPad]]:

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