Helper library for Bukkit plugins development.
For the master
branch:
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
pom.xml
file.<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.PACKAGE
with 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.