getExpansionSort() {
- final String option = plugin.getConfig()
- .getString("cloud_sorting", ExpansionSort.LATEST.name());
-
- try {
- //noinspection ConstantConditions (bad spigot annotation)
- return Optional.of(ExpansionSort.valueOf(option.toUpperCase()));
- } catch (final IllegalArgumentException ignored) {
- return Optional.empty();
- }
- }
-
-
- @NotNull
- public String dateFormat() {
- //noinspection ConstantConditions (bad spigot annotation)
- return plugin.getConfig().getString("date_format", "MM/dd/yy HH:mm:ss");
- }
-
-
- @NotNull
- public String booleanTrue() {
- //noinspection ConstantConditions (bad spigot annotation)
- return plugin.getConfig().getString("boolean.true", "true");
- }
-
- @NotNull
- public String booleanFalse() {
- //noinspection ConstantConditions (bad spigot annotation)
- return plugin.getConfig().getString("boolean.false", "false");
- }
-
- public boolean useAdventureProvidedReplacer() {
- return plugin.getConfig().getBoolean("use_adventure_provided_replacer", false);
- }
-
- public boolean detectMaliciousExpansions() {
- return plugin.getConfig().getBoolean("detect_malicious_expansions", true);
- }
-}
diff --git a/src/main/java/me/clip/placeholderapi/events/ExpansionRegisterEvent.java b/src/main/java/me/clip/placeholderapi/events/ExpansionRegisterEvent.java
deleted file mode 100644
index e054717..0000000
--- a/src/main/java/me/clip/placeholderapi/events/ExpansionRegisterEvent.java
+++ /dev/null
@@ -1,89 +0,0 @@
-/*
- * This file is part of PlaceholderAPI
- *
- * PlaceholderAPI
- * Copyright (c) 2015 - 2026 PlaceholderAPI Team
- *
- * PlaceholderAPI free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * PlaceholderAPI is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this program. If not, see .
- */
-
-package me.clip.placeholderapi.events;
-
-import me.clip.placeholderapi.expansion.PlaceholderExpansion;
-import org.bukkit.event.Cancellable;
-import org.bukkit.event.Event;
-import org.bukkit.event.HandlerList;
-import org.jetbrains.annotations.NotNull;
-
-/**
- * This event indicates that a single {@link PlaceholderExpansion PlaceholderExpansion} has
- * been registered in PlaceholderAPI.
- *
- * To know when all Expansions have been registered, use the
- * {@link me.clip.placeholderapi.events.ExpansionsLoadedEvent ExpansionsLoadedEvent} instead.
- */
-public final class ExpansionRegisterEvent extends Event implements Cancellable {
-
- @NotNull
- private static final HandlerList HANDLERS = new HandlerList();
- @NotNull
- private final PlaceholderExpansion expansion;
- private boolean cancelled;
-
- public ExpansionRegisterEvent(@NotNull final PlaceholderExpansion expansion) {
- this.expansion = expansion;
- }
-
- @NotNull
- public static HandlerList getHandlerList() {
- return HANDLERS;
- }
-
- /**
- * The {@link PlaceholderExpansion PlaceholderExpansion} that was registered in PlaceholderAPI.
- *
The PlaceholderExpansion will be available for use when the event
- * {@link #isCancelled() was not cancelled}!
- *
- * @return Current instance of the registered {@link PlaceholderExpansion PlaceholderExpansion}
- */
- @NotNull
- public PlaceholderExpansion getExpansion() {
- return expansion;
- }
-
- /**
- * Indicates if this event was cancelled or not.
- *
A cancelled Event will result in the {@link #getExpansion() PlaceholderExpansion} NOT
- * being added to PlaceholderAPI's internal list and will therefore be considered not registered
- * anymore.
- *
- * @return Whether the event has been cancelled or not.
- */
- @Override
- public boolean isCancelled() {
- return cancelled;
- }
-
- @Override
- public void setCancelled(boolean cancelled) {
- this.cancelled = cancelled;
- }
-
- @NotNull
- @Override
- public HandlerList getHandlers() {
- return HANDLERS;
- }
-
-}
diff --git a/src/main/java/me/clip/placeholderapi/events/ExpansionUnregisterEvent.java b/src/main/java/me/clip/placeholderapi/events/ExpansionUnregisterEvent.java
deleted file mode 100644
index e7a1683..0000000
--- a/src/main/java/me/clip/placeholderapi/events/ExpansionUnregisterEvent.java
+++ /dev/null
@@ -1,70 +0,0 @@
-/*
- * This file is part of PlaceholderAPI
- *
- * PlaceholderAPI
- * Copyright (c) 2015 - 2026 PlaceholderAPI Team
- *
- * PlaceholderAPI free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * PlaceholderAPI is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this program. If not, see .
- */
-
-package me.clip.placeholderapi.events;
-
-import me.clip.placeholderapi.expansion.PlaceholderExpansion;
-import org.bukkit.event.Event;
-import org.bukkit.event.HandlerList;
-import org.jetbrains.annotations.NotNull;
-
-/**
- * This event indicates that a {@link PlaceholderExpansion PlaceholderExpansion} has been
- * unregistered by PlaceholderAPI.
- *
- *
Note that this event is triggered before the PlaceholderExpansion is completely
- * removed.
- *
This includes removing any Listeners, stopping active tasks and clearing the cache of
- * the PlaceholderExpansion.
- */
-public final class ExpansionUnregisterEvent extends Event {
-
- @NotNull
- private static final HandlerList HANDLERS = new HandlerList();
-
- @NotNull
- private final PlaceholderExpansion expansion;
-
- public ExpansionUnregisterEvent(@NotNull final PlaceholderExpansion expansion) {
- this.expansion = expansion;
- }
-
- @NotNull
- public static HandlerList getHandlerList() {
- return HANDLERS;
- }
-
- /**
- * The {@link PlaceholderExpansion PlaceholderExpansion} that was unregistered.
- *
- * @return The {@link PlaceholderExpansion PlaceholderExpansion} instance.
- */
- @NotNull
- public PlaceholderExpansion getExpansion() {
- return expansion;
- }
-
- @NotNull
- @Override
- public HandlerList getHandlers() {
- return HANDLERS;
- }
-
-}
diff --git a/src/main/java/me/clip/placeholderapi/events/ExpansionsLoadedEvent.java b/src/main/java/me/clip/placeholderapi/events/ExpansionsLoadedEvent.java
deleted file mode 100644
index 169030b..0000000
--- a/src/main/java/me/clip/placeholderapi/events/ExpansionsLoadedEvent.java
+++ /dev/null
@@ -1,74 +0,0 @@
-/*
- * This file is part of PlaceholderAPI
- *
- * PlaceholderAPI
- * Copyright (c) 2015 - 2026 PlaceholderAPI Team
- *
- * PlaceholderAPI free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * PlaceholderAPI is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this program. If not, see .
- */
-
-package me.clip.placeholderapi.events;
-
-
-import java.util.Collections;
-import java.util.List;
-
-import me.clip.placeholderapi.expansion.PlaceholderExpansion;
-import org.bukkit.event.Event;
-import org.bukkit.event.HandlerList;
-import org.jetbrains.annotations.NotNull;
-
-/**
- * This event indicated that all {@link PlaceholderExpansion PlaceholderExpansions} have
- * been registered in PlaceholderAPI and can now be used.
- *
This even will also be triggered whenever PlaceholderAPI gets reloaded.
- *
- *
All PlaceholderExpansions, except for those loaded by plugins, are loaded
- * after Spigot triggered its ServerLoadEvent (1.13+), or after PlaceholderAPI has been enabled.
- */
-public class ExpansionsLoadedEvent extends Event {
-
- private final List expansions;
-
- public ExpansionsLoadedEvent(List expansions) {
- this.expansions = Collections.unmodifiableList(expansions);
- }
-
- /**
- * Returns a unmodifiable list of {@link PlaceholderExpansion PlaceholderExpansions} that
- * have been registered by PlaceholderAPI.
- *
- * This list does not include manually registered PlaceholderExpansions.
- *
- * @return List of {@link PlaceholderExpansion registered PlaceholderExpansions}.
- */
- @NotNull
- public final List getExpansions() {
- return expansions;
- }
-
- @NotNull
- private static final HandlerList HANDLERS = new HandlerList();
-
- @NotNull
- @Override
- public HandlerList getHandlers() {
- return HANDLERS;
- }
-
- @NotNull
- public static HandlerList getHandlerList() {
- return HANDLERS;
- }
-}
diff --git a/src/main/java/me/clip/placeholderapi/events/PlaceholderHookUnloadEvent.java b/src/main/java/me/clip/placeholderapi/events/PlaceholderHookUnloadEvent.java
deleted file mode 100644
index 402077b..0000000
--- a/src/main/java/me/clip/placeholderapi/events/PlaceholderHookUnloadEvent.java
+++ /dev/null
@@ -1,70 +0,0 @@
-/*
- * This file is part of PlaceholderAPI
- *
- * PlaceholderAPI
- * Copyright (c) 2015 - 2026 PlaceholderAPI Team
- *
- * PlaceholderAPI free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * PlaceholderAPI is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this program. If not, see .
- */
-
-package me.clip.placeholderapi.events;
-
-import me.clip.placeholderapi.PlaceholderHook;
-import org.bukkit.event.Event;
-import org.bukkit.event.HandlerList;
-import org.jetbrains.annotations.NotNull;
-
-/**
- * @deprecated This event is no longer used.
- */
-@Deprecated
-public final class PlaceholderHookUnloadEvent extends Event {
-
- @NotNull
- private static final HandlerList HANDLERS = new HandlerList();
-
-
- @NotNull
- private final String plugin;
- @NotNull
- private final PlaceholderHook placeholderHook;
-
- public PlaceholderHookUnloadEvent(@NotNull final String plugin,
- @NotNull final PlaceholderHook placeholderHook) {
- this.plugin = plugin;
- this.placeholderHook = placeholderHook;
- }
-
- @NotNull
- public static HandlerList getHandlerList() {
- return HANDLERS;
- }
-
- @NotNull
- public String getHookName() {
- return plugin;
- }
-
- @NotNull
- public PlaceholderHook getHook() {
- return placeholderHook;
- }
-
- @NotNull
- @Override
- public HandlerList getHandlers() {
- return HANDLERS;
- }
-
-}
diff --git a/src/main/java/me/clip/placeholderapi/exceptions/NoDefaultCommandException.java b/src/main/java/me/clip/placeholderapi/exceptions/NoDefaultCommandException.java
deleted file mode 100644
index 3d454ac..0000000
--- a/src/main/java/me/clip/placeholderapi/exceptions/NoDefaultCommandException.java
+++ /dev/null
@@ -1,29 +0,0 @@
-/*
- * This file is part of PlaceholderAPI
- *
- * PlaceholderAPI
- * Copyright (c) 2015 - 2026 PlaceholderAPI Team
- *
- * PlaceholderAPI free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * PlaceholderAPI is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this program. If not, see .
- */
-
-package me.clip.placeholderapi.exceptions;
-
-public final class NoDefaultCommandException extends RuntimeException {
-
- public NoDefaultCommandException(final String message) {
- super(message);
- }
-}
-
diff --git a/src/main/java/me/clip/placeholderapi/expansion/Cacheable.java b/src/main/java/me/clip/placeholderapi/expansion/Cacheable.java
deleted file mode 100644
index 3a8be6d..0000000
--- a/src/main/java/me/clip/placeholderapi/expansion/Cacheable.java
+++ /dev/null
@@ -1,38 +0,0 @@
-/*
- * This file is part of PlaceholderAPI
- *
- * PlaceholderAPI
- * Copyright (c) 2015 - 2026 PlaceholderAPI Team
- *
- * PlaceholderAPI free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * PlaceholderAPI is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this program. If not, see .
- */
-
-package me.clip.placeholderapi.expansion;
-
-/**
- * Classes implementing this interface will have a {@link #clear() clear void} that is called
- * by PlaceholderAPI whenever the {@link me.clip.placeholderapi.expansion.PlaceholderExpansion PlaceholderExpansion}
- * is unregistered.
- *
- * This allows you to execute things such as clearing internal caches, saving data to files, etc.
- *
- * @author Ryan McCarthy
- */
-public interface Cacheable {
-
- /**
- * Called when the implementing class is unregistered from PlaceholderAPI
- */
- void clear();
-}
diff --git a/src/main/java/me/clip/placeholderapi/expansion/Cleanable.java b/src/main/java/me/clip/placeholderapi/expansion/Cleanable.java
deleted file mode 100644
index ae49325..0000000
--- a/src/main/java/me/clip/placeholderapi/expansion/Cleanable.java
+++ /dev/null
@@ -1,42 +0,0 @@
-/*
- * This file is part of PlaceholderAPI
- *
- * PlaceholderAPI
- * Copyright (c) 2015 - 2026 PlaceholderAPI Team
- *
- * PlaceholderAPI free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * PlaceholderAPI is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this program. If not, see .
- */
-
-package me.clip.placeholderapi.expansion;
-
-import org.bukkit.entity.Player;
-
-/**
- * Classes implementing this interface will have a {@link #cleanup(Player) cleanup void} that is
- * called by PlaceholderAPI whenever a Player leaves the server.
- *
- *
This can be useful for cases where you keep data of the player in a cache or similar
- * and want to free up space whenever they leave.
- *
- * @author Ryan McCarthy
- */
-public interface Cleanable {
-
- /**
- * Called when a player leaves the server
- *
- * @param p (@link Player} who left the server
- */
- void cleanup(Player p);
-}
diff --git a/src/main/java/me/clip/placeholderapi/expansion/Configurable.java b/src/main/java/me/clip/placeholderapi/expansion/Configurable.java
deleted file mode 100644
index 48b85c7..0000000
--- a/src/main/java/me/clip/placeholderapi/expansion/Configurable.java
+++ /dev/null
@@ -1,57 +0,0 @@
-/*
- * This file is part of PlaceholderAPI
- *
- * PlaceholderAPI
- * Copyright (c) 2015 - 2026 PlaceholderAPI Team
- *
- * PlaceholderAPI free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * PlaceholderAPI is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this program. If not, see .
- */
-
-package me.clip.placeholderapi.expansion;
-
-import java.util.Map;
-
-/**
- * Implementing this interface allows {@link me.clip.placeholderapi.expansion.PlaceholderExpansion PlaceholderExpansions}
- * to set a list of default configuration values through the {@link #getDefaults() getDefaults method}
- * that should be added to the config.yml of PlaceholderAPI.
- *
- *
The entries will be added under {@code expansions} as their own section.
- *
Example:
- * returning a Map with key {@code foo} and value {@code bar} will result in the following config entry:
- *
- *
- * expansions:
- * myexpansion:
- * foo: "bar"
- *
- *
- * The configuration is set before the PlaceholderExpansion is registered!
- *
- * @author Ryan McCarthy
- */
-public interface Configurable {
-
- /**
- * The map returned by this method will be used to set config options in PlaceholderAPI's config.yml.
- *
- *
The key and value pairs are set under a section named after your
- * {@link me.clip.placeholderapi.expansion.PlaceholderExpansion PlaceholderExpansion} in the
- * {@code expansions} section of the config.
- *
- * @return Map of config path / values which need to be added / removed from the PlaceholderAPI
- * config.yml file
- */
- Map getDefaults();
-}
diff --git a/src/main/java/me/clip/placeholderapi/expansion/NMSVersion.java b/src/main/java/me/clip/placeholderapi/expansion/NMSVersion.java
deleted file mode 100644
index 6053828..0000000
--- a/src/main/java/me/clip/placeholderapi/expansion/NMSVersion.java
+++ /dev/null
@@ -1,81 +0,0 @@
-/*
- * This file is part of PlaceholderAPI
- *
- * PlaceholderAPI
- * Copyright (c) 2015 - 2026 PlaceholderAPI Team
- *
- * PlaceholderAPI free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * PlaceholderAPI is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this program. If not, see .
- */
-
-package me.clip.placeholderapi.expansion;
-
-public enum NMSVersion {
-
- UNKNOWN("unknown"),
- SPIGOT_1_7_R1("v1_7_R1"),
- SPIGOT_1_7_R2("v1_7_R2"),
- SPIGOT_1_7_R3("v1_7_R3"),
- SPIGOT_1_7_R4("v1_7_R4"),
- SPIGOT_1_8_R1("v1_8_R1"),
- SPIGOT_1_8_R2("v1_8_R2"),
- SPIGOT_1_8_R3("v1_8_R3"),
- SPIGOT_1_9_R1("v1_9_R1"),
- SPIGOT_1_9_R2("v1_9_R2"),
- SPIGOT_1_10_R1("v1_10_R1"),
- SPIGOT_1_11_R1("v1_11_R1"),
- SPIGOT_1_12_R1("v1_12_R1"),
- SPIGOT_1_13_R1("v1_13_R1"),
- SPIGOT_1_13_R2("v1_13_R2"),
- SPIGOT_1_14_R1("v1_14_R1"),
- SPIGOT_1_15_R1("v1_15_R1"),
- SPIGOT_1_16_R1("v1_16_R1"),
- SPIGOT_1_16_R2("v1_16_R2"),
- SPIGOT_1_16_R3("v1_16_R3"),
- SPIGOT_1_17_R1("v1_17_R1"),
- SPIGOT_1_18_R1("v1_18_R1"),
- SPIGOT_1_19_R1("v1_19_R1"),
- SPIGOT_1_19_R2("v1_19_R2"),
- SPIGOT_1_19_R3("v1_19_R3"),
- SPIGOT_1_20_R1("v1_20_R1"),
- SPIGOT_1_20_R2("v1_20_R2"),
- SPIGOT_1_20_R3("v1_20_R3"),
- SPIGOT_1_20_R4("v1_20_R4"),
- SPIGOT_1_21_R1("v1_21_R1"),
- SPIGOT_1_21_R2("V1_21_R2"),
- SPIGOT_1_21_R3("V1_21_R3"),
- SPIGOT_1_21_R4("V1_21_R4"),
- SPIGOT_1_21_R5("V1_21_R5"),
- SPIGOT_1_21_R6("V1_21_R6");
-
- private final String version;
-
- NMSVersion(String version) {
- this.version = version;
- }
-
- public static NMSVersion getVersion(String version) {
- for (NMSVersion v : values()) {
- if (v.getVersion().equalsIgnoreCase(version)) {
- return v;
- }
- }
-
- return NMSVersion.UNKNOWN;
- }
-
- public String getVersion() {
- return version;
- }
-
-}
diff --git a/src/main/java/me/clip/placeholderapi/expansion/PlaceholderExpansion.java b/src/main/java/me/clip/placeholderapi/expansion/PlaceholderExpansion.java
deleted file mode 100644
index 0d90b89..0000000
--- a/src/main/java/me/clip/placeholderapi/expansion/PlaceholderExpansion.java
+++ /dev/null
@@ -1,479 +0,0 @@
-/*
- * This file is part of PlaceholderAPI
- *
- * PlaceholderAPI
- * Copyright (c) 2015 - 2026 PlaceholderAPI Team
- *
- * PlaceholderAPI free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * PlaceholderAPI is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this program. If not, see .
- */
-
-package me.clip.placeholderapi.expansion;
-
-import java.util.Collections;
-import java.util.List;
-import java.util.logging.Level;
-
-import me.clip.placeholderapi.PlaceholderAPIPlugin;
-import me.clip.placeholderapi.PlaceholderHook;
-import org.bukkit.Bukkit;
-import org.bukkit.configuration.ConfigurationSection;
-import org.jetbrains.annotations.ApiStatus;
-import org.jetbrains.annotations.Contract;
-import org.jetbrains.annotations.NotNull;
-import org.jetbrains.annotations.Nullable;
-
-/**
- * Any class extending this will be able to get registered as a PlaceholderExpansion.
- *
The registration either happens automatically when the jar file containing a
- * class extending this one is located under the {@code PlaceholderAPI/expansions}
- * directory or when the {@link #register()} method is called by said class.
- */
-public abstract class PlaceholderExpansion extends PlaceholderHook {
-
- /**
- * The type is {@link Type#INTERNAL} by default.
- * For external expansions, the type is updated on {@link me.clip.placeholderapi.expansion.manager.LocalExpansionManager#register(Class) register}.
- *
- * @since 2.11.4
- */
- @ApiStatus.Internal
- protected Type expansionType = Type.INTERNAL;
-
- /**
- * The placeholder identifier of this expansion. May not contain {@literal %},
- * {@literal {}} or _
- *
- * @return placeholder identifier that is associated with this expansion
- */
- @NotNull
- public abstract String getIdentifier();
-
- /**
- * The author of this expansion
- *
- * @return name of the author for this expansion
- */
- @NotNull
- public abstract String getAuthor();
-
- /**
- * The version of this expansion
- *
- * @return current version of this expansion
- */
- @NotNull
- public abstract String getVersion();
-
- /**
- * The name of this expansion
- *
- * @return {@link #getIdentifier()} by default, name of this expansion if specified
- */
- @NotNull
- public String getName() {
- return getIdentifier();
- }
-
- /**
- * The name of the plugin that this expansion hooks into. by default will null
- *
- * @return plugin name that this expansion requires to function
- */
- @Nullable
- public String getRequiredPlugin() {
- return getPlugin();
- }
-
- /**
- * The placeholders associated with this expansion
- *
- * @return placeholder list that this expansion provides
- */
- @NotNull
- public List getPlaceholders() {
- return Collections.emptyList();
- }
-
-
- /**
- * Expansions that do not use the ecloud and instead register from the dependency should set this
- * to true to ensure that your placeholder expansion is not unregistered when the papi reload
- * command is used
- *
- * @return if this expansion should persist through placeholder reloads
- */
- public boolean persist() {
- return false;
- }
-
-
- /**
- * Check if this placeholder identifier has already been registered
- *
- * @return true if the identifier for this expansion is already registered
- */
- public final boolean isRegistered() {
- return getPlaceholderAPI().getLocalExpansionManager().findExpansionByIdentifier(getIdentifier())
- .map(it -> it.equals(this)).orElse(false);
- }
-
-
- /**
- * If any requirements need to be checked before this expansion should register, you can check
- * them here
- *
- * @return true if this hook meets all the requirements to register
- */
- public boolean canRegister() {
- return getRequiredPlugin() == null
- || Bukkit.getPluginManager().getPlugin(getRequiredPlugin()) != null;
- }
-
- /**
- * Attempt to register this PlaceholderExpansion
- *
- * @return true if this expansion is now registered with PlaceholderAPI
- */
- public boolean register() {
- return getPlaceholderAPI().getLocalExpansionManager().register(this);
- }
-
- /**
- * Attempt to unregister this PlaceholderExpansion
- *
- * @return true if this expansion is now unregistered with PlaceholderAPI
- */
- public final boolean unregister() {
- return getPlaceholderAPI().getLocalExpansionManager().unregister(this);
- }
-
-
- /**
- * Quick getter for the {@link PlaceholderAPIPlugin} instance
- *
- * @return {@link PlaceholderAPIPlugin} instance
- */
- @NotNull
- public final PlaceholderAPIPlugin getPlaceholderAPI() {
- return PlaceholderAPIPlugin.getInstance();
- }
-
- /**
- * Get the type of the expansion
- *
- * @return the type of the expansion
- * @since 2.11.4
- */
- @ApiStatus.Internal
- public Type getExpansionType() {
- return expansionType;
- }
-
- /**
- * Set the type of the expansion
- *
- * @param expansionType the new type
- * @since 2.11.4
- */
- @ApiStatus.Internal
- public void setExpansionType(Type expansionType) {
- this.expansionType = expansionType;
- }
-
- // === Configuration ===
-
- /**
- * Gets the ConfigurationSection of the expansion located in the config.yml of PlaceholderAPI or
- * null when not specified.
- *
You may use the {@link Configurable} interface to define default values set
- *
- * @return ConfigurationSection that this expansion has.
- */
- @Nullable
- public final ConfigurationSection getConfigSection() {
- return getPlaceholderAPI().getConfig().getConfigurationSection("expansions." + getIdentifier());
- }
-
- /**
- * Gets the ConfigurationSection relative to the {@link #getConfigSection() default one} set
- * by the expansion or null when the default ConfigurationSection is null
- *
- * @param path The path to get the ConfigurationSection from. This is relative to the default section
- * @return ConfigurationSection relative to the default section
- */
- @Nullable
- public final ConfigurationSection getConfigSection(@NotNull final String path) {
- final ConfigurationSection section = getConfigSection();
- return section == null ? null : section.getConfigurationSection(path);
- }
-
- /**
- * Gets the Object relative to the {@link #getConfigSection() default ConfigurationSection} set
- * by the expansion or the provided Default Object, when the default ConfigurationSection is null
- *
- * @param path The path to get the Object from. This is relative to the default section
- * @param def The default Object to return when the ConfigurationSection returns null
- * @return Object from the provided path or the default one provided
- */
- @Nullable
- @Contract("_, !null -> !null")
- public final Object get(@NotNull final String path, final Object def) {
- final ConfigurationSection section = getConfigSection();
- return section == null ? def : section.get(path, def);
- }
-
- /**
- * Gets the int relative to the {@link #getConfigSection() default ConfigurationSection} set
- * by the expansion or the provided Default int, when the default ConfigurationSection is null
- *
- * @param path The path to get the int from. This is relative to the default section
- * @param def The default int to return when the ConfigurationSection returns null
- * @return int from the provided path or the default one provided
- */
- public final int getInt(@NotNull final String path, final int def) {
- final ConfigurationSection section = getConfigSection();
- return section == null ? def : section.getInt(path, def);
- }
-
- /**
- * Gets the long relative to the {@link #getConfigSection() default ConfigurationSection} set
- * by the expansion or the provided Default long, when the default ConfigurationSection is null
- *
- * @param path The path to get the long from. This is relative to the default section
- * @param def The default long to return when the ConfigurationSection returns null
- * @return long from the provided path or the default one provided
- */
- public final long getLong(@NotNull final String path, final long def) {
- final ConfigurationSection section = getConfigSection();
- return section == null ? def : section.getLong(path, def);
- }
-
- /**
- * Gets the double relative to the {@link #getConfigSection() default ConfigurationSection} set
- * by the expansion or the provided Default double, when the default ConfigurationSection is null
- *
- * @param path The path to get the double from. This is relative to the default section
- * @param def The default double to return when the ConfigurationSection returns null
- * @return double from the provided path or the default one provided
- */
- public final double getDouble(@NotNull final String path, final double def) {
- final ConfigurationSection section = getConfigSection();
- return section == null ? def : section.getDouble(path, def);
- }
-
- /**
- * Gets the String relative to the {@link #getConfigSection() default ConfigurationSection} set
- * by the expansion or the provided Default String, when the default ConfigurationSection is null
- *
- * @param path The path to get the String from. This is relative to the default section
- * @param def The default String to return when the ConfigurationSection returns null. Can be null
- * @return String from the provided path or the default one provided
- */
- @Nullable
- @Contract("_, !null -> !null")
- public final String getString(@NotNull final String path, @Nullable final String def) {
- final ConfigurationSection section = getConfigSection();
- return section == null ? def : section.getString(path, def);
- }
-
- /**
- * Gets a String List relative to the {@link #getConfigSection() default ConfigurationSection} set
- * by the expansion or an empty List, when the default ConfigurationSection is null
- *
- * @param path The path to get the String list from. This is relative to the default section
- * @return String list from the provided path or an empty list
- */
- @NotNull
- public final List getStringList(@NotNull final String path) {
- final ConfigurationSection section = getConfigSection();
- return section == null ? Collections.emptyList() : section.getStringList(path);
- }
-
- /**
- * Gets the boolean relative to the {@link #getConfigSection() default ConfigurationSection} set
- * by the expansion or the default boolean, when the default ConfigurationSection is null
- *
- * @param path The path to get the boolean from. This is relative to the default section
- * @param def The default boolean to return when the ConfigurationSection is null
- * @return boolean from the provided path or the default one provided
- */
- public final boolean getBoolean(@NotNull final String path, final boolean def) {
- final ConfigurationSection section = getConfigSection();
- return section == null ? def : section.getBoolean(path, def);
- }
-
- /**
- * Whether the {@link #getConfigSection() default ConfigurationSection} contains the provided path
- * or not. This will return {@code false} when either the default section is null, or doesn't
- * contain the provided path
- *
- * @param path The path to check
- * @return true when the default ConfigurationSection is not null and contains the path, false otherwise
- */
- public final boolean configurationContains(@NotNull final String path) {
- final ConfigurationSection section = getConfigSection();
- return section != null && section.contains(path);
- }
-
- /**
- * Logs the provided message with the provided Level in the console.
- *
The message will be prefixed with {@link #getName() [<expansion name>]}
- *
- * @param level The Level at which the message should be logged with
- * @param msg The message to log
- */
- public void log(Level level, String msg) {
- getPlaceholderAPI().getLogger().log(level, "[" + getName() + "] " + msg);
- }
-
- /**
- * Logs the provided message and Throwable with the provided Level in the console.
- *
The message will be prefixed with {@link #getName() [<expansion name>]}
- *
- * @param level The Level at which the message should be logged with
- * @param msg The message to log
- * @param throwable The Throwable to log
- */
- public void log(Level level, String msg, Throwable throwable) {
- getPlaceholderAPI().getLogger().log(level, "[" + getName() + "] " + msg, throwable);
- }
-
- /**
- * Logs the provided message with Level "info".
- *
The message will be prefixed with {@link #getName() [<expansion name>]}
- *
- * @param msg The message to log
- */
- public void info(String msg) {
- log(Level.INFO, msg);
- }
-
- /**
- * Logs the provided message with Level "warning".
- *
The message will be prefixed with {@link #getName() [<expansion name>]}
- *
- * @param msg The message to log
- */
- public void warning(String msg) {
- log(Level.WARNING, msg);
- }
-
- /**
- * Logs the provided message with Level "severe" (error).
- *
The message will be prefixed with {@link #getName() [<expansion name>]}
- *
- * @param msg The message to log
- */
- public void severe(String msg) {
- log(Level.SEVERE, msg);
- }
-
- /**
- * Logs the provided message and Throwable with Level "severe" (error).
- *
The message will be prefixed with {@link #getName() [<expansion name>]}
- *
- * @param msg The message to log
- * @param throwable The Throwable to log
- */
- public void severe(String msg, Throwable throwable) {
- log(Level.SEVERE, msg, throwable);
- }
-
-
- /**
- * Whether the provided Object is an instance of this PlaceholderExpansion.
- *
This method will perform the following checks in order:
- *
- * - Checks if Object equals the class. Returns true when equal and continues otherwise
- * - Checks if the Object is an instance of a PlaceholderExpansion. Returns false if not
- * - Checks if the Object's Identifier, Author and version equal the one of this class
- *
- *
- * @param o The Object to check
- * @return true or false depending on the above mentioned checks
- */
- @Override
- public final boolean equals(final Object o) {
- if (this == o) {
- return true;
- }
- if (!(o instanceof PlaceholderExpansion)) {
- return false;
- }
-
- final PlaceholderExpansion expansion = (PlaceholderExpansion) o;
-
- return getIdentifier().equals(expansion.getIdentifier()) &&
- getAuthor().equals(expansion.getAuthor()) &&
- getVersion().equals(expansion.getVersion());
- }
-
- /**
- * Returns a String containing the Expansion's name, author and version
- *
- * @return String containing name, author and version of the expansion
- */
- @Override
- public final String toString() {
- return String.format("PlaceholderExpansion[name: '%s', author: '%s', version: '%s', type: '%s']", getName(),
- getAuthor(), getVersion(), getExpansionType());
- }
-
- // === Deprecated API ===
-
- /**
- * @return The plugin name.
- * @deprecated As of versions greater than 2.8.7, use {@link #getRequiredPlugin()}
- */
- @Deprecated
- @ApiStatus.ScheduledForRemoval(inVersion = "2.13.0")
- public String getPlugin() {
- return null;
- }
-
- /**
- * @return The description of the expansion.
- * @deprecated As of versions greater than 2.8.7, use the expansion cloud to show a description
- */
- @Deprecated
- @ApiStatus.ScheduledForRemoval(inVersion = "2.13.0")
- public String getDescription() {
- return null;
- }
-
- /**
- * @return The link for the expansion.
- * @deprecated As of versions greater than 2.8.7, use the expansion cloud to display a link
- */
- @Deprecated
- @ApiStatus.ScheduledForRemoval(inVersion = "2.13.0")
- public String getLink() {
- return null;
- }
-
- public enum Type {
-
- /**
- * An expansion provided by a plugin is considered internal
- */
- INTERNAL,
-
- /**
- * An expansion loaded from the expansions folder is considered external
- */
- EXTERNAL
-
- }
-
-}
diff --git a/src/main/java/me/clip/placeholderapi/expansion/Relational.java b/src/main/java/me/clip/placeholderapi/expansion/Relational.java
deleted file mode 100644
index 2ee8987..0000000
--- a/src/main/java/me/clip/placeholderapi/expansion/Relational.java
+++ /dev/null
@@ -1,43 +0,0 @@
-/*
- * This file is part of PlaceholderAPI
- *
- * PlaceholderAPI
- * Copyright (c) 2015 - 2026 PlaceholderAPI Team
- *
- * PlaceholderAPI free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * PlaceholderAPI is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this program. If not, see .
- */
-
-package me.clip.placeholderapi.expansion;
-
-import org.bukkit.entity.Player;
-
-/**
- * Implementing this interface allows your {@link me.clip.placeholderapi.expansion.PlaceholderExpansion PlaceholderExpansion}
- * to be used as a relational placeholder expansion.
- *
- * Relational placeholders take two Players as input and are always prefixed with {@code rel_},
- * so {@code %foo_bar%} becomes {@code %rel_foo_bar%}
- */
-public interface Relational {
-
- /**
- * This method is called whenever a placeholder starting with {@code rel_} is called.
- *
- * @param one The first player used for the placeholder.
- * @param two The second player used for the placeholder.
- * @param identifier The text right after the expansion's name (%expansion_identifier%)
- * @return Parsed String from the expansion.
- */
- String onPlaceholderRequest(Player one, Player two, String identifier);
-}
diff --git a/src/main/java/me/clip/placeholderapi/expansion/Taskable.java b/src/main/java/me/clip/placeholderapi/expansion/Taskable.java
deleted file mode 100644
index d266dda..0000000
--- a/src/main/java/me/clip/placeholderapi/expansion/Taskable.java
+++ /dev/null
@@ -1,43 +0,0 @@
-/*
- * This file is part of PlaceholderAPI
- *
- * PlaceholderAPI
- * Copyright (c) 2015 - 2026 PlaceholderAPI Team
- *
- * PlaceholderAPI free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * PlaceholderAPI is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this program. If not, see .
- */
-
-package me.clip.placeholderapi.expansion;
-
-/**
- * Implementing this interface adds the {@link #start() start} and {@link #stop() stop} void
- * methods to your {@link me.clip.placeholderapi.expansion.PlaceholderExpansion PlaceholderExpansion}.
- *
- *
This can be used to execute methods and tasks whenever the PlaceholderExpansion has been
- * successfully (un)registered.
- */
-public interface Taskable {
-
- /**
- * Called when the implementing class has successfully been registered to the placeholder map.
- *
Tasks that need to be performed when this expansion is registered should go here
- */
- void start();
-
- /**
- * Called when the implementing class has been unregistered from PlaceholderAPI.
- *
Tasks that need to be performed when this expansion has unregistered should go here
- */
- void stop();
-}
diff --git a/src/main/java/me/clip/placeholderapi/expansion/Version.java b/src/main/java/me/clip/placeholderapi/expansion/Version.java
deleted file mode 100644
index 487f6d0..0000000
--- a/src/main/java/me/clip/placeholderapi/expansion/Version.java
+++ /dev/null
@@ -1,46 +0,0 @@
-/*
- * This file is part of PlaceholderAPI
- *
- * PlaceholderAPI
- * Copyright (c) 2015 - 2026 PlaceholderAPI Team
- *
- * PlaceholderAPI free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * PlaceholderAPI is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this program. If not, see .
- */
-
-package me.clip.placeholderapi.expansion;
-
-@Deprecated
-public final class Version {
-
- private final boolean isSpigot;
- private final String version;
-
- public Version(String version, boolean isSpigot) {
- this.version = version;
- this.isSpigot = isSpigot;
- }
-
- public String getVersion() {
- return version == null ? "unknown" : version;
- }
-
- public boolean isSpigot() {
- return isSpigot;
- }
-
- public boolean compareTo(String version) {
- return getVersion().equalsIgnoreCase(version);
- }
-
-}
diff --git a/src/main/java/me/clip/placeholderapi/expansion/VersionSpecific.java b/src/main/java/me/clip/placeholderapi/expansion/VersionSpecific.java
deleted file mode 100644
index 7cf3713..0000000
--- a/src/main/java/me/clip/placeholderapi/expansion/VersionSpecific.java
+++ /dev/null
@@ -1,43 +0,0 @@
-/*
- * This file is part of PlaceholderAPI
- *
- * PlaceholderAPI
- * Copyright (c) 2015 - 2026 PlaceholderAPI Team
- *
- * PlaceholderAPI free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * PlaceholderAPI is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this program. If not, see .
- */
-
-package me.clip.placeholderapi.expansion;
-
-/**
- * Placeholder expansions which use NMS code should be version specific. Implementing this class
- * allows you to perform checks based on the version the server is running. The isCompatibleWith
- * method will be passed the server version and allow you to return if your expansion is compatible
- * with that version.
- *
- * @author Ryan McCarthy
- * @deprecated Will be removed in a future release.
- */
-@Deprecated
-public interface VersionSpecific {
-
- /**
- * This method is called before the expansion is attempted to be registered The server version
- * will be passed to this method so you know what version the server is currently running.
- *
- * @param v The {@link Version} to check against
- * @return true if your expansion is compatible with the version the server is running.
- */
- boolean isCompatibleWith(Version v);
-}
diff --git a/src/main/java/me/clip/placeholderapi/expansion/cloud/CloudExpansion.java b/src/main/java/me/clip/placeholderapi/expansion/cloud/CloudExpansion.java
deleted file mode 100644
index 20705a9..0000000
--- a/src/main/java/me/clip/placeholderapi/expansion/cloud/CloudExpansion.java
+++ /dev/null
@@ -1,207 +0,0 @@
-/*
- * This file is part of PlaceholderAPI
- *
- * PlaceholderAPI
- * Copyright (c) 2015 - 2026 PlaceholderAPI Team
- *
- * PlaceholderAPI free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * PlaceholderAPI is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this program. If not, see .
- */
-
-package me.clip.placeholderapi.expansion.cloud;
-
-import java.util.List;
-import java.util.concurrent.TimeUnit;
-import java.util.stream.Collectors;
-
-import me.clip.placeholderapi.util.TimeUtil;
-
-
-public class CloudExpansion {
-
- private String name,
- author,
- latest_version,
- description,
- source_url,
- dependency_url;
-
- private boolean hasExpansion,
- shouldUpdate;
-
- private long last_update,
- ratings_count;
-
- private double average_rating;
-
- private List placeholders;
-
- private List versions;
-
- public CloudExpansion() {
- }
-
- public String getTimeSinceLastUpdate() {
- int time = (int) TimeUnit.MILLISECONDS.toSeconds(System.currentTimeMillis() - getLastUpdate());
- return TimeUtil.getTime(time);
- }
-
- public String getName() {
- return name;
- }
-
- public void setName(String name) {
- this.name = name;
- }
-
- public String getAuthor() {
- return author;
- }
-
- public void setAuthor(String author) {
- this.author = author;
- }
-
- public Version getVersion() {
- return getLatestVersion() == null ? null : getVersion(getLatestVersion());
- }
-
- public Version getVersion(String version) {
- return versions == null ? null : versions.stream()
- .filter(v -> v.getVersion().equals(version))
- .findFirst()
- .orElse(null);
- }
-
- public List getAvailableVersions() {
- return versions.stream().map(Version::getVersion).collect(Collectors.toList());
- }
-
- public String getLatestVersion() {
- return latest_version;
- }
-
- public void setLatestVersion(String latest_version) {
- this.latest_version = latest_version;
- }
-
- public String getDescription() {
- return description;
- }
-
- public void setDescription(String description) {
- this.description = description;
- }
-
- public String getSourceUrl() {
- return source_url;
- }
-
- public void setSourceUrl(String source_url) {
- this.source_url = source_url;
- }
-
- public String getDependencyUrl() {
- return dependency_url;
- }
-
- public void setDependencyUrl(String dependency_url) {
- this.dependency_url = dependency_url;
- }
-
- public boolean hasExpansion() {
- return hasExpansion;
- }
-
- public void setHasExpansion(boolean hasExpansion) {
- this.hasExpansion = hasExpansion;
- }
-
- public boolean shouldUpdate() {
- return shouldUpdate;
- }
-
- public void setShouldUpdate(boolean shouldUpdate) {
- this.shouldUpdate = shouldUpdate;
- }
-
- public long getLastUpdate() {
- return last_update;
- }
-
- public void setLastUpdate(long last_update) {
- this.last_update = last_update;
- }
-
- public long getRatingsCount() {
- return ratings_count;
- }
-
- public double getAverage_rating() {
- return average_rating;
- }
-
- public List getPlaceholders() {
- return placeholders;
- }
-
- public void setPlaceholders(List placeholders) {
- this.placeholders = placeholders;
- }
-
- public List getVersions() {
- return versions;
- }
-
- public void setVersions(List versions) {
- this.versions = versions;
- }
-
- public static class Version {
-
- private String url, version, release_notes;
- private boolean verified;
-
- public String getUrl() {
- return url;
- }
-
- public void setUrl(String url) {
- this.url = url;
- }
-
- public String getVersion() {
- return version;
- }
-
- public void setVersion(String version) {
- this.version = version;
- }
-
- public String getReleaseNotes() {
- return release_notes;
- }
-
- public void setReleaseNotes(String release_notes) {
- this.release_notes = release_notes;
- }
-
- public boolean isVerified() {
- return verified;
- }
-
- public void setVerified(boolean verified) {
- this.verified = verified;
- }
- }
-}
diff --git a/src/main/java/me/clip/placeholderapi/expansion/manager/CloudExpansionManager.java b/src/main/java/me/clip/placeholderapi/expansion/manager/CloudExpansionManager.java
deleted file mode 100644
index 6c830d8..0000000
--- a/src/main/java/me/clip/placeholderapi/expansion/manager/CloudExpansionManager.java
+++ /dev/null
@@ -1,285 +0,0 @@
-/*
- * This file is part of PlaceholderAPI
- *
- * PlaceholderAPI
- * Copyright (c) 2015 - 2026 PlaceholderAPI Team
- *
- * PlaceholderAPI free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * PlaceholderAPI is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this program. If not, see .
- */
-
-package me.clip.placeholderapi.expansion.manager;
-
-import com.google.common.collect.ImmutableMap;
-import com.google.common.io.Resources;
-import com.google.common.util.concurrent.ThreadFactoryBuilder;
-import com.google.gson.Gson;
-import com.google.gson.reflect.TypeToken;
-
-import java.io.File;
-import java.io.FileOutputStream;
-import java.io.IOException;
-import java.lang.reflect.Type;
-import java.net.URL;
-import java.net.UnknownHostException;
-import java.nio.channels.Channels;
-import java.nio.channels.ReadableByteChannel;
-import java.nio.charset.StandardCharsets;
-import java.util.ArrayList;
-import java.util.Collections;
-import java.util.HashMap;
-import java.util.List;
-import java.util.Locale;
-import java.util.Map;
-import java.util.Optional;
-import java.util.Set;
-import java.util.concurrent.CompletableFuture;
-import java.util.concurrent.CompletionException;
-import java.util.concurrent.ConcurrentHashMap;
-import java.util.concurrent.ExecutorService;
-import java.util.concurrent.Executors;
-import java.util.function.Function;
-import java.util.logging.Level;
-import java.util.stream.Collector;
-import java.util.stream.Collectors;
-
-import me.clip.placeholderapi.PlaceholderAPIPlugin;
-import me.clip.placeholderapi.expansion.PlaceholderExpansion;
-import me.clip.placeholderapi.expansion.cloud.CloudExpansion;
-import me.clip.placeholderapi.util.Msg;
-import org.jetbrains.annotations.NotNull;
-import org.jetbrains.annotations.Unmodifiable;
-
-public final class CloudExpansionManager {
-
- @NotNull
- private static final String API_URL = "https://ecloud.placeholderapi.com/api/v3/?platform=bukkit";
-
- @NotNull
- private static final Gson GSON = new Gson();
- @NotNull
- private static final Type TYPE = new TypeToken>() {}.getType();
-
- @NotNull
- private final Collector> INDEXED_NAME_COLLECTOR = Collectors
- .toMap(CloudExpansionManager::toIndexName, Function.identity());
-
-
- @NotNull
- private final PlaceholderAPIPlugin plugin;
-
- @NotNull
- private final Map cache = new HashMap<>();
- @NotNull
- private final Map> await = new ConcurrentHashMap<>();
-
- private final ExecutorService ASYNC_EXECUTOR =
- Executors.newCachedThreadPool(
- new ThreadFactoryBuilder().setNameFormat("placeholderapi-io-#%1$d").build());
-
- public CloudExpansionManager(@NotNull final PlaceholderAPIPlugin plugin) {
- this.plugin = plugin;
- }
-
- @NotNull
- private static String toIndexName(@NotNull final String name) {
- return name.toLowerCase(Locale.ROOT).replace(' ', '_');
- }
-
- @NotNull
- private static String toIndexName(@NotNull final CloudExpansion expansion) {
- return toIndexName(expansion.getName());
- }
-
- public void load() {
- clean();
- fetch();
- }
-
- public void kill() {
- clean();
- }
-
- @NotNull
- @Unmodifiable
- public Map getCloudExpansions() {
- return ImmutableMap.copyOf(cache);
- }
-
- public boolean isEmpty() {
- return cache.isEmpty();
- }
-
- @NotNull
- @Unmodifiable
- public Map getCloudExpansionsInstalled() {
- if (cache.isEmpty()) {
- return Collections.emptyMap();
- }
-
- return cache.values()
- .stream()
- .filter(CloudExpansion::hasExpansion)
- .collect(INDEXED_NAME_COLLECTOR);
- }
-
- @NotNull
- @Unmodifiable
- public Map getCloudExpansionsByAuthor(@NotNull final String author) {
- if (cache.isEmpty()) {
- return Collections.emptyMap();
- }
-
- return cache.values()
- .stream()
- .filter(expansion -> author.equalsIgnoreCase(expansion.getAuthor()))
- .collect(INDEXED_NAME_COLLECTOR);
- }
-
- @NotNull
- @Unmodifiable
- public Set getCloudExpansionAuthors() {
- return cache.values().stream().map(CloudExpansion::getAuthor).collect(Collectors.toSet());
- }
-
- public int getCloudExpansionAuthorCount() {
- return getCloudExpansionAuthors().size();
- }
-
- public int getCloudUpdateCount() {
- return ((int) plugin.getLocalExpansionManager()
- .getExpansions()
- .stream()
- .filter(expansion -> findCloudExpansionByName(expansion.getName())
- .map(CloudExpansion::shouldUpdate).orElse(false))
- .count());
- }
-
- @NotNull
- public Optional findCloudExpansionByName(@NotNull final String name) {
- return Optional.ofNullable(cache.get(toIndexName(name)));
- }
-
- public void clean() {
- cache.clear();
-
- await.values().forEach(future -> future.cancel(true));
- await.clear();
- }
-
- public void fetch() {
- plugin.getLogger().info("Fetching available expansion information...");
-
- ASYNC_EXECUTOR.submit(
- () -> {
- // a defence tactic! use ConcurrentHashMap instead of normal HashMap
- Map values = new ConcurrentHashMap<>();
- try {
- //noinspection UnstableApiUsage
- String json = Resources.toString(new URL(API_URL), StandardCharsets.UTF_8);
- values.putAll(GSON.fromJson(json, TYPE));
-
- List toRemove = new ArrayList<>();
-
- for (Map.Entry entry : values.entrySet()) {
- CloudExpansion expansion = entry.getValue();
- if (expansion.getLatestVersion() == null
- || expansion.getVersion(expansion.getLatestVersion()) == null) {
- toRemove.add(entry.getKey());
- }
- }
-
- for (String name : toRemove) {
- values.remove(name);
- }
- } catch (UnknownHostException e) {
- plugin.getLogger().log(Level.WARNING, "There is no data available from the eCloud. Please try running /papi refresh. If this does not resolve the issue, the eCloud may be blocked by your firewall, server host, or service provider.\n\nMore information: https://placeholderapi.com/ecloud-blocked", e);
- } catch (Throwable e) {
- // ugly swallowing of every throwable, but we have to be defensive
- plugin.getLogger().log(Level.WARNING, "Failed to download expansion information", e);
- }
-
- // loop through what's left on the main thread
- plugin
- .getScheduler()
- .runTask(
- () -> {
- try {
- for (Map.Entry entry : values.entrySet()) {
- String name = entry.getKey();
- CloudExpansion expansion = entry.getValue();
-
- expansion.setName(name);
-
- Optional localOpt =
- plugin.getLocalExpansionManager().findExpansionByName(name);
- if (localOpt.isPresent()) {
- PlaceholderExpansion local = localOpt.get();
- if (local.isRegistered()) {
- expansion.setHasExpansion(true);
- expansion.setShouldUpdate(
- !local.getVersion().equalsIgnoreCase(expansion.getLatestVersion()));
- }
- }
-
- cache.put(toIndexName(expansion), expansion);
- }
- } catch (Throwable e) {
- // ugly swallowing of every throwable, but we have to be defensive
- plugin
- .getLogger()
- .log(Level.WARNING, "Failed to download expansion information", e);
- }
- });
- });
- }
-
- public boolean isDownloading(@NotNull final CloudExpansion expansion) {
- return await.containsKey(toIndexName(expansion));
- }
-
- @NotNull
- public CompletableFuture downloadExpansion(@NotNull final CloudExpansion expansion,
- @NotNull final CloudExpansion.Version version) {
- final CompletableFuture previous = await.get(toIndexName(expansion));
- if (previous != null) {
- return previous;
- }
-
- final File file = new File(plugin.getLocalExpansionManager().getExpansionsFolder(),
- "Expansion-" + toIndexName(expansion) + ".jar");
-
- final CompletableFuture download = CompletableFuture.supplyAsync(() -> {
- try (final ReadableByteChannel source = Channels.newChannel(new URL(version.getUrl())
- .openStream()); final FileOutputStream target = new FileOutputStream(file)) {
- target.getChannel().transferFrom(source, 0, Long.MAX_VALUE);
- } catch (final IOException ex) {
- throw new CompletionException(ex);
- }
- return file;
- }, ASYNC_EXECUTOR);
-
- download.whenCompleteAsync((value, exception) -> {
- await.remove(toIndexName(expansion));
-
- if (exception != null) {
- Msg.severe("Failed to download %s:%s", exception, expansion.getName(), expansion.getVersion());
- }
- }, ASYNC_EXECUTOR);
-
- await.put(toIndexName(expansion), download);
-
- return download;
- }
-
-}
diff --git a/src/main/java/me/clip/placeholderapi/expansion/manager/LocalExpansionManager.java b/src/main/java/me/clip/placeholderapi/expansion/manager/LocalExpansionManager.java
deleted file mode 100644
index ff54463..0000000
--- a/src/main/java/me/clip/placeholderapi/expansion/manager/LocalExpansionManager.java
+++ /dev/null
@@ -1,498 +0,0 @@
-/*
- * This file is part of PlaceholderAPI
- *
- * PlaceholderAPI
- * Copyright (c) 2015 - 2026 PlaceholderAPI Team
- *
- * PlaceholderAPI free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * PlaceholderAPI is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this program. If not, see .
- */
-
-package me.clip.placeholderapi.expansion.manager;
-
-import com.google.common.collect.ImmutableSet;
-import com.google.common.collect.Sets;
-
-import java.io.File;
-import java.lang.reflect.Modifier;
-import java.util.Arrays;
-import java.util.Collection;
-import java.util.Collections;
-import java.util.List;
-import java.util.Locale;
-import java.util.Map;
-import java.util.Objects;
-import java.util.Optional;
-import java.util.Set;
-import java.util.concurrent.CompletableFuture;
-import java.util.concurrent.ConcurrentHashMap;
-import java.util.concurrent.locks.ReentrantLock;
-import java.util.logging.Level;
-import java.util.stream.Collectors;
-
-import me.clip.placeholderapi.PlaceholderAPIPlugin;
-import me.clip.placeholderapi.events.ExpansionRegisterEvent;
-import me.clip.placeholderapi.events.ExpansionUnregisterEvent;
-import me.clip.placeholderapi.events.ExpansionsLoadedEvent;
-import me.clip.placeholderapi.expansion.Cacheable;
-import me.clip.placeholderapi.expansion.Cleanable;
-import me.clip.placeholderapi.expansion.Configurable;
-import me.clip.placeholderapi.expansion.PlaceholderExpansion;
-import me.clip.placeholderapi.expansion.Taskable;
-import me.clip.placeholderapi.expansion.VersionSpecific;
-import me.clip.placeholderapi.expansion.cloud.CloudExpansion;
-import me.clip.placeholderapi.util.FileUtil;
-import me.clip.placeholderapi.util.Futures;
-import me.clip.placeholderapi.util.Msg;
-import org.bukkit.Bukkit;
-import org.bukkit.command.CommandSender;
-import org.bukkit.configuration.file.FileConfiguration;
-import org.bukkit.event.EventHandler;
-import org.bukkit.event.EventPriority;
-import org.bukkit.event.HandlerList;
-import org.bukkit.event.Listener;
-import org.bukkit.event.player.PlayerQuitEvent;
-import org.bukkit.event.server.PluginDisableEvent;
-import org.jetbrains.annotations.ApiStatus;
-import org.jetbrains.annotations.NotNull;
-import org.jetbrains.annotations.Nullable;
-import org.jetbrains.annotations.Unmodifiable;
-
-public final class LocalExpansionManager implements Listener {
-
- @NotNull
- private static final String EXPANSIONS_FOLDER_NAME = "expansions";
-
- @NotNull
- private static final Set ABSTRACT_EXPANSION_METHODS = Arrays.stream(PlaceholderExpansion.class.getDeclaredMethods())
- .filter(method -> Modifier.isAbstract(method.getModifiers()))
- .map(method -> new MethodSignature(method.getName(), method.getParameterTypes()))
- .collect(Collectors.toSet());
-
- @NotNull
- private final File folder;
- @NotNull
- private final PlaceholderAPIPlugin plugin;
-
- @NotNull
- private final Map expansions = new ConcurrentHashMap<>();
- private final ReentrantLock expansionsLock = new ReentrantLock();
-
-
- public LocalExpansionManager(@NotNull final PlaceholderAPIPlugin plugin) {
- this.plugin = plugin;
- this.folder = new File(plugin.getDataFolder(), EXPANSIONS_FOLDER_NAME);
-
- if (!this.folder.exists() && !folder.mkdirs()) {
- Msg.warn("Failed to create expansions folder!");
- }
- }
-
- public void load(@NotNull final CommandSender sender) {
- registerAll(sender);
- }
-
- public void kill() {
- unregisterAll();
- }
-
-
- @NotNull
- public File getExpansionsFolder() {
- return folder;
- }
-
- @NotNull
- @Unmodifiable
- public Collection getIdentifiers() {
- expansionsLock.lock();
- try {
- return ImmutableSet.copyOf(expansions.keySet());
- } finally {
- expansionsLock.unlock();
- }
- }
-
- @NotNull
- @Unmodifiable
- public Collection getExpansions() {
- expansionsLock.lock();
- try {
- return ImmutableSet.copyOf(expansions.values());
- } finally {
- expansionsLock.unlock();
- }
- }
-
- @Nullable
- public PlaceholderExpansion getExpansion(@NotNull final String identifier) {
- expansionsLock.lock();
- try {
- return expansions.get(identifier.toLowerCase(Locale.ROOT));
- } finally {
- expansionsLock.unlock();
- }
- }
-
- @NotNull
- public Optional findExpansionByName(@NotNull final String name) {
- expansionsLock.lock();
- try {
- PlaceholderExpansion bestMatch = null;
- for (Map.Entry entry : expansions.entrySet()) {
- PlaceholderExpansion expansion = entry.getValue();
- if (expansion.getName().equalsIgnoreCase(name)) {
- bestMatch = expansion;
- break;
- }
- }
- return Optional.ofNullable(bestMatch);
- } finally {
- expansionsLock.unlock();
- }
- }
-
- @NotNull
- public Optional findExpansionByIdentifier(
- @NotNull final String identifier) {
- return Optional.ofNullable(getExpansion(identifier));
- }
-
-
- public Optional register(
- @NotNull final Class clazz) {
- try {
- final PlaceholderExpansion expansion = createExpansionInstance(clazz);
-
- if (expansion == null) {
- return Optional.empty();
- }
-
- Objects.requireNonNull(expansion.getAuthor(), "The expansion author is null!");
- Objects.requireNonNull(expansion.getIdentifier(), "The expansion identifier is null!");
- Objects.requireNonNull(expansion.getVersion(), "The expansion version is null!");
-
- if (expansion.getRequiredPlugin() != null && !expansion.getRequiredPlugin().isEmpty()) {
- if (!Bukkit.getPluginManager().isPluginEnabled(expansion.getRequiredPlugin())) {
- Msg.warn("Cannot load expansion %s due to a missing plugin: %s", expansion.getIdentifier(),
- expansion.getRequiredPlugin());
- return Optional.empty();
- }
- }
-
- expansion.setExpansionType(PlaceholderExpansion.Type.EXTERNAL);
-
- if (!expansion.register()) {
- Msg.warn("Cannot load expansion %s due to an unknown issue.", expansion.getIdentifier());
- return Optional.empty();
- }
-
- return Optional.of(expansion);
- } catch (LinkageError | NullPointerException ex) {
- final String reason;
-
- if (ex instanceof LinkageError) {
- reason = " (Is a dependency missing?)";
- } else {
- reason = " - One of its properties is null which is not allowed!";
- }
-
- Msg.severe("Failed to load expansion class %s%s", ex, clazz.getSimpleName(), reason);
- }
-
- return Optional.empty();
- }
-
- /**
- * Attempt to register a {@link PlaceholderExpansion}
- *
- * @param expansion the expansion to register
- * @return if the expansion was registered
- */
- @ApiStatus.Internal
- public boolean register(@NotNull final PlaceholderExpansion expansion) {
- final String identifier = expansion.getIdentifier().toLowerCase(Locale.ROOT);
-
- if (!expansion.canRegister()) {
- return false;
- }
-
- // Avoid loading two external expansions with the same identifier
- if (expansion.getExpansionType() == PlaceholderExpansion.Type.EXTERNAL && expansions.containsKey(identifier)) {
- Msg.warn("Failed to load external expansion %s. Identifier is already in use.", expansion.getIdentifier());
- return false;
- }
-
- if (expansion instanceof Configurable) {
- Map defaults = ((Configurable) expansion).getDefaults();
- String pre = "expansions." + identifier + ".";
- FileConfiguration cfg = plugin.getConfig();
- boolean save = false;
-
- if (defaults != null) {
- for (Map.Entry entries : defaults.entrySet()) {
- if (entries.getKey() == null || entries.getKey().isEmpty()) {
- continue;
- }
-
- if (entries.getValue() == null) {
- if (cfg.contains(pre + entries.getKey())) {
- save = true;
- cfg.set(pre + entries.getKey(), null);
- }
- } else {
- if (!cfg.contains(pre + entries.getKey())) {
- save = true;
- cfg.set(pre + entries.getKey(), entries.getValue());
- }
- }
- }
- }
-
- if (save) {
- plugin.saveConfig();
- plugin.reloadConfig();
- }
- }
-
- if (expansion instanceof VersionSpecific) {
- VersionSpecific nms = (VersionSpecific) expansion;
- if (!nms.isCompatibleWith(PlaceholderAPIPlugin.getServerVersion())) {
- Msg.warn("Your server version is incompatible with expansion %s %s",
- expansion.getIdentifier(), expansion.getVersion());
- return false;
- }
- }
-
- final PlaceholderExpansion removed = getExpansion(identifier);
- if (removed != null && !removed.unregister()) {
- return false;
- }
-
- final ExpansionRegisterEvent event = new ExpansionRegisterEvent(expansion);
- Bukkit.getPluginManager().callEvent(event);
-
- if (event.isCancelled()) {
- return false;
- }
-
- expansionsLock.lock();
- try {
- expansions.put(identifier, expansion);
- } finally {
- expansionsLock.unlock();
- }
-
- if (expansion instanceof Listener) {
- Bukkit.getPluginManager().registerEvents(((Listener) expansion), plugin);
- }
-
- Msg.info(
- "Successfully registered %s expansion: %s [%s]",
- expansion.getExpansionType().name().toLowerCase(),
- expansion.getIdentifier(),
- expansion.getVersion()
- );
-
- if (expansion instanceof Taskable) {
- ((Taskable) expansion).start();
- }
-
- // Check eCloud for updates only if the expansion is external
- if (plugin.getPlaceholderAPIConfig().isCloudEnabled() && expansion.getExpansionType() == PlaceholderExpansion.Type.EXTERNAL) {
- final Optional cloudExpansionOptional = plugin.getCloudExpansionManager().findCloudExpansionByName(identifier);
- if (cloudExpansionOptional.isPresent()) {
- CloudExpansion cloudExpansion = cloudExpansionOptional.get();
- cloudExpansion.setHasExpansion(true);
- cloudExpansion.setShouldUpdate(!cloudExpansion.getLatestVersion().equals(expansion.getVersion()));
- }
- }
-
- return true;
- }
-
- @ApiStatus.Internal
- public boolean unregister(@NotNull final PlaceholderExpansion expansion) {
- if (expansions.remove(expansion.getIdentifier().toLowerCase(Locale.ROOT)) == null) {
- return false;
- }
-
- Bukkit.getPluginManager().callEvent(new ExpansionUnregisterEvent(expansion));
-
- if (expansion instanceof Listener) {
- HandlerList.unregisterAll((Listener) expansion);
- }
-
- if (expansion instanceof Taskable) {
- ((Taskable) expansion).stop();
- }
-
- if (expansion instanceof Cacheable) {
- ((Cacheable) expansion).clear();
- }
-
- if (plugin.getPlaceholderAPIConfig().isCloudEnabled()) {
- plugin.getCloudExpansionManager().findCloudExpansionByName(expansion.getName())
- .ifPresent(cloud -> {
- cloud.setHasExpansion(false);
- cloud.setShouldUpdate(false);
- });
- }
-
- return true;
- }
-
- private void registerAll(@NotNull final CommandSender sender) {
- Msg.info("Placeholder expansion registration initializing...");
-
- Futures.onMainThread(plugin, findExpansionsOnDisk(), (classes, exception) -> {
- if (exception != null) {
- Msg.severe("Failed to load class files of expansion.", exception);
- return;
- }
-
- final List registered = classes.stream()
- .filter(Objects::nonNull)
- .map(this::register)
- .filter(Optional::isPresent)
- .map(Optional::get)
- .collect(Collectors.toList());
-
- final long needsUpdate = registered.stream()
- .map(expansion -> plugin.getCloudExpansionManager().findCloudExpansionByName(expansion.getName()).orElse(null))
- .filter(Objects::nonNull)
- .filter(CloudExpansion::shouldUpdate)
- .count();
-
- StringBuilder message = new StringBuilder(registered.size() == 0 ? "&6" : "&a")
- .append(registered.size())
- .append(' ')
- .append("placeholder hook(s) registered!");
-
- if (needsUpdate > 0) {
- message.append(' ')
- .append("&6")
- .append(needsUpdate)
- .append(' ')
- .append("placeholder hook(s) have an update available.");
- }
-
-
- Msg.msg(sender, message.toString());
-
- Bukkit.getPluginManager().callEvent(new ExpansionsLoadedEvent(registered));
- });
- }
-
- private void unregisterAll() {
- for (final PlaceholderExpansion expansion : Sets.newHashSet(expansions.values())) {
- if (expansion.persist()) {
- continue;
- }
-
- expansion.unregister();
- }
- }
-
- @NotNull
- public CompletableFuture<@NotNull List<@Nullable Class>> findExpansionsOnDisk() {
- File[] files = folder.listFiles((dir, name) -> name.endsWith(".jar"));
- if (files == null) {
- return CompletableFuture.completedFuture(Collections.emptyList());
- }
-
- return Arrays.stream(files)
- .map(this::findExpansionInFile)
- .collect(Futures.collector());
- }
-
- @NotNull
- public CompletableFuture<@Nullable Class> findExpansionInFile(
- @NotNull final File file) {
- return CompletableFuture.supplyAsync(() -> {
- try {
- final Class expansionClass = FileUtil.findClass(file, PlaceholderExpansion.class);
-
- if (expansionClass == null) {
- Msg.severe("Failed to load expansion %s, as it does not have a class which"
- + " extends PlaceholderExpansion", file.getName());
- return null;
- }
-
- Set expansionMethods = Arrays.stream(expansionClass.getDeclaredMethods())
- .map(method -> new MethodSignature(method.getName(), method.getParameterTypes()))
- .collect(Collectors.toSet());
- if (!expansionMethods.containsAll(ABSTRACT_EXPANSION_METHODS)) {
- Msg.severe("Failed to load expansion %s, as it does not have the required"
- + " methods declared for a PlaceholderExpansion.", file.getName());
- return null;
- }
-
- return expansionClass;
- } catch (VerifyError | NoClassDefFoundError e) {
- Msg.severe("Failed to load expansion %s (is a dependency missing?)", e, file.getName());
- return null;
- } catch (Exception e) {
- plugin.getLogger().log(Level.SEVERE, "Failed to load expansion file: " + file.getAbsolutePath(), e);
- return null;
- }
- });
- }
-
-
- @Nullable
- public PlaceholderExpansion createExpansionInstance(
- @NotNull final Class clazz) throws LinkageError {
- try {
- return clazz.getDeclaredConstructor().newInstance();
- } catch (final Exception ex) {
- if (ex.getCause() instanceof LinkageError) {
- throw ((LinkageError) ex.getCause());
- }
-
- Msg.warn("There was an issue with loading an expansion.");
- return null;
- }
- }
-
-
- @EventHandler
- public void onQuit(@NotNull final PlayerQuitEvent event) {
- for (final PlaceholderExpansion expansion : getExpansions()) {
- if (!(expansion instanceof Cleanable)) {
- continue;
- }
-
- ((Cleanable) expansion).cleanup(event.getPlayer());
- }
- }
-
- @EventHandler(priority = EventPriority.HIGH)
- public void onPluginDisable(@NotNull final PluginDisableEvent event) {
- final String name = event.getPlugin().getName();
- if (name.equals(plugin.getName())) {
- return;
- }
-
- for (final PlaceholderExpansion expansion : getExpansions()) {
- if (!name.equalsIgnoreCase(expansion.getRequiredPlugin())) {
- continue;
- }
-
- expansion.unregister();
- Msg.info("Unregistered placeholder expansion %s", expansion.getIdentifier());
- Msg.info("Reason: required plugin %s was disabled.", name);
- }
- }
-
-}
diff --git a/src/main/java/me/clip/placeholderapi/expansion/manager/MethodSignature.java b/src/main/java/me/clip/placeholderapi/expansion/manager/MethodSignature.java
deleted file mode 100644
index 50bc306..0000000
--- a/src/main/java/me/clip/placeholderapi/expansion/manager/MethodSignature.java
+++ /dev/null
@@ -1,57 +0,0 @@
-/*
- * This file is part of PlaceholderAPI
- *
- * PlaceholderAPI
- * Copyright (c) 2015 - 2026 PlaceholderAPI Team
- *
- * PlaceholderAPI free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * PlaceholderAPI is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this program. If not, see .
- */
-
-package me.clip.placeholderapi.expansion.manager;
-
-import java.util.Arrays;
-import java.util.Objects;
-
-public final class MethodSignature {
- private final String name;
- private final Class[] params;
-
- protected MethodSignature(String name, Class[] params) {
- this.name = name;
- this.params = params;
- }
-
- public String getName() {
- return name;
- }
-
- public Class[] getParams() {
- return params;
- }
-
- @Override
- public boolean equals(Object o) {
- if (this == o) return true;
- if (o == null || getClass() != o.getClass()) return false;
- MethodSignature that = (MethodSignature) o;
- return Objects.equals(name, that.name) && Arrays.equals(params, that.params);
- }
-
- @Override
- public int hashCode() {
- int result = Objects.hash(name);
- result = 31 * result + Arrays.hashCode(params);
- return result;
- }
-}
diff --git a/src/main/java/me/clip/placeholderapi/listeners/ServerLoadEventListener.java b/src/main/java/me/clip/placeholderapi/listeners/ServerLoadEventListener.java
deleted file mode 100644
index a06f211..0000000
--- a/src/main/java/me/clip/placeholderapi/listeners/ServerLoadEventListener.java
+++ /dev/null
@@ -1,48 +0,0 @@
-/*
- * This file is part of PlaceholderAPI
- *
- * PlaceholderAPI
- * Copyright (c) 2015 - 2026 PlaceholderAPI Team
- *
- * PlaceholderAPI free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * PlaceholderAPI is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this program. If not, see .
- */
-
-package me.clip.placeholderapi.listeners;
-
-import me.clip.placeholderapi.PlaceholderAPIPlugin;
-import org.bukkit.Bukkit;
-import org.bukkit.event.EventHandler;
-import org.bukkit.event.HandlerList;
-import org.bukkit.event.Listener;
-import org.bukkit.event.server.ServerLoadEvent;
-import org.jetbrains.annotations.NotNull;
-
-public final class ServerLoadEventListener implements Listener {
-
- @NotNull
- private final PlaceholderAPIPlugin plugin;
-
- public ServerLoadEventListener(@NotNull final PlaceholderAPIPlugin plugin) {
- this.plugin = plugin;
-
- Bukkit.getPluginManager().registerEvents(this, plugin);
- }
-
- @EventHandler
- public void onServerLoad(@NotNull final ServerLoadEvent event) {
- HandlerList.unregisterAll(this);
- plugin.getLocalExpansionManager().load(Bukkit.getConsoleSender());
- }
-
-}
diff --git a/src/main/java/me/clip/placeholderapi/replacer/CharsReplacer.java b/src/main/java/me/clip/placeholderapi/replacer/CharsReplacer.java
deleted file mode 100644
index 8f0af63..0000000
--- a/src/main/java/me/clip/placeholderapi/replacer/CharsReplacer.java
+++ /dev/null
@@ -1,138 +0,0 @@
-/*
- * This file is part of PlaceholderAPI
- *
- * PlaceholderAPI
- * Copyright (c) 2015 - 2026 PlaceholderAPI Team
- *
- * PlaceholderAPI free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * PlaceholderAPI is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this program. If not, see .
- */
-
-package me.clip.placeholderapi.replacer;
-
-import java.util.Locale;
-import java.util.function.Function;
-
-import me.clip.placeholderapi.expansion.PlaceholderExpansion;
-import org.bukkit.ChatColor;
-import org.bukkit.OfflinePlayer;
-import org.jetbrains.annotations.NotNull;
-import org.jetbrains.annotations.Nullable;
-
-public final class CharsReplacer implements Replacer {
-
- @NotNull
- private final Closure closure;
-
- public CharsReplacer(@NotNull final Closure closure) {
- this.closure = closure;
- }
-
-
- @NotNull
- @Override
- public String apply(@NotNull final String text, @Nullable final OfflinePlayer player,
- @NotNull final Function lookup) {
- final char[] chars = text.toCharArray();
- final StringBuilder builder = new StringBuilder(text.length());
-
- final StringBuilder identifier = new StringBuilder();
- final StringBuilder parameters = new StringBuilder();
-
- for (int i = 0; i < chars.length; i++) {
- final char l = chars[i];
-
- if (l != closure.head || i + 1 >= chars.length) {
- builder.append(l);
- continue;
- }
-
- boolean identified = false;
- boolean invalid = true;
- boolean hadSpace = false;
-
- while (++i < chars.length) {
- final char p = chars[i];
-
- if (p == ' ' && !identified) {
- hadSpace = true;
- break;
- }
- if (p == closure.tail) {
- invalid = false;
- break;
- }
-
- if (p == '_' && !identified) {
- identified = true;
- continue;
- }
-
- if (identified) {
- parameters.append(p);
- } else {
- identifier.append(p);
- }
- }
-
- final String identifierString = identifier.toString();
- final String lowercaseIdentifierString = identifierString.toLowerCase(Locale.ROOT);
- final String parametersString = parameters.toString();
-
- identifier.setLength(0);
- parameters.setLength(0);
-
- if (invalid) {
- builder.append(closure.head).append(identifierString);
-
- if (identified) {
- builder.append('_').append(parametersString);
- }
-
- if (hadSpace) {
- builder.append(' ');
- }
- continue;
- }
-
- final PlaceholderExpansion placeholder = lookup.apply(lowercaseIdentifierString);
- if (placeholder == null) {
- builder.append(closure.head).append(identifierString);
-
- if (identified) {
- builder.append('_');
- }
-
- builder.append(parametersString).append(closure.tail);
- continue;
- }
-
- final String replacement = placeholder.onRequest(player, parametersString);
- if (replacement == null) {
- builder.append(closure.head).append(identifierString);
-
- if (identified) {
- builder.append('_');
- }
-
- builder.append(parametersString).append(closure.tail);
- continue;
- }
-
- builder.append(replacement);
- }
-
- return builder.toString();
- }
-
-}
diff --git a/src/main/java/me/clip/placeholderapi/replacer/Replacer.java b/src/main/java/me/clip/placeholderapi/replacer/Replacer.java
deleted file mode 100644
index 417df30..0000000
--- a/src/main/java/me/clip/placeholderapi/replacer/Replacer.java
+++ /dev/null
@@ -1,50 +0,0 @@
-/*
- * This file is part of PlaceholderAPI
- *
- * PlaceholderAPI
- * Copyright (c) 2015 - 2026 PlaceholderAPI Team
- *
- * PlaceholderAPI free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * PlaceholderAPI is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this program. If not, see .
- */
-
-package me.clip.placeholderapi.replacer;
-
-import java.util.function.Function;
-
-import me.clip.placeholderapi.expansion.PlaceholderExpansion;
-import org.bukkit.OfflinePlayer;
-import org.jetbrains.annotations.NotNull;
-import org.jetbrains.annotations.Nullable;
-
-public interface Replacer {
-
- @NotNull
- String apply(@NotNull final String text, @Nullable final OfflinePlayer player,
- @NotNull final Function lookup);
-
-
- enum Closure {
- BRACKET('{', '}'),
- PERCENT('%', '%');
-
-
- public final char head, tail;
-
- Closure(final char head, final char tail) {
- this.head = head;
- this.tail = tail;
- }
- }
-
-}
diff --git a/src/main/java/me/clip/placeholderapi/scheduler/UniversalRunnable.java b/src/main/java/me/clip/placeholderapi/scheduler/UniversalRunnable.java
deleted file mode 100644
index 65ae9b5..0000000
--- a/src/main/java/me/clip/placeholderapi/scheduler/UniversalRunnable.java
+++ /dev/null
@@ -1,180 +0,0 @@
-/*
- * MIT License
- *
- * Copyright (c) 2023 Sevastjan
- *
- * Permission is hereby granted, free of charge, to any person obtaining
- * a copy of this software and associated documentation files (the "Software"),
- * to deal in the Software without restriction, including without limitation
- * the rights to use, copy, modify, merge, publish, distribute, sublicense,
- * and/or sell copies of the Software, and to permit persons to whom the
- * Software is furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
- * INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
- * PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
- * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
- * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
- * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
- */
-
-package me.clip.placeholderapi.scheduler;
-
-import me.clip.placeholderapi.scheduler.scheduling.schedulers.TaskScheduler;
-import me.clip.placeholderapi.scheduler.scheduling.tasks.MyScheduledTask;
-import org.bukkit.plugin.Plugin;
-
-/**
- * Just modified BukkitRunnable
- */
-public abstract class UniversalRunnable implements Runnable {
- MyScheduledTask task;
-
- public synchronized void cancel() throws IllegalStateException {
- checkScheduled();
- task.cancel();
- }
-
- /**
- * Returns true if this task has been cancelled.
- *
- * @return true if the task has been cancelled
- * @throws IllegalStateException if task was not scheduled yet
- */
- public synchronized boolean isCancelled() throws IllegalStateException {
- checkScheduled();
- return task.isCancelled();
- }
-
- /**
- * Schedules this in the Bukkit scheduler to run on next tick.
- *
- * @param plugin the reference to the plugin scheduling task
- * @return {@link MyScheduledTask}
- * @throws IllegalArgumentException if plugin is null
- * @throws IllegalStateException if this was already scheduled
- * @see TaskScheduler#runTask(Runnable)
- */
-
- public synchronized MyScheduledTask runTask(Plugin plugin) throws IllegalArgumentException, IllegalStateException {
- checkNotYetScheduled();
- return setupTask(UniversalScheduler.getScheduler(plugin).runTask(this));
- }
-
- /**
- * Asynchronous tasks should never access any API in Bukkit. Great care
- * should be taken to assure the thread-safety of asynchronous tasks.
- *
- * Schedules this in the Bukkit scheduler to run asynchronously.
- *
- * @param plugin the reference to the plugin scheduling task
- * @return {@link MyScheduledTask}
- * @throws IllegalArgumentException if plugin is null
- * @throws IllegalStateException if this was already scheduled
- * @see TaskScheduler#runTaskAsynchronously(Runnable)
- */
-
- public synchronized MyScheduledTask runTaskAsynchronously(Plugin plugin) throws IllegalArgumentException, IllegalStateException {
- checkNotYetScheduled();
- return setupTask(UniversalScheduler.getScheduler(plugin).runTaskAsynchronously(this));
- }
-
- /**
- * Schedules this to run after the specified number of server ticks.
- *
- * @param plugin the reference to the plugin scheduling task
- * @param delay the ticks to wait before running the task
- * @return {@link MyScheduledTask}
- * @throws IllegalArgumentException if plugin is null
- * @throws IllegalStateException if this was already scheduled
- * @see TaskScheduler#runTaskLater(Runnable, long)
- */
-
- public synchronized MyScheduledTask runTaskLater(Plugin plugin, long delay) throws IllegalArgumentException, IllegalStateException {
- checkNotYetScheduled();
- return setupTask(UniversalScheduler.getScheduler(plugin).runTaskLater(this, delay));
- }
-
- /**
- * Asynchronous tasks should never access any API in Bukkit. Great care
- * should be taken to assure the thread-safety of asynchronous tasks.
- *
- * Schedules this to run asynchronously after the specified number of
- * server ticks.
- *
- * @param plugin the reference to the plugin scheduling task
- * @param delay the ticks to wait before running the task
- * @return {@link MyScheduledTask}
- * @throws IllegalArgumentException if plugin is null
- * @throws IllegalStateException if this was already scheduled
- * @see TaskScheduler#runTaskLaterAsynchronously(Runnable, long)
- */
-
- public synchronized MyScheduledTask runTaskLaterAsynchronously(Plugin plugin, long delay) throws IllegalArgumentException, IllegalStateException {
- checkNotYetScheduled();
- return setupTask(UniversalScheduler.getScheduler(plugin).runTaskLaterAsynchronously(this, delay));
- }
-
- /**
- * Schedules this to repeatedly run until cancelled, starting after the
- * specified number of server ticks.
- *
- * @param plugin the reference to the plugin scheduling task
- * @param delay the ticks to wait before running the task
- * @param period the ticks to wait between runs
- * @return {@link MyScheduledTask}
- * @throws IllegalArgumentException if plugin is null
- * @throws IllegalStateException if this was already scheduled
- * @see TaskScheduler#runTaskTimer(Runnable, long, long)
- */
-
- public synchronized MyScheduledTask runTaskTimer(Plugin plugin, long delay, long period) throws IllegalArgumentException, IllegalStateException {
- checkNotYetScheduled();
- return setupTask(UniversalScheduler.getScheduler(plugin).runTaskTimer(this, delay, period));
- }
-
- /**
- * Asynchronous tasks should never access any API in Bukkit. Great care
- * should be taken to assure the thread-safety of asynchronous tasks.
- *
- * Schedules this to repeatedly run asynchronously until cancelled,
- * starting after the specified number of server ticks.
- *
- * @param plugin the reference to the plugin scheduling task
- * @param delay the ticks to wait before running the task for the first
- * time
- * @param period the ticks to wait between runs
- * @return {@link MyScheduledTask}
- * @throws IllegalArgumentException if plugin is null
- * @throws IllegalStateException if this was already scheduled
- * @see TaskScheduler#runTaskTimerAsynchronously(Runnable, long, long)
- */
-
- public synchronized MyScheduledTask runTaskTimerAsynchronously(Plugin plugin, long delay, long period) throws IllegalArgumentException, IllegalStateException {
- checkNotYetScheduled();
- return setupTask(UniversalScheduler.getScheduler(plugin).runTaskTimerAsynchronously(this, delay, period));
- }
-
- private void checkScheduled() {
- if (task == null) {
- throw new IllegalStateException("Not scheduled yet");
- }
- }
-
- private void checkNotYetScheduled() {
- if (task != null) {
- throw new IllegalStateException("Already scheduled");
- }
- }
-
-
- private MyScheduledTask setupTask(final MyScheduledTask task) {
- this.task = task;
- return task;
- }
-
-
-}
diff --git a/src/main/java/me/clip/placeholderapi/scheduler/UniversalScheduler.java b/src/main/java/me/clip/placeholderapi/scheduler/UniversalScheduler.java
deleted file mode 100644
index cfed1e4..0000000
--- a/src/main/java/me/clip/placeholderapi/scheduler/UniversalScheduler.java
+++ /dev/null
@@ -1,42 +0,0 @@
-/*
- * MIT License
- *
- * Copyright (c) 2023 Sevastjan
- *
- * Permission is hereby granted, free of charge, to any person obtaining
- * a copy of this software and associated documentation files (the "Software"),
- * to deal in the Software without restriction, including without limitation
- * the rights to use, copy, modify, merge, publish, distribute, sublicense,
- * and/or sell copies of the Software, and to permit persons to whom the
- * Software is furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
- * INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
- * PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
- * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
- * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
- * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
- */
-
-package me.clip.placeholderapi.scheduler;
-
-import me.clip.placeholderapi.scheduler.bukkit.BukkitScheduler;
-import me.clip.placeholderapi.scheduler.folia.FoliaScheduler;
-import me.clip.placeholderapi.scheduler.paper.PaperScheduler;
-import me.clip.placeholderapi.scheduler.scheduling.schedulers.TaskScheduler;
-import me.clip.placeholderapi.scheduler.utils.JavaUtil;
-import org.bukkit.plugin.Plugin;
-
-public class UniversalScheduler {
- private static final boolean IS_FOLIA = JavaUtil.classExists("io.papermc.paper.threadedregions.RegionizedServer");
- private static final boolean IS_CANVAS = JavaUtil.classExists("io.canvasmc.canvas.server.ThreadedServer");
- private static final boolean IS_EXPANDED_SCHEDULING_AVAILABLE = JavaUtil.classExists("io.papermc.paper.threadedregions.scheduler.ScheduledTask");
-
- public static TaskScheduler getScheduler(Plugin plugin) {
- return IS_FOLIA || IS_CANVAS ? new FoliaScheduler(plugin) : (IS_EXPANDED_SCHEDULING_AVAILABLE ? new PaperScheduler(plugin) : new BukkitScheduler(plugin));
- }
-
-}
diff --git a/src/main/java/me/clip/placeholderapi/scheduler/bukkit/BukkitScheduledTask.java b/src/main/java/me/clip/placeholderapi/scheduler/bukkit/BukkitScheduledTask.java
deleted file mode 100644
index 49cbc69..0000000
--- a/src/main/java/me/clip/placeholderapi/scheduler/bukkit/BukkitScheduledTask.java
+++ /dev/null
@@ -1,71 +0,0 @@
-/*
- * MIT License
- *
- * Copyright (c) 2023 Sevastjan
- *
- * Permission is hereby granted, free of charge, to any person obtaining
- * a copy of this software and associated documentation files (the "Software"),
- * to deal in the Software without restriction, including without limitation
- * the rights to use, copy, modify, merge, publish, distribute, sublicense,
- * and/or sell copies of the Software, and to permit persons to whom the
- * Software is furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
- * INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
- * PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
- * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
- * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
- * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
- */
-
-package me.clip.placeholderapi.scheduler.bukkit;
-
-import me.clip.placeholderapi.scheduler.scheduling.tasks.MyScheduledTask;
-import org.bukkit.Bukkit;
-import org.bukkit.plugin.Plugin;
-import org.bukkit.scheduler.BukkitTask;
-
-public class BukkitScheduledTask implements MyScheduledTask {
-
- BukkitTask task;
-
- boolean isRepeating;
-
- public BukkitScheduledTask(final BukkitTask task) {
- this.task = task;
- this.isRepeating = false;
- }
-
- public BukkitScheduledTask(final BukkitTask task, boolean isRepeating) {
- this.task = task;
- this.isRepeating = isRepeating;
- }
-
- @Override
- public void cancel() {
- task.cancel();
- }
-
- @Override
- public boolean isCancelled() {
- return task.isCancelled();
- }
-
- @Override
- public Plugin getOwningPlugin() {
- return task.getOwner();
- }
-
- @Override
- public boolean isCurrentlyRunning() {
- return Bukkit.getServer().getScheduler().isCurrentlyRunning(this.task.getTaskId()); //There's no other way. Fuck bukkit
- }
-
- @Override
- public boolean isRepeatingTask() {
- return isRepeating;
- }
-}
diff --git a/src/main/java/me/clip/placeholderapi/scheduler/bukkit/BukkitScheduler.java b/src/main/java/me/clip/placeholderapi/scheduler/bukkit/BukkitScheduler.java
deleted file mode 100644
index baa2113..0000000
--- a/src/main/java/me/clip/placeholderapi/scheduler/bukkit/BukkitScheduler.java
+++ /dev/null
@@ -1,129 +0,0 @@
-/*
- * MIT License
- *
- * Copyright (c) 2023 Sevastjan
- *
- * Permission is hereby granted, free of charge, to any person obtaining
- * a copy of this software and associated documentation files (the "Software"),
- * to deal in the Software without restriction, including without limitation
- * the rights to use, copy, modify, merge, publish, distribute, sublicense,
- * and/or sell copies of the Software, and to permit persons to whom the
- * Software is furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
- * INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
- * PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
- * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
- * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
- * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
- */
-
-package me.clip.placeholderapi.scheduler.bukkit;
-
-import me.clip.placeholderapi.scheduler.scheduling.schedulers.TaskScheduler;
-import me.clip.placeholderapi.scheduler.scheduling.tasks.MyScheduledTask;
-import org.bukkit.Bukkit;
-import org.bukkit.Location;
-import org.bukkit.entity.Entity;
-import org.bukkit.plugin.Plugin;
-
-public class BukkitScheduler implements TaskScheduler {
- final Plugin plugin;
-
- public BukkitScheduler(Plugin plugin) {
- this.plugin = plugin;
- }
-
- @Override
- public boolean isGlobalThread() {
- return Bukkit.getServer().isPrimaryThread();
- }
-
- @Override
- public boolean isEntityThread(Entity entity) {
- return Bukkit.getServer().isPrimaryThread();
- }
-
- @Override
- public boolean isRegionThread(Location location) {
- return Bukkit.getServer().isPrimaryThread();
- }
-
- @Override
- public MyScheduledTask runTask(Runnable runnable) {
- return new BukkitScheduledTask(Bukkit.getScheduler().runTask(plugin, runnable));
- }
-
- @Override
- public MyScheduledTask runTaskLater(Runnable runnable, long delay) {
- return new BukkitScheduledTask(Bukkit.getScheduler().runTaskLater(plugin, runnable, delay));
- }
-
- @Override
- public MyScheduledTask runTaskTimer(Runnable runnable, long delay, long period) {
- return new BukkitScheduledTask(Bukkit.getScheduler().runTaskTimer(plugin, runnable, delay, period));
- }
-
- @Override
- public MyScheduledTask runTaskAsynchronously(Runnable runnable) {
- return new BukkitScheduledTask(Bukkit.getScheduler().runTaskAsynchronously(plugin, runnable));
- }
-
- @Override
- public MyScheduledTask runTaskLaterAsynchronously(Runnable runnable, long delay) {
- return new BukkitScheduledTask(Bukkit.getScheduler().runTaskLaterAsynchronously(plugin, runnable, delay));
- }
-
- @Override
- public MyScheduledTask runTaskTimerAsynchronously(Runnable runnable, long delay, long period) {
- return new BukkitScheduledTask(Bukkit.getScheduler().runTaskTimerAsynchronously(plugin, runnable, delay, period));
- }
-
- //Useless? Or...
- public MyScheduledTask runTask(Plugin plugin, Runnable runnable) {
- return new BukkitScheduledTask(Bukkit.getScheduler().runTask(plugin, runnable));
- }
-
- @Override
- public MyScheduledTask runTaskLater(Plugin plugin, Runnable runnable, long delay) {
- return new BukkitScheduledTask(Bukkit.getScheduler().runTaskLater(plugin, runnable, delay));
- }
-
- @Override
- public MyScheduledTask runTaskTimer(Plugin plugin, Runnable runnable, long delay, long period) {
- return new BukkitScheduledTask(Bukkit.getScheduler().runTaskTimer(plugin, runnable, delay, period));
- }
-
- @Override
- public MyScheduledTask runTaskAsynchronously(Plugin plugin, Runnable runnable) {
- return new BukkitScheduledTask(Bukkit.getScheduler().runTaskAsynchronously(plugin, runnable));
- }
-
- @Override
- public MyScheduledTask runTaskLaterAsynchronously(Plugin plugin, Runnable runnable, long delay) {
- return new BukkitScheduledTask(Bukkit.getScheduler().runTaskLaterAsynchronously(plugin, runnable, delay));
- }
-
- @Override
- public MyScheduledTask runTaskTimerAsynchronously(Plugin plugin, Runnable runnable, long delay, long period) {
- return new BukkitScheduledTask(Bukkit.getScheduler().runTaskTimerAsynchronously(plugin, runnable, delay, period));
- }
-
- @Override
- public void execute(Runnable runnable) {
- Bukkit.getScheduler().scheduleSyncDelayedTask(plugin, runnable);
- }
-
- @Override
- public void cancelTasks() {
- Bukkit.getScheduler().cancelTasks(plugin);
- }
-
- @Override
- public void cancelTasks(Plugin plugin) {
- Bukkit.getScheduler().cancelTasks(plugin);
- }
-}
diff --git a/src/main/java/me/clip/placeholderapi/scheduler/folia/FoliaScheduledTask.java b/src/main/java/me/clip/placeholderapi/scheduler/folia/FoliaScheduledTask.java
deleted file mode 100644
index 86091d5..0000000
--- a/src/main/java/me/clip/placeholderapi/scheduler/folia/FoliaScheduledTask.java
+++ /dev/null
@@ -1,57 +0,0 @@
-/*
- * MIT License
- *
- * Copyright (c) 2023 Sevastjan
- *
- * Permission is hereby granted, free of charge, to any person obtaining
- * a copy of this software and associated documentation files (the "Software"),
- * to deal in the Software without restriction, including without limitation
- * the rights to use, copy, modify, merge, publish, distribute, sublicense,
- * and/or sell copies of the Software, and to permit persons to whom the
- * Software is furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
- * INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
- * PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
- * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
- * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
- * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
- */
-
-package me.clip.placeholderapi.scheduler.folia;
-
-import me.clip.placeholderapi.scheduler.scheduling.tasks.MyScheduledTask;
-import io.papermc.paper.threadedregions.scheduler.ScheduledTask;
-import org.bukkit.plugin.Plugin;
-
-public class FoliaScheduledTask implements MyScheduledTask {
- private final ScheduledTask task;
-
- public FoliaScheduledTask(final ScheduledTask task) {
- this.task = task;
- }
-
- public void cancel() {
- this.task.cancel();
- }
-
- public boolean isCancelled() {
- return this.task.isCancelled();
- }
-
- public Plugin getOwningPlugin() {
- return this.task.getOwningPlugin();
- }
-
- public boolean isCurrentlyRunning() {
- final ScheduledTask.ExecutionState state = this.task.getExecutionState();
- return state == ScheduledTask.ExecutionState.RUNNING || state == ScheduledTask.ExecutionState.CANCELLED_RUNNING;
- }
-
- public boolean isRepeatingTask() {
- return this.task.isRepeatingTask();
- }
-}
\ No newline at end of file
diff --git a/src/main/java/me/clip/placeholderapi/scheduler/folia/FoliaScheduler.java b/src/main/java/me/clip/placeholderapi/scheduler/folia/FoliaScheduler.java
deleted file mode 100644
index e0f6842..0000000
--- a/src/main/java/me/clip/placeholderapi/scheduler/folia/FoliaScheduler.java
+++ /dev/null
@@ -1,220 +0,0 @@
-/*
- * MIT License
- *
- * Copyright (c) 2023 Sevastjan
- *
- * Permission is hereby granted, free of charge, to any person obtaining
- * a copy of this software and associated documentation files (the "Software"),
- * to deal in the Software without restriction, including without limitation
- * the rights to use, copy, modify, merge, publish, distribute, sublicense,
- * and/or sell copies of the Software, and to permit persons to whom the
- * Software is furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
- * INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
- * PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
- * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
- * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
- * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
- */
-
-package me.clip.placeholderapi.scheduler.folia;
-
-import me.clip.placeholderapi.scheduler.scheduling.schedulers.TaskScheduler;
-import me.clip.placeholderapi.scheduler.scheduling.tasks.MyScheduledTask;
-import io.papermc.paper.threadedregions.scheduler.AsyncScheduler;
-import io.papermc.paper.threadedregions.scheduler.GlobalRegionScheduler;
-import io.papermc.paper.threadedregions.scheduler.RegionScheduler;
-import org.bukkit.Bukkit;
-import org.bukkit.Location;
-import org.bukkit.entity.Entity;
-import org.bukkit.plugin.Plugin;
-
-import java.util.concurrent.TimeUnit;
-
-public class FoliaScheduler implements TaskScheduler {
-
- final Plugin plugin;
-
- public FoliaScheduler(Plugin plugin) {
- this.plugin = plugin;
- }
-
- private final RegionScheduler regionScheduler = Bukkit.getServer().getRegionScheduler();
- private final GlobalRegionScheduler globalRegionScheduler = Bukkit.getServer().getGlobalRegionScheduler();
- private final AsyncScheduler asyncScheduler = Bukkit.getServer().getAsyncScheduler();
-
- @Override
- public boolean isGlobalThread() {
- return Bukkit.getServer().isGlobalTickThread();
- }
-
- @Override
- public boolean isTickThread() {
- return Bukkit.getServer().isPrimaryThread(); // The Paper implementation checks whether this is a tick thread, this method exists to avoid confusion.
- }
-
- @Override
- public boolean isEntityThread(Entity entity) {
- return Bukkit.getServer().isOwnedByCurrentRegion(entity);
- }
-
- @Override
- public boolean isRegionThread(Location location) {
- return Bukkit.getServer().isOwnedByCurrentRegion(location);
- }
-
- @Override
- public MyScheduledTask runTask(Runnable runnable) {
- return new FoliaScheduledTask(globalRegionScheduler.run(plugin, task -> runnable.run()));
- }
-
- @Override
- public MyScheduledTask runTaskLater(Runnable runnable, long delay) {
- //Folia exception: Delay ticks may not be <= 0
- if (delay <= 0) {
- return runTask(runnable);
- }
- return new FoliaScheduledTask(globalRegionScheduler.runDelayed(plugin, task -> runnable.run(), delay));
- }
-
- @Override
- public MyScheduledTask runTaskTimer(Runnable runnable, long delay, long period) {
- //Folia exception: Delay ticks may not be <= 0
- delay = getOneIfNotPositive(delay);
- return new FoliaScheduledTask(globalRegionScheduler.runAtFixedRate(plugin, task -> runnable.run(), delay, period));
- }
-
- @Override
- public MyScheduledTask runTask(Plugin plugin, Runnable runnable) {
- return new FoliaScheduledTask(globalRegionScheduler.run(plugin, task -> runnable.run()));
- }
-
- @Override
- public MyScheduledTask runTaskLater(Plugin plugin, Runnable runnable, long delay) {
- //Folia exception: Delay ticks may not be <= 0
- if (delay <= 0) {
- return runTask(plugin, runnable);
- }
- return new FoliaScheduledTask(globalRegionScheduler.runDelayed(plugin, task -> runnable.run(), delay));
- }
-
- @Override
- public MyScheduledTask runTaskTimer(Plugin plugin, Runnable runnable, long delay, long period) {
- //Folia exception: Delay ticks may not be <= 0
- delay = getOneIfNotPositive(delay);
- return new FoliaScheduledTask(globalRegionScheduler.runAtFixedRate(plugin, task -> runnable.run(), delay, period));
- }
-
- @Override
- public MyScheduledTask runTask(Location location, Runnable runnable) {
- return new FoliaScheduledTask(regionScheduler.run(plugin, location, task -> runnable.run()));
- }
-
- @Override
- public MyScheduledTask runTaskLater(Location location, Runnable runnable, long delay) {
- //Folia exception: Delay ticks may not be <= 0
- if (delay <= 0) {
- return runTask(runnable);
- }
- return new FoliaScheduledTask(regionScheduler.runDelayed(plugin, location, task -> runnable.run(), delay));
- }
-
- @Override
- public MyScheduledTask runTaskTimer(Location location, Runnable runnable, long delay, long period) {
- //Folia exception: Delay ticks may not be <= 0
- delay = getOneIfNotPositive(delay);
- return new FoliaScheduledTask(regionScheduler.runAtFixedRate(plugin, location, task -> runnable.run(), delay, period));
- }
-
- @Override
- public MyScheduledTask runTask(Entity entity, Runnable runnable) {
- return new FoliaScheduledTask(entity.getScheduler().run(plugin, task -> runnable.run(), null));
- }
-
- @Override
- public MyScheduledTask runTaskLater(Entity entity, Runnable runnable, long delay) {
- //Folia exception: Delay ticks may not be <= 0
- if (delay <= 0) {
- return runTask(entity, runnable);
- }
- return new FoliaScheduledTask(entity.getScheduler().runDelayed(plugin, task -> runnable.run(), null, delay));
- }
-
- @Override
- public MyScheduledTask runTaskTimer(Entity entity, Runnable runnable, long delay, long period) {
- //Folia exception: Delay ticks may not be <= 0
- delay = getOneIfNotPositive(delay);
- return new FoliaScheduledTask(entity.getScheduler().runAtFixedRate(plugin, task -> runnable.run(), null, delay, period));
- }
-
- @Override
- public MyScheduledTask runTaskAsynchronously(Runnable runnable) {
- return new FoliaScheduledTask(asyncScheduler.runNow(plugin, task -> runnable.run()));
- }
-
- @Override
- public MyScheduledTask runTaskLaterAsynchronously(Runnable runnable, long delay) {
- //Folia exception: Delay ticks may not be <= 0
- delay = getOneIfNotPositive(delay);
- return new FoliaScheduledTask(asyncScheduler.runDelayed(plugin, task -> runnable.run(), delay * 50L, TimeUnit.MILLISECONDS));
- }
-
- @Override
- public MyScheduledTask runTaskTimerAsynchronously(Runnable runnable, long delay, long period) {
- return new FoliaScheduledTask(asyncScheduler.runAtFixedRate(plugin, task -> runnable.run(), delay * 50, period * 50, TimeUnit.MILLISECONDS));
- }
-
- @Override
- public MyScheduledTask runTaskAsynchronously(Plugin plugin, Runnable runnable) {
- return new FoliaScheduledTask(asyncScheduler.runNow(plugin, task -> runnable.run()));
- }
-
- @Override
- public MyScheduledTask runTaskLaterAsynchronously(Plugin plugin, Runnable runnable, long delay) {
- //Folia exception: Delay ticks may not be <= 0
- delay = getOneIfNotPositive(delay);
- return new FoliaScheduledTask(asyncScheduler.runDelayed(plugin, task -> runnable.run(), delay * 50L, TimeUnit.MILLISECONDS));
- }
-
- @Override
- public MyScheduledTask runTaskTimerAsynchronously(Plugin plugin, Runnable runnable, long delay, long period) {
- //Folia exception: Delay ticks may not be <= 0
- delay = getOneIfNotPositive(delay);
- return new FoliaScheduledTask(asyncScheduler.runAtFixedRate(plugin, task -> runnable.run(), delay * 50, period * 50, TimeUnit.MILLISECONDS));
- }
-
- @Override
- public void execute(Runnable runnable) {
- globalRegionScheduler.execute(plugin, runnable);
- }
-
- @Override
- public void execute(Location location, Runnable runnable) {
- regionScheduler.execute(plugin, location, runnable);
- }
-
- @Override
- public void execute(Entity entity, Runnable runnable) {
- entity.getScheduler().execute(plugin, runnable, null, 1L);
- }
-
- @Override
- public void cancelTasks() {
- globalRegionScheduler.cancelTasks(plugin);
- asyncScheduler.cancelTasks(plugin);
- }
-
- @Override
- public void cancelTasks(Plugin plugin) {
- globalRegionScheduler.cancelTasks(plugin);
- asyncScheduler.cancelTasks(plugin);
- }
-
- private long getOneIfNotPositive(long x) {
- return x <= 0 ? 1L : x;
- }
-}
diff --git a/src/main/java/me/clip/placeholderapi/scheduler/paper/PaperScheduler.java b/src/main/java/me/clip/placeholderapi/scheduler/paper/PaperScheduler.java
deleted file mode 100644
index dfe9f18..0000000
--- a/src/main/java/me/clip/placeholderapi/scheduler/paper/PaperScheduler.java
+++ /dev/null
@@ -1,41 +0,0 @@
-/*
- * MIT License
- *
- * Copyright (c) 2023 Sevastjan
- *
- * Permission is hereby granted, free of charge, to any person obtaining
- * a copy of this software and associated documentation files (the "Software"),
- * to deal in the Software without restriction, including without limitation
- * the rights to use, copy, modify, merge, publish, distribute, sublicense,
- * and/or sell copies of the Software, and to permit persons to whom the
- * Software is furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
- * INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
- * PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
- * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
- * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
- * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
- */
-
-package me.clip.placeholderapi.scheduler.paper;
-
-import me.clip.placeholderapi.scheduler.folia.FoliaScheduler;
-import org.bukkit.Bukkit;
-import org.bukkit.plugin.Plugin;
-
-//Thanks to Towny
-public class PaperScheduler extends FoliaScheduler {
- public PaperScheduler(Plugin plugin) {
- super(plugin);
- }
-
- @Override
- public boolean isGlobalThread() {
- // isGlobalThread does not exist on paper, match the bukkit task scheduler's behaviour.
- return Bukkit.getServer().isPrimaryThread();
- }
-}
diff --git a/src/main/java/me/clip/placeholderapi/scheduler/scheduling/schedulers/TaskScheduler.java b/src/main/java/me/clip/placeholderapi/scheduler/scheduling/schedulers/TaskScheduler.java
deleted file mode 100644
index 200f0e6..0000000
--- a/src/main/java/me/clip/placeholderapi/scheduler/scheduling/schedulers/TaskScheduler.java
+++ /dev/null
@@ -1,346 +0,0 @@
-/*
- * MIT License
- *
- * Copyright (c) 2023 Sevastjan
- *
- * Permission is hereby granted, free of charge, to any person obtaining
- * a copy of this software and associated documentation files (the "Software"),
- * to deal in the Software without restriction, including without limitation
- * the rights to use, copy, modify, merge, publish, distribute, sublicense,
- * and/or sell copies of the Software, and to permit persons to whom the
- * Software is furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
- * INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
- * PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
- * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
- * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
- * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
- */
-
-package me.clip.placeholderapi.scheduler.scheduling.schedulers;
-
-import me.clip.placeholderapi.scheduler.scheduling.tasks.MyScheduledTask;
-import org.bukkit.Bukkit;
-import org.bukkit.Location;
-import org.bukkit.entity.Entity;
-import org.bukkit.plugin.Plugin;
-
-import java.util.concurrent.Callable;
-import java.util.concurrent.CompletableFuture;
-import java.util.concurrent.Future;
-
-public interface TaskScheduler {
-
- /**
- * Folia: Returns whether the current thread is ticking the global region
- * Paper and Bukkit: Returns {@link org.bukkit.Server#isPrimaryThread}
- */
- boolean isGlobalThread();
-
- /**
- * @return {@link org.bukkit.Server#isPrimaryThread}
- */
- default boolean isTickThread() {
- return Bukkit.getServer().isPrimaryThread();
- }
-
- /**
- * Folia and Paper: Returns whether the current thread is ticking a region and that the region
- * being ticked owns the specified entity. Note that this function is the only appropriate method of
- * checking for ownership of an entity, as retrieving the entity's location is undefined unless the
- * entity is owned by the current region
- *
- * Bukkit: returns {@link org.bukkit.Server#isPrimaryThread}
- *
- * @param entity Specified entity
- */
- boolean isEntityThread(Entity entity);
-
- /**
- * Folia and Paper: Returns whether the current thread is ticking a region and that the region
- * being ticked owns the chunk at the specified world and block position as included in the specified location
- *
- * Bukkit: returns {@link org.bukkit.Server#isPrimaryThread}
- *
- * @param location Specified location, must have a non-null world.
- */
- boolean isRegionThread(Location location);
-
- /**
- * Schedules a task to be executed on the next tick
- * Folia and Paper: ...on the global region
- * Bukkit: ...on the main thread
- *
- * @param runnable The task to execute
- */
- MyScheduledTask runTask(Runnable runnable);
-
- /**
- * Schedules a task to be executed after the specified delay in ticks
- * Folia and Paper: ...on the global region
- * Bukkit: ...on the main thread
- *
- * @param runnable The task to execute
- * @param delay The delay, in ticks
- */
- MyScheduledTask runTaskLater(Runnable runnable, long delay);
-
- /**
- * Schedules a repeating task to be executed after the initial delay with the specified period
- * Folia and Paper: ...on the global region
- * Bukkit: ...on the main thread
- *
- * @param runnable The task to execute
- * @param delay The initial delay, in ticks.
- * @param period The period, in ticks.
- */
- MyScheduledTask runTaskTimer(Runnable runnable, long delay, long period);
-
- /**
- * Deprecated: use {@link #runTask(Runnable)}
- */
- @Deprecated
- default MyScheduledTask runTask(Plugin plugin, Runnable runnable) {
- return runTask(runnable);
- }
-
- /**
- * Deprecated: use {@link #runTaskLater(Runnable, long)}
- */
- @Deprecated
- default MyScheduledTask runTaskLater(Plugin plugin, Runnable runnable, long delay) {
- return runTaskLater(runnable, delay);
- }
-
- /**
- * Deprecated: use {@link #runTaskTimer(Runnable, long, long)}
- */
- @Deprecated
- default MyScheduledTask runTaskTimer(Plugin plugin, Runnable runnable, long delay, long period) {
- return runTaskTimer(runnable, delay, period);
- }
-
- /**
- * Folia and Paper: Schedules a task to be executed on the region which owns the location on the next tick
- *
- * Bukkit: same as {@link #runTask(Runnable)}
- *
- * @param location The location which the region executing should own
- * @param runnable The task to execute
- */
- default MyScheduledTask runTask(Location location, Runnable runnable) {
- return runTask(runnable);
- }
-
- /**
- * Folia and Paper: Schedules a task to be executed on the region which owns the location after the
- * specified delay in ticks
- *
- * Bukkit: same as {@link #runTaskLater(Runnable, long)}
- *
- * @param location The location which the region executing should own
- * @param runnable The task to execute
- * @param delay The delay, in ticks.
- */
- default MyScheduledTask runTaskLater(Location location, Runnable runnable, long delay) {
- return runTaskLater(runnable, delay);
- }
-
- /**
- * Folia and Paper: Schedules a repeating task to be executed on the region which owns the location
- * after the initial delay with the specified period
- *
- * Bukkit: same as {@link #runTaskTimer(Runnable, long, long)}
- *
- * @param location The location which the region executing should own
- * @param runnable The task to execute
- * @param delay The initial delay, in ticks.
- * @param period The period, in ticks.
- */
- default MyScheduledTask runTaskTimer(Location location, Runnable runnable, long delay, long period) {
- return runTaskTimer(runnable, delay, period);
- }
-
- /**
- * Deprecated: use {@link #runTaskLater(Runnable, long)}
- */
- @Deprecated
- default MyScheduledTask scheduleSyncDelayedTask(Runnable runnable, long delay) {
- return runTaskLater(runnable, delay);
- }
-
- /**
- * Deprecated: use {@link #execute(Runnable)} or {@link #runTask(Runnable)}
- */
- @Deprecated
- default MyScheduledTask scheduleSyncDelayedTask(Runnable runnable) {
- return runTask(runnable);
- }
-
- /**
- * Deprecated: use {@link #runTaskTimer(Runnable, long, long)}
- */
- @Deprecated
- default MyScheduledTask scheduleSyncRepeatingTask(Runnable runnable, long delay, long period) {
- return runTaskTimer(runnable, delay, period);
- }
-
- /**
- * Folia and Paper: Schedules a task to be executed on the region which owns the location
- * of given entity on the next tick
- *
- * Bukkit: same as {@link #runTask(Runnable)}
- *
- * @param entity The entity whose location the region executing should own
- * @param runnable The task to execute
- */
- default MyScheduledTask runTask(Entity entity, Runnable runnable) {
- return runTask(runnable);
- }
-
- /**
- * Folia and Paper: Schedules a task to be executed on the region which owns the location
- * of given entity after the specified delay in ticks
- *
- * Bukkit: same as {@link #runTaskLater(Runnable, long)}
- *
- * @param entity The entity whose location the region executing should own
- * @param runnable The task to execute
- * @param delay The delay, in ticks.
- */
- default MyScheduledTask runTaskLater(Entity entity, Runnable runnable, long delay) {
- return runTaskLater(runnable, delay);
- }
-
- /**
- * Folia and Paper: Schedules a repeating task to be executed on the region which owns the
- * location of given entity after the initial delay with the specified period
- *
- * Bukkit: same as {@link #runTaskTimer(Runnable, long, long)}
- *
- * @param entity The entity whose location the region executing should own
- * @param runnable The task to execute
- * @param delay The initial delay, in ticks.
- * @param period The period, in ticks.
- */
- default MyScheduledTask runTaskTimer(Entity entity, Runnable runnable, long delay, long period) {
- return runTaskTimer(runnable, delay, period);
- }
-
- /**
- * Schedules the specified task to be executed asynchronously immediately
- *
- * @param runnable The task to execute
- * @return The {@link MyScheduledTask} that represents the scheduled task
- */
- MyScheduledTask runTaskAsynchronously(Runnable runnable);
-
- /**
- * Schedules the specified task to be executed asynchronously after the time delay has passed
- *
- * @param runnable The task to execute
- * @param delay The time delay to pass before the task should be executed
- * @return The {@link MyScheduledTask} that represents the scheduled task
- */
- MyScheduledTask runTaskLaterAsynchronously(Runnable runnable, long delay);
-
- /**
- * Schedules the specified task to be executed asynchronously after the initial delay has passed,
- * and then periodically executed with the specified period
- *
- * @param runnable The task to execute
- * @param delay The time delay to pass before the first execution of the task, in ticks
- * @param period The time between task executions after the first execution of the task, in ticks
- * @return The {@link MyScheduledTask} that represents the scheduled task
- */
- MyScheduledTask runTaskTimerAsynchronously(Runnable runnable, long delay, long period);
-
- /**
- * Deprecated: use {@link #runTaskAsynchronously(Runnable)}
- */
- @Deprecated
- default MyScheduledTask runTaskAsynchronously(Plugin plugin, Runnable runnable) {
- return runTaskAsynchronously(runnable);
- }
-
- /**
- * Deprecated: use {@link #runTaskLaterAsynchronously(Runnable, long)}
- */
- @Deprecated
- default MyScheduledTask runTaskLaterAsynchronously(Plugin plugin, Runnable runnable, long delay) {
- return runTaskLaterAsynchronously(runnable, delay);
- }
-
- /**
- * Deprecated: use {@link #runTaskTimerAsynchronously(Runnable, long, long)}
- */
- @Deprecated
- default MyScheduledTask runTaskTimerAsynchronously(Plugin plugin, Runnable runnable, long delay, long period) {
- return runTaskTimerAsynchronously(runnable, delay, period);
- }
-
- /**
- * Calls a method on the main thread and returns a Future object. This task will be executed
- * by the main(Bukkit)/global(FoliaandPaper) server thread.
- *
- * Note: The Future.get() methods must NOT be called from the main thread.
- *
- * Note2: There is at least an average of 10ms latency until the isDone() method returns true.
- *
- * @param task Task to be executed
- */
- default Future callSyncMethod(final Callable task) {
- CompletableFuture completableFuture = new CompletableFuture<>();
- execute(() -> {
- try {
- completableFuture.complete(task.call());
- } catch (Exception e) {
- throw new RuntimeException(e);
- }
- });
- return completableFuture;
- }
-
- /**
- * Schedules a task to be executed on the global region
- *
- * @param runnable The task to execute
- */
- void execute(Runnable runnable);
-
- /**
- * Schedules a task to be executed on the region which owns the location
- *
- * @param location The location which the region executing should own
- * @param runnable The task to execute
- */
- default void execute(Location location, Runnable runnable) {
- execute(runnable);
- }
-
- /**
- * Schedules a task to be executed on the region which owns the location of given entity
- *
- * @param entity The entity which location the region executing should own
- * @param runnable The task to execute
- */
- default void execute(Entity entity, Runnable runnable) {
- execute(runnable);
- }
-
- /**
- * Attempts to cancel all tasks scheduled by this plugin
- */
- void cancelTasks();
-
- /**
- * Attempts to cancel all tasks scheduled by the specified plugin
- *
- * @param plugin specified plugin
- */
- void cancelTasks(Plugin plugin);
-}
diff --git a/src/main/java/me/clip/placeholderapi/scheduler/scheduling/tasks/MyScheduledTask.java b/src/main/java/me/clip/placeholderapi/scheduler/scheduling/tasks/MyScheduledTask.java
deleted file mode 100644
index 8f936c7..0000000
--- a/src/main/java/me/clip/placeholderapi/scheduler/scheduling/tasks/MyScheduledTask.java
+++ /dev/null
@@ -1,53 +0,0 @@
-/*
- * MIT License
- *
- * Copyright (c) 2023 Sevastjan
- *
- * Permission is hereby granted, free of charge, to any person obtaining
- * a copy of this software and associated documentation files (the "Software"),
- * to deal in the Software without restriction, including without limitation
- * the rights to use, copy, modify, merge, publish, distribute, sublicense,
- * and/or sell copies of the Software, and to permit persons to whom the
- * Software is furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
- * INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
- * PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
- * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
- * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
- * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
- */
-
-package me.clip.placeholderapi.scheduler.scheduling.tasks;
-
-import org.bukkit.plugin.Plugin;
-
-public interface MyScheduledTask {
- /**
- * Cancels executing task
- */
- void cancel();
-
- /**
- * @return true if task is cancelled, false otherwise
- */
- boolean isCancelled();
-
- /**
- * @return The plugin under which the task was scheduled.
- */
- Plugin getOwningPlugin();
-
- /**
- * @return true if task is currently executing, false otherwise
- */
- boolean isCurrentlyRunning();
-
- /**
- * @return true if task is repeating, false otherwise
- */
- boolean isRepeatingTask();
-}
\ No newline at end of file
diff --git a/src/main/java/me/clip/placeholderapi/scheduler/utils/JavaUtil.java b/src/main/java/me/clip/placeholderapi/scheduler/utils/JavaUtil.java
deleted file mode 100644
index 4a62633..0000000
--- a/src/main/java/me/clip/placeholderapi/scheduler/utils/JavaUtil.java
+++ /dev/null
@@ -1,12 +0,0 @@
-package me.clip.placeholderapi.scheduler.utils;
-
-public class JavaUtil {
- public static boolean classExists(String className) {
- try {
- Class.forName(className);
- return true;
- } catch (ClassNotFoundException e) {
- return false;
- }
- }
-}
diff --git a/src/main/java/me/clip/placeholderapi/updatechecker/UpdateChecker.java b/src/main/java/me/clip/placeholderapi/updatechecker/UpdateChecker.java
deleted file mode 100644
index 0de95be..0000000
--- a/src/main/java/me/clip/placeholderapi/updatechecker/UpdateChecker.java
+++ /dev/null
@@ -1,128 +0,0 @@
-/*
- * This file is part of PlaceholderAPI
- *
- * PlaceholderAPI
- * Copyright (c) 2015 - 2026 PlaceholderAPI Team
- *
- * PlaceholderAPI free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * PlaceholderAPI is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this program. If not, see .
- */
-
-package me.clip.placeholderapi.updatechecker;
-
-import java.io.BufferedReader;
-import java.io.InputStreamReader;
-import java.net.URL;
-import java.util.Arrays;
-import javax.net.ssl.HttpsURLConnection;
-
-import me.clip.placeholderapi.PlaceholderAPIPlugin;
-import me.clip.placeholderapi.scheduler.scheduling.schedulers.TaskScheduler;
-import me.clip.placeholderapi.util.Msg;
-import org.bukkit.Bukkit;
-import org.bukkit.event.EventHandler;
-import org.bukkit.event.EventPriority;
-import org.bukkit.event.Listener;
-import org.bukkit.event.player.PlayerJoinEvent;
-
-public class UpdateChecker implements Listener {
-
- private static final int RESOURCE_ID = 6245;
- private final PlaceholderAPIPlugin plugin;
- private final TaskScheduler scheduler;
- private final String pluginVersion;
- private String spigotVersion;
- private boolean updateAvailable;
-
- public UpdateChecker(PlaceholderAPIPlugin plugin) {
- this.plugin = plugin;
- scheduler = plugin.getScheduler();
- pluginVersion = plugin.getDescription().getVersion();
- }
-
- public boolean hasUpdateAvailable() {
- return updateAvailable;
- }
-
- public String getSpigotVersion() {
- return spigotVersion;
- }
-
- public void fetch() {
- scheduler.runTaskAsynchronously(() -> {
- try {
- HttpsURLConnection con = (HttpsURLConnection) new URL(
- "https://api.spigotmc.org/legacy/update.php?resource=" + RESOURCE_ID).openConnection();
- con.setRequestMethod("GET");
- spigotVersion = new BufferedReader(new InputStreamReader(con.getInputStream())).readLine();
- } catch (Exception ex) {
- plugin.getLogger().info("Failed to check for updates on spigot.");
- return;
- }
-
- if (spigotVersion == null || spigotVersion.isEmpty()) {
- return;
- }
-
- updateAvailable = spigotIsNewer();
-
- if (!updateAvailable) {
- return;
- }
-
- scheduler.runTask(() -> {
- plugin.getLogger()
- .info("An update for PlaceholderAPI (v" + getSpigotVersion() + ") is available at:");
- plugin.getLogger()
- .info("https://www.spigotmc.org/resources/placeholderapi." + RESOURCE_ID + "/");
- Bukkit.getPluginManager().registerEvents(this, plugin);
- });
- });
- }
-
- private boolean spigotIsNewer() {
- if (spigotVersion == null || spigotVersion.isEmpty()) {
- return false;
- }
-
- int[] plV = toReadable(pluginVersion);
- int[] spV = toReadable(spigotVersion);
-
- if (plV[0] < spV[0]) {
- return true;
- } else if ((plV[1] < spV[1])) {
- return true;
- } else {
- return plV[2] < spV[2];
- }
- }
-
- private int[] toReadable(String version) {
- if (version.contains("-DEV")) {
- version = version.split("-DEV")[0];
- }
-
- return Arrays.stream(version.split("\\.")).mapToInt(Integer::parseInt).toArray();
- }
-
- @EventHandler(priority = EventPriority.MONITOR)
- public void onJoin(PlayerJoinEvent e) {
- if (e.getPlayer().hasPermission("placeholderapi.updatenotify")) {
- Msg.msg(e.getPlayer(),
- "&bAn update for &fPlaceholder&7API &e(&fPlaceholder&7API &fv" + getSpigotVersion()
- + "&e)"
- , "&bis available at &ehttps://www.spigotmc.org/resources/placeholderapi." + RESOURCE_ID
- + "/");
- }
- }
-}
diff --git a/src/main/java/me/clip/placeholderapi/util/ExpansionSafetyCheck.java b/src/main/java/me/clip/placeholderapi/util/ExpansionSafetyCheck.java
deleted file mode 100644
index 365fb36..0000000
--- a/src/main/java/me/clip/placeholderapi/util/ExpansionSafetyCheck.java
+++ /dev/null
@@ -1,80 +0,0 @@
-package me.clip.placeholderapi.util;
-
-import com.google.common.hash.Hashing;
-import com.google.common.io.Files;
-import com.google.common.io.Resources;
-import me.clip.placeholderapi.PlaceholderAPIPlugin;
-import org.jetbrains.annotations.NotNull;
-
-import java.io.File;
-import java.net.URL;
-import java.nio.charset.StandardCharsets;
-import java.util.Arrays;
-import java.util.HashSet;
-import java.util.Set;
-import java.util.logging.Level;
-import java.util.stream.Collectors;
-
-public final class ExpansionSafetyCheck {
- private static final String MESSAGE =
- "\n###############################################\n" +
- "###############################################\n" +
- "PlaceholderAPI performs checks at startup and /papi reload for known malicious expansions. If you're seeing this message, there are the following malicious expansions in plugins/PlaceholderAPI/expansions.\n" +
- "%s" +
- "To prevent further infection PlaceholderAPI has stopped the server.\n" +
- "If you're seeing this message after updating PAPI, your server may have been infected for some time, so best practice is a complete system wipe and reinstall of your server software and plugins to be safe.\n" +
- "If you're seeing this after downloading an expansion however, PAPI hasn't loaded any of the malicious expansions above so you should be safe to simply delete the expansion in question.\n" +
- "###############################################\n" +
- "###############################################";
-
- private final PlaceholderAPIPlugin main;
-
- public ExpansionSafetyCheck(@NotNull final PlaceholderAPIPlugin main) {
- this.main = main;
- }
-
- public boolean runChecks() {
- if (!main.getPlaceholderAPIConfig().detectMaliciousExpansions()) {
- return false;
- }
-
- final File expansionsFolder = new File(main.getDataFolder(), "expansions");
-
- if (!expansionsFolder.exists()) {
- return false;
- }
-
- final Set knownMaliciousExpansions;
-
- try {
- final String hashes = Resources.toString(new URL("https://check.placeholderapi.com"), StandardCharsets.UTF_8);
- knownMaliciousExpansions = Arrays.stream(hashes.split("\n")).collect(Collectors.toSet());
- } catch (Exception e) {
- main.getLogger().log(Level.SEVERE, "Failed to download anti malware hash check list from https://check.placeholderapi.com", e);
- return false;
- }
-
- final Set maliciousPaths = new HashSet<>();
-
- for (File file : expansionsFolder.listFiles()) {
- try {
- final String hash = Hashing.sha256().hashBytes(Files.asByteSource(file).read()).toString();
-
- if (knownMaliciousExpansions.contains(hash)) {
- maliciousPaths.add(file.getAbsolutePath());
- }
- } catch (Exception e) {
- main.getLogger().log(Level.SEVERE, "Error occurred while trying to read " + file.getAbsolutePath(), e);
- }
- }
-
- if (maliciousPaths.isEmpty()) {
- return false;
- }
-
- main.getLogger().severe(String.format(MESSAGE, maliciousPaths.stream().map(p -> "HASH OF " + p + " MATCHES KNOWN MALICIOUS EXPANSION DELETE IMMEDIATELY\n").collect(Collectors.joining())));
-
- main.getServer().shutdown();
- return true;
- }
-}
diff --git a/src/main/java/me/clip/placeholderapi/util/FileUtil.java b/src/main/java/me/clip/placeholderapi/util/FileUtil.java
deleted file mode 100644
index 526be73..0000000
--- a/src/main/java/me/clip/placeholderapi/util/FileUtil.java
+++ /dev/null
@@ -1,77 +0,0 @@
-/*
- * This file is part of PlaceholderAPI
- *
- * PlaceholderAPI
- * Copyright (c) 2015 - 2026 PlaceholderAPI Team
- *
- * PlaceholderAPI free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * PlaceholderAPI is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this program. If not, see .
- */
-
-package me.clip.placeholderapi.util;
-
-import org.jetbrains.annotations.NotNull;
-import org.jetbrains.annotations.Nullable;
-
-import java.io.File;
-import java.io.IOException;
-import java.net.URL;
-import java.net.URLClassLoader;
-import java.util.ArrayList;
-import java.util.List;
-import java.util.jar.JarEntry;
-import java.util.jar.JarInputStream;
-
-public class FileUtil {
-
- @Nullable
- public static Class findClass(@NotNull final File file,
- @NotNull final Class clazz) throws IOException, ClassNotFoundException {
- if (!file.exists()) {
- return null;
- }
-
- final URL jar = file.toURI().toURL();
- final URLClassLoader loader = new URLClassLoader(new URL[]{jar}, clazz.getClassLoader());
- final List matches = new ArrayList<>();
- final List> classes = new ArrayList<>();
-
- try (final JarInputStream stream = new JarInputStream(jar.openStream())) {
- JarEntry entry;
- while ((entry = stream.getNextJarEntry()) != null) {
- final String name = entry.getName();
- if (name.isEmpty() || !name.endsWith(".class")) {
- continue;
- }
-
- matches.add(name.substring(0, name.lastIndexOf('.')).replace('/', '.'));
- }
-
- for (final String match : matches) {
- try {
- final Class loaded = loader.loadClass(match);
- if (clazz.isAssignableFrom(loaded)) {
- classes.add(loaded.asSubclass(clazz));
- }
- } catch (final NoClassDefFoundError ignored) {
- }
- }
- }
- if (classes.isEmpty()) {
- loader.close();
- return null;
- }
- return classes.get(0);
- }
-
-}
diff --git a/src/main/java/me/clip/placeholderapi/util/Format.java b/src/main/java/me/clip/placeholderapi/util/Format.java
deleted file mode 100644
index 47ca37b..0000000
--- a/src/main/java/me/clip/placeholderapi/util/Format.java
+++ /dev/null
@@ -1,71 +0,0 @@
-/*
- * This file is part of PlaceholderAPI
- *
- * PlaceholderAPI
- * Copyright (c) 2015 - 2026 PlaceholderAPI Team
- *
- * PlaceholderAPI free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * PlaceholderAPI is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this program. If not, see .
- */
-
-package me.clip.placeholderapi.util;
-
-import static java.lang.Math.max;
-import static java.lang.Math.min;
-import static java.util.Arrays.stream;
-import static java.util.stream.Collectors.joining;
-import static java.util.stream.Collectors.toList;
-import static java.util.stream.IntStream.range;
-
-import java.util.List;
-import java.util.Optional;
-
-import org.jetbrains.annotations.NotNull;
-
-/**
- * For the record, I am not sorry.
- */
-public final class Format {
-
- private Format() {}
-
- @NotNull
- public static Optional> tablify(@NotNull final Align align,
- @NotNull final List> rows) {
- return findSpacing(rows)
- .map(spacing -> buildFormat(align, spacing))
- .map(format -> rows.stream()
- .map(
- row -> String.format(format, row.toArray()).substring(align == Align.RIGHT ? 2 : 0))
- .collect(toList()));
- }
-
- @NotNull
- private static String buildFormat(@NotNull final Align align, final int[] spacing) {
- return stream(spacing)
- .mapToObj(space -> "%" + (align == Align.LEFT ? "-" : "") + (space + 2) + "s")
- .collect(joining());
- }
-
- @NotNull
- private static Optional findSpacing(@NotNull final List> rows) {
- return rows.stream()
- .map(row -> row.stream().mapToInt(String::length).toArray())
- .reduce((l, r) -> range(0, min(l.length, r.length)).map(i -> max(l[i], r[i])).toArray());
- }
-
- public enum Align {
- LEFT, RIGHT
- }
-
-}
diff --git a/src/main/java/me/clip/placeholderapi/util/Futures.java b/src/main/java/me/clip/placeholderapi/util/Futures.java
deleted file mode 100644
index ef87db5..0000000
--- a/src/main/java/me/clip/placeholderapi/util/Futures.java
+++ /dev/null
@@ -1,79 +0,0 @@
-/*
- * This file is part of PlaceholderAPI
- *
- * PlaceholderAPI
- * Copyright (c) 2015 - 2026 PlaceholderAPI Team
- *
- * PlaceholderAPI free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * PlaceholderAPI is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this program. If not, see .
- */
-
-package me.clip.placeholderapi.util;
-
-import java.util.Collection;
-import java.util.List;
-import java.util.concurrent.CompletableFuture;
-import java.util.function.BiConsumer;
-import java.util.stream.Collector;
-import java.util.stream.Collectors;
-import java.util.stream.Stream;
-
-import me.clip.placeholderapi.PlaceholderAPIPlugin;
-import org.bukkit.Bukkit;
-import org.bukkit.plugin.Plugin;
-import org.jetbrains.annotations.NotNull;
-
-public final class Futures {
-
- private Futures() {}
-
-
- public static void onMainThread(@NotNull final PlaceholderAPIPlugin plugin,
- @NotNull final CompletableFuture future,
- @NotNull final BiConsumer consumer) {
- future.whenComplete((value, exception) -> {
- if (Bukkit.isPrimaryThread()) {
- consumer.accept(value, exception);
- } else {
- plugin.getScheduler().runTask(() -> consumer.accept(value, exception));
- }
- });
- }
-
-
- @NotNull
- public static