{"id":18540181,"url":"https://github.com/frustrated-programmer/buildingsorter","last_synced_at":"2025-11-01T04:30:28.777Z","repository":{"id":40254209,"uuid":"409369288","full_name":"Frustrated-Programmer/BuildingSorter","owner":"Frustrated-Programmer","description":"A mod for the game Cookie Clicker","archived":false,"fork":false,"pushed_at":"2023-10-22T07:10:58.000Z","size":13716,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-12-26T04:42:56.857Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Frustrated-Programmer.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-09-22T22:05:37.000Z","updated_at":"2022-05-16T09:40:06.000Z","dependencies_parsed_at":"2023-10-19T06:28:26.090Z","dependency_job_id":"49fd03c1-b0ce-40f1-b745-77f845701d37","html_url":"https://github.com/Frustrated-Programmer/BuildingSorter","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Frustrated-Programmer%2FBuildingSorter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Frustrated-Programmer%2FBuildingSorter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Frustrated-Programmer%2FBuildingSorter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Frustrated-Programmer%2FBuildingSorter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Frustrated-Programmer","download_url":"https://codeload.github.com/Frustrated-Programmer/BuildingSorter/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239257024,"owners_count":19608612,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-06T19:53:12.651Z","updated_at":"2025-11-01T04:30:28.734Z","avatar_url":"https://github.com/Frustrated-Programmer.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Building Sorter\nThis is a mod that sorts the buildings on the right hand side in several different ways. The current list of sorting options are as followed:\n * \u003cb\u003eBuilt In: \u003c/b\u003eSort's building's by their ID's number. This ranks them in order how they were designed to be displayed. This theoretically works with mods that adds new options so long as their \u003ci\u003eID\u003c/i\u003e is a number.\n * \u003cb\u003ePrice: \u003c/b\u003eGrabs each building's current price for buying only 1 of that building, then ranks them based on lowest price.\n * \u003cb\u003eCPS: \u003c/b\u003eGrabs how much each building is producing in CPS, and ranks them based on which is currently producing the most.\n * \u003cb\u003eNext Achievement: \u003c/b\u003eCalculates how many of each building you need to buy to unlock the next \u003ci\u003eachievement\u003c/i\u003e, and ranks them from cheapest total cost of buying all said buildings\n * \u003cb\u003eNext Upgrade: \u003c/b\u003eCalculates how many of each building you need to buy to unlock the next \u003ci\u003eupgrade\u003c/i\u003e, and ranks them from cheapest total cost of buying all said buildings\n * \u003cb\u003eCustom Sorter: \u003c/b\u003eFor you to create your OWN sorter functionality. If you can come with any new sorting algorithms let me know, I might just add it into the official source code(crediting you of course)\n * \u003cb\u003eCookieMonster's Payback Period: \u003c/b\u003eWhen using the mod CookieMonster, it has it's own sorting functionality that I had overridden. With this you can re-enable it and sort by the mod's Payback Period.\n * \u003cb\u003eFrozenCookie's Efficiency: \u003c/b\u003eWhen using the mod FrozenCookies, it has it's recommendation of what buildings to buy in what order. I have now included a sorter to show the user this change.\nThis information also is included in the Settings tab of CookieClicker with several options included as well.\n\n\u003cimg src=\"Options.png\" style=\"width:50%\"\u003e\n\n## To Install:\n\n### Bookmarklet\n\nCopy this code and save it as a bookmark. Paste it in the URL section. To activate, click the bookmark when the game's open.\n\n```javascript\njavascript: (function () {\n  Game.LoadMod('https://frustrated-programmer.github.io/BuildingSorter/BuildingSorter.js');\n}());\n```\n\nIf (for some reason) the above doesn't work, trying pasting everything after the \u003ccode\u003ejavascript:\u003c/code\u003e bit into your browser's console.\n\n### Userscript\n\nIf you'd rather use the addon as an [userscript](https://en.wikipedia.org/wiki/Userscript) to automatically load _Building Sorter_ every time the original game loads, install the `BuldingSorter.user.js` file. You can do this by clicking on the file in the file-list and clicking \"raw\".\n\n### Steam\n\nI don't OWN the Steam version, so I've just worked with the documentation. This should work with Steam version but I cannot test it myself.  But I did receive someone who reached out to let me know it does work!\n1. Download the `steam-mod` folder included in this repo.\n2. Move the folders of the mods you want into `\u003cyoursteaminstall\u003e\\SteamApps\\common\\Cookie Clicker\\resources\\app\\mods\\local`, you can get to this from the mods menu.\n3. Enable them in-game with the mods menu.\n\n## Files:\n* `BuildingSorter.js` is just the source code.\n* `BuildingSorter.main.js` is everything you need if you want to have the source code loading inside an extension.\n* `BuildingSorter.user.js` is the recommended userscript you can use to load Charting Mutations and keep it up to date.\n## Credits:\nHuge thanks to [CookieMonster](https://github.com/CookieMonsterTeam/CookieMonster), I learned a ton from their code, and I also borrowed a ton of their README.\n \n# Todo\nThis is a just passion project of mine. These are my ideas for how to improve. But without some donations or incredible recognition(I got 250 upvotes when I released my mod, that inspired me to release v2), I probably won't implement these. Feel free to make a PR I'll probably accept it.\n\n * Allow users to make MORE than 1 custom sorter.\n * Overhaul custom sorters:\n   - Look into finding other ways to save their custom functions so my mod doesn't have a massive save file\n   - Allow users to put a name \u0026 description for their custom sorters.\n   - Allow users to export/import custom sorters\n   - Allow users to put a name \u0026 description for their custom sorters.\n   - Allow users to pick an icon for their custom sorters and a quote\n * Implement color coding for the custom coder (so it's more like an IDE)\n * Allow dragging/dropping (aka manual) sorting option.\n * Implement adjustments to some sorters depending on whether the user is \"selling\" or \"buying\" (currently everything assumes you are buying)\n * Update next achievement and next upgrade, to exclude achievements/upgrades you already own. (Prestige or Selling can reproduce)\n * Turn the patchnotes reader into a more sleek design.\n    - Allow reading past patchnotes IN the mod.\n * Building Sorter's Settings look terrible. Remake it to be more sleek.\n    - Turn checkboxes into more Cookie Clicker theme.\n    - Put icon with tooltip behind each sorter so the description isn't normally shown\n    - Allow animation speed to be an option.\n    - Rename \"Allow check for updates\" to be \"Updates: ON/OFF\"\n   \n# Check out my OTHER mods!\n\n## \u003ca href=\"https://github.com/Frustrated-Programmer/ChartingMutations\"\u003eCharting Mutations:\u003c/a\u003e\nHave you ever had to open the wiki to look at how you grow a certain crop? Is it frustrating that to play the Garden you have to memorize crop mutations? Well this mod solves all of that by _showing_ you how to grow every crop!\u003cbr\u003e\n\u003ca href=\"https://github.com/Frustrated-Programmer/ChartingMutations\"\u003e\u003cimg src=\"ChartingMutationsPreview.png\" style=\"width: 50%\"\u003e\u003c/a\u003e\n\n## \u003ca href=\"https://github.com/Frustrated-Programmer/SugarLumpInfo\"\u003eSugar Lump Info\u003c/a\u003e\nThe current tooltip for sugar lumps is cramped and tells you information that you already know or is useless to everyone. I have simplified the tooltip and made it more dynamic, fitting every scenario while also leaving a detailed tooltip availible.\u003cbr\u003e\n\u003ca href=\"https://github.com/Frustrated-Programmer/SugarLumpInfo\"\u003e\u003cimg src=\"SugarLumpInfoPreview.gif\"  style=\"width: 50%\"\u003e\u003c/a\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffrustrated-programmer%2Fbuildingsorter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffrustrated-programmer%2Fbuildingsorter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffrustrated-programmer%2Fbuildingsorter/lists"}