package dev.plex.command; import dev.plex.Plex; import dev.plex.cache.DataUtils; import dev.plex.cache.PlayerCache; import dev.plex.command.annotation.CommandParameters; import dev.plex.command.annotation.CommandPermissions; import dev.plex.command.exception.*; import dev.plex.command.source.RequiredCommandSource; import dev.plex.player.PlexPlayer; import dev.plex.rank.enums.Rank; import dev.plex.util.PlexLog; import dev.plex.util.PlexUtils; import net.kyori.adventure.audience.Audience; import net.kyori.adventure.text.Component; import net.kyori.adventure.text.serializer.legacy.LegacyComponentSerializer; import org.bukkit.Bukkit; import org.bukkit.ChatColor; import org.bukkit.World; import org.bukkit.command.*; import org.bukkit.entity.Player; import org.bukkit.plugin.Plugin; import org.jetbrains.annotations.NotNull; import org.jetbrains.annotations.Nullable; import java.util.Arrays; import java.util.UUID; /** * Superclass for all commands */ public abstract class PlexCommand extends Command implements PluginIdentifiableCommand { /** * Returns the instance of the plugin */ protected static Plex plugin = Plex.get(); /** * The parameters for the command */ private final CommandParameters params; /** * The permissions for the command */ private final CommandPermissions perms; /** * Minimum required rank fetched from the permissions */ private final Rank level; /** * Required command source fetched from the permissions */ private final RequiredCommandSource commandSource; /** * Creates an instance of the command */ public PlexCommand() { super(""); this.params = getClass().getAnnotation(CommandParameters.class); this.perms = getClass().getAnnotation(CommandPermissions.class); setName(this.params.name()); setLabel(this.params.name()); setDescription(params.description()); setUsage(params.usage().replace("", this.params.name())); if (params.aliases().split(",").length > 0) { setAliases(Arrays.asList(params.aliases().split(","))); } this.level = perms.level(); this.commandSource = perms.source(); getMap().register("plex", this); } /** * Executes the command * @param sender The sender of the command * @param playerSender The player who executed the command (null if command source is console or if command source is any but console executed) * @param args A Kyori Component to send to the sender (can be null) * @return */ protected abstract Component execute(@NotNull CommandSender sender, @Nullable Player playerSender, @NotNull String[] args); /** * @hidden */ @Override public boolean execute(@NotNull CommandSender sender, @NotNull String label, String[] args) { if (!matches(label)) { return false; } if (commandSource == RequiredCommandSource.CONSOLE && sender instanceof Player) { sender.sendMessage(tl("noPermissionInGame")); return true; } if (commandSource == RequiredCommandSource.IN_GAME) { if (sender instanceof ConsoleCommandSender) { send(sender, tl("noPermissionConsole")); return true; } Player player = (Player) sender; PlexPlayer plexPlayer = PlayerCache.getPlexPlayerMap().get(player.getUniqueId()); if (plugin.getSystem().equalsIgnoreCase("ranks")) { PlexLog.debug(String.format("%s >= %s && comparing %s with %s", plexPlayer.getRankFromString().getLevel(), getLevel().getLevel(), plexPlayer.getRankFromString().name(), getLevel().name())); if (!plexPlayer.getRankFromString().isAtLeast(getLevel())) { send(sender, tl("noPermissionRank", ChatColor.stripColor(getLevel().getLoginMSG()))); return true; // throw new CommandFailException(PlexUtils.tl("noPermissionRank", ChatColor.stripColor(getLevel().getLoginMSG()))); } } else if (plugin.getSystem().equalsIgnoreCase("permissions")) { if (!player.hasPermission(perms.permission())) { send(sender, tl("noPermissionNode", perms.permission())); return true; // throw new CommandFailException(PlexUtils.tl("noPermissionNode", perms.permission())); } } else { PlexLog.error("Neither permissions or ranks were selected to be used in the configuration file!"); send(sender, "There is a server misconfiguration. Please alert a developer or the owner"); return true; } } if (commandSource == RequiredCommandSource.ANY) { if (sender instanceof Player player) { PlexPlayer plexPlayer = PlayerCache.getPlexPlayerMap().get(player.getUniqueId()); if (plugin.getSystem().equalsIgnoreCase("ranks")) { if (!plexPlayer.getRankFromString().isAtLeast(getLevel())) { send(sender, tl("noPermissionRank", ChatColor.stripColor(getLevel().getLoginMSG()))); return true; // throw new CommandFailException(PlexUtils.tl("noPermissionRank", ChatColor.stripColor(getLevel().getLoginMSG()))); } } else if (plugin.getSystem().equalsIgnoreCase("permissions")) { if (!player.hasPermission(perms.permission())) { send(sender, tl("noPermissionNode", perms.permission())); return true; // throw new CommandFailException(PlexUtils.tl("noPermissionNode", perms.permission())); } } else { PlexLog.error("Neither permissions or ranks were selected to be used in the configuration file!"); send(sender, "There is a server misconfiguration. Please alert a developer or the owner"); return true; } } } try { Component component = this.execute(sender, isConsole(sender) ? null : (Player) sender, args); if (component != null) { send(sender, component); } } catch (PlayerNotFoundException | CommandFailException | ConsoleOnlyException | ConsoleMustDefinePlayerException | PlayerNotBannedException ex) { send(sender, ex.getMessage()); } return true; } /** * Checks if the string given is a command string * @param label The string to check * @return true if the string is a command name or alias */ private boolean matches(String label) { if (params.aliases().split(",").length > 0) { for (String alias : params.aliases().split(",")) { if (alias.equalsIgnoreCase(label) || getName().equalsIgnoreCase(label)) { return true; } } } else if (params.aliases().split(",").length < 1) { return getName().equalsIgnoreCase(label); } return false; } /** * Gets a PlexPlayer from Player object * @param player The player object * @return PlexPlayer Object * @see PlexPlayer */ protected PlexPlayer getPlexPlayer(@NotNull Player player) { return DataUtils.getPlayer(player.getUniqueId()); } /** * Sends a message to an audience * @param audience The audience to send the message to * @param s The message to send */ protected void send(Audience audience, String s) { audience.sendMessage(componentFromString(s)); } /** * Sends a message to an audience * @param audience The audience to send the message to * @param component The component to send */ protected void send(Audience audience, Component component) { audience.sendMessage(component); } /** * Checks whether a sender has enough permissions or is high enough a rank * @param sender A command sender * @param rank The rank to check (if the server is using ranks) * @param permission The permission to check (if the server is using permissions) * @return true if the sender has enough permissions * @see Rank */ protected boolean checkRank(CommandSender sender, Rank rank, String permission) { if (!isConsole(sender)) { return checkRank((Player) sender, rank, permission); // return true; } return true; } /** * Checks whether a player has enough permissions or is high enough a rank * @param player The player object * @param rank The rank to check (if the server is using ranks) * @param permission The permission to check (if the server is using permissions) * @return true if the sender has enough permissions * @see Rank */ protected boolean checkRank(Player player, Rank rank, String permission) { PlexPlayer plexPlayer = getPlexPlayer(player); if (plugin.getSystem().equalsIgnoreCase("ranks")) { if (!plexPlayer.getRank().equals(rank.toString())) { throw new CommandFailException(PlexUtils.tl("noPermissionRank", ChatColor.stripColor(rank.getLoginMSG()))); } } else if (plugin.getSystem().equalsIgnoreCase("permissions")) { if (!player.hasPermission(permission)) { throw new CommandFailException(PlexUtils.tl("noPermissionNode", permission)); } } return true; } /** * Checks if a player is an admin * @param plexPlayer The PlexPlayer object * @return true if the player is an admin * @see PlexPlayer */ protected boolean isAdmin(PlexPlayer plexPlayer) { return Plex.get().getRankManager().isAdmin(plexPlayer); } /** * Checks if a sender is an admin * @param sender A command sender * @return true if the sender is an admin or if console */ protected boolean isAdmin(CommandSender sender) { if (!(sender instanceof Player player)) { return true; } PlexPlayer plexPlayer = getPlexPlayer(player); return plugin.getRankManager().isAdmin(plexPlayer); } /** * Checks if a username is an admin * @param name The username * @return true if the username is an admin */ protected boolean isAdmin(String name) { PlexPlayer plexPlayer = DataUtils.getPlayer(name); return plugin.getRankManager().isAdmin(plexPlayer); } /** * Checks if a sender is a senior admin * @param sender A command sender * @return true if the sender is a senior admin or if console */ protected boolean isSeniorAdmin(CommandSender sender) { if (!(sender instanceof Player player)) { return true; } PlexPlayer plexPlayer = getPlexPlayer(player); return plugin.getRankManager().isSeniorAdmin(plexPlayer); } /** * Gets the UUID of the sender * @param sender A command sender * @return A unique ID or null if the sender is console * @see UUID */ protected UUID getUUID(CommandSender sender) { if (!(sender instanceof Player player)) { return null; } return player.getUniqueId(); } /** * The plugin * @return The instance of the plugin * @see Plex */ @Override public @NotNull Plex getPlugin() { return plugin; } /** * Checks whether a sender is console * @param sender A command sender * @return true if the sender is console */ protected boolean isConsole(CommandSender sender) { return !(sender instanceof Player); } /** * Converts a message entry from the "messages.yml" to a component * @param s The message entry * @param objects Any objects to replace in order * @return A kyori component */ protected Component tl(String s, Object... objects) { return componentFromString(PlexUtils.tl(s, objects)); } /** * Converts usage to a component * @param s The usage to convert * @return A kyori component stating the usage */ protected Component usage(String s) { return componentFromString(ChatColor.YELLOW + "Correct Usage: " + ChatColor.GRAY + s); } protected Player getNonNullPlayer(String name) { Player player = Bukkit.getPlayer(name); if (player == null) { throw new PlayerNotFoundException(); } return player; } protected PlexPlayer getOnlinePlexPlayer(String name) { Player player = getNonNullPlayer(name); PlexPlayer plexPlayer = PlayerCache.getPlexPlayer(player.getUniqueId()); if (plexPlayer == null) { throw new PlayerNotFoundException(); } return plexPlayer; } protected PlexPlayer getOfflinePlexPlayer(UUID uuid) { PlexPlayer plexPlayer = DataUtils.getPlayer(uuid); if (plexPlayer == null) { throw new PlayerNotFoundException(); } return plexPlayer; } protected World getNonNullWorld(String name) { World world = Bukkit.getWorld(name); if (world == null) { throw new CommandFailException(PlexUtils.tl("worldNotFound")); } return world; } /** * Converts a string to a legacy kyori component * @param s The string to convert * @return A kyori component */ protected Component componentFromString(String s) { return LegacyComponentSerializer.legacyAmpersand().deserialize(s); } public Rank getLevel() { return level; } public CommandMap getMap() { return Plex.get().getServer().getCommandMap(); } }