{"id":17013921,"url":"https://github.com/john-paul-r/kits","last_synced_at":"2025-03-22T16:31:08.177Z","repository":{"id":40121287,"uuid":"388518893","full_name":"John-Paul-R/kits","owner":"John-Paul-R","description":"Permissions-based player kits for Fabric Servers.","archived":false,"fork":false,"pushed_at":"2025-01-04T18:07:16.000Z","size":509,"stargazers_count":3,"open_issues_count":7,"forks_count":2,"subscribers_count":1,"default_branch":"1.21.1","last_synced_at":"2025-03-18T13:44:11.365Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/John-Paul-R.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":null,"code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":".github/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-07-22T15:55:59.000Z","updated_at":"2025-01-02T00:18:35.000Z","dependencies_parsed_at":"2024-09-15T01:28:28.380Z","dependency_job_id":"0c0caa44-4e53-4491-abed-df9702c44e2a","html_url":"https://github.com/John-Paul-R/kits","commit_stats":null,"previous_names":[],"tags_count":20,"template":false,"template_full_name":"John-Paul-R/fabric-template-mod","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/John-Paul-R%2Fkits","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/John-Paul-R%2Fkits/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/John-Paul-R%2Fkits/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/John-Paul-R%2Fkits/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/John-Paul-R","download_url":"https://codeload.github.com/John-Paul-R/kits/tar.gz/refs/heads/1.21.1","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244986500,"owners_count":20543024,"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-10-14T06:14:37.036Z","updated_at":"2025-03-22T16:31:07.561Z","avatar_url":"https://github.com/John-Paul-R.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n\u003cimg alt=\"Kits Icon\" src=\"src/main/resources/assets/kits/icon.png\" width=\"128\"\u003e\n\n# Kits\n\nPermissions-based player kits for Fabric Servers.\n\n[![Release](https://img.shields.io/github/v/release/John-Paul-R/kits?style=for-the-badge\u0026include_prereleases\u0026sort=semver)][releases]\n[![Available For](https://img.shields.io/badge/dynamic/json?label=Available%20For\u0026style=for-the-badge\u0026color=34aa2f\u0026query=$[:]\u0026url=https%3A%2F%2Fwww.jpcode.dev%2Fkits%2Fsupported_mc_versions.json)][modrinth:files]\n\n\n[![Modrinth Downloads](https://img.shields.io/modrinth/dt/kits?color=00AF5C\u0026label=modrinth\u0026style=for-the-badge\u0026logo=modrinth)][modrinth:files]\n[![Curseforge Downloads](https://img.shields.io/badge/dynamic/json?color=f16436\u0026style=for-the-badge\u0026label=CurseForge\u0026query=downloadCount\u0026url=https://www.fibermc.com/api/v1.0/ForeignMods/507127\u0026logo=CurseForge)][curseforge:files]\n[![GitHub Downloads (all releases)](https://img.shields.io/github/downloads/John-Paul-R/kits/total?style=for-the-badge\u0026amp;label=GitHub\u0026amp;prefix=downloads%20\u0026amp;color=4078c0\u0026amp;logo=github)][releases]\n\n\u003c/div\u003e\n\nKits is a **Minecraft mod** for [Fabric][fabric] servers that adds configurable,\npermissions-based player kits. This allows server owners to easily set up\nbatches of items that their players can claim, depending on their rank.\nAdditionally, kits can have a predefined cooldown, so that players do not get to\nuse them infinitely.\n\n**Compatible with LuckPerms**\n\n## Usage\n\n### Adding Kits\n\nCommand: `/kit add \u003ckit_name\u003e \u003ccooldown_milliseconds\u003e`\\\nRequires Permission: `kits.manage`\n\nTo add a kit, simply place the items you would like to be included in this kit\nanywhere in your inventory and run the command `/kit add`.\n\n### Claiming Kits\n\nCommand: `/kit claim \u003ckit_name\u003e`\\\nRequires Permission: `kits.claim.\u003ckit_name\u003e`\n\nFor players, claiming kits is simple. They simply type `/kit claim \u003ckit_name\u003e`.\nIf they have permissions to use the specified kit, and that kit is not on\ncooldown for them, they receive the kit in their inventory (or on the ground if\ntheir inventory is full.)\n\nBrigadier suggestions are enabled, and will only suggest kits the player has\npermissions for.\n\n### Removing Kits\n\nCommand: `/kit remove \u003ckit_name\u003e`\\\nRequires Permission: `kits.manage`\n\nTo remove a kit, simply type `/kit remove \u003ckit_name\u003e`. This *irreversibly and\ncompletely* **deletes** the specified kit from the server, for all users.\n\n### Reset Player Kit Cooldowns\n\nIf, as a moderator, you wish to reset a player's kit cooldowns, allowing them to\nregain access to already-claimed kits, you can do so with the following commands:\n\n#### Reset a single kit\n\nCommand: `/kit resetPlayerKit \u003cplayer\u003e \u003ckit_name\u003e`\\\nRequires Permission: `kits.manage`\n\n#### Reset all kits\n\nCommand: `/kit resetPlayer \u003cplayer\u003e`\\\nRequires Permission: `kits.manage`\n\n## Advanced\n\n**Kits** stores most of its data in `nbt` files, using Minecraft's NBT format.\nYou can modify and create such files with a tool like [NBTExplorer][nbtexp].\n\n### Kit Config Files\n\nIf, for whatever reason, you wish to configure kits manually, instead of using\nthe built-in commands, you can do so by modifying the kit files directly.\n\nKit files are stored in the directory `config/kits` in Minecraft's NBT format.\n\nThis allows you to modify kit contents or cooldowns after creation, or even add\nentirely new kits.\n\n### Player Kit Usage Files\n\nWhenever a player successfully claims a kit, the time at which this kit was\nclaimed is recorded in a user-specific file named `\u003cplayer_uuid\u003e.nbt` in the directory\n`world/kits_user_data`.\n\nIf you wish to reset or modify when a user can next use a kit that they have\nalready claimed, you can edit the time specified in this file (stored as\n[milliseconds since Epoch](https://www.epochconverter.com/)). To reset all kit\ncooldowns for a given user, simply delete the nbt file that corresponds to them.\n\n---\n\n## Contributing\n\nThank you for considering contributing to Kits! Please see the\n[Contribution Guidelines][contributing].\n\n## Licence\n\nKits is open-sourced software licenced under the [MIT license][licence].\n\n## Discord\n\nQuestions? Contact me in [my Discord server][discord].\n\n[nbtexp]: https://github.com/jaquadro/NBTExplorer\n[contributing]: .github/CONTRIBUTING.md\n[curseforge]: https://curseforge.com/minecraft/mc-mods/kits\n[curseforge:files]: https://www.curseforge.com/minecraft/mc-mods/kits/files\n[modrinth:files]: https://modrinth.com/mod/kits/versions\n[fabric]: https://fabricmc.net/\n[licence]: LICENCE\n[minecraft]: https://minecraft.net/\n[releases]: https://github.com/John-Paul-R/kits/releases\n[security]: .github/SECURITY.md\n[discord]: https://discord.jpcode.dev/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjohn-paul-r%2Fkits","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjohn-paul-r%2Fkits","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjohn-paul-r%2Fkits/lists"}