CraftAPIClient

Description

This is Minecraft library for contacting the Mojang API. It features modern features of Java and flexible way of communicating with Mojang. Furthermore, this project is used for experimenting with Unit-Tests.

Features

• Compatibility with Minecraft 1.8.8+
• Thread-Safe
• Usage of modern Java 11 HTTP Client features
• UUID and skin querying
• Skin changing
• Rotating multiple outgoing source IPs
• Throws exceptions to let the user decide how to handle errors
• Default in-memory cache
• Rotating proxies
• Configurable amount of name -> uuid requests before using proxies

Planned

• Unit testing for HTTP requests like in google-http-client
• Service registration for Bukkit and Sponge
• Cache cracked username requests
• HTTP request interceptor to redirect to this library
• Wait a customizable interval for sending bulk requests (although this increases latency)
• Add multiple remote APIs besides Mojang:
  • MineTools

Requirements

• Java 11+
• Gson
• Guava

Contribution

This project is open for suggestions (including breaking changes between major version) and contributions. If you have an idea to make this library, you are welcome to create an issue ticker or pull request. Please provide units for pull requests if possible.

Maven repository

	<repositories>
        <!-- CodeMc -->
        <repository>
            <id>codemc-repo</id>
            <url>https://repo.codemc.org/repository/maven-public/</url>
        </repository>
    </repositories>

    <dependencies>
        <!--Common component for contacting the Mojang API-->
        <dependency>
            <groupId>com.github.games647</groupId>
            <artifactId>craftapi</artifactId>
            <version>VERSION</version>
        </dependency>
    </dependencies>

Credits

• Fast-UUID - MIT license
  • Remember to include its license file

Inspired by

• Sponge's GameProfileManager GameProfileCache
• SquirrelId
• Mojang Authlib
• Mojang AccountsClient
• API proxy Interceptor