[Updated] BKCommonLib 1.70-2

Access to functions Spigot doesn't (want to) offer

  1. Friwi
    Tested Minecraft Versions:
    • 1.8
    • 1.9
    Contributors:
    Friwi, mg_1999, KamikazePlatypus & original authors (bergerkiller, lenis0012, timstans)
    For versions starting from 1.11.2+, please refer to https://www.spigotmc.org/resources/bkcommonlib.39590/

    Welcome to BKCommonLib for Minecraft 1.8+. The builds released are still development builds, so bugs are expected. You can report bugs to me in the discussion Thread. Please use the format I provided there. Thank you![/B]

    Some plugins using BKCommonLib may need to be updated to work with the new update. A lot of methods were changed due to the use of BlockPosition instead of the old x, y, z coord format!

    Latest version: 1.70


    Spigot: v1_9_R1 (MC 1.9.0)

    Older builds available:

    1.57 for MC1.8.6-1.8.9 (v1_8_R3)


    Tekkit: Untested and thus unsupported, some features may not work as expected

    Description
    This utility library shares all the common code needs for various plugins, and having them in one library heavily reduces the amount of duplicated code. The featured utilities are varied, and whenever something is missing in Spigot, it is added in BKCommonLib. This is one of the reasons why it has become this large: there are simply a lot of things Spigot doesn't (want to) offer.

    BKCommonLib has versioning on a per-plugin basis, so when a certain plugin needs version 2, and version 1 is installed, the server owner is automatically notified and the plugin is not enabled. This prevents the common mishaps with outdated BKCommonLib versions.

    Other than utilities and services, this library offers a wide variety of reflection and user-friendly ways of accessing net.minecraft.server. If your plugin requires the use of the internals, but do not want to risk changing field and method names, you can depend on BKCommonLib to provide them for you. This allows you to remain compatible between CraftBukkit versions automatically, and reduces silent failure hazards.

    Reasons for you to depend on this library
    • You need to access Minecraft internals in your plugin, and Spigot has no API for it
    • You are tired of re-uploading the same version over again because of the internals changing
    • You want to work with Vector/math logic, or need to use other utility classes
    • The YAML of Spigot dislikes you, and you want this to be easier
    • You want to easily read and write configuration/data files
    • You want easy access to data conversion utilities to convert user input
    • You want to work with inventories in an advanced fashion
    • You want to work with unique server events
    • You want to alter entity behaviour (such as handling block collisions, custom movement, etc.)
    • You want plugin messages/permissions to be configurable
    • You want to work with (async)tasks without storing IDs
    • You want to send and manipulate packets
    Features
    Getting started
    To start using BKCommonLib, you have to include the jar file as a dependency (after adding BKCommonLib as dependency in the plugin.yml):

    Like any dependency, keep the jar file somewhere on your computer and add it to your classpath. Nothing special here.

    Dependencies BKCommonLib uses
    BKCommonLib supports various other plugins and projects. Below all of these are listed:

    • Vault - for permission plugin support
    • ProtocolLib - to avoid packet listening conflicts
    • Showcase(Standalone) - to ignore showcased items
    • HyperConomy - to ignore shop items
    • BleedingMobs - to ignore particles
    • CGLib - for generating nms.Entity classes on-the-fly to supply Entity Controllers
    • Objenesis - for generating classes without calling constructors (needed for various fixes inside class constructors)
    Plugins that require BKCommonLib to be installed:
    1. TC ActionBlocks
    2. TC Hangrail
    3. MinecraftTrainSimulator
    Disclaimer
    This plugin utilises Hidendra's plugin metrics system, which means that the following information is collected and sent to mcstats.org:

    • A unique identifier
    • The server's version of Java
    • Whether the server is in offline or online mode
    • The plugin's version
    • The server's version
    • The OS version/name and architecture
    • The core count for the CPU
    • The number of players online
    • The Metrics version Opting out of this service can be done by editing plugins/Plugin Metrics/config.yml and changing opt-out to true.
    License
    This library uses an open license. Feel free to use whatever code you need from it, you do not have to ask me either. If you want me to add certain features, that is fine too. Everyone is allowed to use this Library as a dependency. I do recommend extending 'PluginBase' instead of 'JavaPlugin' then, as it allows you to automatically deal with the BKCommonLib versioning checks. See also: BKCommonLib license file

    This product includes software developed by the Apache Software Foundation (http://www.apache.org/)

    Links:
    Compatibility
    BKCommonLib supports ProtocolLib when it is enabled, but if it is not, the player connection is replaced resulting in several incompatibilities. To fix these incompatibility issues, install ProtocolLib next to BKCommonLib. This can not be stressed enough. When incompatibility occurs, BKCommonLib will notify you in the console and will disable itself.

    Metrics
    This plugin sends server count and dependency statistics to MCStats.org. You can (globally) opt out in the PluginMetrics/config.yml file.

    Credits
    Credits go to bergerkiller, lenis0012 and timstans for developing the original version of this plugin until version 1.57, to @mg_1999 and @KamikazePlatypus for their 1.8 fork of this plugin (took parts of the packet system from them) and to me (@Friwi) for updating it to 1.8 & 1.9.
    Notoh, fues, J0schlZ and 3 others like this.

Recent Updates

  1. Updated for 1.11.2
  2. Try #2
  3. Download Url Update

Recent Reviews

  1. ParrotLync
    ParrotLync
    5/5,
    Version: 1.70-2
    Wow. Great plugin. It really works awesome and you can build great theme parks with it! I definitely recommend it for every server!
  2. MCRocks999
    MCRocks999
    5/5,
    Version: 1.70-2
    Thank you for creating this, it surely does help quite alot of plugins, I'm here to show my appreciation for making one of my favorite plugins work :3
    1. Friwi
      Author's Response
      Thank you :)
  3. Darthlegosmc
    Darthlegosmc
    5/5,
    Version: 1.70-2
    Great plugin. It is a dependency for my favorite server which has Train carts on it. Please update to 1.10 ASAP, we are all ready to have fun with the new version. Thanks for all you do!
  4. fortressworks
    fortressworks
    5/5,
    Version: 1.70-2
    great plugin I love it! are you updating the plugin to 1.10 and when do you think this plugin will be 1.10?
  5. HairyDaddy
    HairyDaddy
    3/5,
    Version: 1.70-2
    It’s not possible to get the download link for version 1.66 and I can’t get the latest version (1.67) on my 1.8.8 server.
    1. Friwi
  6. legokay11
    legokay11
    4/5,
    Version: 1.70
    can u please add 1.8 builds i need it for my server running traincarts and sign link. if u can add them that will be great
    1. Friwi
      Author's Response
      I added them above
  7. roomypoprock
    roomypoprock
    4/5,
    Version: 1.70
    Great plugin! I love it and all, but can you add downloads for the old 1.8 versions? I need it to be able to use another plugin
    1. Friwi
      Author's Response
      Im currently trying to get some downloads of old builds avaiable again. Coming soon :)
  8. Darthlegosmc
    Darthlegosmc
    4/5,
    Version: 1.67
    Great plugin, I need it to run traincarts and myworlds. Please update to 1.9 ASAP as i need it to run my server.
    1. Friwi
      Author's Response
      Update is out now :)
  9. Charlie085
    Charlie085
    5/5,
    Version: 1.67
    whens the 1.9 update may i ask? ,
    1. Friwi
      Author's Response
      Coming soon
  10. DSNxSander
    DSNxSander
    5/5,
    Version: 1.67
    Hey guys! Thank you so much for updating to 1.8!

    But I have one question: When do you expect to finish the update for 1.9?
    1. Friwi
      Author's Response
      Coming soon