百科.dev
全部条目在线工具AI 编程趋势榜开源项目技术资讯提交条目
登录
< 返回工具列表
G

gse_fork

> 编程语言
开源

https://GitHub.com/Detanup01/gbe_fork 的改进版本用于 Goldberg Steam Emulator,最初由 Mr_Goldberg 开发 - https://GitLab.com/Mr_Goldberg/goldber

364 stars0 点赞1 次浏览
访问官网GitHub

工具介绍

https://GitHub.com/Detanup01/gbe_fork 的改进版本用于 Goldberg Steam Emulator,最初由 Mr_Goldberg 开发 - https://GitLab.com/Mr_Goldberg/goldber

:large_orange_diamond: Goldberg Steam Emu

Fork of https://gitlab.com/Mr_Goldberg/goldberg_emulator with a lot of fixes, improvements, additional features and a completely reworked file structure.

Feel free to make a PR.


:red_circle:

This fork is not a takeover, not a resurrection of the original project, and not a replacement.
You are highly encouraged to fork/clone it and do whatever you want with it.

:red_circle:


Compatibility

This fork is incompatible with the original repo, lots of things has changed and might be even broken. If something doesn't work, feel free to create a pull request with the appropriate fix, otherwise ignore this fork and use the original emu.


Credits

Thanks to everyone contributing to this project in any way possible, we try to keep the CHANGELOG.md updated with all the changes and their authors.

This project depends on many third-party libraries and tools, credits to them for their amazing work, you can find their listing here in CREDITS.md.


How to use the emu

  • Always generate the interfaces file using the generate_interfaces tool.
  • If things don't work, try the ColdClientLoader setup.

You can find some guides, helper tools and scripts here:

These guides, tools and scripts are maintained by their authors. Before using them, it's always a good idea to first make sure they are updated and designed to support all features of this fork of the emulator.

  • gbe_fork_tools
  • gen.emu.sharp
  • gse_fork_tools
  • Semuexec
  • Steam Emu Utility
  • How to use Goldberg Emulator
  • GSE-Generator
  • If you created a generator tool create a Feature PR

You can also find instructions here in README.release.md

Included tools

Tools bundled in this repository:

  • generate_interfaces — scans the game’s steam_api(64).dll / libsteam_api.so and writes the required steam_interfaces.txt
  • lobby_connect — discovers LAN peers and launches your game with the right join parameters
  • steam_stats_converter — converts between Steam’s local achievements/stats binary cache and GSE save files; see its README
  • steamclient_loader — Linux launcher for the experimental steamclient.so / steamclient64.so build, taking the exe path, appid and optional working directory from the command line or ldr_*.txt files; see its README

Compiling

One time setup

Cloning the repo

Clone the repo and its submodules recursively

bash
git clone --recurse-submodules -j8 https://github.com/alex47exe/gse_fork.git

The switch -j8 is optional, it allows Git to fetch up to 8 submodules

It is advisable to always checkout submodules every now and then, to make sure they're up to date

bash
git submodule update --init --recursive --remote

For Windows:

  • You need Windows 10 or 8.1 + WDK

  • Using Visual Studio, install Visual Studio 2022 Community: https://visualstudio.microsoft.com/vs/community/

    • Select the Workload Desktop development with C++
    • In the Individual components scroll to the bottom and select the latest version of Windows XX SDK (XX.X...)
      For example Windows 11 SDK (10.0.22621.0)
  • Using MSYS2 this is currently experimental and will not work due to ABI differences: https://www.msys2.org/

    steps

    • To build 64-bit binaries use either the environment UCRT64 or MINGW64 then install the GCC toolchain
      UCRT64
      bash
      pacman -S mingw-w64-ucrt-x86_64-gcc
      MINGW64
      bash
      pacman -S mingw-w64-i686-gcc
    • To build 32-bit binaries use the environment MINGW32 then install the GCC toolchain
      bash
      pacman -S mingw-w64-i686-gcc
  • Python 3.10 or above: https://www.python.org/downloads/windows/
    After installation, make sure it works

    batch
    python --version
  • (Optional) Install a GUI for Git like GitHub Desktop, or Sourcetree

For Linux:

  • Ubuntu 22.04 LTS: https://ubuntu.com/download/desktop
  • Ubuntu required packages:
    bash
    sudo apt update -y
    sudo apt install -y coreutils # echo, printf, etc...
    sudo apt install -y build-essential
    sudo apt install -y gcc-multilib # needed for 32-bit builds
    sudo apt install -y g++-multilib
    sudo apt install -y libglx-dev # needed for overlay build (header files   such as GL/glx.h)
    sudo apt install -y libgl-dev # needed for overlay build (header files   such as GL/gl.h)
    (Optional) Additional packages
    bash
    sudo apt install -y clang # clang compiler
    sudo apt install -y binutils # contains the tool 'readelf' mainly, and   other usefull binary stuff
  • Python 3.10 or above
    bash
    sudo apt update -y
    sudo apt install -y software-properties-common
    sudo add-apt-repository ppa:deadsnakes/ppa -y
    sudo apt update -y
    sudo apt install -y "python3.12"
    sudo apt install -y "python3.12-dev"
    sudo apt install -y "python3.12-venv"
    sudo apt install -y python3-dev
    
    # make sure it works
    python3.12 --version

For cross compiling see the docs

Building dependencies

These are third party libraries needed to build the emu later, they are linked with the emu during its build process.
You don't need to build these dependencies every time, they rarely get updated.
The only times you'll need to rebuild them is either when their separate build folder was accidentally deleted, or when the dependencies were updated.

On Windows:

Open CMD in the repo folder, then run the following

  • To build using Visual Studio

    batch
    set "CMAKE_GENERATOR=Visual Studio 18 2026"
    third-party\common\win\premake\premake5.exe --file=premake5-deps.lua --64-build --32-build   --all-ext --all-build --verbose --os=windows vs2026
  • To build using MSYS2 this is currently experimental and will not work due to ABI differences

    steps

    (Optional) In both cases below, you can use Clang compiler instead of GCC by running these 2 commands in the same terminal instance

    bash
    export CC="clang"
    export CXX="clang++"
    • To build 64-bit binaries (UCRT64 or MINGW64)
    bash
    export CMAKE_GENERATOR="MSYS Makefiles"
    ./third-party/common/win/premake/premake5.exe --file=premake5-deps.lua --64-build --all-ext --all-build --verbose   --os=windows gmake2
    • To build 32-bit binaries (MINGW32)
    bash
    export CMAKE_GENERATOR="MSYS Makefiles"
    ./third-party/common/win/premake/premake5.exe --file=premake5-deps.lua --32-build --all-ext --all-build --verbose   --os=windows gmake2

This will:

  • Extract all third party dependencies from the folder third-party into the folder build\deps\win
  • Build all dependencies

On Linux:

Open a terminal in the repo folder (Optional) You can use Clang compiler instead of GCC by running these 2 commands in the current terminal instance

bash
export CC="clang"
export CXX="clang++"

Then run the following

bash
export CMAKE_GENERATOR="Unix Makefiles"
./third-party/common/linux/premake/premake5 --file=premake5-deps.lua --64-build --32-build --all-ext --all-build --verbose --os=linux gmake2

This will:

  • Extract all third party dependencies from the folder third-party into the folder build/deps/linux
  • Build all dependencies (32-bit and 64-bit)

Building the emu

On Windows:

Open CMD in the repo folder, then run the following

  • For Visual Studio 2022

    batch
    third-party\common\win\premake\premake5.exe --file=premake5.lua --genproto --os=windows vs2026

    You can then go to the folder build\project\vs2026\win and open the produced .sln file in Visual Studio. Or, if you prefer to do it from command line, open the Developer Command Prompt for VS 2026 inside the above folder, then:

    batch
    msbuild /nologo /v:n /p:Configuration=release,Platform=Win32 gse.slnx
    
    msbuild /nologo /v:n /p:Configuration=release,Platform=x64 gse.slnx
  • For MSYS2 this is currently experimental and will not work due to ABI differences

    steps

    bash
    ./third-party/common/win/premake/premake5.exe --file=premake5.lua --genproto --os=windows gmake2
    
    cd ./build/project/gmake2/win

    (Optional) You can use Clang compiler instead of GCC by running these 2 commands in the current terminal instance

    bash
    export CC="clang"
    export CXX="clang++"
    • 64-bit build (UCRT64 or MINGW64)
      bash
      make config=release_x64 -j 8 all
    • 32-bit build (MINGW32)
      bash
      make config=release_x86 -j 8 all
      To see all possible build targets
    bash
    make help

This will build a release version of the emu in the folder build\win\\release An example script build_win_premake.bat is available, check it out

On Linux:

Open a terminal in the repo folder, then run the following

bash
./third-party/common/linux/premake/premake5 --file=premake5.lua --genproto --os=linux gmake2
cd ./build/project/gmake2/linux

(Optional) You can use Clang compiler instead of GCC by running these 2 commands in the current terminal instance

bash
export CC="clang"
export CXX="clang++"

Then run the following

bash
make config=release_x86 -j 8 all
make config=release_x64 -j 8 all

To see all possible build targets

bash
make help

This will build a release version of the emu in the folder build/linux//release An example script build_linux_premake.sh is available, check it out


Using Github CI as a builder

This is really slow and mainly intended for the CI Workflow scripts, but you can use it as another outlet if you can't build locally. You have to fork the repo first.

Initial setup

In your fork, open the Settings tab from the top, then:

  • From the left side panel select Actions -> General
  • In the section Actions permissions select Allow all actions and reusable workflows
  • Scroll down, and in the section Workflow permissions select Read and write permissions
  • (Optional) In the section Artifact and log retention, you can specify the amount of days to keep the build artifacts/archives. It is recommended to set a reasonable number like 3-4 days, otherwise you may consume your packages storage if you use Github as a builder frequently, more details here: https://docs.github.com/en/get-started/learning-about-github/githubs-plans

Manual trigger

  1. Go to the Actions tab in your fork
  2. Select the emu dependencies Workflow (ex: Emu third-party dependencies (Windows) ) and run it on the main branch (ex: dev). Dependencies not created on the main branch won't be recognized by other branches or subsequent runs
  3. Select one of the Workflow scripts from the left side panel, for example Build all emu variants (Windows)
  4. On the top-right, select Run workflow -> select the desired branch (for example dev) -> press the button Run workflow
  5. When it's done, many packages (called build artifacts) will be created for that workflow. Make sure to select the workflow again to view its history, th

Issues· 0 开放

查看全部 Issues在 GitHub 打开

暂无开放 Issues,或尚未同步最近议题。

> 标签

C++cooperativeemulatorlanloader

暂无评论,来聊聊你的看法吧

> 工具信息

发布日期2026年8月1日
最后更新2026年9月17日
分类编程语言
定价开源

> 相关工具

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言