huanglittleorange/worldx-agent-forge

WorldX Agent Forge is a plugin for the OpenAI Codex command-line tool that lets you describe a game world in one sentence and have Codex generate the world settings, map image, character images, and a running local simulation automatically. It is written primarily in Chinese, with an English summary at the end of the README. The plugin is called a Skill in Codex's terminology. After installation, you mention the skill name in a Codex conversation along with a description of the world you want, and Codex handles the rest: designing the world rules and characters, generating map and character artwork using its built-in image generation, processing the images into the format the simulation engine expects, and starting a local web server at localhost:3200 where you can interact with the result. The simulation engine bundled inside this repository is an open-source project called WorldX, which provides the browser-based world viewer, a backend simulation service, and a system for tracking character states and events over time. WorldX Agent Forge packages WorldX directly into the repository so users do not need to download or configure it separately. No external API keys are required for world generation when using the recommended Codex Asset Mode, since Codex handles both the text design and image generation itself. If you want characters to continue making decisions and having conversations after the world loads, you can optionally configure a text model in the WorldX settings page to power the ongoing simulation. Installation involves cloning the repository into Codex's skills directory and restarting Codex. The repository is licensed under MIT, and it bundles WorldX under WorldX's own MIT license.