Plex/server/src/main/java/dev/plex/command/PlexCommand.java

507 lines
15 KiB
Java
Raw Normal View History

2021-01-03 07:21:15 +00:00
package dev.plex.command;
2020-10-31 04:51:22 +00:00
2021-01-03 07:21:15 +00:00
import dev.plex.Plex;
2022-01-04 03:04:39 +00:00
import dev.plex.cache.DataUtils;
2021-01-03 07:21:15 +00:00
import dev.plex.command.annotation.CommandParameters;
import dev.plex.command.annotation.CommandPermissions;
2023-03-08 20:26:10 +00:00
import dev.plex.command.exception.*;
2021-01-03 07:21:15 +00:00
import dev.plex.command.source.RequiredCommandSource;
import dev.plex.player.PlexPlayer;
2022-01-29 22:35:48 +00:00
import dev.plex.util.PlexLog;
2021-01-03 07:21:15 +00:00
import dev.plex.util.PlexUtils;
import net.kyori.adventure.audience.Audience;
import net.kyori.adventure.text.Component;
2022-03-17 22:16:17 +00:00
import net.kyori.adventure.text.format.NamedTextColor;
import net.kyori.adventure.text.serializer.legacy.LegacyComponentSerializer;
import org.bukkit.Bukkit;
import org.bukkit.ChatColor;
import org.bukkit.World;
2023-03-08 20:26:10 +00:00
import org.bukkit.command.*;
import org.bukkit.entity.Player;
import org.jetbrains.annotations.NotNull;
import org.jetbrains.annotations.Nullable;
2020-10-31 04:51:22 +00:00
2023-03-08 20:26:10 +00:00
import java.util.Arrays;
import java.util.UUID;
/**
* Superclass for all commands
*/
public abstract class PlexCommand extends Command implements PluginIdentifiableCommand
2020-10-31 04:51:22 +00:00
{
/**
* Returns the instance of the plugin
*/
protected static Plex plugin = Plex.get();
/**
* The parameters for the command
*/
2020-10-31 04:51:22 +00:00
private final CommandParameters params;
/**
* The permissions for the command
*/
2020-10-31 04:51:22 +00:00
private final CommandPermissions perms;
/**
* Required command source fetched from the permissions
*/
private final RequiredCommandSource commandSource;
2020-10-31 04:51:22 +00:00
/**
* Creates an instance of the command
*/
2022-05-06 01:54:08 +00:00
public PlexCommand(boolean register)
2020-10-31 04:51:22 +00:00
{
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("<command>", this.params.name()));
if (params.aliases().split(",").length > 0)
{
setAliases(Arrays.asList(params.aliases().split(",")));
}
this.commandSource = perms.source();
2022-05-06 01:54:08 +00:00
if (register)
{
if (getMap().getKnownCommands().containsKey(this.getName().toLowerCase()))
{
getMap().getKnownCommands().remove(this.getName().toLowerCase());
}
this.getAliases().forEach(s -> {
if (getMap().getKnownCommands().containsKey(s.toLowerCase()))
{
getMap().getKnownCommands().remove(s.toLowerCase());
}
});
2022-05-06 01:54:08 +00:00
getMap().register("plex", this);
}
}
2022-05-10 05:08:45 +00:00
2022-05-06 01:54:08 +00:00
public PlexCommand()
{
this(true);
2020-10-31 04:51:22 +00:00
}
/**
* Executes the command
2022-02-07 05:58:55 +00:00
*
* @param sender The sender of the command
2022-03-17 22:16:17 +00:00
* @param playerSender The player who executed the command (null if CommandSource is console or if CommandSource is any but console executed)
2022-02-07 05:58:55 +00:00
* @param args A Kyori Component to send to the sender (can be null)
*/
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)
2020-10-31 04:51:22 +00:00
{
2020-11-06 01:29:38 +00:00
if (!matches(label))
{
return false;
}
if (commandSource == RequiredCommandSource.CONSOLE && sender instanceof Player)
{
2022-02-25 07:09:55 +00:00
sender.sendMessage(messageComponent("noPermissionInGame"));
return true;
}
if (commandSource == RequiredCommandSource.IN_GAME)
2020-10-31 04:51:22 +00:00
{
if (sender instanceof ConsoleCommandSender)
{
2022-02-25 07:09:55 +00:00
send(sender, messageComponent("noPermissionConsole"));
return true;
}
}
if (sender instanceof Player player)
{
2022-05-18 10:31:15 +00:00
PlexPlayer plexPlayer = plugin.getPlayerCache().getPlexPlayerMap().get(player.getUniqueId());
2022-01-29 22:35:48 +00:00
2022-07-24 00:08:54 +00:00
if (plexPlayer == null)
{
return false;
}
if (!perms.permission().isEmpty() && !player.hasPermission(perms.permission()))
{
send(sender, messageComponent("noPermissionNode", perms.permission()));
return true;
2022-04-09 05:08:18 +00:00
}
}
if (sender instanceof ConsoleCommandSender && !sender.getName().equalsIgnoreCase("console")) //telnet
{
PlexPlayer plexPlayer = DataUtils.getPlayer(sender.getName());
if (!perms.permission().isEmpty() && !plugin.getPermissions().playerHas(null, Bukkit.getPlayer(plexPlayer.getName()), perms.permission()))
{
send(sender, messageComponent("noPermissionNode", perms.permission()));
return true;
2020-10-31 04:51:22 +00:00
}
}
try
{
2023-03-08 20:26:10 +00:00
Component component = this.execute(sender, isConsole(sender) ? null : (Player) sender, args);
if (component != null)
{
send(sender, component);
}
2022-04-13 02:22:17 +00:00
}
catch (PlayerNotFoundException | CommandFailException | ConsoleOnlyException |
ConsoleMustDefinePlayerException | PlayerNotBannedException | NumberFormatException ex)
{
2022-04-10 01:53:27 +00:00
send(sender, PlexUtils.mmDeserialize(ex.getMessage()));
}
return true;
2020-10-31 04:51:22 +00:00
}
/**
2022-03-17 22:16:17 +00:00
* Checks if the String given is a matching command
2022-02-07 05:58:55 +00:00
*
2022-03-17 22:16:17 +00:00
* @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)
2020-10-31 04:51:22 +00:00
{
for (String alias : params.aliases().split(","))
{
if (alias.equalsIgnoreCase(label) || getName().equalsIgnoreCase(label))
{
return true;
}
}
2022-04-13 02:22:17 +00:00
}
else if (params.aliases().split(",").length < 1)
2020-10-31 04:51:22 +00:00
{
return getName().equalsIgnoreCase(label);
2020-10-31 04:51:22 +00:00
}
return false;
2020-10-31 04:51:22 +00:00
}
/**
* Gets a PlexPlayer from Player object
2022-02-07 05:58:55 +00:00
*
* @param player The player object
2022-02-07 05:58:55 +00:00
* @return PlexPlayer Object
* @see PlexPlayer
*/
protected PlexPlayer getPlexPlayer(@NotNull Player player)
{
return DataUtils.getPlayer(player.getUniqueId());
}
/**
2022-03-17 22:16:17 +00:00
* Sends a message to an Audience
2022-02-07 05:58:55 +00:00
*
2022-03-17 22:16:17 +00:00
* @param audience The Audience to send the message to
2022-02-07 05:58:55 +00:00
* @param s The message to send
*/
protected void send(Audience audience, String s)
{
audience.sendMessage(componentFromString(s));
}
/**
2022-03-17 22:16:17 +00:00
* Sends a message to an Audience
2022-02-07 05:58:55 +00:00
*
2022-03-17 22:16:17 +00:00
* @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
2022-02-07 05:58:55 +00:00
*
2022-03-17 22:16:17 +00:00
* @param sender A CommandSender
* @param permission The permission to check
* @return true if the sender has enough permissions
*/
protected boolean checkPermission(CommandSender sender, String permission)
{
if (!isConsole(sender))
{
return checkPermission((Player) sender, permission);
}
return true;
}
/**
* Checks whether a sender has enough permissions or is high enough a rank
*
* @param sender A CommandSender
* @param permission The permission to check
* @return true if the sender has enough permissions
*/
protected boolean silentCheckPermission(CommandSender sender, String permission)
{
PlexLog.debug("Checking {0} with {1}", sender.getName(), permission);
if (!isConsole(sender))
{
return silentCheckPermission((Player) sender, permission);
}
return true;
}
/**
* Checks whether a player has enough permissions or is high enough a rank
2022-02-07 05:58:55 +00:00
*
* @param player The player object
* @param permission The permission to check
* @return true if the sender has enough permissions
*/
protected boolean checkPermission(Player player, String permission)
2022-01-29 22:35:48 +00:00
{
if (player instanceof ConsoleCommandSender)
{
return true;
}
if (!permission.isEmpty() && !player.hasPermission(permission))
2022-01-29 22:35:48 +00:00
{
throw new CommandFailException(PlexUtils.messageString("noPermissionNode", permission));
2022-01-29 22:35:48 +00:00
}
2022-01-30 00:43:44 +00:00
return true;
2022-01-29 22:35:48 +00:00
}
protected boolean silentCheckPermission(Player player, String permission)
2022-03-25 05:45:55 +00:00
{
return !permission.isEmpty() && player.hasPermission(permission);
2022-03-25 05:45:55 +00:00
}
/* *//**
* Checks whether a sender has enough permissions or is high enough a rank
*
* @param sender 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 silentCheckPermission(CommandSender sender, Rank rank, String permission)
{
if (!isConsole(sender))
{
return silentCheckPermission((Player) sender, rank, permission);
}
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 silentCheckPermission(Player player, Rank rank, String permission)
{
PlexPlayer plexPlayer = getPlexPlayer(player);
if (plugin.getSystem().equalsIgnoreCase("ranks"))
{
2022-04-07 07:37:31 +00:00
return rank.isAtLeast(Rank.ADMIN) ? plexPlayer.isAdminActive() && plexPlayer.getRankFromString().isAtLeast(rank) : plexPlayer.getRankFromString().isAtLeast(rank);
2022-04-13 02:22:17 +00:00
}
else if (plugin.getSystem().equalsIgnoreCase("permissions"))
{
return !permission.isEmpty() && player.hasPermission(permission);
}
return true;
}*/
/**
* Gets the UUID of the sender
2022-02-07 05:58:55 +00:00
*
* @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
2022-02-07 05:58:55 +00:00
*
* @return The instance of the plugin
* @see Plex
*/
@Override
public @NotNull Plex getPlugin()
{
return plugin;
}
/**
* Checks whether a sender is console
2022-02-07 05:58:55 +00:00
*
* @param sender A command sender
* @return true if the sender is console
*/
protected boolean isConsole(CommandSender sender)
2020-11-05 21:17:14 +00:00
{
return !(sender instanceof Player);
2020-11-05 21:17:14 +00:00
}
/**
2022-02-25 07:36:46 +00:00
* Converts a message entry from the "messages.yml" to a Component
2022-02-07 05:58:55 +00:00
*
* @param s The message entry
* @param objects Any objects to replace in order
2022-03-17 22:16:17 +00:00
* @return A Kyori Component
*/
2022-02-25 07:09:55 +00:00
protected Component messageComponent(String s, Object... objects)
{
2022-02-25 07:09:55 +00:00
return PlexUtils.messageComponent(s, objects);
}
/**
* 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 messageComponent(String s, Component... objects)
{
return PlexUtils.messageComponent(s, objects);
}
2022-02-25 07:36:46 +00:00
/**
* Converts a message entry from the "messages.yml" to a String
*
* @param s The message entry
* @param objects Any objects to replace in order
* @return A String
*/
protected String messageString(String s, Object... objects)
{
return PlexUtils.messageString(s, objects);
}
/**
2022-03-17 22:16:17 +00:00
* Converts usage to a Component
2022-02-07 05:58:55 +00:00
*
2022-03-17 22:16:17 +00:00
* @return A Kyori Component stating the usage
*/
protected Component usage()
{
2022-03-17 22:16:17 +00:00
return Component.text("Correct Usage: ").color(NamedTextColor.YELLOW).append(componentFromString(this.getUsage()).color(NamedTextColor.GRAY));
}
/**
2022-03-17 22:16:17 +00:00
* Converts usage to a Component
2022-02-22 09:30:23 +00:00
* <p>
* s The usage to convert
2022-02-22 09:30:23 +00:00
*
2022-03-17 22:16:17 +00:00
* @return A Kyori Component stating the usage
*/
protected Component usage(String s)
{
2022-03-17 22:16:17 +00:00
return Component.text("Correct Usage: ").color(NamedTextColor.YELLOW).append(componentFromString(s).color(NamedTextColor.GRAY));
}
protected Player getNonNullPlayer(String name)
{
try
{
UUID uuid = UUID.fromString(name);
return Bukkit.getPlayer(uuid);
}
catch (IllegalArgumentException ignored)
{
}
Player player = Bukkit.getPlayer(name);
if (player == null)
2020-11-06 01:29:38 +00:00
{
throw new PlayerNotFoundException();
2020-11-06 01:29:38 +00:00
}
return player;
}
protected PlexPlayer getOnlinePlexPlayer(String name)
{
Player player = getNonNullPlayer(name);
2022-05-18 10:31:15 +00:00
PlexPlayer plexPlayer = plugin.getPlayerCache().getPlexPlayer(player.getUniqueId());
if (plexPlayer == null)
2020-11-06 01:29:38 +00:00
{
throw new PlayerNotFoundException();
2020-11-06 01:29:38 +00:00
}
return plexPlayer;
}
protected PlexPlayer getOfflinePlexPlayer(UUID uuid)
{
PlexPlayer plexPlayer = DataUtils.getPlayer(uuid);
if (plexPlayer == null)
2020-11-06 01:29:38 +00:00
{
throw new PlayerNotFoundException();
2020-11-06 01:29:38 +00:00
}
return plexPlayer;
}
protected World getNonNullWorld(String name)
{
World world = Bukkit.getWorld(name);
if (world == null)
2020-11-06 01:29:38 +00:00
{
2022-02-25 07:09:55 +00:00
throw new CommandFailException(PlexUtils.messageString("worldNotFound"));
2020-11-06 01:29:38 +00:00
}
return world;
}
/**
2022-03-17 22:16:17 +00:00
* Converts a String to a legacy Kyori Component
2022-02-07 05:58:55 +00:00
*
2022-03-17 22:16:17 +00:00
* @param s The String to convert
2022-02-25 07:36:46 +00:00
* @return A Kyori component
*/
protected Component componentFromString(String s)
{
2022-03-17 22:16:17 +00:00
return LegacyComponentSerializer.legacyAmpersand().deserialize(s).colorIfAbsent(NamedTextColor.GRAY);
}
protected Component noColorComponentFromString(String s)
{
return LegacyComponentSerializer.legacyAmpersand().deserialize(s);
}
/**
2022-03-17 22:16:17 +00:00
* Converts a String to a MiniMessage Component
*
2022-03-17 22:16:17 +00:00
* @param s The String to convert
* @return A Kyori Component
*/
protected Component mmString(String s)
{
2022-04-10 01:53:27 +00:00
return PlexUtils.mmDeserialize(s);
}
public CommandMap getMap()
{
return Plex.get().getServer().getCommandMap();
2020-10-31 04:51:22 +00:00
}
}