Skip to content
This repository has been archived by the owner on Mar 7, 2024. It is now read-only.

SuperAdvancements is an advanced, customizable, and easy-to-learn Custom Advancements API for Minecraft 1.12.2 and above.

License

Notifications You must be signed in to change notification settings

gmitch215/SuperAdvancements

🪙 SuperAdvancements

Advanced & Customizable Advancement API, made for SpigotMC and PaperMC 1.12+.

Background

Click to Expand

Advancements are one of the core features of Minecraft, and have been widely sought-out to modify and develop with. With a lack of understanding and documentation, it can be difficult to create custom advancements.

This API serves to solve this by creating a simple and easy-to-use API that supports all versions of Minecraft where they exist, 1.12.2 and above. Featuring Bukkit, Spigot, and Paper support, this API is designed to be as flexible as possible, allowing for easy developing.


❓ Why?

  • Small: The API aims to be as small, compact, and useful as possible, while also maintaining quality-of-life features.
  • Simple: SuperAdvancements aims to have as much documentation and minimalization as possible in order to make usage seamless and comfortable.
  • Flexible: SuperAdvancements is designed to be as flexible as possible, allowing for easy customization and modification. We often have API methods that directly access the methods we are using, allowing for even more modification.
  • Transparent: SuperAdvancements is completely open source, has multiple issue reporting and support channels, and downloadable from your favorite repositories to depend and modify with.

📥 Installation

GitHub License Project Status GitHub release (latest by date)

Maven
<project>
    
    <!-- Import CodeMC Repo -->
    
    <repositories>
        <repository>
            <id>codemc-releases</id>
            <url>https://repo.codemc.io/repository/maven-releases/</url>
        </repository>
    </repositories>
    
    <dependencies>
        <!-- Replace [VERSION] with your Project Version -->

        <!-- 'superadvancements-spigot' for developing with Strings and BaseComponents -->
        <dependency>
            <groupId>me.gamercoder215.superadvancements</groupId>
            <artifactId>superadvancements-spigot</artifactId>
            <version>[VERSION]</version>
        </dependency>

        <!-- 'superadvancements-paper' for developing with Adventure Components -->
        <dependency>
            <groupId>me.gamercoder215.superadvancements</groupId>
            <artifactId>superadvancements-paper</artifactId>
            <version>[VERSION]</version>
        </dependency>
    </dependencies>
    
</project>
Gradle (Groovy)
repositories {
    maven { url 'https://repo.codemc.io/repository/maven-releases/' }
}

dependencies {
    // Replace [VERSION] with your Project Version

    // 'superadvancements-spigot' for developing with Strings and BaseComponents
    implementation 'me.gamercoder215.superadvancements:superadvancements-spigot:[VERSION]'

    // 'superadvancements-paper' for developing with Adventure Components
    implementation 'me.gamercoder215.superadvancements:superadvancements-paper:[VERSION]'
}
Gradle (Kotlin DSL)
repositories {
    maven(url = "https://repo.codemc.io/repository/maven-releases/")
}

dependencies {
    // Replace [VERSION] with your Project Version

    // 'superadvancements-spigot' for developing with Strings and BaseComponents
    implementation("me.gamercoder215.superadvancements:superadvancements-spigot:[VERSION]")

    // 'superadvancements-paper' for developing with Adventure Components
    implementation("me.gamercoder215.superadvancements:superadvancements-paper:[VERSION]")
}