{"id":15143010,"url":"https://github.com/dapigguy/piggycustomenchants","last_synced_at":"2025-04-08T03:14:51.627Z","repository":{"id":20383671,"uuid":"89804328","full_name":"DaPigGuy/PiggyCustomEnchants","owner":"DaPigGuy","description":"An open source custom enchantment plugin for PocketMine-MP","archived":false,"fork":false,"pushed_at":"2024-04-06T08:54:16.000Z","size":1176,"stargazers_count":104,"open_issues_count":15,"forks_count":117,"subscribers_count":29,"default_branch":"master","last_synced_at":"2025-04-07T23:33:24.364Z","etag":null,"topics":["customenchants","piggyce","piggycustomenchants","pmmp","pocketmine"],"latest_commit_sha":null,"homepage":"https://piggydocs.aericio.net/PiggyCustomEnchants.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}},"created_at":"2017-04-29T18:22:32.000Z","updated_at":"2025-02-26T10:10:24.000Z","dependencies_parsed_at":"2024-04-06T09:41:56.284Z","dependency_job_id":null,"html_url":"https://github.com/DaPigGuy/PiggyCustomEnchants","commit_stats":null,"previous_names":[],"tags_count":59,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DaPigGuy%2FPiggyCustomEnchants","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DaPigGuy%2FPiggyCustomEnchants/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DaPigGuy%2FPiggyCustomEnchants/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DaPigGuy%2FPiggyCustomEnchants/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DaPigGuy","download_url":"https://codeload.github.com/DaPigGuy/PiggyCustomEnchants/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247767236,"owners_count":20992548,"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":["customenchants","piggyce","piggycustomenchants","pmmp","pocketmine"],"created_at":"2024-09-26T10:01:05.466Z","updated_at":"2025-04-08T03:14:51.597Z","avatar_url":"https://github.com/DaPigGuy.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PiggyCustomEnchants [![Poggit-CI](https://poggit.pmmp.io/shield.dl/PiggyCustomEnchants)](https://poggit.pmmp.io/p/PiggyCustomEnchants) [![Discord](https://img.shields.io/discord/330850307607363585?logo=discord)](https://discord.gg/qmnDsSD)\n\nPiggyCustomEnchants is an open-sourced custom enchants plugin for [PocketMine-MP](https://github.com/pmmp/PocketMine-MP) featuring over 90 custom enchantments.\n\n\u003c!-- If one question constantly persists, add the Q/A in here. --\u003e\n## FAQ\n**Q:** How do I create/use an enchanted book? \u003c/br\u003e\n**A:** If you want to create an enchanted book, use the /ce enchant command on a normal book. Afterwards, you place the item you want to enchant on top of the enchanted book. It will then enchant your item.\n\n## Prerequisites\n* Basic knowledge on how to install plugins from Poggit Releases and/or Poggit CI\n* PMMP 4.21.0+\n\n## Installation \u0026 Setup\n1. Install the plugin from Poggit.\n2. (Optional) Configure your PiggyCE\n   * Enchantment rarities, max levels, names, descriptions, \u0026 chances can be configured in their respective JSON files.\n        * `chances.json`: Allows custom chance multipliers for any reactive enchantments.\n            * Reaction chances are calculated by `chance multiplier * enchantment level`.\n            * The chance multiplier by default is 100 for most enchantments.\n   * Extra enchantment settings can be found under `extra_data.json`\n   * The `config.yml` has many options. Some that you should pay attention to are:\n     * `disabled-enchants`: Allows certain enchants to be disabled\n     \n         ```yaml\n            disabled-enchants:\n              - Porkified\n         ```\n     * `per-world-disabled-enchants`: Allows certain enchants to be disabled in specific worlds\n     \n         ```yaml\n            per-world-disabled-enchants:\n              # Disables Porkified \u0026 Volley in PlotWorld\n              PlotWorld:\n                - Porkified\n                - Volley\n              # Disables Jetpack in SurvivalWorld\n              SurvivalWorld:\n                - Jetpack\n         ```\n     * `world-damage`: Toggles world damage for explosive enchantments\n3. (Optional) Install additional plugins supporting PiggyCE:\n   * [PiggyCrates](https://poggit.pmmp.io/p/PiggyCrates) (Official)\n   * [PiggyCustomEnchantsShop](https://poggit.pmmp.io/p/PiggyCustomEnchantsShop) (Official)\n   * [PCEAllyChecks](https://poggit.pmmp.io/p/PCEAllyChecks) (Official)\n   * [PCEBookShop](https://poggit.pmmp.io/p/PCEBookShop) (Official)\n   * Kits\n      * [EasyKits](https://poggit.pmmp.io/p/EasyKits)\n      * [AdvancedKits](https://poggit.pmmp.io/p/AdvancedKits) \n      * [KitUI](https://poggit.pmmp.io/p/KitUI)\n      * [KitsPlus](https://poggit.pmmp.io/p/KitsPlus)\n   * [EnchantUI](https://poggit.pmmp.io/p/EnchantUI)\n5. You're done! Start your server.\n\n## Commands\n| Command                  | Description                                     | Permissions                              | Aliases       |\n|--------------------------|-------------------------------------------------|------------------------------------------|---------------|\n| `/customenchant`         | Main command for PiggyCustomEnchants            | `piggycustomenchants.command.ce`         | `/ce`         |\n| `/customenchant about`   | Shows version and author information            | `piggycustomenchants.command.ce.about`   | `/ce about`   |\n| `/customenchant enchant` | Command to enchant an item with custom enchants | `piggycustomenchants.command.ce.enchant` | `/ce enchant` |\n| `/customenchant help`    | Lists all PiggyCustomEnchant commands           | `piggycustomenchants.command.ce.help`    | `/ce help`    |\n| `/customenchant info`    | Gives information on a custom enchant           | `piggycustomenchants.command.ce.info`    | `/ce info`    |\n| `/customenchant list`    | Lists all PiggyCustomEnchants enchants          | `piggycustomenchants.command.ce.list`    | `/ce list`    |\n| `/customenchant nbt`     | Outputs the NBT of the held item                | `piggycustomenchants.command.ce.nbt`     | `/ce nbt`     |\n| `/customenchant remove`  | Removes a custom enchant from the held item     | `piggycustomenchants.command.ce.remove`  | `/ce remove`  |\n\n## Permissions\n| Permissions                              | Description                                                         | Default |\n|------------------------------------------|---------------------------------------------------------------------|---------|\n| `piggycustomenchants`                    | Allows usage of all PiggyCustomEnchants features                    | `op`    |\n| `piggycustomenchants.command`            | Allow usage of all PiggyCustomEnchants commands                     | `op`    |\n| `piggycustomenchants.command.ce`         | Allow usage of the /customenchant command                           | `op`    |\n| `piggycustomenchants.command.ce.about`   | Allow usage of the /customenchant about subcommand                  | `true`  |\n| `piggycustomenchants.command.ce.enchant` | Allow usage of the /customenchant enchant subcommand                | `op`    |\n| `piggycustomenchants.command.ce.help`    | Allow usage of the /customenchant help subcommand                   | `true`  |\n| `piggycustomenchants.command.ce.info`    | Allow usage of the /customenchant info subcommand                   | `true`  |\n| `piggycustomenchants.command.ce.list`    | Allow usage of the /customenchant list subcommand                   | `true`  |\n| `piggycustomenchants.command.ce.nbt`     | Allow usage of the /customenchant nbt subcommand                    | `true`  |\n| `piggycustomenchants.command.ce.remove`  | Allow usage of the /customenchant remove subcommand                 | `op`    |\n| `piggycustomenchants.overridecheck`      | Allow overriding of custom enchant level limit and item restriction | `false` |\n\n## Issue Reporting\n* If you experience an unexpected non-crash behavior with PiggyCustomEnchants, click [here](https://github.com/DaPigGuy/PiggyCustomEnchants/issues/new?assignees=DaPigGuy\u0026labels=bug\u0026template=bug_report.md\u0026title=).\n* If you experience a crash in PiggyCustomEnchants, click [here](https://github.com/DaPigGuy/PiggyCustomEnchants/issues/new?assignees=DaPigGuy\u0026labels=bug\u0026template=crash.md\u0026title=).\n* If you would like to suggest a feature to be added to PiggyCustomEnchants, click [here](https://github.com/DaPigGuy/PiggyCustomEnchants/issues/new?assignees=DaPigGuy\u0026labels=suggestion\u0026template=suggestion.md\u0026title=).\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## Additional Information\n* Detailed Plugin Setup, Custom Enchantment List, \u0026 API Documentation available at [PiggyDocs](https://piggydocs.aericio.net/PiggyCustomEnchants.html).\n\n## License\n```\n   Copyright 2017 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```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdapigguy%2Fpiggycustomenchants","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdapigguy%2Fpiggycustomenchants","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdapigguy%2Fpiggycustomenchants/lists"}