API dla programistów

Notatka

FunnyGuilds API 5.x (nightly)

FunnyGuilds API

Maven

<repository>
    <id>reposilite-snapshots-repository</id>
    <url>https://maven.reposilite.com/snapshots</url>
</repository>

<dependency>
    <groupId>net.dzikoysk.funnyguilds</groupId>
    <artifactId>plugin</artifactId>
    <version>5.0.0-SNAPSHOT</version>
    <classifier>all</classifier>
    <scope>provided</scope>
</dependency>

Gradle Groovy

repositories {
    mavenCentral()
    maven {
        name 'reposilite-snapshots-repository'
        url 'https://maven.reposilite.com/snapshots'
    }
}

dependencies {
    implementation 'net.dzikoysk.funnyguilds:plugin:5.0.0-SNAPSHOT:all'
}

Gradle Kotlin

repositories {
    mavenCentral()
    maven {
        name = "reposilite-snapshots-repository"
        url = uri("https://maven.reposilite.com/snapshots")
    }
}

dependencies {
    implementation("net.dzikoysk.funnyguilds:plugin:5.0.0-SNAPSHOT:all")
}

FunnyGuilds

Główna instancja pluginu. Powinna zostać pobrana tylko raz, np.:

public class MyPlugin extends JavaPlugin {

    private FunnyGuilds funnyGuilds;

    @Override
    public void onEnable() {
        funnyGuilds = FunnyGuilds.getInstance();
    }

}

User

Dostępne metody pobierania użytkownika:

• UserManager#findByName(String)
• UserManager#findByPlayer(Player)
• UserManager#findByUuid(UUID)

Przykład użycia:

UserManager userManager = funnyGuilds.getUserManager();
Option<User> userOption = userManager.findByName("PlayerName");

if (userOption.isPresent()) {
    User user = userOption.get();
}

Guild

Dostępne metody pobierania gildii:

• GuildManager#findByName(String)
• GuildManager#findByTag(String)
• GuildManager#findByUuid(UUID)
• User#getGuild()

Przykład użycia:

GuildManager guildManager = funnyGuilds.getGuildManager();
Option<Guild> guildOption = guildManager.findByTag("TAG");

if (guildOption.isPresent()) {
    Guild guild = guildOption.get();
}

Option<Guild> guildOption = user.getGuild();

if (guildOption.isPresent()) {
    Guild guild = guildOption.get();
}

Nasłuchiwanie wydarzeń

Wydarzenia dotyczące:

• zmian rankingu: net/dzikoysk/funnyguilds/event/rank
• gildii: net/dzikoysk/funnyguilds/event/guild
• członków gildii: net/dzikoysk/funnyguilds/event/guild/member
• sojuszy: net/dzikoysk/funnyguilds/event/guild/ally

Przykład z użyciem GuildDeleteEvent:

public class GuildDeleteListener implements Listener {

    @EventHandler
    public void onGuildDelete(GuildDeleteEvent event) {
        Guild guild = event.getGuild();
        User doer = event.getDoer();
        FunnyEvent.EventCause eventCause = event.getEventCause();

    }

}

Rejestracja w metodzie onEnable():

@Override
public void onEnable() {
    this.getServer().getPluginManager().registerEvents(new GuildDeleteListener(), this);
}