- Installation Directions
- Mod Compatibility
- Achievements
- Upgrades
- Heavenly Upgrades
- Mysteries of the Cookie Age
- Javascript Console Minigame: Terminal
- Changelog
The Just Natural Expansion Mod enhances the Cookie Clicker endgame without disrupting core gameplay, staying true to the spirit of the vanilla experience. It introduces new achievements, upgrades, goals, stories, puzzles, and minigames, all specifically designed for late-game progression, so early or mid-game players may not immediately notice many changes.
By default, the mod adds no upgrades and marks new achievements as shadow, allowing leaderboard and competition focused players to pursue extra challenges without affecting their current gameplay.
Players aiming for higher scores and a more rewarding late-game can enable mod features one by one, while also converting shadow achievements into regular ones to gain extra milk for their efforts. These upgrades can be disabled at any time, and shadow achievements can be re-enabled via the options menu. However, a permanent shadow achievement will be awarded to mark that you have used the mod outside of leaderboard/competition mode.
All new achievements are designed to be attainable, though some require significant effort, some even taking weeks of focused effort to earn. Thank you for playing! If you enjoy the mod, please spread the word!
Big thanks to the amazing folks in the Cookie Clicker Discord, whose late-game wisdom and strategic tips helped shape this mod into what it is today.
Thank you to the "beta" testers who were willing to help me balance and test, I have now struck a balance between people saying things are too hard and things are too easy, which I suspect is the sweet middle ground.
Special thanks to CursedSliver and The_1_Shadow for donating art to the mod, anyone who wants to improve and donate art is more than welcome as it is not my skillset.
When I reached the late game of Cookie Clicker, I felt a real sense of loss. I was running out of meaningful goals. I looked for mods that could extend the experience without radically changing the core gameplay.
Most of what I found didn’t fit. Many end-game mods added flashy new buildings or mechanics that didn’t feel true to vanilla and often weren’t balanced. Others offered extremely difficult, sometimes nearly impossible, achievements. Those were closer to what I wanted, but I wasn’t looking for “impossible.” I wanted more of what made the base game fun.
So I set out to imagine what Cookie Clicker would feel like if it simply lasted longer with deeper goals to chase. Achievements are challenging but not unreasonable, designed for active players who like having long-term targets. Nothing breaks the existing formula (though I had to heavily nerf the new kittens to keep them balanced). The intent was always to extend the game, not reinvent it. Do not expect to knock out these features in a few days. Many require weeks of planning and patience. The idea is to add lasting goals, not hand out free milk and CpS.
I hope this mod hits that mark and gives you years more clicking, planning, and cookie glory. If not, I’ll still enjoy it myself, since I built what I wanted to play. If you do find something broken or unreasonable, reach out on Discord (User: DFSW). I am always happy to discuss and evaluate.
Installing mods and add-ons for Cookie Clicker can feel intimidating if you’ve never done it before. To get some background, check out this guide from the wiki Below, you’ll find specific instructions to help you get everything set up.
CookieClickerModManager - Recommended
https://cdn.jsdelivr.net/gh/dfsw/Just-Natural-Expansion@latest/JustNaturalExpansion.js
javascript:(function(){Game.LoadMod('https://cdn.jsdelivr.net/gh/dfsw/Just-Natural-Expansion@latest/JustNaturalExpansion.js');})();Game.LoadMod('https://cdn.jsdelivr.net/gh/dfsw/Just-Natural-Expansion@latest/JustNaturalExpansion.js');Link to Mod Loader on Steam. You can also search for Just Natural Expansion in the Cookie Clicker Steam Workshop.
Game.LoadMod('https://cdn.jsdelivr.net/gh/dfsw/Just-Natural-Expansion@latest/JustNaturalExpansion.js');The mobile version of Cookie Clicker does not support mods at this time.
- CCSE Compatible: Works with Cookie Clicker Script Extender
- CCMM Compatible: Works with Cookie Clicker Mod Manager
- Load Order: For best compatibility, load CCSE first, then this mod
- Browser Support: Works in all modern browsers
Just Natural Expansion uses Cookie Clicker’s documented API layer to extend the core game. As a result, Just Natural Expansion should remain functional for years to come—even if I get hit by a bus. However this API is fairly limited, so many modders rely on CCSE.
Unfortunately, CCSE uses code injection to make fundamental changes to the vanilla game’s source code, which breaks the built-in modding API in a handful of places. To address this, I’ve written a CCSE Bridge that allows CCSE mods and Just Natural Expansion to run together. The catch: CCSE must be loaded before Just Natural Expansion, so make sure JNE is last in your load order. Other modders are welcome to use my bridge code (located in the same repo) if they prefer a more vanilla mod approach.
I’ve tested compatibility with many popular CCSE mods. If you encounter specific incompatibilities, please let me know so I can look into possible workarounds.
Note: Yes, these challenges are all doable, and no, none of them are absurdly impossible (No ECM Style Here). But don’t expect a free ride. These achievements will not hold your hand, and they will not go easy on you. Think of them less as a grind and more as puzzles that demand clever planning, precise timing, and maybe a lucky cookie or a well-placed upgrade. This is late-game content meant to extend your playtime, not something to finish in a single week.
| Icon | Achievement Name | Requirement |
|---|---|---|
| Hardercorest | Bake 3 billion cookies with no cookie clicks and no upgrades bought in Born Again mode | |
| Hardercorest-er | Bake 1 billion cookies with no more than 20 clicks, no more than 20 buildings (no selling), and no more than 20 upgrades in Born Again mode | |
| The Final Countdown | Own exactly 15 Cursors, 14 Grandmas, 13 Farms, yada yada yada, down to 1 Chancemaker. No selling or sacrificing any buildings. Must be earned in Born Again mode. See Changelog for Version 0.0.11 for more info. | |
| Really more of a dog person | Bake 1 billion cookies per second without buying any kitten upgrades in Born Again mode | |
| Gilded Restraint | Bake 1 trillion cookies without ever clicking a golden cookie, must be done in Born Again mode | |
| Back to Basic Bakers | Reach 1 million cookies per second using only Cursors and Grandmas (no other buildings), must be done in Born Again mode | |
| Modest Portfolio | Reach 1 quadrillion cookies without ever owning more than 10 of any building type (no selling), must be done in Born Again mode | |
| Difficult Decisions | Bake 1 billion cookies without ever having more than 25 combined upgrades or buildings at any given time, must be done in Born Again mode | |
| Laid in Plain Sight | Bake 10 cookies per second without purchasing any buildings, must be done in Born Again mode |
- See also I feel the need for seed
| Icon | Achievement Name | Requirement |
|---|---|---|
| Faithless Loyalty | Swap gods in the Pantheon 100 times in one ascension | |
| God of All Gods | Use each pantheon god for at least 24 hours total across all ascensions |
- See also Holiday Hoover and Merry Mayhem
- See also The Final Challenger
- See also Gilded Restraint and Second Life, First Click
- See also The Final Countdown, Back to Basic Bakers, Modest Portfolio, Difficult Decisions, and Treading water
| Icon | Achievement Name | Requirement |
|---|---|---|
| Ascension master | Ascend 250 times | |
| Ascension legend | Ascend 500 times | |
| Ascension deity | Ascend 999 times |
Long before ovens were kindled and sugar knew its name, there arose six Orders, bakers, mystics, and crumb-guardians whose deeds shaped the fate of cookies forevermore. Each sworn to a creed, each guarding secrets older than the dough itself. - Transcribed by Crumblekeeper Thryce, 3rd Sifter of the Sacred Pantry
| Icon | Upgrade Name | Unlock Condition | Base Price | Description |
|---|---|---|---|---|
| Order of the Golden Crumb | Requires Vanilla Star achievement | 250 years of base CpS, but no less than 1 duovigintillion cookies | Golden cookies appear 5% more often. | |
| Order of the Impossible Batch | Requires The Final Challenger achievement | 250 years of base CpS, but no less than 1 duovigintillion cookies | Golden cookies appear 5% more often. | |
| Order of the Shining Spoon | Requires all Combo achievements | 250 years of base CpS, but no less than 1 duovigintillion cookies | Golden cookie effects last 5% longer. | |
| Order of the Cookie Eclipse | Requires all Grandmapocalypse achievements | 250 years of base CpS, but no less than 1 duovigintillion cookies | Golden cookie effects last 5% longer. | |
| Order of the Enchanted Whisk | Requires all Grimoire achievements | 250 years of base CpS, but no less than 1 duovigintillion cookies | Frenzy, Click Frenzy, and Elder Frenzy buffs are 5% more powerful. | |
| Order of the Eternal Cookie | Requires all previous Great Orders of the Cookie Age upgrades | 1000 years of base CpS, but no less than 1 trevigintillion cookies | Golden cookies appear 5% more often and effects last 5% longer. |
Note: Expansion Kittens are the knock-off brand: cute, cuddly, and noticeably worse at their job. Don’t expect them to pull their weight like original vanilla flavored kittens, but they sure as heck do try hard.
Note: These upgrades provide cumulative 5% cost reductions for their respective buildings. Each upgrade applies a 5% discount to the remaining cost, so owning all 6 upgrades for a building provides approximately a 26.5% total discount.
Just Natural Expansion introduces 97 new Heavenly Upgrades, extending progression beyond the completion of the vanilla heavenly upgrade tree. These upgrades are intended for late-game ascensions, with costs scaling naturally from where vanilla leaves off.
Heavenly upgrades are enabled and disabled via the Options menu, they become available for purchase once you have purchased the Unshackled You upgrade from the Vanilla heavenly upgrades tree.
As with the rest of the mod, these upgrades are not designed as quick, disposable bonuses. Some are intentionally inexpensive, others deliberately punishingly expensive. This of course is by design, the goal is to meaningfully extend long-term gameplay and decision-making in the endgame.
All Heavenly Upgrades in Just Natural Expansion are painstakingly balanced to avoid breaking the game. They expand existing systems, reinforce long-term strategies, reward sustained investment, and hopefully cover a variety of play styles (including some for idle players!).
The upgrades are organized into six distinct trees, each focusing on a different aspect of the game. These trees are outlined in detail below.
Slip a note under the door. Burn a secret message. Unearth hidden treasures and buried truths. Decode secret ciphers. Count the lamps when the watchman passes. You may even do the unforgivable to stay alive. The Orders are ancient and powerful. Their eyes are everywhere, their actions are sinister. Uncover what they hide—before they decide who you are, and what you’re really doing.
This story add-on layers an occult mystery over your Cookie Clicker run: riddles to solve, ciphers to break, puzzles to test your wits, and secret rites to perform—all inside the world you’re already playing.
- Diegetic puzzles: Clues arrive in-world and puzzles are solved in game, no separated gameplay or isolated minigames, just careful observation and precise actions.
- Escalating difficulty: As the story unfolds, puzzles grow sharper and more demanding. Some will click; others will test your patience.
- Intrigue and mystery: Early nudges become hard asks. Your cover tightens; your choices start to matter.
- Unfolding lore: The signs, taboos, and symbols of an ancient and mystical Order emerge piece by piece, if you’re paying attention.
- Deep gameplay: With dozens of puzzles, ciphers, riddles, and tasks to carry out, days, weeks, even months of mystery adventure awaits you. There is an end to the mystery, but not everyone will make it.
- Open Options → toggle “Mysteries of the Cookie” to ON.
- Play as normal, but keep a watchful eye—things may seem ordinary at first, but everything is different now. Track progress in Stats.
- Read carefully, observe everything. Act precisely and diligently. Everything has meaning, no word, clue, or mark is incidental. Trust no one, not even me.
Hints can be purchased with sugar lumps; each hint you reveal increases the cost of the next by +1 lump. You may reveal one hint every 24 hours (global cooldown). A hint for a puzzle won’t be available until that puzzle has been unlocked for at least 2 hours, so you get a fair shot first. Hints are nudges, not walkthroughs: we can’t know exactly where you’re stuck, but we’ve targeted the most common snags. Later puzzles are harder than early ones, so buy hints sparingly.
Cookie Clicker has natural downtime while you wait for cycles, combos, and the occasional shiny wrinkler. Mysteries of the Cookie Age is designed to be lightweight and in-world, giving you a parallel mystery to unravel between bursts of action. Some steps may ask for temporary, even disruptive changes, but nothing breaks your save or playstyle, you can return to normal once a puzzle is complete. There are no time limits, and you can tackle clues at your pace.
Don’t be discouraged if a puzzle doesn’t fall immediately. Like the rest of Just Natural Expansion, this isn’t meant to be finished in a day. It’s weeks of discovery. Resist the urge to seek help right away; try to solve it yourself (or with a friend). If you do get stuck, help exists—but your victories will mean more if you earn them.
Mysteries of the Cookie Age is designed as a late-game expansion. When you activate it, the game will warn you if you haven’t progressed far enough to complete all the puzzles, and it will outline the milestones you still need to reach. You might be able to tackle some puzzles early, but without the right tools, the experience can quickly become frustrating.
There are six new Achievements for working your way through Mysteries of the Cookie Age, they respect the toggle settings for Shadow Achievements so they only effect milk levels if you have them turned on. They will also disappear from your stats if you disable Mysteries of the Cookie Age.

A brief demo of Terminal Minigame
Reaching Level 1 Javascript Consoles unlocks the Terminal minigame, the pinnacle of cookie automation technology. Inside, you'll piece together powerful functions to make your bakery run smoother than a perfectly buttered script. Choose from 10 unique functions, each with its own quirks and parameters. Every line of "code" takes up an execution slot, and leveling up your Consoles (up to 10) expands your capacity for cookie-fueled creativity.
Write clean, think fast, flawless execution unleashes cookies straight from the mainframe, while a single bad call can send your setup crumbling. There’s no time to debug; only those who can see the logic behind the madness will prevail. After every run, the mainframe needs 8 hours to cool back down to operating temperatures.
Master the system, optimize your scripts, and ascend as Cookie Clicker’s ultimate pseudo-programmer.
/**
* property_Exchange_Daemon()
* @description Buy and sell buildings
*/
property_Exchange_Daemon();
/**
* divine_Thread_Swapper()
* @description Swap gods in the Pantheon
*/
divine_Thread_Swapper();
/**
* spellcast_Process_Handler()
* @description Cast spells from the Grimoire
*/
spellcast_Process_Handler();
/**
* garden_Task_Executor()
* @description Harvest and plant seeds in the Garden
*/
garden_Task_Executor();
/**
* aura_Heap_Controller()
* @description Change Dragon Auras
*/
aura_Heap_Controller();
/**
* async_Sleep_Thread()
* @description Pause execution to perform human actions
*/
async_Sleep_Thread();
/**
* click_Pulse_Generator(level)
* @description Click the Big Cookie 5 times per Javascript Console level (up to 20)
*/
click_Pulse_Generator(level);
/**
* credit_Cycle_Routine()
* @description Take out stock market loans
*/
credit_Cycle_Routine();
/**
* toggle_Switcher_Module()
* @description Toggle switches (Golden Switch, Elder Pact, Seasons, etc.)
*/
toggle_Switcher_Module();
/**
* sweet_Runtime_Swizzler()
* @description Spend sugar to activate Sugar Frenzy, refresh cooldowns,
* harvest lumps, or click on-screen golden cookies
*/
sweet_Runtime_Swizzler();- Fixed a regression that would cause Doordashing every day, Second day takeout, and Chinese leftovers to not reliably work as intended.
- Fixed a UI bug with Sugar Predictor when having more than 600 Grandmas owned on a lump that requires 600+.
- Tweaking Slot Machine Jackpot win rates and making the notification for them a bit more sticky.
- Seasonal reindeer achievements are now more stable and reliable.
- Fixed a bug that prevented the item in the expanded (Heavenly upgrade/aura) 11th and 12th slots of the Terminal minigame from saving and restoring on load.
- Updated Fortune Tolls For You heavenly upgrade to take advantage of the new ticker hook added with the last vanilla version update.
- Improved pantheon custom god save restortation logic to fix some funky behavior that was bothering mostly me.
- Fixed a bug that could prevent seeds from the heavenly upgrades from restoring their unlock state due to a loading race condition.
- Various other small fixes.
- Heavenly upgrade Mega Clicks can no longer consume RNG generation values.
- Fixed a regression that could allow a user to harvest multiple sugar lumps at once. This was a byproduct of the fix for sugar lump harvesting that rerolled the random seed.
- Fixed a crash that could be caused by the setup of Wholesale Discount Club and CCSE.
- Added more robust awarding logic for the Ascension Forfeited achievements to deal with third-party mod conflicts.
- Fixed a bug that could prevent Box of Donuts upgrades from saving their purchase state.
- Fixed a bug that would allow unintentional low mana cycling of Gambler’s Fever Dream to enable infinite spell cycling.
- Hotfix
- Fixed a sugar harvesting bug that would allow a user to reroll the random seed unintentionally.
- Fixed a bug that would cause Doordashing every day, Second day takeout, and Chinese leftovers to regenerate fortunes too often.
- Fixed a bug that could cause a conflict with CCSE based mods and not restore saved god info.
- Additional Cookie Clicker 2.057 Beta fixes and support.
- Improvements to make JNE heavenly upgrades and CYOL (3rd party mod) more compatiable.
- Treading water achievement now exempts using Solgreth, Spirit of Selfishness as a win condition.
- Adjusted values for Hellish hunger and Ravenous leeches upgrades.
- Fixed a bug that caused Cookie Fish not to be clickable in Cookie Clicker 2.057 Beta.
- The heavenly upgrade patch is now fully compatible with FTHOF Planner v1-6, Clairvoyance, and Fortune Cookie mods. As a design choice Gilded Allure spells will not shuffle into GFD anymore.
- Fixed a bug that would crash old saves with permanent upgrade slots items that were created before our previous fix.
- Introducing 97 new heavenly upgrades for your clicking pleasure. Unlocked after purchasing the Unshackled You vanilla heavenly upgrade. You can find the new upgrade tree to the left of the existing vanilla tree. Existing players will need to turn on Heavenly Upgrades in options.
- Fixed an exploit in the terminal minigame that allowed the user to spam execute radpidly to get the program to execute multiple times in a row.
- Compatibility updates for Cookie Clicker 2.057 Beta.
- Updated several production achievement descriptions to correct the use of wrong notation numbers. The logic was always correct, but the descriptions were incorrect. Thanks to Reddit user mei_ch.
- Cleaned up some outdated code that was hanging around.
- Several quality-of-life fixes to the terminal minigame to improve layout and behavior.
- Terminal minigame: fixed a bug that could cause Shimmering Veil to break if placed after click generators on laggy computers.
- Fixed Garden Sacrifice achievements to track the existing sacrifice counter.
- Fixed an exploit that could award Spellslinger via save-scumming.
- Fixed a bug with In the Shadows not being awarded due to character encoding mismatches.
- Holding down the Shift key while viewing a completed Mysteries of the Cookie Age puzzle will now display the original clue you solved. Thanks to CursedSliver for the idea.
- Various puzzle tweaks in Mysteries of the Cookie Age to reduce tolerance and make things more fair to solve; no puzzle logic has been updated.
- Fixed the vanilla bug that could corrupt a save file if two spirits are swapped before a save. Many thanks to Fillexs and CursedSliver for the code and guidance on the fix.
- Fixed a bug that would apply mod upgrades in permanent upgrade slots in Born Again mode when they shouldn’t have been.
- Many additional small fixes and UI improvements.
- Introducing a whole new minigame for Cookie Clicker! The Javascript Console Minigame: Terminal allows the player to write programs for Cookie Clicker to automate actions and create perfect combos or crash the system and ruin their setups. Unlocked at Level 1 Javascript Consoles are toggled on/off in the Options Menu.
- Updated pricing on building upgrades.
- Fixed some kitten icons to be less melty and sad.
- There is a longstanding vanilla game issue/bug/feature with sugar lumps being harvested during lag, which caused Choose Your Own Lump Mod (CYOL) to be inaccurate and unreliable. The Spiced Cookies mod fixed this, but it’s no longer being updated or maintained. That was the only reason I used the Spiced Cookies mod. Now, JNE quietly fixes this issue, and CYOL will show a discrepancy of 0 for planning purposes. It’s one of those small quality-of-life tweaks that probably only I care about, but now everyone is forced to live with anyways.
- Fixed a bug that made some Just Natural Expansion cookie upgrades stronger than they should have been.
- Fixed a bug that could cause unbought upgrades to quickly flash for one frame as available for purchase even if they aren't, also the season cooldown bar doesn't blink every few seconds anymore as a byproduct of this fix.
- Mysteries of the Cookie Age Expansion Patch. May you enjoy your puzzling.
- Fixed a bug that would prevent users from using Just Natural Expansion upgrades in Permanent Upgrade Slots.
- Made several fixes and improvements to the first run/install system to be a much more smooth experience.
- Ask and you shall receive, the "mid" achievement names have been replaced with more interesting ones. No save data will be lost as the old achievements automatically map to the updated ones.
- The Final Countdown was widely criticized for being too hard. It has been made easier, HOWEVER the original unlock conditions still exists so it may be unlocked starting with 20 Cursors and counting down to 1 You, or with 15 Cursors counting down to 1 Chancemakers. I thank our beta testers especially those who have completed the harder challenge for their feedback.
- Added more bake X cookies per second achievements
- Big graphics update also prestaging the graphics for next major revision
- Flavor text now with more punctuation.
- Regression in minigame achievement check fixed
- Fix for Frenzy Marathon achievement that could cause it not to trigger when chaining low time remaining frenzy buffs together.
- Fixed some bugs with first run experience when not running against any other CCSE Mods installed.
- Price updates for improved cookies to be more balanced and fair.
- Just more work on building a robust saving/loading system. Clearly my last version was a bit optimistic about being bullet proof.
- More saving/loading fixes but I think everything is finally bullet proof, I probably made that way harder than it needed to be.
- Fixed a bug that could cause God of All Gods to unlock if your Pantheon wasnt fully loaded yet.
- Store lifetime stock market data even if the stock market mini game hasnt been unlocked yet
- Wrath cookie storm drops no longer count towards total wrath cookie clicks
- Rethinking and refactoring some logic around saving and loading data
- Tweaking some achivement requirements for balance
- Various small bug fixes throughout
- Back to Basic Bakers Achievement is now easier
- Fixed a bug that could mark achivements as won improperly when loading an older save
- Improvements to the save/load system
- Tweaking the requirements of some achievements, mostly in the challenges section
- Fixed a bug that may have prevented option settings from working when CCSE was installed
- initial version