{"id":26865752,"url":"https://github.com/mrfiend179/granter","last_synced_at":"2025-07-19T13:36:50.409Z","repository":{"id":284928260,"uuid":"956518813","full_name":"MrFiend179/Granter","owner":"MrFiend179","description":"Effortless rank grant, Limitless Control","archived":false,"fork":false,"pushed_at":"2025-03-28T12:19:27.000Z","size":0,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-28T12:33:58.564Z","etag":null,"topics":["java","jdk21","minecraft","minecraft-plugin"],"latest_commit_sha":null,"homepage":"https://www.flubel.com/","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MrFiend179.png","metadata":{"files":{"readme":"README.md","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":"2025-03-28T11:44:20.000Z","updated_at":"2025-03-28T12:19:30.000Z","dependencies_parsed_at":"2025-03-28T12:44:15.763Z","dependency_job_id":null,"html_url":"https://github.com/MrFiend179/Granter","commit_stats":null,"previous_names":["mrfiend179/granter"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/MrFiend179/Granter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MrFiend179%2FGranter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MrFiend179%2FGranter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MrFiend179%2FGranter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MrFiend179%2FGranter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MrFiend179","download_url":"https://codeload.github.com/MrFiend179/Granter/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MrFiend179%2FGranter/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265942581,"owners_count":23853294,"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":["java","jdk21","minecraft","minecraft-plugin"],"created_at":"2025-03-31T04:24:02.548Z","updated_at":"2025-07-19T13:36:50.376Z","avatar_url":"https://github.com/MrFiend179.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Granter v1.0\n\nA **powerful and flexible granting system** for **Minecraft servers** that integrates with **LuckPerms** and **PlaceholderAPI**. This plugin allows players with specific permission to grant ranks to other players.\n\n![image](https://firebasestorage.googleapis.com/v0/b/flubel-a1b4b.appspot.com/o/images%2FX%20(4).png?alt=media\u0026token=82596528-8a2d-4c1f-ba7a-04dc8458b63a)\n\n---\n\n## Features\n\n- **Dynamic Rank Limits**: The plugin allows you to set limits for how many times a player can grant specific ranks, such as `limit1`, `limit2`, etc.\n- **Integration with LuckPerms**: Automatically checks for the required permissions to grant ranks.\n- **Customizable Rank Prefixes**: Set custom rank prefixes and messages in `config.yml`.\n- **Colored Rank Notifications**: Grant notifications and messages are color-coded and fully customizable.\n- **Grant Usage Logging**: Track who granted what rank to which player and how many times.\n\n---\n\n## Optional Plugins (Dependencies)\n\n1. **[PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/)**  \n   - **Required for dynamic placeholders in messages**. PlaceholderAPI allows the plugin to dynamically insert player data (e.g., player name, rank) into messages.\n\n\n## Required Plugins (Dependencies)\n\n1. **[LuckPerms](https://www.spigotmc.org/resources/luckperms.28140/)**  \n   - **Required for rank management**. This plugin handles permissions and rank assignments. Without LuckPerms, the plugin won't be able to manage ranks or check for permissions.\n\n---\n\n## Commands\n\n1. ```/grant \u003cplayer_name\u003e \u003crank_name\u003e```\n    - **Description:** Grants the mentioned player the rank.\n    - **Permission:** ```granter.grant```, ```granter.grant.limit\u003climit\u003e```\n\n2. ```/grantreload```\n    - **Description:** Reloads the plugin configuration (data.yml, config.yml).\n    - **Permission:** ```granter.grant.reload```\n\n3. ```/grantinfo```\n   - **Description:** Shows a player information regarding his grants (available and used).\n   - **Permission:** ```granter.grant.info```\n\n\n5. ```/grantreset```\n   - **Description:** Resets a players grants essentially letting him grant again.\n   - **Permission:** ```granter.grant.reset```\n\n\n---\n\n## Configuration\n\n### `config.yml`\n\nThe `config.yml` file allows you to configure rank prefixes, limits, and other plugin settings:\n\n```yaml\n# ===================================================================\n# Granter Plugin Configuration, Made by Flubel\n# ===================================================================\n# This configuration file allows you to set up ranks, their prefixes, \n# limits for granting, and messages that appear when a rank is granted.\n# ===================================================================\n\nranks:\n  # Default demo ranks, you can add your own ranks, prefixes, and limits.\n  # Each rank has a unique prefix and granting limits.\n  # Limits work with the permission node: granter.grant.limit\u003climit_number\u003e (limit1, limit2)\n  # Example: For limit1, the permission would be granter.grant.limit1\n\n  flux:\n    prefix: '\u0026b[FLUX]'  # Prefix that appears before player names\n    limits:\n      limit1: 4       # Max number of times this rank can grant permission level 1\n      limit2: 2       # Max number of times this rank can grant permission level 2\n      limit3: 1       # Max number of times this rank can grant permission level 3\n\n  flux+:\n    prefix: '\u0026d[FLUX+]'\n    limits:\n      limit1: 4\n      limit2: 2\n      limit3: 1\n\n  vortex:\n    prefix: '\u0026e[VORTEX]'\n    limits:\n      limit1: 2\n      limit2: 1\n      limit3: 0  # This rank cannot grant level 3 permissions\n\n# ===================================================================\n# Grant Messages\n# ===================================================================\n# These messages are broadcasted to the server when a rank is granted.\n# Use placeholders to dynamically insert player names and ranks.\n# - {granter_player} = Player granting the rank\n# - {granted_player} = Player receiving the rank\n# - {rank} = Rank being granted\nmessages:\n  - \" \"  # Optional Space\n  - \"\u0026ePlayer \u00266\u0026l{granter_player}\u0026e granted {rank} \u0026eto \u00266\u0026l{granted_player}\"\n  - \" \"  # Optional Space\n\n# ===================================================================\n# Message Decoration\n# ===================================================================\n# This decoration appears above and below the broadcasted messages. e.g. @, =, ~, +. *, $\n# It can be adjusted to fit different symbols and widths.\ndecor: \"@\"\n\n# Number of decoration characters to appear in a single row.\n# Recommended values: 45 for '@', 46 for '=' (adjust as needed).\ndecor_length: 45\n```\n\n---\n\n## License\nThis plugin is distributed unded the [FGPL](https://flubel.com/license) license.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmrfiend179%2Fgranter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmrfiend179%2Fgranter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmrfiend179%2Fgranter/lists"}