Skip to content

Latest commit

 

History

History
79 lines (59 loc) · 4.69 KB

README.md

File metadata and controls

79 lines (59 loc) · 4.69 KB

UltimateAdvancementAPI

Build Status main Branch Build Status dev Branch License Version Issues Stars Forks Contributors

A powerful API to create custom advancements for your minecraft server.

Advancement Tab Image

Modrinth Page: https://modrinth.com/plugin/ultimateadvancementapi
Spigot Page: https://www.spigotmc.org/resources/95585/
Hangar Page: https://hangar.papermc.io/DevHeim/UltimateAdvancementAPI
UltimateAdvancementGenerator: https://escanortargaryen.dev/UltimateAdvancementGenerator/
Discord: https://discord.gg/BMg6VJk5n3
Official Wiki: https://github.com/frengor/UltimateAdvancementAPI/wiki/
Javadoc: https://frengor.com/javadocs/UltimateAdvancementAPI/latest/
Jenkins: https://jenkins.frengor.com/job/UltimateAdvancementAPI/

Get it with maven:

<repositories>
    <repository>
        <id>fren_gor</id>
        <url>https://nexus.frengor.com/repository/public/</url>
    </repository>
</repositories>
<dependency>
    <groupId>com.frengor</groupId>
    <artifactId>ultimateadvancementapi</artifactId>
    <version>2.4.3</version>
    <scope>provided</scope>
</dependency>

Example Plugin:

An example of plugin using UltimateAdvancementAPI can be found here.

More examples by the community can be found in the showcase forum on Discord.

Test Plugin:

The plugin used for tests can be found here.

Contributing

Feel free to open issues or pull requests. Feature requests can be done opening an issue, the enhancement tag will be applied by maintainers.

For pull requests, open them towards the dev branch, as the main branch is only for releases. Also, please use the formatting style settings present under .idea/codeStyles folder.

Required Java version

Currently, the project is compiled for Java 16, although the minimum required Java version might change in future releases.

We consider changing the minimum required Java version a breaking change, so DO NOT expect it to be frequently modified.

In order to compile the code you must be using (at least) the Java version required by the last Minecraft version, since the project uses NMS.

License

This project is licensed under the GNU Lesser General Public License v3.0 or later.

Credits

UltimateAdvancementAPI has been made by fren_gor and EscanorTargaryen.
The API uses the following libraries:

  • EventManagerAPI (released under Apache-2.0 license) to handle events
  • Libby (released under MIT license) to handle dependencies at runtime
  • CommandAPI (released under MIT license) to add commands to the plugin version of the API
  • HikariCP (released under Apache-2.0 license) to connect to MySQL databases
  • bStats (the Java library is released under MIT license) to collect usage data (which can be found here) about the plugin version of the API