{"id":16876198,"url":"https://github.com/fuyukai/kamuidrome","last_synced_at":"2025-09-27T18:31:48.237Z","repository":{"id":217069107,"uuid":"743031138","full_name":"Fuyukai/Kamuidrome","owner":"Fuyukai","description":"Minecraft modpack building helper","archived":false,"fork":false,"pushed_at":"2024-12-16T10:47:45.000Z","size":1374,"stargazers_count":5,"open_issues_count":3,"forks_count":0,"subscribers_count":1,"default_branch":"mizuki","last_synced_at":"2025-01-13T15:41:57.119Z","etag":null,"topics":["minecraft","modpack"],"latest_commit_sha":null,"homepage":"","language":"Python","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/Fuyukai.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2024-01-14T05:12:14.000Z","updated_at":"2024-12-16T10:47:35.000Z","dependencies_parsed_at":"2024-02-24T13:45:54.739Z","dependency_job_id":"a5ae0467-7a84-46f3-8d13-ee787afcce78","html_url":"https://github.com/Fuyukai/Kamuidrome","commit_stats":null,"previous_names":["fuyukai/kamuidrome"],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Fuyukai%2FKamuidrome","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Fuyukai%2FKamuidrome/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Fuyukai%2FKamuidrome/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Fuyukai%2FKamuidrome/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Fuyukai","download_url":"https://codeload.github.com/Fuyukai/Kamuidrome/tar.gz/refs/heads/mizuki","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":234452686,"owners_count":18834895,"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":["minecraft","modpack"],"created_at":"2024-10-13T15:38:32.733Z","updated_at":"2025-09-27T18:31:42.843Z","avatar_url":"https://github.com/Fuyukai.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"Kamuidrome\n==========\n\n.. image:: demo.gif\n    :alt: Demo asciinema\n    :target: https://asciinema.org/a/emNSBAOMSGAwgsCxsh6Fovmw7\n\nKamuidrome is a Minecraft modpack creation helper that integrates directly with Prism Launcher.\nKamuidrome is currently geared entirely towards modpack developers, *not* modpack users. Modpack\nusers should use the exported ``mrpack`` packs instead.\n\nKamuidrome comes with first-class support for `Sinytra Connector \u003chttps://modrinth.com/mod/connector\u003e`_,\nmeaning you can manage Fabric mods in a Forge workspace without issues.\n\nInstallation\n------------\n\nKamuidrome is available on PyPI, and can be installed with `pipx \u003chttps://pipx.pypa.io/stable/installation/\u003e`_:\n\n.. code-block:: fish\n\n    $ pipx install kamuidrome\n\nGetting Started\n---------------\n\nA new, empty modpack can be created using the ``kamuidrome init`` subcommand. This will \ninteractively guide you through setting up your ``pack.toml`` and generate a skeleton file structure\nfor you.\n\n::\n\n    $ kamuidrome init --git\n    Pack name: My Awesome Modpack\n    Minecraft version: 1.20.1\n    Pack version (0.1.0): 0.1.0\n    Modloader [legacyforge/neoforge/fabric/quilt]: fabric\n    Modloader version (leave empty for auto): 0.15.3\n\nAdding Mods\n-----------\n\nModrinth mods can be added to your modpack in one of three ways:\n\n- Using ``kamuidrome add [-s/--search]`` to add a mod via a search query. This will add mods either\n  based on a direct name match (most commonly) or allow you to select the mod you mean.\n\n- Using ``kamuidrome add [-p/--project-id]`` to add the latest version of a specific project, based\n  on its *Modrinth project ID*.\n\n- Using ``kamuidrome add [-V/--version-id]`` to add a specific version of a specific project.\n\nWhen adding a mod, dependencies will be automatically resolved and downloaded if the author has\nprovided the appropriate metadata on Modrinth.\n\n::\n\n    $ kamuidrome add -s \"Big Globe\"\n    successful match: Big Globe / xsng1aJf\n    selected version 3.12.0 for Big Globe\n    selected version 0.91.0+1.20.1 for [1.20.1] Fabric API 0.91.0+1.20.1\n    skipping Big Globe download as it exists already\n    [1.20.1] Fabric API 0.91.0+1.20.1 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 100% 0:00:00\n    Downloading mods...               ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 100% 0:00:00\n\nMod Caching\n~~~~~~~~~~~\n\nMods are automatically cached in your ``$XDG_CACHE_HOME`` directory, meaning that specific mod \nversions will only ever be downloaded once. \n\nAdding Local Mods\n~~~~~~~~~~~~~~~~~\n\nAny mods in the ``mods/`` directory are considered \"local mods\", and will be ignored by \n``kamuidrome`` outside of deployments and exporting. You can use this for mods that aren't available\non Modrinth (provided you obey copyright requirements).\n\nSinytra Connector\n~~~~~~~~~~~~~~~~~\n\nWhen using a ``legacyforge`` or ``neoforge`` pack with ``sinytra_compat`` enabled, all mods with\na ``fabric`` category will be valid for installation. In the case of mods that have both a Fabric\nand a Forge version available, the Forge version will *always* be selected, even if the Fabric\nversion is newer.\n\nFabric API dependencies will automatically be rewritten to Forgified Fabric API when adding mods\nwith the command line. \n\nInstalling Indexed Mods\n-----------------------\n\nWhilst ``kamuidrome add`` *adds* mods to the index, other developers need to be able to install all\nof the mods when checking out the repository. The ``kamuidrome download`` command will download all\nmods in the modpack index and store them in the mod cache.\n\n::\n\n    $ kamuidrome download                                                                                                                                                                                                                ↵ 2\n    Big Globe 3.12.0                  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 100% 0:00:00\n    [1.20.1] Fabric API 0.91.0+1.20.1 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 100% 0:00:00\n    Downloading mods...               ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 100% 0:00:00\n\nListing Indexed Mods\n--------------------\n\nThe ``kamuidrone list`` command can be used to list all mods currently installed in the index.\n\nUpdating Mods\n-------------\n\nMods can be automatically updated with the ``kamuidrome update`` command. This will fetch version\ninformation for all mods in the mod index and update all non-pinned mods to their latest version.\n\n:: \n\n    $ kamuidrome update\n    selected version 3.12.0 for Big Globe\n    selected version 0.91.0+1.20.1 for [1.20.1] Fabric API 0.91.0+1.20.1\n    selected version 0.91.0+1.20.1 for Fabric API\n    Fetching mod info ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 100% 0:00:00\n    skipping Big Globe download as it exists already\n    skipping Fabric API download as it exists already\n    Downloading mods... ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 100% 0:00:00\n\nPinning Mods\n~~~~~~~~~~~~\n\nIf a mod you have in your index can't be updated (possibly due to incompatibility or bugs) you can\npin the version using the ``kamuidrome pin`` command or by editing the ``pinned`` field in the\nindex manually.\n\n::\n\n    $ kamuidrome pin \"Big Globe\"\n    pinned mod Big Globe to version 3.12.0\n\nUpdates for pinned mods will still be downloaded, but the metadata in the mod index will not be\nchanged.\n\nPrism Integration\n-----------------\n\nKamuidrome has Prism Launcher integration as a first class feature via the power of symbolic links.\nYou can automatically deploy a modpack to an instance with the ``kamuidrome deploy`` command, which\nwill symlink data from your download mod cache and local pack directory.\n\nThis is a more flexible approach than ones used by other pack builders (such as Packwiz); for \nexample, you can edit configurations in-game and have the changes saved to your ``config`` \ndirectory in your pack without needing to synchronise.\n\n::\n\n    $ kamuidrome deploy -i \"test pack\"\n    cleaning up symlinks from index...\n    linked included dir /home/lura/.local/share/PrismLauncher/instances/test pack/.minecraft/config\n    linked managed mod /home/lura/.local/share/PrismLauncher/instances/test pack/.minecraft/mods/Big Globe-3.12.0-MC1.20.1.jar\n    linked managed mod /home/lura/.local/share/PrismLauncher/instances/test pack/.minecraft/mods/fabric-api-0.91.0+1.20.1.jar\n\nPlease note that this will *delete* any data in the instance's ``config`` directory, or any other\nsynchronised directories (outside of jars in the ``mods/`` directory) before creating the symbolic\nlinks.\n\nYou can store an instance name in the ``localpack.toml`` file (this should be added to your \ngitignore) so that you don't need to type the instance name when running the ``deploy`` command.\n\n.. code-block:: toml\n    \n    # example ``localpack.toml`` file\n    instance_name = \"test pack\"\n\nAdding Extra Directories\n~~~~~~~~~~~~~~~~~~~~~~~~\n\nExtra directories for both deployment and export can be added with the ``include_directories``\nkey in your ``pack.toml``::\n\n    include_directories = [\n       \"kubejs\",\n    ]\n\nThese directories will be symlinked to your instance folder and included in the generated ``mrpack``.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffuyukai%2Fkamuidrome","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffuyukai%2Fkamuidrome","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffuyukai%2Fkamuidrome/lists"}