Minepacks/Minepacks-API/src/at/pcgamingfreaks/Minepacks/Bukkit/API/MinepacksCommand.java

200 lines
6.9 KiB
Java

/*
* Copyright (C) 2020 GeorgH93
*
* This program is 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.
*
* This program 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 <https://www.gnu.org/licenses/>.
*/
package at.pcgamingfreaks.Minepacks.Bukkit.API;
import at.pcgamingfreaks.Bukkit.Command.SubCommand;
import at.pcgamingfreaks.Bukkit.Message.Message;
import at.pcgamingfreaks.Command.HelpData;
import org.bukkit.ChatColor;
import org.bukkit.command.CommandSender;
import org.bukkit.entity.Player;
import org.bukkit.plugin.java.JavaPlugin;
import org.jetbrains.annotations.NotNull;
import org.jetbrains.annotations.Nullable;
import java.lang.reflect.Method;
import java.util.ArrayList;
import java.util.List;
/**
* Only available if the plugin is not running in standalone mode!
*/
public abstract class MinepacksCommand extends SubCommand
{
private static MinepacksPlugin minepacksPlugin = null;
private static Method showHelp = null;
private static Message messageNoPermission = new Message(ChatColor.RED + "You don't have the permission to do that.");
private static Message messageNotFromConsole = new Message(ChatColor.RED + "This command can't be used from console!");
protected final JavaPlugin plugin;
private final boolean playerOnly;
//region Constructors
/**
* Creates a new command instance.
*
* @param plugin The plugin owning the command.
* @param name The command used.
* @param description The description of the command.
* @param aliases List of aliases for that command.
*/
public MinepacksCommand(@NotNull JavaPlugin plugin, @NotNull String name, @NotNull String description, @Nullable String... aliases)
{
this(plugin, name, description, null, aliases);
}
/**
* Creates a new command instance.
*
* @param plugin The plugin owning the command.
* @param name The command used.
* @param description The description of the command.
* @param permission The permission to be checked for this command. Players without the permission neither can use the command nor will they see it in help.
* @param aliases List of aliases for that command.
*/
public MinepacksCommand(@NotNull JavaPlugin plugin, @NotNull String name, @NotNull String description, @Nullable String permission, @Nullable String... aliases)
{
this(plugin, name, description, permission, false, aliases);
}
/**
* Creates a new command instance.
*
* @param plugin The plugin owning the command.
* @param name The command used.
* @param description The description of the command.
* @param permission The permission to be checked for this command. Players without the permission neither can use the command nor will they see it in help.
* @param playerOnly Limits the command to players, console can't use and can't see the command.
* @param aliases List of aliases for that command.
*/
public MinepacksCommand(@NotNull JavaPlugin plugin, @NotNull String name, @NotNull String description, @Nullable String permission, boolean playerOnly, @Nullable String... aliases)
{
super(name, description, permission, aliases);
this.plugin = plugin;
this.playerOnly = playerOnly;
}
//endregion
/**
* Gets the instance of the marriage master plugin.
*
* @return The instance of the marriage master plugin.
*/
protected @NotNull MinepacksPlugin getMinepacksPlugin()
{
return minepacksPlugin;
}
//region Command Stuff
/**
* Executes some basic checks and runs the command afterwards.
*
* @param sender Source of the command.
* @param mainCommandAlias Alias of the plugins main command which was used.
* @param alias Alias of the command which has been used.
* @param args Passed command arguments.
*/
@Override
public void doExecute(@NotNull CommandSender sender, @NotNull String mainCommandAlias, @NotNull String alias, @NotNull String... args)
{
if(playerOnly && !(sender instanceof Player))
{
messageNotFromConsole.send(sender);
}
else if(getPermission() != null && !sender.hasPermission(getPermission()))
{
messageNoPermission.send(sender);
}
else
{
execute(sender, mainCommandAlias, alias, args);
}
}
/**
* Executes some basic checks and generates list for tab completion.
*
* @param sender Source of the command.
* @param mainCommandAlias Alias of the plugins main command which has been used.
* @param alias The alias used.
* @param args The arguments passed to the command, including final partial argument to be completed and command label.
* @return A List of possible completions for the final argument, or null to default to the command executor.
*/
@Override
public List<String> doTabComplete(@NotNull CommandSender sender, @NotNull String mainCommandAlias, @NotNull String alias, @NotNull String... args)
{
if(playerOnly && !(sender instanceof Player))
{
messageNotFromConsole.send(sender);
}
else if(getPermission() != null && !sender.hasPermission(getPermission()))
{
messageNoPermission.send(sender);
}
else
{
return tabComplete(sender, mainCommandAlias, alias, args);
}
return null;
}
/**
* Gets the help for a given {@link CommandSender}.
*
* @param requester The {@link CommandSender} that requested help.
* @return All the help data for this command.
*/
@Override
public @Nullable List<HelpData> getHelp(@NotNull CommandSender requester)
{
List<HelpData> help = new ArrayList<>(1);
help.add(new HelpData(getTranslatedName(), null, getDescription()));
return help;
}
/**
* Shows the help to a given command sender.
*
* @param sendTo The command sender that requested help.
* @param usedMainCommandAlias The used backpack alias to replace the /backpack with the used alias.
*/
@Override
public void showHelp(@NotNull CommandSender sendTo, @NotNull String usedMainCommandAlias)
{
try
{
showHelp.invoke(getMinepacksPlugin().getCommandManager(), sendTo, usedMainCommandAlias, doGetHelp(sendTo));
}
catch(Exception e)
{
e.printStackTrace();
}
}
/**
* Checks if a user can use the command. Checks permission, marriage status and player/console.
*
* @param sender The player/console that should be checked.
* @return True if it can use the command, false if not.
*/
@Override
public boolean canUse(@NotNull CommandSender sender)
{
return (!playerOnly || sender instanceof Player) && (getPermission() == null || sender.hasPermission(getPermission()));
}
//endregion
}