API dla programistów
FunnyGuilds API
Dział zatytułowany „FunnyGuilds API”<repository> <id>reposilite-repository</id> <url>https://maven.reposilite.com/releases</url></repository><dependency> <groupId>net.dzikoysk.funnyguilds</groupId> <artifactId>plugin</artifactId> <version>5.0.0</version> <classifier>all</classifier> <scope>provided</scope></dependency>repositories { mavenCentral() maven { name 'reposilite-repository' url 'https://maven.reposilite.com/releases' }}dependencies { implementation 'net.dzikoysk.funnyguilds:plugin:5.0.0:all'}repositories { mavenCentral() maven { name = "reposilite-repository" url = uri("https://maven.reposilite.com/releases") }}dependencies { implementation("net.dzikoysk.funnyguilds:plugin:5.0.0:all")}FunnyGuilds
Dział zatytułowany „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(); }
}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();}UserManager#addUser(User) odrzuca inny obiekt z już zarejestrowanym UUID,
rzucając IllegalStateException. Istniejący obiekt użytkownika oraz oba indeksy
pozostają bez zmian. Po odrzuceniu nie używaj przekazanego obiektu jako
zarejestrowanego użytkownika; istniejące konto pobierz przez findByUuid(UUID).
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();}Przedmioty i wymagania
Dział zatytułowany „Przedmioty i wymagania”Konfiguracja przedmiotów z items.yml jest dostępna bezpośrednio z instancji pluginu:
FunnyGuilds#getItemsConfiguration()— biblioteka przedmiotów i zestawy wymagań.FunnyGuilds#getGuildItemSetService()— zestaw przysługujący danemu graczowi.FunnyGuilds#getGuildItemRequirementChecker()— sprawdzenie, czy gracz spełnia wymagania.
Nasłuchiwanie wydarzeń
Dział zatytułowany „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():
@Overridepublic void onEnable() { this.getServer().getPluginManager().registerEvents(new GuildDeleteListener(), this);}