Troubleshooting
Full error details: set $env:RWK_DEBUG = "1" in PowerShell (export RWK_DEBUG=1 on macOS / Linux), then run the command again.
Running the command
Not sure what is wrong on this PC? rwk doctor checks Node.js, wrangler, the Cloudflare login, the token's permissions, and that the account has R2 switched on and a workers.dev subdomain. rwk analyze checks the game alone, without logging in. See Commands.
| Message | Fix |
|---|---|
Node.js 22 or newer is required | Install Node.js, then close and reopen PowerShell or Terminal |
npm ci failed | A network problem. Run again, or try another network than a company one |
Folder not found | Drag the folder into the window instead of typing the path |
No index.html + js/ in … | Use the folder with Game.exe (or its www/). XP / VX / VX Ace are not supported |
Unknown engine | Only MZ (js/rmmz_core.js) and MV (js/rpg_core.js) games work |
The game's creator does not allow publishing this game as a website | The game's rwk-policy.json says so. Play the desktop version, or ask the creator (contact printed above) |
Cloudflare
| Message | Fix |
|---|---|
R2 is not enabled for this account | Open the printed link, enable R2, choose Yes, try again |
The account has no workers.dev subdomain yet | Dashboard → Workers & Pages → pick a subdomain, run again |
| Logged in to the wrong account | npx wrangler auth delete rpgmaker-web-toolkit, run again. Other account, same login: delete %APPDATA%\rpgmaker-web-toolkit\settings.json |
Uploading
| Message | Fix |
|---|---|
The web build has N files, over the Workers limit of 20000 | Exclude what players don't need (the message lists the biggest folders) |
| A file over about 300 MiB fails | The upload tool's limit. Exclude it if the game works without it (usually a movie) |
Hard links were not possible… files were copied | Not an error: slower, and uses temporary disk space |
Access
| Message | Fix |
|---|---|
| The page says This game is being set up | Access is not finished. Run the deploy again and turn on Access |
The site is not protected by Access yet | Check that the Worker's Access page says All traffic (not Previews only), wait a minute, Check again, or enter the team domain and AUD manually |
Cloudflare Access is NO LONGER protecting the site! | Worker → Access: turn Access back on, scope All traffic |
N different emails have saves for this game | A reminder: sharing a copy is redistribution. Remove emails from the policy (removed ones still count) |
| A friend never gets the code | Their email is not allowed yet: add it |
In the game
| Problem | Fix |
|---|---|
Login expired: reload the page to sync saves | Reload and sign in. Saves made meanwhile upload afterwards |
Offline: using this device's saves | Keep playing; saves upload once back online |
Failed to load with a file in js/ (often js/libs/pixi.js) | The connection was too slow or dropped while the game started. Reload on a better one (Wi-Fi). Still there on a good connection: clear the site's data in the browser settings, then reload |
| Saves gone after clearing browser data | With sync on, reload: they come back. Without it they are lost, so export important ones |
| A key or button does nothing after changing it | ⚙ → Keys and buttons → Reset to defaults. An action shown as No key lost its key to another action |
| A picture, sound or plugin is missing online but fine on Windows | Windows ignores letter case, the web does not ("actor1" for Actor1.png, Actor1.PNG, a folder img/Faces). rwk analyze lists them under Checking file paths. Fix them with the rwk-paths skills in Claude Code |
| Black screen or an error | Does the desktop version show it too? If not, it comes from the web copy: report it here with the engine and the error, not to the game's creator |