{"id":15143559,"url":"https://github.com/dapigguy/piggycrates","last_synced_at":"2025-07-23T15:04:36.307Z","repository":{"id":41534439,"uuid":"118399424","full_name":"DaPigGuy/PiggyCrates","owner":"DaPigGuy","description":"A crate plugin for PocketMine-MP supporting unlimited crate types","archived":false,"fork":false,"pushed_at":"2023-12-07T14:59:25.000Z","size":311,"stargazers_count":31,"open_issues_count":17,"forks_count":41,"subscribers_count":11,"default_branch":"master","last_synced_at":"2025-07-17T09:03:21.706Z","etag":null,"topics":["piggycrates","pmmp","pocketmine"],"latest_commit_sha":null,"homepage":"https://piggydocs.aericio.net/PiggyCrates.html","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DaPigGuy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","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":"2018-01-22T03:07:24.000Z","updated_at":"2023-11-06T16:18:43.000Z","dependencies_parsed_at":"2025-06-10T21:36:23.779Z","dependency_job_id":"04d871bb-3190-45ef-9b1c-5e666c4db61e","html_url":"https://github.com/DaPigGuy/PiggyCrates","commit_stats":null,"previous_names":[],"tags_count":26,"template":false,"template_full_name":null,"purl":"pkg:github/DaPigGuy/PiggyCrates","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DaPigGuy%2FPiggyCrates","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DaPigGuy%2FPiggyCrates/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DaPigGuy%2FPiggyCrates/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DaPigGuy%2FPiggyCrates/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DaPigGuy","download_url":"https://codeload.github.com/DaPigGuy/PiggyCrates/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DaPigGuy%2FPiggyCrates/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266699565,"owners_count":23970514,"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","status":"online","status_checked_at":"2025-07-23T02:00:09.312Z","response_time":66,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["piggycrates","pmmp","pocketmine"],"created_at":"2024-09-26T10:01:56.966Z","updated_at":"2025-07-23T15:04:36.283Z","avatar_url":"https://github.com/DaPigGuy.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PiggyCrates [![Poggit-CI](https://poggit.pmmp.io/shield.dl/PiggyCrates)](https://poggit.pmmp.io/p/PiggyCrates) [![Discord](https://img.shields.io/discord/330850307607363585?logo=discord)](https://discord.gg/qmnDsSD)\n\nPiggyCrates is a simple and customizable crates plugin, supporting an unlimited amount of crate types. It also supports\nvanilla and custom enchants, such as [PiggyCustomEnchants](https://github.com/DaPigGuy/PiggyCustomEnchants/).\n\n## Prerequisites\n\n* Basic knowledge on how to install plugins from Poggit Releases and/or Poggit CI\n* PMMP 4.0.0+\n\n## Installation \u0026 Setup\n\n1. Install the plugin from Poggit.\n2. Start your server.\n3. (Optional) The `config.yml` file has a few options that allow you to customize your key items \u0026 crate modes (default\n   is roulette).\n4. Open the `crates.yml`.\n5. PiggyCrates supports an unlimited number of crates. To define a crate, add a key `crates.yourcratename`.\n6. Configure your crate types. Crate types have several different properties:\n    * (Optional) `floating-text`: Floating text that will appear above the crate type. Leave empty for no floating text.\n    * (Optional) `commands`: Commands to be run by CONSOLE when crate type is opened. Use `{PLAYER}` as a placeholder\n      for player name.\n    * `drops`: Possible drops of a crate type. Items are defined with the properties:\n        * `id`: Item ID\n        * `meta`: Item Meta\n        * `amount`: Item Amount\n        * (Optional) `type`: Item Type\n            * (Default) `item`: Runs all crate item commands \u0026 gives the item\n            * `command`: Runs all crate item commands\n        * (Optional) `chance`: Item Weight\n        * (Optional) `nbt`: Item NBT as stringified JSON\n        * (Optional) `name`: Item Name\n        * (Optional) `lore`: Item Lore as string with line breaks represented as `\\n`\n        * (Optional) `enchantments`: Item enchantments defined like so:\n          ```yaml\n          enchantments:\n           - name: \"Protection\"\n             level: 1\n           - name: \"Thorns\"\n             level: 1\n          ```\n        * (Optional) `commands`: Commands to be run by CONSOLE if item is dropped by crate.\n    * `amount`: Amount of drops a single crate type will give.\n\n   **Example**:\n   ```yaml\n   crates:\n     # Crate type named \"Example\"\n     Example:\n       floating-text: \"Example Crate\"\n       amount: 1\n       # Will run the command \"/say\" when opened\n       commands:\n         - \"say {PLAYER} has opened the example crate!\"\n       drops:\n         # 50% chance for 1x Diamond Sword named Sharpened Diamond Sword w/ Sharpness 5 enchantment\n         # Will run the command \"/tell\" on drop\n         - id: 276\n           meta: 0\n           amount: 1\n           chance: 50\n           name: \"Sharpened Diamond Sword\"\n           enchantments:\n             - name: \"Sharpness\"\n               level: 5\n           commands:\n             - \"tell {PLAYER} You got a Sharpened Diamond Sword! ;o\"\n         # Identical to the above drop but with a 25% chance and an Iron Sword\n         - id: 267\n           meta: 0\n           amount: 1\n           chance: 25\n           name: \"Sharpened Iron Sword\"\n           enchantments:\n             - name: \"Sharpness\"\n               level: 5\n           commands:\n             - \"tell {PLAYER} You got a Sharpened Iron Sword! ;o\"\n         # 25% chance for player to get money\n         - id: 266\n           meta: 0\n           amount: 1\n           chance: 25\n           name: \"$2500\"\n           type: command\n           commands:\n             - \"givemoney {PLAYER} 2500\"\n    ```\n7. Restart your server.\n8. Connect to your server.\n9. Place a chest block where you intend on having a crate.\n9. Run the command `/crate \u003ccrate name\u003e`\n10. Tap the target chest.\n11. Repeat with other crate types.\n12. You're done!\n\n## Commands\n\n| Command | Description | Permissions | Aliases\n| --- | --- | --- | --- |\n| `/crate \u003ccrate\u003e` | Changes a chest to a crate by tapping | `piggycrates.command.crate` | N/A |\n| `/key` | Gives a player a specific crate key | `piggycrates.command.key` | N/A |\n| `/keyall` | Gives all online players a specific crate key | `piggycrates.command.keyall` | N/A |\n\n## Permissions\n\n| Permissions | Description | Default |\n| --- | --- | --- |\n| `piggycrates` | Allows usage of all PiggyCrates features | `false` |\n| `piggycrates.command` | Allow usage of all PiggyCrates commands | `op` |\n| `piggycrates.command.crate` | Allow usage of all /crate commands | `op` |\n| `piggycrates.command.key` | Allow usage of the /key command | `op` |\n| `piggycrates.command.keyall` | Allow usage of the /keyall command | `op` |\n\n## Issue Reporting\n\n* If you experience an unexpected non-crash behavior with PiggyCrates,\n  click [here](https://github.com/DaPigGuy/PiggyCrates/issues/new?assignees=DaPigGuy\u0026labels=bug\u0026template=bug_report.md\u0026title=)\n  .\n* If you experience a crash in PiggyCrates,\n  click [here](https://github.com/DaPigGuy/PiggyCrates/issues/new?assignees=DaPigGuy\u0026labels=bug\u0026template=crash.md\u0026title=)\n  .\n* If you would like to suggest a feature to be added to PiggyCrates,\n  click [here](https://github.com/DaPigGuy/PiggyCrates/issues/new?assignees=DaPigGuy\u0026labels=suggestion\u0026template=suggestion.md\u0026title=)\n  .\n* If you require support, please join our discord server [here](https://discord.gg/qmnDsSD).\n* Do not file any issues related to outdated API version; we will resolve such issues as soon as possible.\n* We do not support any spoons of PocketMine-MP. Anything to do with spoons (Issues or PRs) will be ignored.\n    * This includes plugins that modify PocketMine-MP's behavior directly, such as TeaSpoon.\n\n## License\n\n```\n   Copyright 2018-2020 DaPigGuy\n\n   Licensed under the Apache License, Version 2.0 (the \"License\");\n   you may not use this file except in compliance with the License.\n   You may obtain a copy of the License at\n\n       http://www.apache.org/licenses/LICENSE-2.0\n\n   Unless required by applicable law or agreed to in writing, software\n   distributed under the License is distributed on an \"AS IS\" BASIS,\n   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n   See the License for the specific language governing permissions and\n   limitations under the License.\n\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdapigguy%2Fpiggycrates","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdapigguy%2Fpiggycrates","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdapigguy%2Fpiggycrates/lists"}