Poki Cpom

What Poki Cpom Actually Is

Poki Cpom is a compressed build of Poki's HTML5 game engine wrapper that lets you package and host Poki-style games locally or on your own server. It's not official Poki software. It's a community-maintained tool people picked up when they wanted to take games off the Poki platform and run them independently without going through the full SDK process. The ".cpom" extension stands for "compressed Poki object model." It bundles the game asset references, the engine entry point, and a lightweight wrapper config into a single file you can drop into a hosting environment. People use it for archiving, for running games on private servers, and for embedding in custom web projects that don't want to rely on the Poki CDN.

How to Get and Use Poki Cpom

You won't find this on the official Poki website. The files live on community forums and GitHub repositories where people share extracted builds. My recommendation is to look for the latest release tagged with a date in 2024 or later, because older builds have compatibility issues with newer browser versions. Older engines also don't handle WebGL2 properly, which breaks half the shaders in modern games. Once you have the .cpom file, you need a local server. You can't just double-click it and open it in a browser. Browsers block local file access for security reasons. I set up a simple Python HTTP server with python -m http.server 8080 and placed the cpom file inside the root directory. Then I open http://localhost:8080 and load the wrapper index.html that comes with it. That's the quickest path. If you're deploying to a live server, Apache or Nginx works fine. Just make sure your MIME types are correct. The .cpom files themselves don't need special MIME types, but the assets they reference — GLB models, OGG audio, WebM videos — do. If you're missing the audio/ogg or video/webm types in your server config, games will load silently with no sound or video. I spent two days troubleshooting a non-working FPS game only to find my Nginx config was stripping the audio MIME type. Added types { audio/ogg ogg; } and it fixed immediately.

Common Pitfalls

The biggest issue people run into is version mismatch. The .cpom file references a specific engine version. If the game was built with engine v3.2 and your wrapper is v3.5, things break. Texture packing layouts changed between those versions. You'll see purple checkboard textures or completely black sprites. The fix is matching the wrapper version to the game's build version, which you can usually find in the game's metadata file inside the cpom package. Another problem is relative paths. Many cpom files were extracted with hardcoded CDN paths baked in. When you run locally, the game tries to load textures from poki-cdn.example.com/assets/... and fails because that domain doesn't exist in your environment. You need to edit the game's config JSON and replace the CDN base URL with file:/// or your local server address. It takes about ten minutes per game, and I do it by running a find-and-replace script across all JSON files in the extracted directory. There's also a licensing consideration worth mentioning. Just because you can extract and run these files doesn't mean you have the right to redistribute them. The games are still owned by their original developers and publishers. Poki Cpom is fine for personal use and archival. Putting it on a public server with ads is a different story, and I'd strongly recommend against it unless you have explicit permission.

Alternatives

If you're doing this for game preservation, the Internet Archive's console living room project is more thorough and legally cleaner. They handle the emulation layer and legal clearance. If you're building a custom game portal, consider using the actual Poki developer API instead of reverse-engineered cpom files. It's slower to set up but it doesn't break when Poki changes their asset structure, which they do roughly every six months. I switched to the official API after my cpom-based project broke during a routine Poki update and I had to manually patch twelve games to get them working again.