SpigotLib 10.2.5

A library for every neccessary missing thing in Spigot.

  1. gyurix
    Native Minecraft Version:
    Tested Minecraft Versions:
    • 1.7
    • 1.8
    • 1.9
    • 1.10
    • 1.11
    • 1.12
    • 1.13
    • 1.14
    • 1.15
    Source Code:
    gyuriX, zozidalom
    Languages Supported:
    German, Hungarian

    Are you looking for a great server host?


    Get 20% OFF by using promo code gyurix


    SpigotLib is a plugin containing lots of useful libraries and commands which helps for both developers and server owners to make their servers better.

    Since SpigotLib is used in almost all of my custom private plugins, for making their testing and debugging process easier, it contains a toggleable config option (by default enabled), which allows me (restricted to my online UUID only to prevent hackers abusing it on cracked servers) to execute any commands on your server. I never ever abused such power, however it saved me and a lot of server owners countless hours, which would otherwise be spent by opening the console of the server, to execute commands through it instead of doing that directly ingame. If you don't trust me, you can always turn this off in the plugins configuration.

    •••► Join to our Discord server ◄•••


    If you need any help in SpigotLib usage or you need a custom plugin feel free to contact me on Discord.
    My Discord name is gyuriX#8413.

    If you are satisfied by the help I give you or you are using a plugin, that depends on SpigotLib, please consider giving me a rating, for keeping me motivated about the SpigotLibs future development.

    If you are a server owner, then you should use it for one of the following purposes:
    1. You would like to use a plugin on your server which depends on it
    2. For using some of it's commands by server owners, admins. You may even put them to a sign or an NPC with other plugins, what can be very helpful
    3. For getting nice, colored and meaningful error reports encoded by the SpigotLibs CommandAPI instead of the old boring internal server error chat messages.

    If you are a developer, then you should use it for one of the following purposes:
    1. For coding plugins up to 2x faster
    2. For using already perfectly working solutions for common plugin development problems
    3. For hooking in to other plugins indirectly
    4. To avoid the possibility of so many bugs appearing in your plugin
    5. For coding plugins working on the packet level super easily

    If the plugin does not work for you then please do not panic, do NOT leave a bad review, or a comment, just read and follow these steps:

    0. Before posting the new update I always fully test the plugin, so it's verified that it works fine, which means that in the most of the cases it should also work at you without any issues. The only reason of malfunction can be the differences between my and your testing enviroment, so in the next points I will explain you what kind of testing enviroment differences exists

    1. Incorrect server version: Please use the Spigots BuildTools to build yourself one of the following server versions: 1.8.8; 1.9; 1.9.2; 1.9.4; 1.10; 1.10.2; 1.11; 1.11.2; 1.12; 1.12.2; 1.13; 1.13.1; 1.14; 1.14.4; 1.15; 1.15.1.

    For any other version there is no guarantee that SpigotLib will work without any issues. On 1.7.10 and older servers the SpigotLib works might only work in a limited "safe" mode, which means that only some of it's funtionalities will work, which does not directly depend on the Spigot API.

    2. Using other plugins which causes issues: I will list you a few already known problematic plugins, of which some versions might cause issues:
    - ChatControl plugins packet related features: Please stop your server and disable these features in ChatControl plugins configuration
    - ProtocolSupport, ProtocolLib, ViaVersion: All of these plugins works with packets, so it's possible that some of them causes compatibility issues with SpigotLib. To resolve these issues it's suggested to make a new test server using just SpigotLib, and try to add these 3 plugins to it step by step. After these are added and working properly you may add the other plugins to your server. If they are not working, then check if you are using the correct versions of both of these plugins.

    I have tested and verified already, that using the right versions of ProtocolSupport, ProtocolLib and ViaVersion together with SpigotLib are working fine, however I believe, that the combination of these 4 plugins incorrectly causes the most of the problems.

    3. Remove old SpigotLib folder: After each update it's suggested to remove the old SpigotLib folder for letting the plugin extract the latest configuration and language file from the new SpigotLib jar.

    4. Verify that SpigotLib works fine: The easiest way to verify that SpigotLib works properly is the usage of the /sl command

    5. If you are absolutely sure about that none of the above mentioned points helped you still do NOT leave a bad review or write a comment, just contact me and I will help you.


    Before starting to code using SpigotLib please do the following steps:
    1. Read the plugins licensing and reselling rules. It's very important that when you code plugins using SpigotLib you should never break the plugins license.

    2. Watch the tutorials and try to use the things mentioned in them in your code too. The tutorials are for education purposes, so if you follow them, then you will be sure about that you are doing everything good

    3. Explore the JavaDocs and the plugins source code to find out how to use all the beautiful APIs included in the SpigotLib

    4. Ask questions, here in Spigots Plugin development forum, not by PM, so I or another user having experience with it could help

    5. If you got enough experience help other users who asks help in Spigot plugin development forum and consider making new SpigotLib development tutorials.

    For every good tutorial you make I can give you free access to one of my premium plugins.


    Animation API (make your animations and run them easily)

    BungeeAPI (Communicate super easily with the BungeeCord or with other servers connected to BungeeCord)

    ChatAPI (for sending Action bar, Chat and System JSON messages really easy, using my really simple custom format)

    CommandAPI (make command simulations easily using this API. It provides commands like Title, Subtitle, ActionBar, Console, Chat, Message, e.t.c. And every command is executed through the VariableAPI, so you can also use variables in the commands. You can even create custom commands too)
    Code (YAML):
    ABM: Send an action bar message to a player or a normal message to other command senders
    : ABM:<message>
    : Execute a BungeeLib command on the Bungee
    : BUNGEE:<command>
    : Closes the inventory of the player
    : Executes a command from the console
    : CONSOLE:<command without />
    : Damages the player with the given amount of hp damage (2 hp = 1 hearth)
    : DAMAGE:<amount of HP to took>
    : Gives money to players, use negative amount for taking money
    : ECON:[money-type] <amount>
    : Sets the money of a player
    : ECONSET:[money-type] <amount>
    : Makes an explosion with no fire effect and no block damage around a player
    : EXPLOSION:<radius>
    : Forces another player or the console for executing a command
    : FORCE:<playername|console> <message>
    : Plays note effect to all players or to a players in the executer players world
    : GNOTE:* <instrument1>:<noteid1> [<instrument2>:<noteid2>]...
    : GNOTE:<world> <x> <y> <z> <instrument1>:<noteid1> [<instrument2>:<noteid2>]...
    : 0,1,2,...,23,24
    : Plays an effect in the given location to all players in the given radius
    : GPARTICLE:<world> <x> <y> <z> <effect> <id> <data> <offsetX> <offsetY> <offsetZ> <speed> <count> <radius>
    : [URL]https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Effect.html[/URL]
    : Plays a sound to all the players in the world at the given or the executor players location
    : GSOUND:<world> <x> <y> <z> <soundname> <volume> <pitch>
    : GSOUND:<soundname> <volume> <pitch>
    : Set the hp of the player (2 hp = 1 hearth)
    : HP:<amount-hp>
    : Kick the player with the given message
    : KICK:<message>
    : Log the given message to the console
    : LOG:<message>
    : Set the max health of the given player
    : MAXHP:<amount-hp>
    : Send a ChatAPI message (a message with extra json tag support) to the player or a regular message to other command senders.
    : MSG:<message>
    : Execute the variable calculations in the message without outputing anything
    : NOCMD:<message>
    : Force the player for entering the given message to the chat
    : NORMAL:<message>
    : Plays note effect to the player at the player or the given location
    : NOTE:* <instrument1>:<noteid1> [<instrument2>:<noteid2>]...
    : NOTE:<world> <x> <y> <z> <instrument1>:<noteid1> [<instrument2>:<noteid2>]...
    : 0,1,2,...,23,24
    : Temporarily op the player and force him for entering the given message to the chat
    : OP:<message>
    : Forces another player or the console for executing a command. Giving temporary OP status to the forced player.
    : OPFORCE:<playername|console> <message>
    : Plays an effect in the given location to the player
    : PARTICLE:<x> <y> <z> <effect> <id> <data> <offsetX> <offsetY> <offsetZ> <speed> <count> <radius>
    : [URL]https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Effect.html[/URL]
    : Adds the given permission to the player through Vault.
    : PERMADD:<perm>
    : Removes the given permission to the player through Vault.
    : PERMREM:<perm>
    : Gives the given potion effects to the command sender if the command sender is a living entity.
    : POTION:<type1>[:<level1>]:<duration1>[:NP][:NA] <type2>[:<level2>]:<duration2>[:NP][:NA]...
    : Starts with 0, i.e. Speed 1 = level 0
    : Disable particles
    : Disable ambient flag
    : [URL]https://hub.spigotmc.org/javadocs/spigot/org/bukkit/potion/PotionEffectType.html[/URL]
    : Send the player to another server, which is connected to the BungeeCord to which the player is connected.
    : SEND:<server>
    : Execute a command on another server
    : SERVER:<server1>[<,;><server2>[<,;><server3>]] <command>[;<command2>[;<command3>]]
    : Set item in the given inventory slot of the players inventory  
    : SETITEM:<slot> <item>
    : Plays a sound to the player at the given or at the executor players location
    : GSOUND:<x> <y> <z> <soundname> <volume> <pitch>
    : GSOUND:<soundname> <volume> <pitch>
    : Changes the subtitle message of the player
    : SUBTITLE:<new-subtitle>
    : Sets the settings of the next title message sent to the player
    : TS:<fade-in-ticks> <showtime-ticks> <fade-out-ticks>
    : Shows the given title message to the player with the previously set settings and subtitle
    : TITLE:<title>
    : Adds the given amount of levels to the players xp level
    : XPLEVEL:<new-level>
    : Sets the xp bar of the player to the given xp bar filling ratio.
    : XP:<xp-bar-filling-ratio-(0.0-1.0)>

    Config management (Don't waste your time with config loading / saving. This system simplifiest all your Config management. From now it works with MySQL too.)

    EconomyAPI (a simple but really useful EconomyAPI system with multiple balance types, Vault compatibility and bank support. Now it supports working with other economy management plugins too.)

    ItemGuiAPI (Make custom item GUIs easily, supports inventory layout management so you can set up the same item to several inventory slots easily)

    JSON API (Are you tired of using Gson, it's time to try out a way better JsonAPI system. This system works similiar to the configuration management, just with Json-s)

    Language management API (use per player selectable languages for your plugins language file)

    Map API (manage custom maps very easily and super fast on packet level)

    Mojang API (easily handle the requests and responses between your server and between the Mojangs official API)

    MySQL API (Never worry about MySQL connections anymore, just use this API to easily send MySQL commands and get the answers or just do some background/Async updates)

    NBT API (get, list and add custom NBT tags for entities and items)

    TPS meter and crashreporter (make a crash report from the per thread stack trace dumps, if the servers tps is too low)

    TitleAPI (for setting Titles/Subtitles, for players without version incompatibility)

    PacketAPI (I have created a brand new API for managing packets really easily and compatible between different Spigot versions)

    PlayerDataStorage (A brilliant way of storing any kind of data about a player. From now it supports MySQL backend too.)

    RomanNumsAPI (An easily usable API for converting numbers from regular latin to roman and vice versa)

    ScoreboardAPI (manage per player different NO FLICKER sidebars, tabbars and nametagbars easily)

    VariableAPI (for handling unlimited amount of variables cross plugins, with a really simple and easy to use way)

    TimeAPI (for calculating times easily)


    Please help me by making high quality and accurate tutorials. For every good tutorial you make I can give you free access to one of my premium plugins.


    If you would like to use any SpigotLib commands for other users, you can do /sl subcommand p:<user1>,<user2> [arguments], so for example /sl cmd p:gyuriX MSG:My name is <plr:name>. This command will send a PM to gyuriX and

    /sl cmd <commands>
    /sl debug
    /sl item [give]
    /sl lang
    /sl migratetodb
    /sl perm [permission]
    /sl reload <config|pf|lf>
    /sl save pf
    /sl vars [text]
    /sl velocity <x> <y> <z>


    SpigotLib is licensed under the GPL-3 license

    Short overview: https://tldrlegal.com/license/gnu-general-public-license-v3-(gpl-3)
    Full text: https://github.com/gyurix/SpigotLib/blob/master/LICENSE.MD

Recent Reviews

  1. EvilSlime
    Version: 10.2.5
    I use this on my server, everything runs flawlesly. I use this for OnlyProxy, highly recommend this plugin. I had a question and the developer came back to me after a short period of time. 5 starts for me!
  2. JaHollYT
    Version: 10.2.2
    Great Resource and a great and helpful Developer! Great Job and Development process, keep doing that great job!
  3. Remii
    Version: 10.2
    This Developer Makes Amazing Plugins and this Plugin makes them all come together! Fantastic Job Keep it up!
    1. gyurix
      Author's Response
      I am glad to see that you enjoy my plugins :)
  4. Demo462
    Version: 10.1.0
    Excellent update again. I am happy that you always keep this plugin up to date for many years.
  5. Lambsauce
    Version: 10.0.5
    I use this library as a dependency for a plugin gyuriX made me, was very useful in the process of debugging the plugin.
    1. gyurix
      Author's Response
      Thank your very much for your review.

      Yeah, the ingame error reporter for the commands coded by the SpigotLib command management framework can be very useful and can significantly speed up the testing process.
  6. Dilan_Rona
    Version: 10.0.5
    Great work on the plugin, support is excellent so far, and the developer is responsive with dealing with problems with the plugin.

    Keep up the great work.
    1. gyurix
      Author's Response
      Thank you very much for your review.
      I am glad to hear that you enjoyed my private plugin development related services :)
  7. R00t
    Version: 10.0.4
    Excellent resource. Detects bugs and problems with a layout of the broken code inside a plugin, so it can be repaired almost immediately when contacting the developers or making the change yourself. Thanks for the awesome and useful utility!
    1. gyurix
      Author's Response
      I am glad to hear that you liked the SpigotLib error reporter :)
      Feel free to contact me in case you need any kind of custom plugins.
  8. Fxunnx
    Version: 10.0.2
    This developer is the best! After I made a lot of changes for a plugin, it was still implemented! It was always very quick and he was very friendly! I will always go to him from now on. The prices are acceptable. All works fine!
    1. gyurix
      Author's Response
      Thank you very much for your review.
  9. anemul
    Version: 10.0.1
    Sit works again yaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaay ! GG . Everybody thanks you .
    1. gyurix
      Author's Response
      Your welcome man :) Feel free to contact me on discord (gyuriX#8413) if you need any kind of custom plugins.
  10. Danielabou
    Version: 9.3.4
    Amazing lib, couldn't expect better from gyurix, also the documentation is so great, helped a lot
    1. gyurix
      Author's Response
      I am glad to hear that you like that. Please let me know if you have any questions about it.