TuxTwoLib

This library does nothing on it's own and is re-compiled every minecraft version to provide a stable API for several of my plugins of some craftbukkit internals.

Which Download do I Need?

All the downloads are versioned with the craftbukkit version they are for, followed by an optional revision number, and then build number. So if you are on Craftbukkit for Minecraft server version 1.4.4, you would look for a version like this: 1.4.4-b1, with the b1 being the build number. (Always get the version with the highest build number for your version of minecraft) If an incompatibility exists in the builds, it also has a number corresponding to the build, like this: 1.4.5-R0.2-b1 would be compatible for all of 1.4.5-R0.2 builds and up for that version of minecraft.

Features

  • Self aware auto updater will only update the plugin if there is an update available for your minecraft version.
  • Set it to auto update only on Minecraft version changing, whenever there is an update available, or not at all.
  • Will warn you upon login and in console when your version of Minecraft is incompatible with the version installed.
  • Will notify you when new updates are installed.
  • Provides a method for getting offline player data

Permissions

  • tuxtwolib.notices - User can recieve notices about new updates and incompatible Minecraft version errors.

Purpose

For Developers

A recent commit to CraftBukkit now requires any plugins that accesses native "net.minecraft.server" or "org.bukkit.craftbukkit" classes to modify its imports for every new Minecraft version update.
This library abstracts these native classes so that whenever Minecraft updates, only this library needs to be updated. Plugins which use this library can potentially be coded to be compatible with multiple versions of Minecraft.

For Server Admins

If you have multiple plugins that utilize native Minecraft code, you will now have to update each one of them for each update.
Fortunately, if you use any plugins which utilize this library, you only need to update one plugin for them. Just grab the version of this library made for your Minecraft version and you're done!

How to Use:

For Server Admins

  1. Download the correct version of this plugin for your Minecraft version. (follow the instructions above)
    • You can find the different versions of this plugin by clicking the "Files" tab above
    • Make sure you remember where you downloaded the file to!
  2. Select the file you just downloaded and "copy" it to your "/plugins" folder.
    • On Windows, you can use ctrl+c or right click then press "copy". Then use ctrl+v or right-click to paste it in the proper folder.
    • If you are using the terminal, you should know how to use the "cp" command or Midnight Commander.
    • If you need to use FTP, be sure to read the documentation. (connect to the correct IP, traverse directories, etc.)
  3. Run your server as you usually would.
    • Typically this involves a run script or an admin panel. (this part is very important)

For Developers

  1. Check through this library's JavaDocs to see if we have the hooks you require.
    • Because this library is new, it likely does not yet have the hooks you need.
    • If we do not have them, create a Support Ticket for an enhancement. We can add it in for you!
  2. If we do, just examine the JavaDocs and hook into it with your plugin.
    • Do not forget to add "depend: [TuxTwoLib]" to your plugin.yml! (This makes sure that the library is loaded before your plugin)
  3. On your plugin's description make sure you tell users that they need to have this library installed on their server!



JavaDocs: http://javadocs.yu8.me/tuxtwolib/

Thread on how to use the book API: http://forums.bukkit.org/threads/simple-temp-book-api.93562/
A lot of classes taken from: http://forums.bukkit.org/threads/lib-prettyscarylib.110164/

FAQ

Q. I'm getting this in my console: INFO java.lang.NoClassDefFoundError
A. You downloaded the wrong version of the library, or a version that's compatible with your version of minecraft isn't released yet. Please double check and make sure you got the right download.

You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of Karchliu Karchliu Jul 27, 2015 at 09:25 UTC - 0 likes

    good , I am a Chinese

  • Avatar of Ebins Ebins Jul 18, 2015 at 12:56 UTC - 0 likes

    @SanscraftMC: Go

    I'm getting the same thing.

    Solarius Minecraft Server

  • Avatar of SanscraftMC SanscraftMC Jul 15, 2015 at 09:38 UTC - 0 likes

    It says me I'm using a wrong version of TuxTwoLib in Spigot 1.8.7... however, I'm using latest TuxTwoLib and MultiInv, so, why does this happen?

  • Avatar of The_PC_Tech_Guy The_PC_Tech_Guy Jul 13, 2015 at 22:55 UTC - 0 likes

    I think a timeout of 60 seconds of holding up the server to check for updates is a little excessive? http://paste.md-5.net/jegoxolahu.avrasm

    This account is so old that I don't even use that username anymore.
    I now go by "robomwm"

  • Avatar of Manercraft Manercraft Jun 29, 2015 at 14:04 UTC - 0 likes

    Can you become compatible with ParachutePlus ?

    Error: http://pastebin.com/sguvcF3c "Tux2.TuxTwoLib.TuxTwoInventoryPlayer.setItem(TuxTwoInventoryPlayer.java:73) [?:?]"

  • Avatar of HoligamerDev HoligamerDev Jun 16, 2015 at 14:17 UTC - 0 likes

    I cannot access the JavaDocs. Please fix that. :(

  • Avatar of PsychoLynx PsychoLynx Jun 06, 2015 at 21:00 UTC - 0 likes

    @Tux2: Go

    Thanks a million!

  • Avatar of Tux2 Tux2 Jun 06, 2015 at 20:40 UTC - 1 like

    Hey guys! I just published a version which works with 1.8.4, 1.8.5, 1.8.6, and 1.8.7! Yes, that's correct, 4 different versions in one plugin! The NMS hasn't changed so I just added a check into the plugin which will allow you to continue using the same version of the plugin on future versions which are NMS compatible.

    http://myfavs.me/bcs.pngDonate Bitcoins?1Lr7prAnqYpZe2UizvPKV2Cg4KSuj2weXb
    If you didn't take the time to read how my plugins work, don't expect me to take the time to diagnose your stupidity.
    If updates to my plugins depended on donations, they would never update. Donate!

  • Avatar of PsychoLynx PsychoLynx Jun 01, 2015 at 19:03 UTC - 1 like

    @BoomerBR: Go

    Seconding that! 1.8.6 please :)

  • Avatar of BoomerBR BoomerBR May 25, 2015 at 18:33 UTC - 1 like

    1.8.6 out please update

    Run automatic commands is easy with ConsoleScheduler, Download it now!
    http://bit.ly/CScheduler

Facts

Date created
Dec 08, 2012
Category
Last update
Jun 06, 2015
Development stage
Release
License
GNU Lesser General Public License version 3 (LGPLv3)
Curse link
TuxTwoLib
Downloads
360,177
Recent files

Authors