GBMap2Project

A tool to decompile GoreBox27 map files into editable project

Current Status: Maps currently decompile with roughly 80% accuracy - most objects, shapes, models, materials, textures, and sounds are resolved

Tested on game version 0.14.13

How It Works

1. Unpack / Decrypt: Reads .gbmap files or decrypts .gbmc cache files
2. Extract Assets:
   • Textures saved as .png / .jpg.
   • Materials saved as .gbmat.
   • Sounds decoded to .wav and linked to scene audio sources(Beta)
3. Geometry & Shapes: Saves 3D meshes as .obj and classifies basic shapes (cubes, stairs, cylinders, etc.)
4. Scene File: Rebuilds positions, rotations, and hierarchy into project.gbproj

Usage

GUI Mode

Double-click or run gbmap2project.exe without arguments

Command Line

./gbmap2project.exe "map.gbmap" "output_folder"

# Decompile a cache map .gbmc
./gbmap2project.exe --2project "idk.gbmc" "output_folder"

# Just decrypt a cache map to .gbmap
./gbmap2project.exe --2map "idk.gbmc"

Build

# via moom
moon run gbmap2project:build-release

Where can I get some maps?

Maps downloaded while connecting to a server or downloaded from the workshop are saved in the following folders:

• Server-downloaded maps:
  C:\Users\<UserName>\AppData\LocalLow\F2Games\GB27\mapcache
  (Usually stored with .gbmc or .gbmap file extensions)

• Workshop-downloaded maps:
  C:\Users\<UserName>\AppData\LocalLow\F2Games\GB27\maps
  (Usually stored with .gbmap file extension)

Have fun!