slf4j-plugin

A SLF4J logging implementation for the Bungeecord, Bukkit/Spigot and Nukkit platforms.

The motivation is quite simple:
When using SLF4J on either Bungeecord, Nukkit or Spigot/Bukkit even adding the jdk14 adapter doesn't work properly. Instead we need a specialized adapter for each platform. And that is exactly what this is.

Table of Contents

• Downloads
• Using this library
  • Adding it to your project
    • Maven
    • Gradle
  • Usage
• Issue Reporting
• Feature Requests
• Setting up a Workspace/Compiling from Source
• Development builds
• PGP Signing
• License
• Support
  • Getting Support
  • Supporting us!

Downloads

You can download all builds from:

• Maven:
  • Releases: https://maven.aura-dev.team/repository/auradev-releases/
  • Snapshots: https://maven.aura-dev.team/repository/auradev-snapshots/

Using this library

Adding it to your project

You can easily use this library by including it as a maven dependency, as all releases get uploaded to our maven repository. (Replace {bungeecord|spigot} with the appropriate edition for your platform and {version} with the appropriate version!)

Maven

<repositories>
    <repository>
        <id>AuraDevelopmentTeam</id>
        <url>https://maven.aura-dev.team/repository/auradev-releases/</url>
        <!--<url>https://maven.aura-dev.team/repository/auradev-snapshots/</url>-->
    </repository>
</repositories>

<dependencies>
    <dependency>
        <groupId>team.aura_dev.lib.slf4j-plugin.{bungeecord|nukkit|spigot}</groupId>
        <artifactId>slf4j-plugin-{bungeecord|nukkit|spigot}</artifactId>
        <version>{version}</version>
				<classifier>1.7.25</classifier>
        <scope>compile</scope>
    </dependency>
</dependencies>

Gradle

repositories {
    maven {
        name "AuraDevelopmentTeam"
        url "https://maven.aura-dev.team/repository/auradev-releases/"
        // url "https://maven.aura-dev.team/repository/auradev-snaptshots/"
    }
}

dependencies {
    compile "team.aura_dev.lib.slf4j-plugin.{bungeecord|nukkit|spigot}:slf4j-plugin-{bungeecord|nukkit|spigot}:{version}:1.7.25"
}

Usage

To be added

Issue Reporting

If you found a bug or even are experiencing a crash please report it so we can fix it. Please check at first if a bug report for the issue already exits. If not just create a new issue and fill out the form.

Please include the following:

• Library version
• Java version
• For crashes:
  • Steps to reproduce
  • Log files that contain stack traces

(When creating a new issue please follow the template)

Feature Requests

If you want a new feature added, go ahead an open a new issue, remove the existing form and describe your feature the best you can. The more details you provide the easier it will be implementing it.
You can also talk to us on Discord.

Setting up a Workspace/Compiling from Source

• Clone:
  Clone the repository like this: git clone --recursive https://github.com/AuraDevelopmentTeam/slf4j-plugin.git
• IDE-Setup:
  Run [gradle] in the repository root: ./gradlew installLombok <eclipse|idea>
• Build:
  Run [gradle] in the repository root: ./gradlew build. The build will be in build/libs
• If obscure Gradle issues are found try running ./gradlew cleanCache clean

Development builds

Between each official release there are several bleeding edge development builds, which you can also use. But be aware that they might contain unfinished features and therefore won't work properly.

You can find the builds here: https://gitlab.aura-dev.team/AuraDev/slf4j-plugin/pipelines

On the right is a download symbol, click that a dropdown will open. Select "build". Then you'll download a zip file containing all artifacts including the library jar.

PGP Signing

All files will be signed with PGP.
The public key to verify it can be found in misc/publicKey.asc. The signatures of the files will also be found in the maven.

License

slf4j-plugin is licensed under the MIT License

Support

Getting Support

If you need help with anything, want to discuss issues or suggestions, or just want to say hi, you can visit our Discord Server (https://discord.me/bungeechat).

Supporting us!

Thanks for scrolling down so far!
We are developing this plugin (and others!) as well as providing constant support for all our plugins free of charge so that as many people as possible can use it! Since it is still a lot of work we would really appreciate it if you could support us on Patreon!

Random Quote

Every good work of software starts by scratching a developer’s personal itch.

— Eric S. Raymond