How h4tiux/pubg2017ps works
Project Type and Purpose
• This is an open-source private server for PUBG 2017 (“PUBG2017PS”).
• It injects into the official Unreal Engine 4 game binary, loads a mod-loader (UE4SS), and hosts a custom server so players can run and join a private match locally.
File Structure
• Top-level:
– Mods/ ← directory of individual Lua-based game mods
– RUN_LocalServer.bat, RUN_LocalClientJoin.bat
– UE4SS-settings.ini, UE4SS.log, imgui.ini
– liveview/, watches/ ← debugging extensions (filters, watches)
• Mods/ substructure:
– Each mod in Mods/<ModName>/Scripts/main.lua
– Shared code in Mods/shared/UEHelpers and Mods/shared/jsbProfiler
– OGServerProxy contains a “dlls” folder (native proxy library)
– mods.json and mods.txt define load order and metadata
• Configuration and entry points:
– Batch files kick off the game in server or client mode with specific flags
– INI files configure UE4SS mod-loader, ImGui overlay, and logging
Extract README Insights
• Purpose: Turn the official PUBG binary into a local private server + client.
• Usage: Copy files into TslGame/Binaries/Win64, then run batch scripts.
Main Components & Interactions
a. Game Executable
– Unreal Engine 4 “TslGame.exe”
– Launch modes: headless server vs. client join
b. UE4SS Mod-Loader (Injected DLL)
– Hooks into game startup, reads UE4SS-settings.ini
– Loads all Mods from Mods/ directory
c. Mods (Lua Scripts + Native DLL)
– Individual Lua mods (ActorDumper, ConsoleCommands, SplitScreen, etc.)
– Shared modules (UEHelpers, jsbProfiler) referenced by each mod
– OGServerProxy’s DLL implements network redirection to private server
d. Configuration & Debugging
– INI files (UE4SS, imgui) control overlays & logging
– liveview/ and watches/ folders supply real-time debugging filters
e. Batch Scripts
– RUN_LocalServer.bat: launches TslGame.exe in server mode (-nullrhi -nosound)
– RUN_LocalClientJoin.bat: launches client and connects to localhost
f. Network Flow
– Client instance ↔ OGServerProxy ↔ Private server logic (inside TslGame)
– No external internet connection
Architectural Patterns & Design Principles
• Plugin/Mod architecture: UE4SS acts as a host, mods are independent Lua modules
• Shared libraries: common utilities in Mods/shared minimize code duplication
• Proxy pattern: OGServerProxy DLL intercepts and reroutes network calls
• Separation of concerns: batch scripts handle environment setup; INI files manage configuration; Lua scripts implement features
Final Checklist
• Components: TslGame.exe, UE4SS mod-loader, each mod, shared libs, OGServerProxy DLL, Private Server logic, batch scripts, config files, debug tooling
• Labels: concise but descriptive, include file/folder names where relevant