Installation Guide

Complete step-by-step guide to install and set up SSOEngine on Windows

System Requirements

Minimum Requirements

  • Operating System: Windows 10/11 (64-bit)
  • Processor: Dual-core CPU (2.0 GHz or higher)
  • Memory: 2GB RAM
  • Storage: 100MB free space
  • Compiler: MinGW-w64 GCC 7.0 or higher

Recommended Requirements

  • Operating System: Windows 11
  • Processor: Quad-core CPU (3.0 GHz or higher)
  • Memory: 4GB RAM or more
  • Graphics: DirectX 11 compatible GPU

Step 1: Download SSOEngine

Download the Alpha Version

Get the latest Alpha version of SSOEngine from GitHub releases:

Download SSOEngine Alpha v1.0
Size: ~30MB (zipped) / ~70MB (extracted)

After Downloading

  1. 1 Extract the ZIP file to your preferred location (e.g., C:\SSOEngine)
  2. 2 Verify the folder structure matches the documentation
  3. 3 Proceed to Step 2: Install MinGW-w64

Step 2: Install MinGW-w64

SSOEngine requires a C++ compiler. We recommend MinGW-w64 for Windows development.

Option A: MSYS2 (Recommended)

MSYS2 provides a comprehensive development environment with package management.

1. Install MSYS2

Download and run the installer from msys2.org

Choose the default installation options and complete the setup.

2. Install MinGW-w64

Open the MSYS2 MINGW64 terminal and run: 

pacman -Syu
pacman -S mingw-w64-x86_64-gcc
pacman -S mingw-w64-x86_64-make

3. Add to PATH

Add the following to your Windows PATH environment variable: 

C:\msys64\mingw64\bin

Option B: Standalone MinGW-w64

For a lightweight installation without additional tools.

1. Download MinGW-w64

Download from winlibs.com

Choose the latest version with GCC and UCRT runtime.

2. Extract and Install

Extract to C:\mingw64 (or another location)

3. Add to PATH

Add the MinGW-w64 bin directory to your Windows PATH: 

C:\mingw64\bin

Step 3: Verify Installation

Test Your Compiler

Open Command Prompt (cmd) or PowerShell and run: 

g++ --version

You should see output similar to: 

g++.exe (Rev2, Built by MSYS2 project) 12.2.0
Copyright (C) 2022 Free Software Foundation, Inc.
This is free software; see the source for copying conditions.  There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

If you get "command not found": Make sure MinGW-w64 is properly added to your PATH and restart your terminal.

Step 4: Build Your First Game

Quick Build Process

  1. 1

    Navigate to the Core Directory

    cd SSOEngine/01_Core
  2. 2

    Run the Build Script

    build.bat
  3. 3

    Configure Game Details (Optional)

    The build script will ask if you want to edit game details. Type 'y' to customize:

    • • Game name
    • • Game description
    • • Icon file
  4. 4

    Run Your Game

    Your compiled game will be in the build/ folder: 

    build/game.exe

Troubleshooting

"'g++' is not recognized"

Cause: MinGW-w64 is not installed or not in PATH

Solution: Install MinGW-w64 and add its bin folder to Windows PATH, then restart your terminal.

"Build Failed"

Possible causes:

  • • Missing Raylib libraries in lib/ folder
  • • Syntax errors in your code
  • • Missing asset files

Solutions: Check lib/ folder contains libraylib.a, review your code for syntax errors, ensure all assets are in assets/ folder.

"Asset Not Found"

Cause: Assets are not in the correct location

Solution: Place assets in 01_Core/assets/ folder, use correct file names (case-sensitive), and rebuild with build.bat.

"Window Won't Open"

Possible causes:

  • • Outdated graphics drivers
  • • OpenGL not supported
  • • Permission issues

Solutions: Update graphics drivers, ensure OpenGL is supported, try running as administrator.

Next Steps

Congratulations! 🎉

You've successfully installed SSOEngine and built your first game. Here's what to do next:

📚 API Reference

Learn about all available classes and functions

🎓 Tutorials

Step-by-step guides for building games

💻 Code Examples

Ready-to-use code snippets and samples

📞 Get Help

Contact the developer for support