Git Product home page Git Product logo

piggycustomenchants's Introduction

PiggyCustomEnchants Poggit-CI Discord

PiggyCustomEnchants is an open-sourced custom enchants plugin for PocketMine-MP featuring over 90 custom enchantments.

FAQ

Q: How do I create/use an enchanted book?
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.

Prerequisites

  • Basic knowledge on how to install plugins from Poggit Releases and/or Poggit CI
  • PMMP 3.2.0 or greater

Installation & Setup

  1. Install the plugin from Poggit.
  2. (Optional) Configure your PiggyCE
    • Enchantment rarities, max levels, names, descriptions, & chances can be configured in their respective JSON files.
      • chances.json: Allows custom chance multipliers for any reactive enchantments.
        • Reaction chances are calculated by chance multiplier * enchantment level.
        • The chance multiplier by default is 100 for most enchantments.
    • Extra enchantment settings can be found under extra_data.json
    • The config.yml has many options. Some that you should pay attention to are:
      • disabled-enchants: Allows certain enchants to be disabled

           disabled-enchants:
             - Porkified
      • per-world-disabled-enchants: Allows certain enchants to be disabled in specific worlds

           per-world-disabled-enchants:
             # Disables Porkified & Volley in PlotWorld
             PlotWorld:
               - Porkified
               - Volley
             # Disables Jetpack in SurvivalWorld
             SurvivalWorld:
               - Jetpack
      • world-damage: Toggles world damage for explosive enchantments

  3. (Optional) Install additional plugins supporting PiggyCE:
  4. You're done! Start your server.

Commands

Command Description Permissions Aliases
/customenchant Main command for PiggyCustomEnchants piggycustomenchants.command.ce /ce
/customenchant about Shows version and author information piggycustomenchants.command.ce.about /ce about
/customenchant enchant Command to enchant an item with custom enchants piggycustomenchants.command.ce.enchant /ce enchant
/customenchant help Lists all PiggyCustomEnchant commands piggycustomenchants.command.ce.help /ce help
/customenchant info Gives information on a custom enchant piggycustomenchants.command.ce.info /ce info
/customenchant list Lists all PiggyCustomEnchants enchants piggycustomenchants.command.ce.list /ce list
/customenchant nbt Outputs the NBT of the held item piggycustomenchants.command.ce.nbt /ce nbt
/customenchant remove Removes a custom enchant from the held item piggycustomenchants.command.ce.remove /ce remove

Permissions

Permissions Description Default
piggycustomenchants Allows usage of all PiggyCustomEnchants features op
piggycustomenchants.command Allow usage of all PiggyCustomEnchants commands op
piggycustomenchants.command.ce Allow usage of the /customenchant command op
piggycustomenchants.command.ce.about Allow usage of the /customenchant about subcommand true
piggycustomenchants.command.ce.enchant Allow usage of the /customenchant enchant subcommand op
piggycustomenchants.command.ce.help Allow usage of the /customenchant help subcommand true
piggycustomenchants.command.ce.info Allow usage of the /customenchant info subcommand true
piggycustomenchants.command.ce.list Allow usage of the /customenchant list subcommand true
piggycustomenchants.command.ce.nbt Allow usage of the /customenchant nbt subcommand true
piggycustomenchants.command.ce.remove Allow usage of the /customenchant remove subcommand op
piggycustomenchants.overridecheck Allow overriding of custom enchant level limit and item restriction false

Issue Reporting

  • If you experience an unexpected non-crash behavior with PiggyCustomEnchants, click here.
  • If you experience a crash in PiggyCustomEnchants, click here.
  • If you would like to suggest a feature to be added to PiggyCustomEnchants, click here.
  • If you require support, please join our discord server here.
  • Do not file any issues related to outdated API version; we will resolve such issues as soon as possible.
  • We do not support any spoons of PocketMine-MP. Anything to do with spoons (Issues or PRs) will be ignored.
    • This includes plugins that modify PocketMine-MP's behavior directly, such as TeaSpoon.

Additional Information

  • We do not support any spoons. Anything to do with spoons (Issues or PRs) will be ignored.
  • We are using the following virions: Commando and libFormAPI.
    • Unless you know what you are doing, use the pre-compiled phar from Poggit-CI and not GitHub.
    • If you wish to run it via source, check out DEVirion.
  • Detailed Plugin Setup, Custom Enchantment List, & API Documentation available at PiggyDocs.

License

   Copyright 2017-2020 DaPigGuy

   Licensed under the Apache License, Version 2.0 (the "License");
   you may not use this file except in compliance with the License.
   You may obtain a copy of the License at

       http://www.apache.org/licenses/LICENSE-2.0

   Unless required by applicable law or agreed to in writing, software
   distributed under the License is distributed on an "AS IS" BASIS,
   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   See the License for the specific language governing permissions and
   limitations under the License.

piggycustomenchants's People

Contributors

95civicsi avatar aericio avatar awzaw avatar dapigguy avatar haxley avatar jasonw4331 avatar jaxkdev avatar luca28pet avatar muqsit avatar poggit-bot avatar r7vmc avatar rubytemple avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.