Helper library for Bukkit plugins development.
How to use this library in your plugin?
If you are using Maven to build your plugin, follow these simple steps. Other builds methods are not supported (but you can use them of course).
Currently, the zLib requires Java 7 or later and Bukkit 1.8.3 or later.
I'm starting a new plugin
Either create a plugin as usual and add the zLib as explained below, or use the plugin bootstrap generator and answer “yes” when the tool asks if you want to use zLib.
I want to add zLib to an existing project
Add our Maven repository to your
<repository> <id>zDevelopers</id> <url>http://maven.carrade.eu/artifactory/snapshots</url> </repository>
Add the zLib as a dependency.
<dependency> <groupId>fr.zcraft</groupId> <artifactId>zlib</artifactId> <version>0.99-SNAPSHOT</version> </dependency>
Add the shading plugin to the build. Replace
YOUR.OWN.PACKAGEwith your own package.
<build> ... <plugins> ... <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-shade-plugin</artifactId> <version>2.4</version> <configuration> <artifactSet> <includes> <include>fr.zcraft:zlib</include> </includes> </artifactSet> <relocations> <relocation> <pattern>fr.zcraft.zlib</pattern> <shadedPattern>YOUR.OWN.PACKAGE</shadedPattern> </relocation> </relocations> </configuration> <executions> <execution> <phase>package</phase> <goals> <goal>shade</goal> </goals> </execution> </executions> </plugin> ... </plugins> ... </build>
Build your project as usual, as example with the following command from your working directory, or using an integrated tool from your IDE.
mvn clean install
You should also update your code so your main class extends
ZPlugin instead of
JavaPlugin. No other changes are required. This will allow you to use directly some useful methods to load your plugin's components.
Check out the wiki for more informations.