{"id":23892183,"url":"https://github.com/lnxfca/balatro-mods","last_synced_at":"2025-07-06T10:33:13.727Z","repository":{"id":270811248,"uuid":"911502312","full_name":"LnxFCA/balatro-mods","owner":"LnxFCA","description":"Collection of my hand-made mods for Balatro.","archived":false,"fork":false,"pushed_at":"2025-04-15T00:16:31.000Z","size":5436,"stargazers_count":8,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-15T03:46:11.839Z","etag":null,"topics":["balatro","balatro-mod","linux","love2d","smods","steamodded"],"latest_commit_sha":null,"homepage":"","language":"Lua","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/LnxFCA.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,"zenodo":null}},"created_at":"2025-01-03T07:01:01.000Z","updated_at":"2025-04-15T00:16:34.000Z","dependencies_parsed_at":"2025-02-06T23:22:15.789Z","dependency_job_id":"d4033932-5ede-42b8-b467-457a32090579","html_url":"https://github.com/LnxFCA/balatro-mods","commit_stats":null,"previous_names":["lnxfca/balatro-mods"],"tags_count":19,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LnxFCA%2Fbalatro-mods","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LnxFCA%2Fbalatro-mods/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LnxFCA%2Fbalatro-mods/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LnxFCA%2Fbalatro-mods/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/LnxFCA","download_url":"https://codeload.github.com/LnxFCA/balatro-mods/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249003939,"owners_count":21196794,"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":["balatro","balatro-mod","linux","love2d","smods","steamodded"],"created_at":"2025-01-04T13:39:33.229Z","updated_at":"2025-07-06T10:33:13.719Z","avatar_url":"https://github.com/LnxFCA.png","language":"Lua","funding_links":["https://ko-fi.com/H2H219IGVS"],"categories":[],"sub_categories":[],"readme":"# balatro-mods\n\nThis is a collection of my hand-made mods for [Balatro](https://store.steampowered.com/app/2379780).\n\nAll mods in this repository require at least Balatro version `1.0.1n`.\n\n[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/H2H219IGVS)\n\n## Table of Contents\n- [Introduction](#balatro-mods)\n- [Mod List](#mod-list)\n- [Installation](#installation)\n    - [Requirements](#requirements)\n    - [Methods](#installation-methods)\n- [Updating](#updating)\n- [Troubleshooting](#general-troubleshooting)\n- [License](#license)\n\n## Mod list\n\n- [first-round-joker](./first-round-joker) (First Round Joker): Ensures a specific\nJoker card appears in the shop during the first round.\n[NexusMods](https://www.nexusmods.com/balatro/mods/105)\n\n- [lock-the-deal](./lock-the-deal) (Lock the Deal): Adds a Lock feature to shop items,\nallowing players to save cards for future rounds or re-rolls.\n[NexusMods](https://www.nexusmods.com/balatro/mods/191)\n\n- [celestial-expansion-pack](./celestial-expansion-pack) (Celestial Expansion Pack *dev*): A\nPlanetary Power-Up for Balatro!\n\n- [hermit-level-up](./hermit-level-up) (Hermit Level Up): A mod\nthat let's **The Hermite** level up.\n[NexusMods](https://www.nexusmods.com/balatro/mods/331)\n\n- [fortune-wheel-negative](./fortune-wheel-negative) (Fortune Wheel: Negative *dev*): Adds a chance to get **Negative** edition to **The Wheel of Fortune**.\n\n## Installation\n\n\u003e :warning: **Development Branch Warning:** This branch (`main`) is for development only.\n\u003e Code here is unstable and may not work. For stable releases,\n\u003e use the [GitLab subgroup](https://gitlab.com/lnxfca-dev/balatro-mods) `release` branch.\n\nThis repository contains all my mods for **Balatro**.\nEach mod is located in its respective directory\n(e.g., `first-round-joker` is in the `first-round-joker` directory).\n\nThe installation steps are similar for all mods, but some mods may require specific instructions.\nThese will be listed in the individual mod's **README.md** under the **Installation** section.\n\n\u003e **Important**: If you're updating from an older version of the mod,\n\u003e please refer to the [Updating](#updating) section to ensure a clean installation and avoid issues.\n\n---\n\n### Requirements\n\nBefore installing any mod, ensure the following core dependencies are installed:\n\n| Dependency          | Description                                  | Link                                                                   |\n|---------------------|----------------------------------------------|------------------------------------------------------------------------|\n| **smods**           | Mod loader for Balatro.                      | [GitHub Repository](https://github.com/Steamodded/smods)               |\n| **lovely-injector** | Used by **smods** to inject mods at runtime. | [GitHub Repository](https://github.com/ethangreen-dev/lovely-injector) |\n\nRefer to the respective repositories for detailed installation instructions.\n\n\u003e :warning: **Note**: Some mods may have additional dependencies.\n\u003e Check the mod's `README.md` for details.\n\nOnce the core dependencies are installed, locate Balatro's `Mods` directory,\nwhich depends on your OS:\n\n| OS            | Path                                                                                                      |\n|---------------|-----------------------------------------------------------------------------------------------------------|\n| Linux/Deck    | `%LIBRARY%/steamapps/compatdata/2379780/pfx/drive_c/users/steamuser/AppData/Roaming/Balatro/Mods`         |\n| Default Linux | `$HOME/.steam/root/steamapps/compatdata/2379780/pfx/drive_c/users/steamuser/AppData/Roaming/Balatro/Mods` |\n| Windows       | `C:\\Users\\%User%\\AppData\\Roaming\\Balatro\\Mods` or `%AppData%/Balatro/Mods`                               |\n| macOS         | `/Users/$USER/Library/Application Support/Balatro/Mods`                                                   |\n\n\n\u003e **Note**: **Linux / Deck**: Replace `%LIBRARY%` with your Steam Library path.\nIf you don’t use a custom library, then use the **Default Linux** path.\n\nFor further help, visit the\n[lovely-injector](https://github.com/ethangreen-dev/lovely-injector?tab=readme-ov-file#manual-installation)\nproject page or the [smods wiki](https://github.com/Steamodded/smods/wiki#step-3-installing-steamodded).\n\n### Installation methods\n\nYou can install the mods in one of the following ways:\n\n#### Method 1: Release File (Recommended)\n\nThe easiest way to install a mod is by downloading the release file from either:\n\n- [GitHub releases page](https://github.com/LnxFCA/balatro-mods/releases)\n- [NexusMods](https://next.nexusmods.com/profile/LnxFCA/mods?gameId=6217)\n\nThis method is ideal for installing a single mod.\n\nThe release file on GitHub follows the naming scheme: `%mod-dir-name%-v%VERSION%.zip`\n\n- `%mod-dir-name%` is replaced by the mod directory name (e.g., `first-round-joker`).\n- `%VERSION%` is replaced by the version number of the mod (e.g., `first-round-joker-v2.0.0.zip`).\n\nOn NexusMods, the file name is slightly different, but the version can be found in the **Files** tab.\n\nInstall steps:\n\n1. Download the mod release from:\n   - [GitHub Releases](https://github.com/LnxFCA/balatro-mods/releases)\n   - [NexusMods](https://next.nexusmods.com/profile/LnxFCA/mods?gameId=6217)\n\n2. Extract the file into your Balatro `Mods` directory (see [Requirements](#requirements) for help).\n\n3. After extraction, you will find a directory named after the mod (e.g., `Mods/first-round-joker`).\n\n4. The mod is now installed. You can configure it through the **smods** mods panel,\nwhich can be accessed by clicking the **MODS** button on the game's main menu.\n\n#### 2. Using Git\n\nTo install all mods in the repository, you can clone the `release` branch\nof **balatro-mods** using Git.\nThis method is recommended if you want to install all available mods in the\nrepository at once, and it also simplifies updating all mods.\n\n\u003e **Note**: When using this method, it is necessary to clean up the `Mods`\n\u003e directory and reinstall the dependencies after successfully cloning the repository.\n\nTo clone the repository, run the following command:\n\n```bash\ngit clone --branch release https://github.com/LnxFCA/balatro-mods.git Mods\n```\n\nTo update, run the following command:\n\n```shell\ngit pull origin release\n```\n\n\u003e **Note**: For a better experience with `git`, is recommended to use the GitLab\nsubgroup: `https://gitlab.com/lnxfca-dev/balatro-mods`.\n\n## Updating\n\nWhen updating to a new major version (e.g., from `v1.x.x` to `v2.x.x`) or a new\nminor version (e.g., from `v1.1.x` to `v1.2.x`),\nit’s important to follow these steps to prevent potential issues or a \"dirty installation.\"\n\n\u003e **Note**: These steps are only necessary for major or minor version updates\n\u003e (e.g., `v1.x.x` → `v2.x.x` or `v1.1.x` → `v1.2.x`).\n\u003e Patch updates (e.g., `v1.1.0` → `v1.1.1`) usually only include bug fixes\n\u003e and can be applied directly.\n\nFollow the instructions carefully to ensure the mod functions as expected:\n\n1. **Uninstall Previous Version**:\nBefore installing the new version, ensure you fully uninstall the previous version.\nThis can usually be done by deleting the mod folder from the `Mods` directory. This\nis not necessary when using the git installation method.\n\n2. **Clean Configuration Files**:\nAfter successfully uninstalling the old version, you need to remove the old \nconfiguration files from the configuration directory.\nThe configuration directory (`config`) is located in the same Balatro data directory\nas the `Mods` folder. The configuration file will have the same name as the mod directory.\nFor example, the configuration file for the `first-round-joker`\nmod will be located at the relative path: `Balatro/config/first-round-joker.jkr`.\n\n3. **Install the New Version**: Follow the [installation instructions](#installation)\nto install the latest version of the mod.\n\n4. **Check for Additional Steps**: Some updates may introduce changes that require\nadditional steps or configuration.\nMake sure to check the mod README.md for any specific instructions related to the new version.\n\n5. **Verify the Update**: After installation, launch the game to ensure the mod is\nworking correctly. If you encounter any issues, please refer to the\n[troubleshooting section](#general-troubleshooting) or open a new issue on the GitHub repository.\n\n\u003e **Note**: If you're updating from an old version, it’s strongly recommended\n\u003e to delete the mod folder completely before reinstalling to avoid potential conflicts\n\u003e with outdated files or settings. It also helps keeping the mod folder clean by\n\u003e removing unused files.\n\n## General Troubleshooting\n\nIf you are experiencing issues with a specific mod, please check the\nmod's directory for troubleshooting steps related to that mod.\n\nIn general, you can try the following:\n\n- Verify that you are using the latest stable version of `smods`\n(this may not necessarily be the latest commit).\n\n- Ensure that you are using the latest version of the mod.\n\n- Confirm that you downloaded the mod from a valid source:\n    - The GitHub releases page.\n    - Nexus Mods.\n    - The repository's `release` branch.\n\n- If using `git`, make sure you are not on the `main` branch.\n\nIf you cannot update to the latest version of `smods` due to incompatibility with\nmods requiring an older version, you may create a new issue explaining your problem.\n\n---\n\n### Creating a new GitHub issue\n\nIf you cannot find a solution after reviewing the specific mod's README,\nyou can create a new issue.\n\nPlease include the following information to assist in troubleshooting:\n\n1. **Specify the mod name**: Include the mod name, such as `first-round-joker`, \neither in the issue label or in its description.\n\n2. **Provide visual or log evidence**: Upload or paste any relevant screenshots or\ngame logs that illustrate the problem.\n\n3. **Include detailed information**: Add the following details to the issue description:\n\n- **Mod Name**: (e.g., `first-round-joker`)\n- **Game Version**: (e.g., `balatro: 1.0.1n`)\n- **smods Version**: (e.g., `1.0.0~ALPHA-1307d-STEAMODDED`)\n- **Mod Version**: (e.g., `first-round-joker: 1.1.1`)\n\nBy providing this information, you will help developers identify and address your issue more efficiently.\n\n## License\n\nAll source code in this repository is released under the GNU General Public License version 3 or later, unless stated otherwise.\nHowever, it includes other projects (git submodules) that may have different licenses. Please refer to the respective project\nrepository for their licensing information.\n\n### Projects used (submodules)\n\n- [balatro-menv](https://github.com/LnxFCA/balatro-menv) - Refer to its repository for license details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flnxfca%2Fbalatro-mods","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flnxfca%2Fbalatro-mods","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flnxfca%2Fbalatro-mods/lists"}