Getting Started with Dawn Server API

The Dawn Server API allows server owners and plugin developers to interact with features of the Dawn client from their Minecraft servers. This guide will help you integrate the API into your server plugins.

#Prerequisites

Before you begin, ensure you have:

• A Bukkit/Spigot/Paper Minecraft server
• Basic knowledge of Java and Bukkit plugin development
• A development environment set up for creating Minecraft plugins

#Adding the Dependency

To use the Dawn Server API in your project, you need to add it as a dependency. The examples below show how to include it in your project using different build systems.

<repositories>
    <repository>
        <id>dawn-repo</id>
        <url>https://nexus.dawn.gg/repository/maven-releases</url>
    </repository>
</repositories>

<dependencies>
    <dependency>
        <groupId>gg.dawn.server-api</groupId>
        <artifactId>api</artifactId>
        <version>0.0.8</version>
        <scope>provided</scope>
    </dependency>
</dependencies>

repositories {
    maven {
        name = 'dawn-repo'
        url = 'https://nexus.dawn.gg/repository/maven-releases'
    }
}

dependencies {
    compileOnly 'gg.dawn.server-api:api:0.0.8'
}

repositories {
    maven {
        name = "dawn-repo"
        url = uri("https://nexus.dawn.gg/repository/maven-releases")
    }
}

dependencies {
    compileOnly("gg.dawn.server-api:api:0.0.8")
}

#Installing the Server Plugin

The Dawn Server API requires a plugin to be installed on your server. Download the latest version from GitHub and place it in your server's plugins directory.

After restarting your server, the API will be available for your plugins to use.

#Basic Usage

Here's a simple example of a plugin that detects when a player with Feather joins the server:

public class MyFeatherPlugin extends JavaPlugin {
    
    @Override
    public void onEnable() {
        // Register for Feather events
        FeatherAPI.getEventService().subscribe(
            PlayerHelloEvent.class,
            event -> {
                FeatherPlayer player = event.getPlayer();
                getLogger().info(player.getName() + " is using Feather!");
                getLogger().info("Platform: " + event.getPlatform());
                getLogger().info("Enabled mods: " + event.getFeatherMods().size());
            }
        );
    }
}

This simple example logs information when a player using Feather joins your server.

#Next Steps

Now that you've set up the Dawn Server API in your project, you can explore its various features:

• Events - Subscribe to Feather events
• Mods - Control which mods players can use
• UI - Create custom UI overlays for Feather users
• Waypoints - Create and manage waypoints for players
• Meta Services - Customize server appearance and functionality