[Copilot]

OpenBSD lacks StormLib support but provides libmpq 0.4.2. This PR adds a compile-time MPQ library abstraction to enable OpenBSD builds.

Changes

• MPQ Abstraction Layer (src/common/mpq_adapter.{h,c})

  • Detects OpenBSD via __OpenBSD__ and uses libmpq; defaults to StormLib elsewhere
  • Wraps StormLib API: SFileOpenArchive, SFileReadFile, SFileGetFileSize, etc.
  • Caches file data in memory on open (libmpq reads entire files, no random access)
  • File enumeration not supported with libmpq (returns NULL from SFileFindFirstFile)

• Build System

  • Makefile: Sets MPQ_LIB=-lmpq on OpenBSD, -lstorm otherwise
  • premake5.lua: Adds BSD platform config with /usr/local/{include,lib} paths

• Type Definitions

  • Added missing LPVOID typedef to shared.h
  • Replaced #include <StormLib.h> with #include "mpq_adapter.h" in 6 files

• Security

  • Overflow checks in malloc sizing and file pointer arithmetic
  • Bounds validation for buffer operations
  • Safe casting between off_t, DWORD, and size types

Example Usage

// Same code works on both platforms
HANDLE archive;
SFileOpenArchive("War3.mpq", 0, 0, &archive);

HANDLE file;
SFileOpenFileEx(archive, "war3map.w3e", SFILE_OPEN_FROM_MPQ, &file);

DWORD size = SFileGetFileSize(file, NULL);
unsigned char* buffer = malloc(size);
SFileReadFile(file, buffer, size, NULL, NULL);

Limitations

File enumeration APIs return NULL on libmpq. Features requiring MPQ file listing may need alternative implementation or will be unavailable on OpenBSD.

Original prompt

---

This section details on the original issue you should resolve

<issue_title>Can I compile it on OpenBSD?</issue_title>
<issue_description>OpenBSD has:
SDL2: 2.32.8
libmpq: 0.4.2

I don't think StormLIB supports OpenBSD yet, can I use libmpq instead?</issue_description>

<agent_instructions>Check if it's possible to compile using libmpq, update the code with #ifdef for OpenBSD</agent_instructions>

Comments on the Issue (you are @copilot in this section)

@corepunch I think it would take some #ifdef-ing but should be possible!

• Fixes Can I compile it on OpenBSD? #5

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.