Waddle Forever is composed of a localhost server emulator for Club Penguin and an Electron client with the server that can run the game out of the box, built with Node.js in TypeScript.

It has the main goal to be as complete as possible of an archive of Club Penguin that can be downloaded easily by anyone!

Waddle Forever is still in constant development. A decent amount of features are present, but the program is far from complete.

The client has ambitious goals, so it is uncertain if they will be met. The main goals include:

• Be fully useable for all speedruns
• Allow exploring any party, event and timestamp in the timeline
• Allow adding mods easily
• Useable for small servers hosted for friends
• Have a world of NPCs over the island
• Have a complete singleplayer experience and "story mode"

For more detailed updates and plans for the project, check out the Discord server.

The project is composed of two segments:

Its client uses Electron to read the webpages for Club Penguin and run Flash, so the user does not need to worry about installing Flash. The a Electron client runs all the servers it will access, so there is no need to setup.

Under the hood, a Club Penguin server emulator runs to give full functionality to the game. The server can also be run standalone, in which case the Electron client is not needed, and you can use multiple windows to access the game.

To build you must have Node.js, npm and yarn installed. After cloning the code, install all dependencies:

yarn install

In order to properly launch the game, you will also need to have FFDEC installed (version 24 or greater). Then, copy the .env-template file into .env, and edit it with the path to FFDEC (in Windows, the .bat file). Then you will want to run these commands to finish setting everything up:

yarn build-packages
yarn global-crumbs
yarn local-crumbs
yarn news-crumbs

For running the client in development, run

yarn start

For running the server in development, run

yarn dev

The Electron client is originally forked from the Club Penguin Avalanche client.

The server, code and setup sources a lot of things from the Houdini and Mammoth server emulators. Special thanks to all of the developers of those repositories for making it open sourced and contributing to the community.

Special thanks to charlotte, who made CPSC, the original singleplayer/speedrunning client.

Credits to Ben for developing the Scavenger Hunt dependency and dynamic Igloo List. Credits for Randomno for the modified igloo list.

Special thanks for continued support, recreating, researching and or testing the game to: Doubleuman, slicedpizza39, Cyan, Randomno, supermanover, Blue Kirby, Jeff The Rock, Resol van Lemmy, VampLovr, ungato, Zeldaboy, Ryboflavin, Bluestk, Levi