Skip to content

BUILD.md

Latest commit

 

History

History
39 lines (27 loc) · 1.57 KB

BUILD.md

File metadata and controls

39 lines (27 loc) · 1.57 KB
Raw

Building from source

Requirements

Layout

src\AgenticalMods-Continue.vcxproj references the SDK by relative path and expects it two levels up:

<parent>\
  StarRupture-Plugin-SDK\
  <this repo>\src\AgenticalMods-Continue.vcxproj

Override with /p:SdkDir=<path-to-sdk>\ if your layout differs.

Build

msbuild src\AgenticalMods-Continue.vcxproj /t:Rebuild /p:Configuration="Client Release" /p:Platform=x64

Use /t:Rebuild. An incremental build may not recompile the translation unit carrying PluginInfo when only the SDK header changed, leaving a stale interfaceVersion in the binary.

Output: src\bin\Client Release\AgenticalMods-Continue.dll.

Notes

  • Client Release sets WarningLevel=TurnOffAllWarnings, so a clean Release build says nothing about warnings. Build Client Debug for the real signal. Expect warnings only from the SDK's own generated headers (C4309/C4369 in CoreUObject_structs.hpp / Engine_structs.hpp); anything naming a file under src\ is new.
  • Every <Link> block sets /PDBALTPATH:%_PDB% so the absolute build path is not embedded in the DLL. Do not remove it. Verify with grep -acF ':\' AgenticalMods-Continue.dll — expect 0.
  • Two addresses are build-specific and live in the .ini, not the source: ClickGateOffset and NativeConstructRva. After a game update they can be re-resolved from the shipped PDB without rebuilding.