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.
Yes, this plugin has been updated to Spigot for Minecraft version 1.12!
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
- 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!
- 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.)
- Run your server as you usually would.
- Typically this involves a run script or an admin panel. (this part is very important)
For Developers
- 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!
- 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)
- 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.
So does this only work for certain plugins right?
And if the plugin is setup a certain way, it would work with a 1.3 or 1.4 plugin?
Could someone link me to a tutorial on updating your own plugins? Or making a plugin compatible with this? If its in the desc, I'm sorry, must of missed it, reading again tho
I have just compiled it for 1.6.4 just reboot your server and let the auto updater do it's magic! Enjoy guys!
@DenialMC
Here's a little tip: if you're doing a fan update to a new build, set the build number in the plugin to "1". All official updates are build number 2 or above, so it would update automatically when a new build came out on bukkit dev. Also, due to bukkit dev policy, and me being staff, I "have" to remove your links to unofficial builds, etc. sorry. :(
@KevinEssence: Because I removed the auto-updater, the only thing this plugin haves is a "get offline player" function, which is really really small. You can decompile and take a look.
Daniel
@DenialMC
Why is the file so small?
Here's an unofficial update to 1.6.4! Tested and working with MultiInv installed. Updater is removed to prevent nasty things from happening so please update as soon an official 1.6.4 build for TuxTwoLib is out. Thanks.
Join us at our server: mc.salvagecraft.org
Daniel
I need at 1.6.4 brah :D It's acting funny ;)
Update please if you can to 1.6.4 thanks! :D
Please update to 1.6.4 if you have time! Thanks!
@rcth
It could either be a java incompatability, or your using an alternate version of bukkit. I think. Make sure you at least have the latest dev build.
@rcth
Are you using normal CraftBukkit?
I installed the 1.6.2 build, but it still says it's incompatible.
@rpr797
http://dev.bukkit.org/media/files/717/729/TuxTwoLib.jar
If someone who has the new .jar could post a download, I'd really appreciate it.
When I try to do that, I get:
10.07 12:38:58 [Server] SEVERE New version download was unsuccessful. Please download the correct version of the library from http://dev.bukkit.org/server-mods/tuxtwolib/ 10.07 12:38:58 [Server] WARNING Unable to update to new version. Please update manually! 10.07 12:38:56 [Server] WARNING Current version incompatible with this version of Craftbukkit! Checking for and downloading a compatible version. 10.07 12:38:56 [Server] INFO Enabling TuxTwoLib v1.6.1-b2
and there's no 1.6.2 version download available here, so I can't update manually.
When will this be updated to 1.6.2? I'd really like to update, but this is the plugin that's stopping me from updating.
Thanks,
Isyndel.
@softvelvet
Yup, that's correct. Although I just uploaded a new file for 1.6.2.
I am glad it auto-updates, but that must mean that there is no update for 1.6.2 yet?
oh snap
@PaulBGD
lol, I've heard rumors that the auto updater updates the plugin as soon as an update is available. I just updated the plugin.
@Gonzalineitor
There is no way for this plugin to break your server map, your server crashed.
@CommodoreAlpha
The auto updater downloads the new file as a .jar.part file just in case it fails.
You NEED a CI server.. some of us can't wait for every plugin to be approved by bukkit.