{"id":13316504,"url":"https://github.com/amesgen/hellsmack","last_synced_at":"2025-10-25T23:31:16.261Z","repository":{"id":39702936,"uuid":"324456518","full_name":"amesgen/hellsmack","owner":"amesgen","description":"Minecraft stuff","archived":true,"fork":false,"pushed_at":"2023-03-02T04:57:28.000Z","size":205,"stargazers_count":5,"open_issues_count":3,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-12-17T14:42:37.266Z","etag":null,"topics":["curseforge","fabric","launch-mc","minecraft","minecraft-forge","minecraft-installer","minecraft-mods"],"latest_commit_sha":null,"homepage":"","language":"Haskell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"cc0-1.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/amesgen.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}},"created_at":"2020-12-26T00:46:26.000Z","updated_at":"2023-12-07T21:05:41.000Z","dependencies_parsed_at":"2023-01-19T19:32:26.586Z","dependency_job_id":null,"html_url":"https://github.com/amesgen/hellsmack","commit_stats":null,"previous_names":[],"tags_count":16,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amesgen%2Fhellsmack","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amesgen%2Fhellsmack/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amesgen%2Fhellsmack/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amesgen%2Fhellsmack/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/amesgen","download_url":"https://codeload.github.com/amesgen/hellsmack/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238023377,"owners_count":19403719,"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":["curseforge","fabric","launch-mc","minecraft","minecraft-forge","minecraft-installer","minecraft-mods"],"created_at":"2024-07-29T18:21:47.298Z","updated_at":"2025-10-25T23:31:10.932Z","avatar_url":"https://github.com/amesgen.png","language":"Haskell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# hellsmack\n\n![CI](https://github.com/amesgen/hellsmack/workflows/CI/badge.svg)\n\nSome Minecraft stuff as a CLI:\n\n - No GUI\n - uNiX pHiLoSoPhY\n - Does work offline if all necessary files have been downloaded previously\n - Launch Minecraft\n    - client and server\n    - works at least for recent-ish versions (\u003e= 1.7)\n    - automatic Forge installation (in particular for \u003e 1.12)\n    - automatic Fabric installation\n - Manage CurseForge mods\n    - install\n    - update\n    - deduplicate\n - Install and update CurseForge modpacks\n\n## Usage\n\n### Launching\n\nLaunch Vanilla MC:\n```bash\nhellsmack launch client 1.16.5 /path/to/game/dir\n```\n\nLaunch MC 1.12.2 with latest Forge:\n```bash\nhellsmack launch client 1.12.2 -f latest /path/to/game/dir\n```\nOne can also use `recommended`.\n\nLaunch MC 1.16.5 with specific Forge version (see [Forge download page](https://files.minecraftforge.net/)):\n```bash\nhellsmack launch client 1.16.5 -f 35.1.13 /path/to/game/dir\n```\n\nSimilarly, you can use a specific [Fabric](https://fabricmc.net/) version:\n```bash\nhellsmack launch client 1.16.5 --fabric 0.11.3 /path/to/game/dir\n```\nAgain, you can use `recommended` or `latest` to select the latest stable or latest version, resp.\n\nIn each case, one can use `server` instead of `client`.\n\n#### Authentication\n\nBy default, the client is launched in offline mode. To log in with a Mojang account, use\n```bash\nhellsmack auth login ibims@gugel.com correcthorsebatterystaple\n```\nand then use the flag `-a`/`--authenticate`:\n```bash\nhellsmack launch -a client 1.16.5 /path/to/game/dir\n```\n\n### CurseForge\n\n#### Mods\n\nSearch for \"openc\" in MC 1.12.2 on CurseForge and install by selecting e.g. OpenComputers:\n```bash\nhellsmack curse mods search-install 1.12.2 openc\n```\n\nInstall OpenComputers-MC1.12.2-1.7.5.192 (https://www.curseforge.com/minecraft/mc-mods/opencomputers/files/2828357) via its file ID (also accepts multiple arguments):\n```bash\nhellsmack curse mods install 2828357\n```\n\nInteractively update mods in current directory (has multiple options):\n```bash\nhellsmack curse mods update .\n```\n\nDeduplicate different versions of the same mod in the current directory:\n```bash\nhellsmack curse mods deduplicate .\n```\n\n#### Modpacks\n\nSearch and install a client modpack (has multiple filtering options) into the current directory:\n```bash\nhellsmack curse modpacks search-install client \"all the mods\"\n```\n\nInstall a modpack (https://www.curseforge.com/minecraft/modpacks/all-the-mods-6/files/3145702) by file ID into the current directory:\n```bash\nhellsmack curse modpacks install client 3145702\n```\n\nIn each case, one can use `server` instead of `client` (if a server pack is available).\n\nTo update a modpack:\n\n 1. Backup your saves and customizations in `options.txt`, `config/` etc.\n 2. Remove all folders except `mods`.\n 3. Install the new modpack version like above (this will take care of only downloading new/changed mods in the `mods` folder).\n 4. Reapply your customizations.\n\n## Installation\n\nIf you are using Nix on Linux x86_64, you can use `pkgs.nur.repos.amesgen.hellsmack` via [NUR](https://github.com/nix-community/NUR).\n\nAlternatively, pre-built binaries can be found on the [release page](https://github.com/amesgen/hellsmack/releases).\n\nBash/zsh/fish completions are also available, run one of\n```bash\nhellsmack --bash-completion-script /path/to/hellsmack\nhellsmack --zsh-completion-script  /path/to/hellsmack\nhellsmack --fish-completion-script /path/to/hellsmack\n```\n\n## Building\n\nThis is an ordinary [Cabal](https://www.haskell.org/cabal/) project, so you can e.g. build the main executable via\n```bash\ncabal build exe:hellsmack\n```\n\nAlternatively, you can use [haskell.nix](https://input-output-hk.github.io/haskell.nix) to build a fully static Linux x86_64 binary:\n```bash\nnix build .#binaries-Linux\n```\n\n## Acknowledgements\n\nThere are a myriad of resources about Minecraft launchers out here, but I found [wiki.vg](https://wiki.vg) particularly helpful.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famesgen%2Fhellsmack","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Famesgen%2Fhellsmack","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famesgen%2Fhellsmack/lists"}