pubgld-mcp

# pubgld-mcp PUBG UGC Editor MCP Tool. If you are looking for "PUBG UGC MCP", this repository is for connecting Codex to the local UGC Editor. ## Where to Install There are two parts to install: 1. Editor Script Place it in the PUBG Editor startup directory: ```text <ShadowTrackerExtra>\Content\pyScripts\ue_site.py ``` Common path: ```text D:\WeGameApps\rail_apps\OasisEraEditor(2001776)\ShadowTrackerExtra\Content\pyScripts\ue_site.py ``` 2. MCP Service Script Place it in the Codex MCP directory, for example: ```text C:\Users\Administrator\.codex\mcp\pubgld-mcp\pubgld_mcp.py ``` ## One-Click Installation First, download the repository: ```powershell git clone https://github.com/mrcang09/pubgld-mcp.git C:\Users\Administrator\.codex\mcp\pubgld-mcp cd C:\Users\Administrator\.codex\mcp\pubgld-mcp ``` Then, execute the installation script: ```powershell powershell -ExecutionPolicy Bypass -File .\install.ps1 -EditorRoot "D:\WeGameApps\rail_apps\OasisEraEditor(2001776)\ShadowTrackerExtra" ``` This script will do three things: - Copy `hook\ue_site.py` to the editor's `Content\pyScripts\ue_site.py` - Write MCP configuration to `%USERPROFILE%\.codex\config.toml` - Automatically backup before overwriting old files After installation, restart the PUBG UGC Editor and then restart Codex. ## Manual Installation If you don't want to use the installation script, follow these steps: Step 1: Copy the editor script to: ```text D:\WeGameApps\rail_apps\OasisEraEditor(2001776)\ShadowTrackerExtra\Content\pyScripts\ue_site.py ``` If your editor is not on the D drive, replace it with your own `ShadowTrackerExtra` path. Step 2: Add the following configuration to: ```text C:\Users\Administrator\.codex\config.toml ``` Configuration content: ```toml [mcp_servers.pubgld-mcp] command = "python" args = ["C:\\Users\\Administrator\\.codex\\mcp\\pubgld-mcp\\pubgld_mcp.py"] ``` Step 3: Restart the PUBG UGC Editor and Codex. ## How to Confirm Installation After restarting the editor, check if this file exists: ```text <ShadowTrackerExtra>\Saved\Codex\editor_py_bridge\status.json ``` For example: ```text D:\WeGameApps\rail_apps\OasisEraEditor(2001776)\ShadowTrackerExtra\Saved\Codex\editor_py_bridge\status.json ``` The following fields should be `true`: ```text hook_loaded server_started ticker_registered editor_world_available ``` Then, in Codex, call: ```text pubgld_bridge_status ``` If you can see the editor status, it means MCP has connected. ## Frequently Asked Questions `status.json` does not exist: Usually, `ue_site.py` is placed in the wrong directory, or the editor is not restarted. Confirm it is in `ShadowTrackerExtra\Content\pyScripts\ue_site.py`. Cannot see `pubgld` tool in Codex: Usually, `%USERPROFILE%\.codex\config.toml` is not configured properly, or Codex is not restarted. `editor_world_available = false`: The editor has started, but the project or level has not been opened. Open your UGC project, for example, `boxing1`. Connection failed: Restart the editor and then restart Codex. This tool depends on the editor loading `ue_site.py` at startup. ## Simple Principle ```text Codex -> pubgld_mcp.py -> Local TCP -> ue_site.py in Editor -> Unreal Python API ``` `ue_site.py` is a script on the editor side and must be placed in the `Content\pyScripts` directory. The editor will load it at startup, and then it will write connection information to `Saved\Codex\editor_py_bridge`. The MCP service will then connect to the editor based on this information. ## Development Check ```powershell python -m py_compile .\pubgld_mcp.py python -m py_compile .\hook\ue_site.py ```