diff --git a/CommandFramework-Old/build.gradle.kts b/CommandFramework-Old/build.gradle.kts
new file mode 100644
index 00000000..61fbf34e
--- /dev/null
+++ b/CommandFramework-Old/build.gradle.kts
@@ -0,0 +1,27 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2024 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+plugins {
+ steamwar.java
+}
+
+dependencies {
+ testImplementation(libs.junit)
+ testImplementation(libs.hamcrest)
+}
\ No newline at end of file
diff --git a/CommandFramework/src/de/steamwar/command/AbstractSWCommand.java b/CommandFramework-Old/src/de/steamwar/command/AbstractSWCommand.java
similarity index 100%
rename from CommandFramework/src/de/steamwar/command/AbstractSWCommand.java
rename to CommandFramework-Old/src/de/steamwar/command/AbstractSWCommand.java
diff --git a/CommandFramework/src/de/steamwar/command/AbstractTypeMapper.java b/CommandFramework-Old/src/de/steamwar/command/AbstractTypeMapper.java
similarity index 100%
rename from CommandFramework/src/de/steamwar/command/AbstractTypeMapper.java
rename to CommandFramework-Old/src/de/steamwar/command/AbstractTypeMapper.java
diff --git a/CommandFramework/src/de/steamwar/command/AbstractValidator.java b/CommandFramework-Old/src/de/steamwar/command/AbstractValidator.java
similarity index 100%
rename from CommandFramework/src/de/steamwar/command/AbstractValidator.java
rename to CommandFramework-Old/src/de/steamwar/command/AbstractValidator.java
diff --git a/CommandFramework/src/de/steamwar/command/CommandFrameworkException.java b/CommandFramework-Old/src/de/steamwar/command/CommandFrameworkException.java
similarity index 100%
rename from CommandFramework/src/de/steamwar/command/CommandFrameworkException.java
rename to CommandFramework-Old/src/de/steamwar/command/CommandFrameworkException.java
diff --git a/CommandFramework/src/de/steamwar/command/CommandMetaData.java b/CommandFramework-Old/src/de/steamwar/command/CommandMetaData.java
similarity index 100%
rename from CommandFramework/src/de/steamwar/command/CommandMetaData.java
rename to CommandFramework-Old/src/de/steamwar/command/CommandMetaData.java
diff --git a/CommandFramework/src/de/steamwar/command/CommandParseException.java b/CommandFramework-Old/src/de/steamwar/command/CommandParseException.java
similarity index 100%
rename from CommandFramework/src/de/steamwar/command/CommandParseException.java
rename to CommandFramework-Old/src/de/steamwar/command/CommandParseException.java
diff --git a/CommandFramework/src/de/steamwar/command/CommandPart.java b/CommandFramework-Old/src/de/steamwar/command/CommandPart.java
similarity index 100%
rename from CommandFramework/src/de/steamwar/command/CommandPart.java
rename to CommandFramework-Old/src/de/steamwar/command/CommandPart.java
diff --git a/CommandFramework/src/de/steamwar/command/PreviousArguments.java b/CommandFramework-Old/src/de/steamwar/command/PreviousArguments.java
similarity index 100%
rename from CommandFramework/src/de/steamwar/command/PreviousArguments.java
rename to CommandFramework-Old/src/de/steamwar/command/PreviousArguments.java
diff --git a/CommandFramework/src/de/steamwar/command/SWCommandUtils.java b/CommandFramework-Old/src/de/steamwar/command/SWCommandUtils.java
similarity index 100%
rename from CommandFramework/src/de/steamwar/command/SWCommandUtils.java
rename to CommandFramework-Old/src/de/steamwar/command/SWCommandUtils.java
diff --git a/CommandFramework/src/de/steamwar/command/SWTypeMapperCreator.java b/CommandFramework-Old/src/de/steamwar/command/SWTypeMapperCreator.java
similarity index 100%
rename from CommandFramework/src/de/steamwar/command/SWTypeMapperCreator.java
rename to CommandFramework-Old/src/de/steamwar/command/SWTypeMapperCreator.java
diff --git a/CommandFramework/src/de/steamwar/command/SubCommand.java b/CommandFramework-Old/src/de/steamwar/command/SubCommand.java
similarity index 100%
rename from CommandFramework/src/de/steamwar/command/SubCommand.java
rename to CommandFramework-Old/src/de/steamwar/command/SubCommand.java
diff --git a/CommandFramework/src/de/steamwar/command/TabCompletionCache.java b/CommandFramework-Old/src/de/steamwar/command/TabCompletionCache.java
similarity index 100%
rename from CommandFramework/src/de/steamwar/command/TabCompletionCache.java
rename to CommandFramework-Old/src/de/steamwar/command/TabCompletionCache.java
diff --git a/CommandFramework/testsrc/de/steamwar/AssertionUtils.java b/CommandFramework-Old/testsrc/de/steamwar/AssertionUtils.java
similarity index 100%
rename from CommandFramework/testsrc/de/steamwar/AssertionUtils.java
rename to CommandFramework-Old/testsrc/de/steamwar/AssertionUtils.java
diff --git a/CommandFramework/testsrc/de/steamwar/command/ArgumentCommand.java b/CommandFramework-Old/testsrc/de/steamwar/command/ArgumentCommand.java
similarity index 100%
rename from CommandFramework/testsrc/de/steamwar/command/ArgumentCommand.java
rename to CommandFramework-Old/testsrc/de/steamwar/command/ArgumentCommand.java
diff --git a/CommandFramework/testsrc/de/steamwar/command/ArgumentCommandTest.java b/CommandFramework-Old/testsrc/de/steamwar/command/ArgumentCommandTest.java
similarity index 100%
rename from CommandFramework/testsrc/de/steamwar/command/ArgumentCommandTest.java
rename to CommandFramework-Old/testsrc/de/steamwar/command/ArgumentCommandTest.java
diff --git a/CommandFramework/testsrc/de/steamwar/command/BetterExceptionCommand.java b/CommandFramework-Old/testsrc/de/steamwar/command/BetterExceptionCommand.java
similarity index 100%
rename from CommandFramework/testsrc/de/steamwar/command/BetterExceptionCommand.java
rename to CommandFramework-Old/testsrc/de/steamwar/command/BetterExceptionCommand.java
diff --git a/CommandFramework/testsrc/de/steamwar/command/BetterExceptionCommandTest.java b/CommandFramework-Old/testsrc/de/steamwar/command/BetterExceptionCommandTest.java
similarity index 100%
rename from CommandFramework/testsrc/de/steamwar/command/BetterExceptionCommandTest.java
rename to CommandFramework-Old/testsrc/de/steamwar/command/BetterExceptionCommandTest.java
diff --git a/CommandFramework/testsrc/de/steamwar/command/CacheCommand.java b/CommandFramework-Old/testsrc/de/steamwar/command/CacheCommand.java
similarity index 100%
rename from CommandFramework/testsrc/de/steamwar/command/CacheCommand.java
rename to CommandFramework-Old/testsrc/de/steamwar/command/CacheCommand.java
diff --git a/CommandFramework/testsrc/de/steamwar/command/CacheCommandTest.java b/CommandFramework-Old/testsrc/de/steamwar/command/CacheCommandTest.java
similarity index 100%
rename from CommandFramework/testsrc/de/steamwar/command/CacheCommandTest.java
rename to CommandFramework-Old/testsrc/de/steamwar/command/CacheCommandTest.java
diff --git a/CommandFramework/testsrc/de/steamwar/command/NullMapperCommand.java b/CommandFramework-Old/testsrc/de/steamwar/command/NullMapperCommand.java
similarity index 100%
rename from CommandFramework/testsrc/de/steamwar/command/NullMapperCommand.java
rename to CommandFramework-Old/testsrc/de/steamwar/command/NullMapperCommand.java
diff --git a/CommandFramework/testsrc/de/steamwar/command/NullMapperCommandTest.java b/CommandFramework-Old/testsrc/de/steamwar/command/NullMapperCommandTest.java
similarity index 100%
rename from CommandFramework/testsrc/de/steamwar/command/NullMapperCommandTest.java
rename to CommandFramework-Old/testsrc/de/steamwar/command/NullMapperCommandTest.java
diff --git a/CommandFramework/testsrc/de/steamwar/command/NumberValidatorCommand.java b/CommandFramework-Old/testsrc/de/steamwar/command/NumberValidatorCommand.java
similarity index 100%
rename from CommandFramework/testsrc/de/steamwar/command/NumberValidatorCommand.java
rename to CommandFramework-Old/testsrc/de/steamwar/command/NumberValidatorCommand.java
diff --git a/CommandFramework/testsrc/de/steamwar/command/NumberValidatorCommandTest.java b/CommandFramework-Old/testsrc/de/steamwar/command/NumberValidatorCommandTest.java
similarity index 100%
rename from CommandFramework/testsrc/de/steamwar/command/NumberValidatorCommandTest.java
rename to CommandFramework-Old/testsrc/de/steamwar/command/NumberValidatorCommandTest.java
diff --git a/CommandFramework/testsrc/de/steamwar/command/PartOfCommand.java b/CommandFramework-Old/testsrc/de/steamwar/command/PartOfCommand.java
similarity index 100%
rename from CommandFramework/testsrc/de/steamwar/command/PartOfCommand.java
rename to CommandFramework-Old/testsrc/de/steamwar/command/PartOfCommand.java
diff --git a/CommandFramework/testsrc/de/steamwar/command/PartOfCommandTest.java b/CommandFramework-Old/testsrc/de/steamwar/command/PartOfCommandTest.java
similarity index 100%
rename from CommandFramework/testsrc/de/steamwar/command/PartOfCommandTest.java
rename to CommandFramework-Old/testsrc/de/steamwar/command/PartOfCommandTest.java
diff --git a/CommandFramework/testsrc/de/steamwar/command/PreviousArgumentCommand.java b/CommandFramework-Old/testsrc/de/steamwar/command/PreviousArgumentCommand.java
similarity index 100%
rename from CommandFramework/testsrc/de/steamwar/command/PreviousArgumentCommand.java
rename to CommandFramework-Old/testsrc/de/steamwar/command/PreviousArgumentCommand.java
diff --git a/CommandFramework/testsrc/de/steamwar/command/PreviousArgumentCommandTest.java b/CommandFramework-Old/testsrc/de/steamwar/command/PreviousArgumentCommandTest.java
similarity index 100%
rename from CommandFramework/testsrc/de/steamwar/command/PreviousArgumentCommandTest.java
rename to CommandFramework-Old/testsrc/de/steamwar/command/PreviousArgumentCommandTest.java
diff --git a/CommandFramework/testsrc/de/steamwar/command/SimpleCommand.java b/CommandFramework-Old/testsrc/de/steamwar/command/SimpleCommand.java
similarity index 100%
rename from CommandFramework/testsrc/de/steamwar/command/SimpleCommand.java
rename to CommandFramework-Old/testsrc/de/steamwar/command/SimpleCommand.java
diff --git a/CommandFramework/testsrc/de/steamwar/command/SimpleCommandTest.java b/CommandFramework-Old/testsrc/de/steamwar/command/SimpleCommandTest.java
similarity index 100%
rename from CommandFramework/testsrc/de/steamwar/command/SimpleCommandTest.java
rename to CommandFramework-Old/testsrc/de/steamwar/command/SimpleCommandTest.java
diff --git a/CommandFramework/testsrc/de/steamwar/command/StaticValueCommand.java b/CommandFramework-Old/testsrc/de/steamwar/command/StaticValueCommand.java
similarity index 100%
rename from CommandFramework/testsrc/de/steamwar/command/StaticValueCommand.java
rename to CommandFramework-Old/testsrc/de/steamwar/command/StaticValueCommand.java
diff --git a/CommandFramework/testsrc/de/steamwar/command/StaticValueCommandTest.java b/CommandFramework-Old/testsrc/de/steamwar/command/StaticValueCommandTest.java
similarity index 100%
rename from CommandFramework/testsrc/de/steamwar/command/StaticValueCommandTest.java
rename to CommandFramework-Old/testsrc/de/steamwar/command/StaticValueCommandTest.java
diff --git a/CommandFramework/testsrc/de/steamwar/command/SubCMDSortingCommand.java b/CommandFramework-Old/testsrc/de/steamwar/command/SubCMDSortingCommand.java
similarity index 100%
rename from CommandFramework/testsrc/de/steamwar/command/SubCMDSortingCommand.java
rename to CommandFramework-Old/testsrc/de/steamwar/command/SubCMDSortingCommand.java
diff --git a/CommandFramework/testsrc/de/steamwar/command/SubCMDSortingCommandTest.java b/CommandFramework-Old/testsrc/de/steamwar/command/SubCMDSortingCommandTest.java
similarity index 100%
rename from CommandFramework/testsrc/de/steamwar/command/SubCMDSortingCommandTest.java
rename to CommandFramework-Old/testsrc/de/steamwar/command/SubCMDSortingCommandTest.java
diff --git a/CommandFramework/testsrc/de/steamwar/command/TypeMapperCommand.java b/CommandFramework-Old/testsrc/de/steamwar/command/TypeMapperCommand.java
similarity index 100%
rename from CommandFramework/testsrc/de/steamwar/command/TypeMapperCommand.java
rename to CommandFramework-Old/testsrc/de/steamwar/command/TypeMapperCommand.java
diff --git a/CommandFramework/testsrc/de/steamwar/command/TypeMapperCommandTest.java b/CommandFramework-Old/testsrc/de/steamwar/command/TypeMapperCommandTest.java
similarity index 100%
rename from CommandFramework/testsrc/de/steamwar/command/TypeMapperCommandTest.java
rename to CommandFramework-Old/testsrc/de/steamwar/command/TypeMapperCommandTest.java
diff --git a/CommandFramework/testsrc/de/steamwar/command/ValidatorCommand.java b/CommandFramework-Old/testsrc/de/steamwar/command/ValidatorCommand.java
similarity index 100%
rename from CommandFramework/testsrc/de/steamwar/command/ValidatorCommand.java
rename to CommandFramework-Old/testsrc/de/steamwar/command/ValidatorCommand.java
diff --git a/CommandFramework/testsrc/de/steamwar/command/ValidatorCommandTest.java b/CommandFramework-Old/testsrc/de/steamwar/command/ValidatorCommandTest.java
similarity index 100%
rename from CommandFramework/testsrc/de/steamwar/command/ValidatorCommandTest.java
rename to CommandFramework-Old/testsrc/de/steamwar/command/ValidatorCommandTest.java
diff --git a/CommandFramework/testsrc/de/steamwar/command/ValidatorInvertCommand.java b/CommandFramework-Old/testsrc/de/steamwar/command/ValidatorInvertCommand.java
similarity index 100%
rename from CommandFramework/testsrc/de/steamwar/command/ValidatorInvertCommand.java
rename to CommandFramework-Old/testsrc/de/steamwar/command/ValidatorInvertCommand.java
diff --git a/CommandFramework/testsrc/de/steamwar/command/dto/ExecutionIdentifier.java b/CommandFramework-Old/testsrc/de/steamwar/command/dto/ExecutionIdentifier.java
similarity index 100%
rename from CommandFramework/testsrc/de/steamwar/command/dto/ExecutionIdentifier.java
rename to CommandFramework-Old/testsrc/de/steamwar/command/dto/ExecutionIdentifier.java
diff --git a/CommandFramework/testsrc/de/steamwar/command/dto/TestSWCommand.java b/CommandFramework-Old/testsrc/de/steamwar/command/dto/TestSWCommand.java
similarity index 100%
rename from CommandFramework/testsrc/de/steamwar/command/dto/TestSWCommand.java
rename to CommandFramework-Old/testsrc/de/steamwar/command/dto/TestSWCommand.java
diff --git a/CommandFramework/testsrc/de/steamwar/command/dto/TestTypeMapper.java b/CommandFramework-Old/testsrc/de/steamwar/command/dto/TestTypeMapper.java
similarity index 100%
rename from CommandFramework/testsrc/de/steamwar/command/dto/TestTypeMapper.java
rename to CommandFramework-Old/testsrc/de/steamwar/command/dto/TestTypeMapper.java
diff --git a/CommandFramework/testsrc/de/steamwar/command/dto/TestValidator.java b/CommandFramework-Old/testsrc/de/steamwar/command/dto/TestValidator.java
similarity index 100%
rename from CommandFramework/testsrc/de/steamwar/command/dto/TestValidator.java
rename to CommandFramework-Old/testsrc/de/steamwar/command/dto/TestValidator.java
diff --git a/CommandFramework/CommandFrameworkBase/build.gradle.kts b/CommandFramework/CommandFrameworkBase/build.gradle.kts
new file mode 100644
index 00000000..fbe578e4
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/build.gradle.kts
@@ -0,0 +1,27 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2024 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+plugins {
+ steamwar.java
+}
+
+java {
+ sourceCompatibility = JavaVersion.VERSION_11
+ targetCompatibility = JavaVersion.VERSION_11
+}
\ No newline at end of file
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/AbstractCommand.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/AbstractCommand.java
new file mode 100644
index 00000000..2c297a97
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/AbstractCommand.java
@@ -0,0 +1,216 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2020 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command;
+
+import de.steamwar.command.graph.NodeData;
+import de.steamwar.command.graph.RootNode;
+import de.steamwar.command.utils.Pair;
+import de.steamwar.command.utils.Triple;
+
+import java.lang.annotation.Annotation;
+import java.lang.reflect.InvocationTargetException;
+import java.lang.reflect.Method;
+import java.util.*;
+import java.util.function.Consumer;
+import java.util.function.Function;
+import java.util.logging.Level;
+import java.util.logging.Logger;
+import java.util.stream.Collectors;
+
+public abstract class AbstractCommand {
+
+ private static final Map>, Map, Function, ?>>> EXECUTOR_MAPPER = new HashMap<>();
+
+ public static void addExecutorMapper(Class extends AbstractCommand> wrapper, Class executorType, Function mapper) {
+ EXECUTOR_MAPPER.computeIfAbsent(wrapper, __ -> new HashMap<>())
+ .putIfAbsent(executorType, mapper);
+ }
+
+ protected final String command;
+ protected final String permission;
+ private final Consumer> initializer;
+ protected final String[] aliases;
+ protected final List descriptions = new ArrayList<>();
+
+ private boolean initialized = false;
+ protected final RootNode rootNode = new RootNode<>();
+
+ private final Map> localTypeMapper = new HashMap<>();
+ private final Map> localValidators = new HashMap<>();
+ private final Map> localSupplier = new HashMap<>();
+
+ protected AbstractCommand(String command, Consumer> initializer, String... aliases) {
+ this(command, null, initializer, aliases);
+ }
+
+ protected AbstractCommand(String command, String permission, Consumer> initializer, String... aliases) {
+ this.command = command;
+ this.permission = permission;
+ this.initializer = initializer;
+ this.aliases = aliases;
+ initCommand();
+ unregister();
+ register();
+ }
+
+ protected synchronized void initCommand() {
+ }
+
+ public abstract void unregister();
+
+ public abstract void register();
+
+ protected void commandSystemError(T sender, CommandFrameworkException e) {
+ Logger.getGlobal().log(Level.WARNING, "An unexpected error occurred", e);
+ }
+
+ protected void sendMessage(T sender, String message, Object[] args) {
+ }
+
+ public final void execute(T sender, String alias, String[] args) {
+ initialize();
+ List errors = new ArrayList<>();
+ try {
+ boolean executed = rootNode.execute(sender, new NodeData(alias, fixArgs(args), (s, args1) -> {
+ errors.add(() -> sendMessage(sender, s, args1));
+ }));
+ if (executed) return;
+ if (!errors.isEmpty()) {
+ errors.forEach(Runnable::run);
+ return;
+ }
+ descriptions.forEach(s -> sendMessage(sender, s, new Object[0]));
+ } catch (CommandFrameworkException e) {
+ commandSystemError(sender, e);
+ }
+ }
+
+ public final List tabComplete(T sender, String alias, String[] args) throws IllegalArgumentException {
+ initialize();
+ List> tabCompletes = new ArrayList<>();
+ rootNode.tabComplete(sender, new NodeData(alias, fixArgs(args), (s, args1) -> {}), tabCompletes);
+ return tabCompletes.stream()
+ .filter(Objects::nonNull)
+ .flatMap(Collection::stream)
+ .filter(Objects::nonNull)
+ .filter(s -> !s.isEmpty())
+ .distinct()
+ .collect(Collectors.toList());
+ }
+
+ private String[] fixArgs(String[] args) {
+ int removedCount = 0;
+ for (int i = 0; i < args.length; i++) {
+ String arg = args[i];
+ if (arg.isEmpty() && i != args.length - 1) {
+ removedCount++;
+ continue;
+ }
+ args[i] = args[i - removedCount];
+ }
+ if (removedCount != 0) {
+ args = Arrays.copyOf(args, args.length - removedCount);
+ }
+ if (args.length == 0) {
+ return new String[]{""};
+ }
+ return args;
+ }
+
+ private synchronized void initialize() {
+ if (initialized) return;
+
+ List commandObjects = new ArrayList<>();
+ initializer.accept(new CommandLoader<>() {
+ @Override
+ public AbstractCommand get() {
+ return AbstractCommand.this;
+ }
+
+ @Override
+ public void add(Object command) {
+ commandObjects.add(command);
+ }
+ });
+
+ List> methods = new ArrayList<>();
+ for (Object commandObject : commandObjects) {
+ DataImpl dataImpl = new DataImpl(this, commandObject, rootNode, EXECUTOR_MAPPER.getOrDefault(this.getClass(), Collections.emptyMap()), (Map) localTypeMapper, CommandUtils.MAPPER_FUNCTIONS, (Map) localValidators, CommandUtils.VALIDATOR_FUNCTIONS, (Map) localSupplier, CommandUtils.SUPPLIER_FUNCTIONS);
+ methods(commandObject).stream()
+ .filter(method -> Arrays.stream(method.getAnnotations()).anyMatch(anno -> anno.annotationType().isAnnotationPresent(Handler.Implementation.class)))
+ .forEach(method -> methods.add(new Pair<>(dataImpl, method)));
+ }
+
+ Map, List>>> handlerMap = new HashMap<>();
+ for (Pair commandMethod : methods) {
+ List annotations = CommandUtils.getAnnotations(commandMethod.b);
+ for (Annotation annotation : annotations) {
+ Handler.Implementation handler = annotation.annotationType().getAnnotation(Handler.Implementation.class);
+ Handler handlerObject;
+ try {
+ handlerObject = handler.value().getConstructor().newInstance();
+ } catch (NoSuchMethodException | InstantiationException | IllegalAccessException |
+ InvocationTargetException e) {
+ throw new UnsupportedOperationException("Handler " + handler.value().getName() + " cannot be used to check the argument validity", e);
+ }
+ if (!(handlerObject instanceof Handler.HandlerMethod)) {
+ throw new UnsupportedOperationException("Handler " + handlerObject.getClass().getName() + " is not a HandlerMethod");
+ }
+ handlerMap.computeIfAbsent(((Handler.HandlerMethod>) handlerObject).getRunPriority(), k -> new LinkedHashMap<>())
+ .computeIfAbsent(new Triple<>(commandMethod.a, commandMethod.b, annotation), k -> new ArrayList<>())
+ .add((Handler.HandlerMethod) handlerObject);
+ }
+ }
+
+ List runPriorities = new ArrayList<>(handlerMap.keySet());
+ runPriorities.sort(Comparator.naturalOrder());
+ for (int runPriority : runPriorities) {
+ handlerMap.get(runPriority).forEach((dataMethodAnnotationTriple, handlerMethods) -> {
+ handlerMethods.forEach(annotationHandlerMethod -> {
+ try {
+ annotationHandlerMethod.check(dataMethodAnnotationTriple.c, dataMethodAnnotationTriple.b, dataMethodAnnotationTriple.a);
+ } catch (Exception e) {
+ throw new UnsupportedOperationException("Method check failed for " + dataMethodAnnotationTriple.b.getName(), e);
+ }
+ annotationHandlerMethod.run(dataMethodAnnotationTriple.c, dataMethodAnnotationTriple.b, dataMethodAnnotationTriple.a);
+ });
+ });
+ }
+ rootNode.sort();
+ initialized = true;
+ }
+
+ // TODO: Implement this when Message System is ready
+ /*
+ public void addDefaultHelpMessage(String message) {
+ defaultHelpMessages.add(message);
+ }
+ */
+
+ private List methods(Object commandObject) {
+ List methods = new ArrayList<>();
+ Class> current = commandObject.getClass();
+ while (current != null) {
+ methods.addAll(Arrays.asList(current.getDeclaredMethods()));
+ current = current.getSuperclass();
+ }
+ return methods;
+ }
+}
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/AbstractTypeMapper.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/AbstractTypeMapper.java
new file mode 100644
index 00000000..a9076eb1
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/AbstractTypeMapper.java
@@ -0,0 +1,48 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2020 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command;
+
+import java.util.Collection;
+
+public interface AbstractTypeMapper {
+
+ /**
+ * The CommandSender can be null!
+ */
+ T map(K sender, PreviousArguments previousArguments, String s);
+
+ Collection tabComplete(K sender, PreviousArguments previousArguments, String s);
+
+ /**
+ * @return true if the next element should be appended to the current tab complete.
+ */
+ default boolean appendNextElementTabCompletions() {
+ return false;
+ }
+
+ /**
+ * Normalize the cache key by sender and user provided argument.
+ * Note: The CommandSender can be null if the cache is defined as a global cache!
+ * Returning null and the empty string are equivalent.
+ */
+ default String normalize(K sender, String s) {
+ return null;
+ }
+}
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/AbstractTypeSupplier.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/AbstractTypeSupplier.java
new file mode 100644
index 00000000..b648a884
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/AbstractTypeSupplier.java
@@ -0,0 +1,25 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2023 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command;
+
+public interface AbstractTypeSupplier {
+
+ T get(K sender, PreviousArguments previousArguments);
+}
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/AbstractTypeValidator.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/AbstractTypeValidator.java
new file mode 100644
index 00000000..cb9de530
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/AbstractTypeValidator.java
@@ -0,0 +1,62 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2022 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command;
+
+import java.util.function.BooleanSupplier;
+
+@FunctionalInterface
+public interface AbstractTypeValidator {
+
+ /**
+ * Validates the given value.
+ *
+ * @param sender The sender of the command.
+ * @param value The value to validate or null if mapping returned null.
+ * @param messageSender The message sender to send messages to the player. Never send messages directly to the player.
+ * @return The result of the validation.
+ */
+ boolean validate(K sender, T value, MessageSender messageSender);
+
+ default AbstractTypeValidator and(AbstractTypeValidator other) {
+ return (sender, value, messageSender) -> validate(sender, value, messageSender) && other.validate(sender, value, messageSender);
+ }
+
+ default AbstractTypeValidator or(AbstractTypeValidator other) {
+ return (sender, value, messageSender) -> validate(sender, value, messageSender) || other.validate(sender, value, messageSender);
+ }
+
+ default AbstractTypeValidator not() {
+ return (sender, value, messageSender) -> !validate(sender, value, messageSender);
+ }
+
+ @FunctionalInterface
+ interface MessageSender {
+ void send(String s, Object... args);
+
+ default boolean send(boolean condition, String s, Object... args) {
+ if (condition) send(s, args);
+ return condition;
+ }
+
+ default boolean send(BooleanSupplier condition, String s, Object... args) {
+ return send(condition.getAsBoolean(), s, args);
+ }
+ }
+}
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/CommandFrameworkException.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/CommandFrameworkException.java
new file mode 100644
index 00000000..cf8e7ee3
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/CommandFrameworkException.java
@@ -0,0 +1,93 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2020 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command;
+
+import java.io.PrintStream;
+import java.io.PrintWriter;
+import java.lang.reflect.InvocationTargetException;
+import java.util.Arrays;
+import java.util.function.Function;
+import java.util.stream.Stream;
+
+public class CommandFrameworkException extends RuntimeException {
+
+ private Function causeMessage;
+ private Throwable cause;
+ private Function stackTraceExtractor;
+ private String extraStackTraces;
+
+ private String message;
+
+ public CommandFrameworkException(InvocationTargetException invocationTargetException, String alias, String[] args) {
+ this(e -> {
+ StringBuilder st = new StringBuilder();
+ st.append(e.getCause().getClass().getTypeName());
+ if (e.getCause().getMessage() != null) {
+ st.append(": ").append(e.getCause().getMessage());
+ }
+ if (alias != null && !alias.isEmpty()) {
+ st.append("\n").append("Performed command: " + alias + " " + String.join(" ", args));
+ }
+ return st.toString();
+ }, invocationTargetException, e -> {
+ StackTraceElement[] stackTraceElements = e.getCause().getStackTrace();
+ return Arrays.stream(stackTraceElements).limit(stackTraceElements.length - e.getStackTrace().length);
+ }, null);
+ }
+
+ private CommandFrameworkException(Function causeMessage, T cause, Function> stackTraceExtractor, String extraStackTraces) {
+ super(causeMessage.apply(cause), cause);
+ this.causeMessage = causeMessage;
+ this.cause = cause;
+ this.stackTraceExtractor = stackTraceExtractor;
+ this.extraStackTraces = extraStackTraces;
+ }
+
+ public synchronized String getBuildStackTrace() {
+ if (message != null) {
+ return message;
+ }
+ StringBuilder st = new StringBuilder();
+ st.append(causeMessage.apply(cause)).append("\n");
+ ((Stream) stackTraceExtractor.apply(cause)).forEach(stackTraceElement -> {
+ st.append("\tat ").append(stackTraceElement.toString()).append("\n");
+ });
+ if (extraStackTraces != null) {
+ st.append("\tat ").append(extraStackTraces).append("\n");
+ }
+ message = st.toString();
+ return message;
+ }
+
+ @Override
+ public void printStackTrace() {
+ printStackTrace(System.err);
+ }
+
+ @Override
+ public void printStackTrace(PrintStream s) {
+ s.print(getBuildStackTrace());
+ }
+
+ @Override
+ public void printStackTrace(PrintWriter s) {
+ s.print(getBuildStackTrace());
+ }
+}
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/CommandLoader.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/CommandLoader.java
new file mode 100644
index 00000000..b937eba6
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/CommandLoader.java
@@ -0,0 +1,26 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2023 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command;
+
+public interface CommandLoader {
+
+ AbstractCommand get();
+ void add(Object command);
+}
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/CommandUtils.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/CommandUtils.java
new file mode 100644
index 00000000..be9dc2e0
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/CommandUtils.java
@@ -0,0 +1,148 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2020 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command;
+
+import de.steamwar.command.mapper.BooleanMapper;
+import de.steamwar.command.mapper.NumberMapper;
+import lombok.experimental.UtilityClass;
+
+import java.lang.annotation.Annotation;
+import java.lang.annotation.Repeatable;
+import java.lang.reflect.AnnotatedElement;
+import java.lang.reflect.Method;
+import java.util.*;
+import java.util.function.ToIntFunction;
+
+@UtilityClass
+public class CommandUtils {
+
+ final Map> MAPPER_FUNCTIONS = new HashMap<>();
+
+ final Map> VALIDATOR_FUNCTIONS = new HashMap<>();
+
+ final Map> SUPPLIER_FUNCTIONS = new HashMap<>();
+
+ static final AbstractTypeMapper STRING_MAPPER = new AbstractTypeMapper<>() {
+ @Override
+ public String map(Object sender, PreviousArguments previousArguments, String s) {
+ return s;
+ }
+
+ @Override
+ public Collection tabComplete(Object sender, PreviousArguments previousArguments, String s) {
+ return Collections.singletonList(s);
+ }
+ };
+
+ static {
+ addMapper(boolean.class, Boolean.class, new BooleanMapper());
+ addMapper(int.class, Integer.class, new NumberMapper(Integer::parseInt, false));
+ addMapper(long.class, Long.class, new NumberMapper(Long::parseLong, false));
+ addMapper(float.class, Float.class, new NumberMapper(Float::parseFloat, true));
+ addMapper(double.class, Double.class, new NumberMapper(Double::parseDouble, true));
+ MAPPER_FUNCTIONS.put(String.class.getTypeName(), STRING_MAPPER);
+ }
+
+ private static void addMapper(Class> clazz, Class> alternativeClazz, AbstractTypeMapper, ?> mapper) {
+ MAPPER_FUNCTIONS.put(clazz.getTypeName(), mapper);
+ MAPPER_FUNCTIONS.put(alternativeClazz.getTypeName(), mapper);
+ }
+
+ public static void addMapper(Class clazz, AbstractTypeMapper mapper) {
+ addMapper(clazz.getTypeName(), mapper);
+ }
+
+ public static void addMapper(String name, AbstractTypeMapper mapper) {
+ MAPPER_FUNCTIONS.putIfAbsent(name, mapper);
+ }
+
+ public static void addValidator(Class clazz, AbstractTypeValidator validator) {
+ addValidator(clazz.getTypeName(), validator);
+ }
+
+ public static void addValidator(String name, AbstractTypeValidator validator) {
+ VALIDATOR_FUNCTIONS.putIfAbsent(name, validator);
+ }
+
+ public static void addSupplier(Class clazz, AbstractTypeSupplier supplier) {
+ addSupplier(clazz.getTypeName(), supplier);
+ }
+
+ public static void addSupplier(String name, AbstractTypeSupplier supplier) {
+ SUPPLIER_FUNCTIONS.putIfAbsent(name, supplier);
+ }
+
+ public static List getAnnotations(AnnotatedElement annotatedElement) {
+ List annotationList = new ArrayList<>();
+ for (Annotation annotation : annotatedElement.getAnnotations()) {
+ try {
+ Method method = annotation.annotationType().getMethod("value");
+ Class> returnType = method.getReturnType();
+ if (!returnType.isArray()) {
+ annotationList.add(annotation);
+ continue;
+ }
+ Class> innerReturnType = returnType.getComponentType();
+ if (!(innerReturnType.isAnnotation() && innerReturnType.isAnnotationPresent(Repeatable.class))) {
+ annotationList.add(annotation);
+ continue;
+ }
+ Repeatable repeatable = innerReturnType.getAnnotation(Repeatable.class);
+ Class extends Annotation> containerType = repeatable.value();
+ if (containerType == returnType) {
+ throw new UnsupportedOperationException("Repeatable annotation must have a container annotation");
+ }
+ try {
+ Annotation[] innerAnnotations = (Annotation[]) method.invoke(annotation);
+ Collections.addAll(annotationList, innerAnnotations);
+ } catch (Exception e) {
+ annotationList.add(annotation);
+ }
+ } catch (NoSuchMethodException e) {
+ annotationList.add(annotation);
+ }
+ }
+ annotationList.removeIf(anno -> !anno.annotationType().isAnnotationPresent(Handler.Implementation.class));
+ return annotationList;
+ }
+
+ public static List getAnnotations(AnnotatedElement annotatedElement, Class type) {
+ List annotations = getAnnotations(annotatedElement);
+ annotations.removeIf(annotation -> {
+ Handler.Implementation implementation = annotation.annotationType().getAnnotation(Handler.Implementation.class);
+ return implementation == null || !type.isAssignableFrom(implementation.value());
+ });
+ return annotations;
+ }
+
+ public static ToIntFunction createComparator(String type, Class> clazz, int iValue, long lValue, float fValue, double dValue) {
+ if (clazz == int.class || clazz == Integer.class) {
+ return number -> Integer.compare(number.intValue(), iValue);
+ } else if (clazz == long.class || clazz == Long.class) {
+ return number -> Long.compare(number.longValue(), lValue);
+ } else if (clazz == float.class || clazz == Float.class) {
+ return number -> Float.compare(number.floatValue(), fValue);
+ } else if (clazz == double.class || clazz == Double.class) {
+ return number -> Double.compare(number.doubleValue(), dValue);
+ } else {
+ throw new IllegalArgumentException(type + " annotation is not supported for " + clazz);
+ }
+ }
+}
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/DataImpl.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/DataImpl.java
new file mode 100644
index 00000000..ba0d8800
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/DataImpl.java
@@ -0,0 +1,186 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2023 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command;
+
+import de.steamwar.command.annotations.Supplier;
+import de.steamwar.command.graph.*;
+import de.steamwar.command.handler.GreedyHandler;
+
+import java.lang.reflect.InvocationTargetException;
+import java.lang.reflect.Method;
+import java.lang.reflect.Parameter;
+import java.util.Arrays;
+import java.util.HashMap;
+import java.util.Map;
+import java.util.function.Function;
+
+class DataImpl implements Handler.DataCheckable, Handler.DataReadable, Handler.DataWritable {
+
+ private final AbstractCommand> container;
+ private final Object self;
+ private final RootNode> node;
+ private final Map, Function, ?>> executorMapper;
+ private final Map> mapper;
+ private final Map> globalMapper;
+ private final Map> validator;
+ private final Map> globalValidator;
+ private final Map> supplier;
+ private final Map> globalSupplier;
+
+ private final Map cache = new HashMap<>();
+
+ DataImpl(AbstractCommand> container, Object self, RootNode> node, Map, Function, ?>> executorMapper, Map> mapper, Map> globalMapper, Map> validator, Map> globalValidator, Map> supplier, Map> globalSupplier) {
+ this.container = container;
+ this.self = self;
+ this.node = node;
+ this.executorMapper = executorMapper;
+ this.mapper = mapper;
+ this.globalMapper = globalMapper;
+ this.validator = validator;
+ this.globalValidator = globalValidator;
+ this.supplier = supplier;
+ this.globalSupplier = globalSupplier;
+ }
+
+ @Override
+ public boolean hasExecutorMapper(Class> clazz) {
+ return getExecutorMapper(clazz) != null;
+ }
+
+ @Override
+ public Function, ?> getExecutorMapper(Class> clazz) {
+ for (Map.Entry, Function, ?>> entry : executorMapper.entrySet()) {
+ if (entry.getKey().isAssignableFrom(clazz)) {
+ return entry.getValue();
+ }
+ }
+ return null;
+ }
+
+ @Override
+ public boolean hasMapper(String key) {
+ return mapper.containsKey(key) || globalMapper.containsKey(key);
+ }
+
+ @Override
+ public AbstractTypeMapper getMapper(String key) {
+ return (AbstractTypeMapper ) mapper.getOrDefault(key, globalMapper.get(key));
+ }
+
+ @Override
+ public void addMapper(String key, boolean local, AbstractTypeMapper mapper) {
+ if (local) {
+ this.mapper.put(key, mapper);
+ } else {
+ this.globalMapper.putIfAbsent(key, mapper);
+ }
+ }
+
+ @Override
+ public boolean hasValidator(String key) {
+ return validator.containsKey(key) || globalValidator.containsKey(key);
+ }
+
+ @Override
+ public AbstractTypeValidator getValidator(String key) {
+ return (AbstractTypeValidator ) validator.getOrDefault(key, globalValidator.get(key));
+ }
+
+ @Override
+ public void addValidator(String key, boolean local, AbstractTypeValidator validator) {
+ if (local) {
+ this.validator.put(key, validator);
+ } else {
+ this.globalValidator.putIfAbsent(key, validator);
+ }
+ }
+
+ @Override
+ public boolean hasSupplier(String key) {
+ return supplier.containsKey(key) || globalSupplier.containsKey(key);
+ }
+
+ @Override
+ public AbstractTypeSupplier getSupplier(String key) {
+ return (AbstractTypeSupplier ) supplier.getOrDefault(key, globalSupplier.get(key));
+ }
+
+ @Override
+ public void addSupplier(String key, boolean local, AbstractTypeSupplier supplier) {
+ if (local) {
+ this.supplier.put(key, supplier);
+ } else {
+ this.globalSupplier.putIfAbsent(key, supplier);
+ }
+ }
+
+ /**
+ * Invoking the same method twice will result in the exact same result.
+ */
+ @Override
+ public T invoke(Method method) {
+ return (T) cache.computeIfAbsent(method, m -> {
+ try {
+ return m.invoke(self);
+ } catch (IllegalAccessException | InvocationTargetException e) {
+ return null;
+ } catch (Exception e) {
+ throw new RuntimeException(e);
+ }
+ });
+ }
+
+ @Override
+ public void addCommand(Method method, String[] subCommand, String[] description, boolean noTabComplete) {
+ Node> temp = node;
+ container.descriptions.addAll(Arrays.asList(description));
+ if (noTabComplete) {
+ temp = temp.addChild(null, new NoTabCompleteNode<>());
+ }
+ for (int i = 0; i < subCommand.length; i++) {
+ temp = temp.addChild(null, new LiteralNode<>(subCommand[i]));
+ }
+ Parameter[] parameters = method.getParameters();
+ for (int i = 0; i < parameters.length; i++) {
+ Parameter parameter = parameters[i];
+ if (i == 0) {
+ temp = temp.addChild(parameter, new ExecutorTypeNode<>(parameter, i, this));
+ continue;
+ }
+ if (parameter.isAnnotationPresent(Supplier.class)) {
+ temp = temp.addChild(parameter, new SupplierNode<>(parameter, this));
+ continue;
+ }
+ Class> type = parameter.getType();
+ boolean isArray = parameter.isVarArgs() || type.isArray();
+ if (!isArray) {
+ temp = temp.addChild(parameter, new TypeNode<>(parameter, i, this));
+ continue;
+ }
+ boolean greedy = parameter.isVarArgs() || GreedyHandler.isGreedy(parameter);
+ if (greedy) {
+ temp = temp.addChild(parameter, new GreedyArrayNode<>(parameter, i, this));
+ } else {
+ temp = temp.addChild(parameter, new NonGreedyArrayNode<>(parameter, i, this));
+ }
+ }
+ temp.addChild(null, new ExecuteNode<>(self, method));
+ }
+}
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/Handler.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/Handler.java
new file mode 100644
index 00000000..667c0375
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/Handler.java
@@ -0,0 +1,121 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2023 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command;
+
+import java.lang.annotation.*;
+import java.lang.reflect.Method;
+import java.lang.reflect.Parameter;
+import java.lang.reflect.ParameterizedType;
+import java.lang.reflect.Type;
+import java.util.Optional;
+import java.util.function.Function;
+
+public interface Handler {
+
+ default Optional> getGenericTypeOfReturn(Method method) {
+ Type type;
+ try {
+ type = method.getGenericReturnType();
+ } catch (Exception e) {
+ return Optional.empty();
+ }
+ if (!(type instanceof ParameterizedType)) {
+ return Optional.empty();
+ }
+ ParameterizedType parameterizedType = (ParameterizedType) type;
+ Type[] generics = parameterizedType.getActualTypeArguments();
+ if (generics.length != 1 && generics.length != 2) {
+ return Optional.empty();
+ }
+ Type genericType = generics[generics.length - 1];
+ try {
+ return Optional.of(Class.forName(genericType.getTypeName()));
+ } catch (Exception e) {
+ return Optional.empty();
+ }
+ }
+
+ @Retention(RetentionPolicy.RUNTIME)
+ @Target(ElementType.ANNOTATION_TYPE)
+ @interface Implementation {
+ Class extends Handler> value();
+ }
+
+ interface DataCheckable {
+ boolean hasExecutorMapper(Class> clazz);
+ boolean hasMapper(String key);
+ boolean hasValidator(String key);
+ boolean hasSupplier(String key);
+ }
+
+ interface DataReadable {
+ Function, ?> getExecutorMapper(Class> clazz);
+ AbstractTypeMapper getMapper(String key);
+ AbstractTypeValidator getValidator(String key);
+ AbstractTypeSupplier getSupplier(String key);
+ }
+
+ interface DataWritable {
+ Function, ?> getExecutorMapper(Class> clazz);
+
+ void addMapper(String key, boolean local, AbstractTypeMapper mapper);
+ void addValidator(String key, boolean local, AbstractTypeValidator validator);
+ void addSupplier(String key, boolean local, AbstractTypeSupplier supplier);
+ /**
+ * Invoking the same method twice will result in the exact same result.
+ */
+ T invoke(Method method);
+ void addCommand(Method method, String[] subCommand, String[] description, boolean noTabComplete);
+ }
+
+ interface HandlerMethod extends Handler {
+ void check(T annotation, Method method, DataCheckable dataCheckable) throws Exception;
+
+ int getRunPriority();
+
+ void run(T annotation, Method method, DataWritable dataWritable);
+ }
+
+ interface HandlerParameter extends Handler {
+ void check(T annotation, Parameter parameter, int index, DataCheckable dataCheckable) throws Exception;
+
+ default boolean needsParentTypeMapper() {
+ return false;
+ }
+
+ /**
+ * Null values are allowed to be returned.
+ */
+ default AbstractTypeMapper getTypeMapper(T annotation, Parameter parameter, int index, DataReadable dataReadable, AbstractTypeMapper parentTypeMapper) {
+ return null;
+ }
+
+ default int getValidatorPriority() {
+ return 0;
+ }
+
+ /**
+ * Null values are allowed to be returned.
+ */
+ default AbstractTypeValidator getValidator(T annotation, Parameter parameter, int index, DataReadable dataReadable) {
+ return null;
+ }
+ }
+}
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/OptionEnum.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/OptionEnum.java
new file mode 100644
index 00000000..69c6b1b8
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/OptionEnum.java
@@ -0,0 +1,30 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2023 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command;
+
+import java.util.Arrays;
+import java.util.List;
+
+public interface OptionEnum & OptionEnum> {
+ default List getTabCompletes() {
+ return Arrays.asList("-" + ((T) this).name().toLowerCase());
+ }
+ T[] getRemoved();
+}
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/PreviousArguments.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/PreviousArguments.java
new file mode 100644
index 00000000..6458c6c1
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/PreviousArguments.java
@@ -0,0 +1,96 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2022 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command;
+
+import lombok.NonNull;
+
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Optional;
+import java.util.function.Function;
+
+public class PreviousArguments {
+
+ public final String[] userArgs;
+ public final Object[] mappedArgs;
+ public final boolean hasMoreArguments;
+ private final Function getByNameFunction;
+ private boolean usedOptionalValue = false;
+
+ public PreviousArguments(String[] userArgs, Object[] mappedArgs, boolean hasMoreArguments, Function getByNameFunction) {
+ this.userArgs = userArgs;
+ this.mappedArgs = mappedArgs;
+ this.hasMoreArguments = hasMoreArguments;
+ this.getByNameFunction = getByNameFunction;
+ }
+
+ public boolean hasUsedOptionalValue() {
+ return usedOptionalValue;
+ }
+
+ public void usedOptionalValue() {
+ this.usedOptionalValue = true;
+ }
+
+ public String getUserArg(int index) {
+ return userArgs[userArgs.length - index - 1];
+ }
+
+ public T getMappedArg(int index) {
+ return (T) mappedArgs[mappedArgs.length - index - 1];
+ }
+
+ public Optional getFirst(Class clazz) {
+ for (Object o : mappedArgs) {
+ if (clazz.isInstance(o)) {
+ return Optional.of((T) o);
+ }
+ }
+ return Optional.empty();
+ }
+
+ public List getAll(Class clazz) {
+ List list = new ArrayList<>();
+ for (Object o : mappedArgs) {
+ if (clazz.isInstance(o)) {
+ list.add((T) o);
+ }
+ if (o == null) {
+ continue;
+ }
+ if (o.getClass().isArray()) {
+ Object[] array = (Object[]) o;
+ if (array.length == 0) {
+ continue;
+ }
+ for (Object o1 : array) {
+ if (clazz.isInstance(o1)) {
+ list.add((T) o1);
+ }
+ }
+ }
+ }
+ return list;
+ }
+
+ public T getByName(@NonNull String name) {
+ return (T) getByNameFunction.apply(name);
+ }
+}
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/TabCompletionCache.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/TabCompletionCache.java
new file mode 100644
index 00000000..231b5116
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/TabCompletionCache.java
@@ -0,0 +1,109 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2020 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command;
+
+import de.steamwar.command.mapper.internal.DelegatingMapper;
+import lombok.AllArgsConstructor;
+import lombok.EqualsAndHashCode;
+import lombok.experimental.UtilityClass;
+
+import java.util.*;
+import java.util.concurrent.ConcurrentHashMap;
+import java.util.concurrent.TimeUnit;
+
+@UtilityClass
+public class TabCompletionCache {
+
+ private final Map tabCompletionCache = new ConcurrentHashMap<>();
+
+ Set> cached = new HashSet<>();
+ Set> global = new HashSet<>();
+ Map, Long> cacheDuration = new HashMap<>();
+
+ static {
+ Thread thread = new Thread(() -> {
+ while (true) {
+ Set toRemove = new HashSet<>();
+ for (Map.Entry tabCompletionsEntry : tabCompletionCache.entrySet()) {
+ if (System.currentTimeMillis() - tabCompletionsEntry.getValue().timestamp > cacheDuration.get(tabCompletionsEntry.getKey().typeMapper)) {
+ toRemove.add(tabCompletionsEntry.getKey());
+ }
+ }
+ for (Key key : toRemove) {
+ tabCompletionCache.remove(key);
+ }
+
+ try {
+ Thread.sleep(1000);
+ } catch (InterruptedException e) {
+ Thread.currentThread().interrupt();
+ }
+ }
+ });
+ thread.setName("TabCompletionCache Invalidator");
+ thread.setDaemon(true);
+ thread.start();
+ }
+
+ public void add(AbstractTypeMapper, ?> typeMapper, boolean global, long cacheDuration, TimeUnit timeUnit) {
+ TabCompletionCache.cached.add(typeMapper);
+ if (global) TabCompletionCache.global.add(typeMapper);
+ TabCompletionCache.cacheDuration.put(typeMapper, timeUnit.toMillis(cacheDuration));
+ }
+
+ public AbstractTypeMapper cached(AbstractTypeMapper dataMapper, AbstractTypeMapper toBeCached) {
+ if (!cached.contains(dataMapper)) return toBeCached;
+ boolean global = TabCompletionCache.global.contains(dataMapper);
+ long cacheDuration = TabCompletionCache.cacheDuration.get(dataMapper);
+
+ return new DelegatingMapper<>(toBeCached, null) {
+ @Override
+ public Collection tabComplete(A sender, PreviousArguments previousArguments, String s) {
+ String normalizedArg = dataMapper.normalize(global ? null : sender, s);
+ if (normalizedArg == null) normalizedArg = "";
+ Key key = new Key(global ? null : sender, normalizedArg, dataMapper);
+
+ TabCompletions tabCompletions = tabCompletionCache.computeIfAbsent(key, ignore -> {
+ return new TabCompletions(System.currentTimeMillis(), toBeCached.tabComplete(sender, previousArguments, s));
+ });
+
+ if (System.currentTimeMillis() - tabCompletions.timestamp > cacheDuration) {
+ tabCompletions.tabCompletions = toBeCached.tabComplete(sender, previousArguments, s);
+ }
+ tabCompletions.timestamp = System.currentTimeMillis();
+ return tabCompletions.tabCompletions;
+ }
+ };
+ }
+
+ @EqualsAndHashCode
+ @AllArgsConstructor
+ private static class Key {
+ private Object sender;
+ private String arg;
+ private AbstractTypeMapper, ?> typeMapper;
+ }
+
+ @AllArgsConstructor
+ private static class TabCompletions {
+ private long timestamp;
+ private Collection tabCompletions;
+ }
+}
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/AllowNull.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/AllowNull.java
new file mode 100644
index 00000000..944b96e8
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/AllowNull.java
@@ -0,0 +1,37 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2023 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command.annotations;
+
+import de.steamwar.command.Handler;
+import de.steamwar.command.handler.AllowNullHandler;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * This annotation is used to allow null values passed to the command.
+ */
+@Retention(RetentionPolicy.RUNTIME)
+@Target({ElementType.PARAMETER})
+@Handler.Implementation(AllowNullHandler.Impl.class)
+public @interface AllowNull {
+}
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/ArrayLength.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/ArrayLength.java
new file mode 100644
index 00000000..3398f695
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/ArrayLength.java
@@ -0,0 +1,53 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2023 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command.annotations;
+
+import de.steamwar.command.Handler;
+import de.steamwar.command.handler.ArrayLengthHandler;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * This annotation is used to define a minimum and maximum length the supplied array can have.
+ */
+@Retention(RetentionPolicy.RUNTIME)
+@Target({ElementType.PARAMETER})
+@Handler.Implementation(ArrayLengthHandler.Impl.class)
+public @interface ArrayLength {
+ /**
+ * Inclusive
+ */
+ int min() default 0;
+
+ /**
+ * Inclusive
+ */
+ int max() default Integer.MAX_VALUE;
+
+ /**
+ * Error message if too few Elements got parsed. There are 2 arguments provided to the message.
+ * The first is the number of elements that got parsed as a number and the second one is how many
+ * should have been parsed, so the min number of elements expected.
+ */
+ String error() default "";
+}
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/Cached.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/Cached.java
new file mode 100644
index 00000000..d0940384
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/Cached.java
@@ -0,0 +1,52 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2023 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command.annotations;
+
+import de.steamwar.command.AbstractTypeMapper;
+import de.steamwar.command.Handler;
+import de.steamwar.command.handler.CachedHandler;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+import java.util.concurrent.TimeUnit;
+
+/**
+ * This annotation is used to register a or {@link Mapper}
+ * on registration as being cached. Only TabCompletions are cached for the duration
+ * denoted by {@link #timeUnit()} and {@link #cacheDuration()} using
+ * {@link TimeUnit#toMillis(long)}. If {@link #global()} is {@code true}, the
+ * cache will not be created per player but for everyone. This is useful for
+ * commands that are not player specific.
+ *
+ * To calculate the cache key for a {@link AbstractTypeMapper} the
+ * {@link AbstractTypeMapper#normalize(Object, String)} method is called.
+ */
+@Retention(RetentionPolicy.RUNTIME)
+@Target({ElementType.METHOD})
+@Handler.Implementation(CachedHandler.Impl.class)
+public @interface Cached {
+ long cacheDuration() default 5;
+
+ TimeUnit timeUnit() default TimeUnit.SECONDS;
+
+ boolean global() default false;
+}
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/ClassMapper.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/ClassMapper.java
new file mode 100644
index 00000000..3743b24d
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/ClassMapper.java
@@ -0,0 +1,56 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2023 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command.annotations;
+
+import de.steamwar.command.AbstractTypeMapper;
+import de.steamwar.command.Handler;
+import de.steamwar.command.handler.ClassMapperHandler;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * Annotation for registering a method as a class mapper.
+ * The annotated method will be executed while {@link #initialize()}
+ * is evaluated. The result of this method will be cached under the
+ * name {@link ClassMapper#value()} converted to a {@link String} using
+ * {@link Class#getTypeName()}. {@link AbstractTypeMapper} will be used
+ * as the default mapper if the type this mapper is registered for is
+ * found as a parameter of any command method annotated with {@link Register}.
+ */
+@Retention(RetentionPolicy.RUNTIME)
+@Target({ElementType.METHOD})
+@Handler.Implementation(ClassMapperHandler.Impl.class)
+@Deprecated
+@DeprecationInfo("Use @Mapper instead")
+public @interface ClassMapper {
+
+ /**
+ * The type this mapper is registered for.
+ */
+ Class> value();
+
+ /**
+ * If {@code true}, the mapper will only be used in the current command class.
+ */
+ boolean local() default true;
+}
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/ClassValidator.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/ClassValidator.java
new file mode 100644
index 00000000..86fc23a4
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/ClassValidator.java
@@ -0,0 +1,53 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2023 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command.annotations;
+
+import de.steamwar.command.Handler;
+import de.steamwar.command.handler.ClassValidatorHandler;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * Annotation for registering a method as a class validator.
+ * The annotated method will be executed while {@link #initialize()}
+ * is evaluated. The result of this method will be cached under the
+ * name {@link ClassValidator#value()} converted to a {@link String} using
+ * {@link Class#getTypeName()}.
+ */
+@Retention(RetentionPolicy.RUNTIME)
+@Target({ElementType.METHOD})
+@Handler.Implementation(ClassValidatorHandler.Impl.class)
+@Deprecated
+@DeprecationInfo("Use @Validator instead")
+public @interface ClassValidator {
+
+ /**
+ * The type this validator is registered for.
+ */
+ Class> value();
+
+ /**
+ * If {@code true}, the validator will only be used in the current command class.
+ */
+ boolean local() default true;
+}
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/DeprecationInfo.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/DeprecationInfo.java
new file mode 100644
index 00000000..9877b162
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/DeprecationInfo.java
@@ -0,0 +1,28 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2023 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command.annotations;
+
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+
+@Retention(RetentionPolicy.RUNTIME)
+public @interface DeprecationInfo {
+ String value();
+}
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/EndsWith.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/EndsWith.java
new file mode 100644
index 00000000..5537359d
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/EndsWith.java
@@ -0,0 +1,38 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2023 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command.annotations;
+
+import de.steamwar.command.Handler;
+import de.steamwar.command.handler.EndsWithHandler;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+@Retention(RetentionPolicy.RUNTIME)
+@Target({ElementType.PARAMETER})
+@Handler.Implementation(EndsWithHandler.Impl.class)
+public @interface EndsWith {
+
+ String value();
+
+ String error() default "";
+}
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/ErrorMessage.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/ErrorMessage.java
new file mode 100644
index 00000000..6d77133e
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/ErrorMessage.java
@@ -0,0 +1,48 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2023 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command.annotations;
+
+import de.steamwar.command.Handler;
+import de.steamwar.command.handler.ErrorMessageHandler;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * This annotation is used to define an error message for a parameter.
+ */
+@Retention(RetentionPolicy.RUNTIME)
+@Target({ElementType.PARAMETER})
+@Handler.Implementation(ErrorMessageHandler.Impl.class)
+public @interface ErrorMessage {
+ /**
+ * Error message to be displayed when the parameter is invalid.
+ */
+ String value();
+
+ /**
+ * This is the short form for 'allowEmptyArrays'.
+ */
+ @Deprecated
+ @DeprecationInfo("Use @ArrayLength instead of this flag")
+ boolean allowEAs() default true;
+}
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/Greedy.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/Greedy.java
new file mode 100644
index 00000000..59102376
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/Greedy.java
@@ -0,0 +1,46 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2023 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command.annotations;
+
+import de.steamwar.command.Handler;
+import de.steamwar.command.handler.GreedyHandler;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * This annotation can have a huge performance impact. Both positive and negative.
+ * You can design your command to be more flexible and allow performance improvements if used correctly.
+ *
+ * The more restrictive the underlying array type is, the more performance can be gained.
+ *
+ * Using this annotation on the varargs parameter of a command will not have any effect, since they are already treated as greedy arrays.
+ *
+ * The {@link #backTrackingDepth()} can be used to limit the amount of backtracking that is done. This can be used to improve performance.
+ * For varargs parameters, this value is defaulted to 0, since they are at the end of the parameter list.
+ */
+@Retention(RetentionPolicy.RUNTIME)
+@Target({ElementType.PARAMETER})
+@Handler.Implementation(GreedyHandler.Impl.class)
+public @interface Greedy {
+ int backTrackingDepth() default Integer.MAX_VALUE;
+}
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/Length.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/Length.java
new file mode 100644
index 00000000..f48d9265
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/Length.java
@@ -0,0 +1,46 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2023 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command.annotations;
+
+import de.steamwar.command.Handler;
+import de.steamwar.command.handler.LengthHandler;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * This annotation is used to define a minimum and maximum length the supplied string can have.
+ */
+@Retention(RetentionPolicy.RUNTIME)
+@Target({ElementType.PARAMETER})
+@Handler.Implementation(LengthHandler.Impl.class)
+public @interface Length {
+ /**
+ * Inclusive
+ */
+ int min() default 0;
+
+ /**
+ * Inclusive
+ */
+ int max() default Integer.MAX_VALUE;
+}
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/Mapper.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/Mapper.java
new file mode 100644
index 00000000..0fd84fa5
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/Mapper.java
@@ -0,0 +1,58 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2023 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command.annotations;
+
+import de.steamwar.command.AbstractTypeMapper;
+import de.steamwar.command.Handler;
+import de.steamwar.command.handler.MapperHandler;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * Annotation for registering a method as a mapper. The annotated method will
+ * be executed while {@link #initialize()} is evaluated. The result of this
+ * method will be cached under either {@link Mapper#value()} or {@link Mapper#value()}.
+ * If {@link Mapper#type()} is used any parameter using that type will be using
+ * this {@link AbstractTypeMapper} implicitly. While using this annotation on
+ * a method it can be possible to not supply any type. On a parameter you can
+ * only use this annotation using the {@link Mapper#value()} value.
+ */
+@Retention(RetentionPolicy.RUNTIME)
+@Target({ElementType.PARAMETER, ElementType.METHOD})
+@Handler.Implementation(MapperHandler.Impl.class)
+public @interface Mapper {
+ /**
+ * The name this mapper is registered for.
+ */
+ String value() default "";
+
+ /**
+ * The type this mapper is registered for.
+ */
+ Class> type() default void.class;
+
+ /**
+ * If {@code true}, the mapper will only be used in the current command class.
+ */
+ boolean local() default true;
+}
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/Max.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/Max.java
new file mode 100644
index 00000000..ff792c0b
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/Max.java
@@ -0,0 +1,70 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2023 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command.annotations;
+
+import de.steamwar.command.Handler;
+import de.steamwar.command.handler.MaxHandler;
+import de.steamwar.command.handler.MaxReferenceHandler;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * This annotation is used to define a maximum number value for a parameter.
+ */
+@Retention(RetentionPolicy.RUNTIME)
+@Target({ElementType.PARAMETER})
+@Handler.Implementation(MaxHandler.Impl.class)
+public @interface Max {
+ int intValue() default Integer.MAX_VALUE;
+
+ long longValue() default Long.MAX_VALUE;
+
+ float floatValue() default Float.MAX_VALUE;
+
+ double doubleValue() default Double.MAX_VALUE;
+
+ boolean inclusive() default true;
+
+ /**
+ * Error message to be displayed when the argument supplied is bigger than this allows.
+ * Two arguments are supplied to the error message. The first is the number that got parsed
+ * and the second is the max this annotation allows.
+ */
+ String error() default "";
+
+ @Retention(RetentionPolicy.RUNTIME)
+ @Target({ElementType.PARAMETER})
+ @Handler.Implementation(MaxReferenceHandler.Impl.class)
+ @interface Reference {
+ String value();
+
+ boolean inclusive() default true;
+
+ /**
+ * Error message to be displayed when the argument supplied is smaller than this allows.
+ * Two arguments are supplied to the error message. The first is the number that got parsed
+ * and the second is the min this annotation allows.
+ */
+ String error() default "";
+ }
+}
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/Min.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/Min.java
new file mode 100644
index 00000000..41edc8b4
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/Min.java
@@ -0,0 +1,70 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2023 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command.annotations;
+
+import de.steamwar.command.Handler;
+import de.steamwar.command.handler.MinHandler;
+import de.steamwar.command.handler.MinReferenceHandler;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * This annotation is used to define a minimum number value for a parameter.
+ */
+@Retention(RetentionPolicy.RUNTIME)
+@Target({ElementType.PARAMETER})
+@Handler.Implementation(MinHandler.Impl.class)
+public @interface Min {
+ int intValue() default Integer.MIN_VALUE;
+
+ long longValue() default Long.MIN_VALUE;
+
+ float floatValue() default Float.MIN_VALUE;
+
+ double doubleValue() default Double.MIN_VALUE;
+
+ boolean inclusive() default true;
+
+ /**
+ * Error message to be displayed when the argument supplied is smaller than this allows.
+ * Two arguments are supplied to the error message. The first is the number that got parsed
+ * and the second is the min this annotation allows.
+ */
+ String error() default "";
+
+ @Retention(RetentionPolicy.RUNTIME)
+ @Target({ElementType.PARAMETER})
+ @Handler.Implementation(MinReferenceHandler.Impl.class)
+ @interface Reference {
+ String value();
+
+ boolean inclusive() default true;
+
+ /**
+ * Error message to be displayed when the argument supplied is smaller than this allows.
+ * Two arguments are supplied to the error message. The first is the number that got parsed
+ * and the second is the min this annotation allows.
+ */
+ String error() default "";
+ }
+}
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/Name.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/Name.java
new file mode 100644
index 00000000..a1dbfa73
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/Name.java
@@ -0,0 +1,31 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2024 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command.annotations;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+@Retention(RetentionPolicy.RUNTIME)
+@Target({ElementType.PARAMETER})
+public @interface Name {
+ String value();
+}
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/OptionalValue.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/OptionalValue.java
new file mode 100644
index 00000000..d893218b
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/OptionalValue.java
@@ -0,0 +1,46 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2023 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command.annotations;
+
+import de.steamwar.command.Handler;
+import de.steamwar.command.handler.OptionalValueHandler;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * This annotation is used to define a default value for a parameter.
+ */
+@Retention(RetentionPolicy.RUNTIME)
+@Target({ElementType.PARAMETER})
+@Handler.Implementation(OptionalValueHandler.Impl.class)
+public @interface OptionalValue {
+ /**
+ * Will pe parsed against the TypeMapper specified by the parameter or annotation.
+ */
+ String value();
+
+ /**
+ * The method name stands for 'onlyUseIfNoneIsGiven'.
+ */
+ boolean onlyUINIG() default false;
+}
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/Regex.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/Regex.java
new file mode 100644
index 00000000..7c261781
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/Regex.java
@@ -0,0 +1,38 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2023 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command.annotations;
+
+import de.steamwar.command.Handler;
+import de.steamwar.command.handler.RegexHandler;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+@Retention(RetentionPolicy.RUNTIME)
+@Target({ElementType.PARAMETER})
+@Handler.Implementation(RegexHandler.Impl.class)
+public @interface Regex {
+
+ String value();
+
+ String error() default "";
+}
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/Register.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/Register.java
new file mode 100644
index 00000000..8483bf83
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/Register.java
@@ -0,0 +1,57 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2023 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command.annotations;
+
+import de.steamwar.command.Handler;
+import de.steamwar.command.handler.RegisterHandler;
+
+import java.lang.annotation.*;
+
+/**
+ * Annotation for registering a method as a command.
+ */
+@Retention(RetentionPolicy.RUNTIME)
+@Target({ElementType.METHOD})
+@Repeatable(Register.Registers.class)
+@Handler.Implementation(RegisterHandler.Impl.class)
+public @interface Register {
+
+ /**
+ * Identifier of subcommand.
+ */
+ String[] value() default {};
+
+ /**
+ * Description of subcommand.
+ */
+ String[] description() default {};
+
+ /**
+ * If {@code true}, the command will not be tab completed.
+ */
+ boolean noTabComplete() default false;
+
+ @Retention(RetentionPolicy.RUNTIME)
+ @Target({ElementType.METHOD})
+ @Handler.Implementation(RegisterHandler.Impl.class)
+ @interface Registers {
+ Register[] value();
+ }
+}
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/StartsWith.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/StartsWith.java
new file mode 100644
index 00000000..9f1af0a8
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/StartsWith.java
@@ -0,0 +1,38 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2023 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command.annotations;
+
+import de.steamwar.command.Handler;
+import de.steamwar.command.handler.StartsWithHandler;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+@Retention(RetentionPolicy.RUNTIME)
+@Target({ElementType.PARAMETER})
+@Handler.Implementation(StartsWithHandler.Impl.class)
+public @interface StartsWith {
+
+ String value();
+
+ String error() default "";
+}
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/StaticValue.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/StaticValue.java
new file mode 100644
index 00000000..7eefa873
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/StaticValue.java
@@ -0,0 +1,58 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2023 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command.annotations;
+
+import de.steamwar.command.Handler;
+import de.steamwar.command.handler.StaticValueHandler;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * This annotation is used to define static values for a parameter like an enum just without the enum.
+ * You can use this annotation on a parameter of type {@link String} or {@link int}, {@link long} and
+ * {@link boolean}. While using an int, the value will represent the index into the value array. While
+ * using a boolean, the {@link #falseValues()} defines which indices are considered {@code false} or
+ * {@code true}.
+ */
+@Retention(RetentionPolicy.RUNTIME)
+@Target({ElementType.PARAMETER})
+@Handler.Implementation(StaticValueHandler.Impl.class)
+@Deprecated
+@DeprecationInfo("Use @Values instead")
+public @interface StaticValue {
+ String[] value();
+
+ /**
+ * This is the short form for 'allowImplicitSwitchExpressions'
+ * and can be set to true if you want to allow int as well as boolean as annotated parameter types.
+ * The value array needs to be at least 2 long for this flag to be considered.
+ * While using an int, the value will represent the index into the value array.
+ * While using a boolean, the {@link #falseValues()} defines which indices are
+ * considered {@code false} or {@code true}.
+ */
+ @Deprecated
+ @DeprecationInfo("Dont need to set this to true")
+ boolean allowISE() default false;
+
+ int[] falseValues() default {0};
+}
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/Supplier.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/Supplier.java
new file mode 100644
index 00000000..b0b7b2f8
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/Supplier.java
@@ -0,0 +1,48 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2023 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command.annotations;
+
+import de.steamwar.command.Handler;
+import de.steamwar.command.handler.SupplierHandler;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+@Retention(RetentionPolicy.RUNTIME)
+@Target({ElementType.PARAMETER, ElementType.METHOD})
+@Handler.Implementation(SupplierHandler.Impl.class)
+public @interface Supplier {
+ /**
+ * The name this supplier is registered for.
+ */
+ String value() default "";
+
+ /**
+ * The type this supplier is registered for.
+ */
+ Class> type() default void.class;
+
+ /**
+ * If {@code true}, the supplier will only be used in the current command class.
+ */
+ boolean local() default true;
+}
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/TabFilter.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/TabFilter.java
new file mode 100644
index 00000000..3d0e9af1
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/TabFilter.java
@@ -0,0 +1,40 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2023 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command.annotations;
+
+import de.steamwar.command.Handler;
+import de.steamwar.command.handler.TabFilterHandler;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * This annotation defines per Parameter how the TabCompletions should be filtered and displayed by the client.
+ * There are 3 modes further described by {@link TabFilterType}. If this annotation is not present the default
+ * {@link TabFilterType#STARTS_WITH} is used.
+ */
+@Retention(RetentionPolicy.RUNTIME)
+@Target({ElementType.PARAMETER})
+@Handler.Implementation(TabFilterHandler.Impl.class)
+public @interface TabFilter {
+ TabFilterType value();
+}
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/TabFilterType.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/TabFilterType.java
new file mode 100644
index 00000000..af9ef427
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/TabFilterType.java
@@ -0,0 +1,41 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2023 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command.annotations;
+
+public enum TabFilterType {
+
+ /**
+ * This value defines that, the starts with tab-completion filter is used.
+ * see: {@link de.steamwar.command.mapper.internal.StartsWithFilter} for more.
+ */
+ STARTS_WITH,
+
+ /**
+ * This value defines that, the contains tab-completions filter is used.
+ * see: {@link de.steamwar.command.mapper.internal.ContainsFilter} for more.
+ */
+ CONTAINS,
+
+ /**
+ * This value disables any tab-completion filters and just returns anything you
+ * specified inside the TypeMapper.
+ */
+ NONE
+}
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/Unique.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/Unique.java
new file mode 100644
index 00000000..ae25575c
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/Unique.java
@@ -0,0 +1,37 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2024 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command.annotations;
+
+import de.steamwar.command.Handler;
+import de.steamwar.command.handler.UniqueHandler;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * This annotation is used to define an array with unique values.
+ */
+@Retention(RetentionPolicy.RUNTIME)
+@Target({ElementType.PARAMETER})
+@Handler.Implementation(UniqueHandler.Impl.class)
+public @interface Unique {
+}
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/Validator.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/Validator.java
new file mode 100644
index 00000000..2b2e9f49
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/Validator.java
@@ -0,0 +1,68 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2023 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command.annotations;
+
+import de.steamwar.command.Handler;
+import de.steamwar.command.handler.ValidatorHandler;
+
+import java.lang.annotation.*;
+
+/**
+ * Annotation for registering a method as a validator.
+ * The annotated method will be executed while {@link #initialize()}
+ * is evaluated. The result of this method will be cached under the
+ * name {@link ClassValidator#value()} converted to a {@link String} using
+ * {@link Class#getTypeName()}.
+ * This annotation can also be used on parameters to apply a validator to them.
+ * You can leave the {@link #value()} empty here to use the type of the parameter.
+ * For registering you should never leave {@link #value()} empty.
+ */
+@Retention(RetentionPolicy.RUNTIME)
+@Target({ElementType.PARAMETER, ElementType.METHOD})
+@Handler.Implementation(ValidatorHandler.Impl.class)
+@Repeatable(Validator.Validators.class)
+public @interface Validator {
+ /**
+ * The name this validator is registered for.
+ */
+ String value() default "";
+
+ /**
+ * The type this validator is registered for.
+ */
+ Class> type() default void.class;
+
+ /**
+ * If {@code true}, the validator will only be used in the current command class.
+ */
+ boolean local() default true;
+
+ /**
+ * If {@code true}, the validator will be inverted for parameter usage.
+ */
+ boolean invert() default false;
+
+ @Retention(RetentionPolicy.RUNTIME)
+ @Target({ElementType.PARAMETER})
+ @Handler.Implementation(ValidatorHandler.Impl.class)
+ @interface Validators {
+ Validator[] value();
+ }
+}
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/Values.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/Values.java
new file mode 100644
index 00000000..a00864f4
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/annotations/Values.java
@@ -0,0 +1,52 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2023 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command.annotations;
+
+import de.steamwar.command.Handler;
+import de.steamwar.command.handler.ValuesHandler;
+import de.steamwar.command.handler.ValuesReferenceHandler;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * This annotation is used to define static values for a parameter like an enum just without the enum.
+ * You can use this annotation on a parameter of type {@link String} or {@link int}, {@link long} and
+ * {@link boolean}. While using an int, the value will represent the index into the value array. While
+ * using a boolean, the {@link #falseValues()} defines which indices are considered {@code false} or
+ * {@code true}.
+ */
+@Retention(RetentionPolicy.RUNTIME)
+@Target({ElementType.PARAMETER})
+@Handler.Implementation(ValuesHandler.Impl.class)
+public @interface Values {
+ String[] value();
+
+ int[] falseValues() default {0};
+
+ @Retention(RetentionPolicy.RUNTIME)
+ @Target({ElementType.PARAMETER})
+ @Handler.Implementation(ValuesReferenceHandler.Impl.class)
+ @interface Reference {
+ String value();
+ }
+}
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/graph/AbstractArrayNode.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/graph/AbstractArrayNode.java
new file mode 100644
index 00000000..7ba207cd
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/graph/AbstractArrayNode.java
@@ -0,0 +1,110 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2023 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command.graph;
+
+import de.steamwar.command.Handler;
+import de.steamwar.command.PreviousArguments;
+import de.steamwar.command.handler.ArrayLengthHandler;
+import de.steamwar.command.handler.UniqueHandler;
+import de.steamwar.command.utils.Triple;
+
+import java.lang.reflect.Array;
+import java.lang.reflect.Parameter;
+import java.util.*;
+
+public abstract class AbstractArrayNode extends AbstractTypeNode {
+
+ protected final boolean unique;
+ protected final int minArrayLength;
+ protected final int maxArrayLength;
+ protected final String error;
+
+ protected AbstractArrayNode(Parameter parameter, int index, Handler.DataReadable dataReadable) {
+ super(parameter, index, dataReadable);
+
+ this.unique = UniqueHandler.isPresent(parameter);
+ this.minArrayLength = ArrayLengthHandler.getMin(parameter);
+ this.maxArrayLength = ArrayLengthHandler.getMax(parameter);
+ this.error = ArrayLengthHandler.getError(parameter);
+ }
+
+ @Override
+ public void tabComplete(E executor, NodeData nodeData, List> completions) {
+ Object array = Array.newInstance(type, Math.min(nodeData.unparsedArgumentsSize(), maxArrayLength));
+
+ int i = 0;
+ while (!nodeData.hasOneLeft()) {
+ if (i >= minArrayLength) {
+ for (Node child : children) {
+ child.tabComplete(executor, nodeData, completions);
+ }
+ }
+
+ nodeData.add(name, arrayCopy(array, i));
+ Triple argument = argument(executor, nodeData);
+ nodeData.remove();
+
+ if (!argument.b) {
+ for (; i > 0; i--) nodeData.unconsume();
+ return;
+ }
+ nodeData.consume();
+ Array.set(array, i, argument.a);
+ i++;
+ }
+ nodeData.add(name, arrayCopy(array, i));
+ if (i < maxArrayLength) {
+ PreviousArguments previousArguments = nodeData.toPreviousArguments();
+ if (unique) {
+ Map> mapped = new HashMap<>();
+ for (String s : typeMapper.tabComplete(executor, previousArguments, nodeData.current())) {
+ mapped.computeIfAbsent(typeMapper.map(executor, previousArguments, s), object -> new ArrayList<>())
+ .add(s);
+ }
+ for (int j = 0; j < i; j++) {
+ mapped.remove(Array.get(array, j));
+ }
+ mapped.forEach((object, strings) -> {
+ completions.add(strings);
+ });
+ } else {
+ completions.add(typeMapper.tabComplete(executor, previousArguments, nodeData.current()));
+ }
+ }
+ if (i >= minArrayLength) {
+ for (Node child : children) {
+ child.tabComplete(executor, nodeData, completions);
+ }
+ }
+ nodeData.remove();
+ for (; i > 0; i--) nodeData.unconsume();
+ }
+
+ protected Object arrayCopy(Object array, int newLength) {
+ Object newArray = Array.newInstance(type, newLength);
+ System.arraycopy(array, 0, newArray, 0, Math.min(Array.getLength(array), newLength));
+ return newArray;
+ }
+
+ @Override
+ public int nodeCost() {
+ return minArrayLength * 2 + super.nodeCost();
+ }
+}
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/graph/AbstractTypeNode.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/graph/AbstractTypeNode.java
new file mode 100644
index 00000000..d9f527ab
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/graph/AbstractTypeNode.java
@@ -0,0 +1,145 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2023 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command.graph;
+
+import de.steamwar.command.*;
+import de.steamwar.command.annotations.TabFilterType;
+import de.steamwar.command.handler.TabFilterHandler;
+import de.steamwar.command.mapper.EnumMapper;
+import de.steamwar.command.mapper.OptionEnumMapper;
+import de.steamwar.command.mapper.internal.ContainsFilter;
+import de.steamwar.command.mapper.internal.StartsWithFilter;
+import de.steamwar.command.utils.Pair;
+import de.steamwar.command.utils.Triple;
+
+import java.lang.annotation.Annotation;
+import java.lang.reflect.Parameter;
+import java.util.List;
+
+public abstract class AbstractTypeNode extends AbstractValidationNode {
+
+ protected Class> type;
+ protected AbstractTypeMapper typeMapper;
+
+ protected AbstractTypeNode(Parameter parameter, int index, Handler.DataReadable dataReadable) {
+ super(parameter, index, dataReadable);
+
+ type = parameter.getType();
+ if (type.isArray()) type = type.getComponentType();
+
+ initializeTypeMapper(handlerParameters, parameter, index, dataReadable);
+ }
+
+ private AbstractTypeMapper getTypeMapper(Handler.DataReadable dataReadable) {
+ AbstractTypeMapper typeMapper = dataReadable.getMapper(type.getTypeName());
+ if (typeMapper == null && type.isEnum()) {
+ if (OptionEnum.class.isAssignableFrom(type)) {
+ typeMapper = (AbstractTypeMapper) new OptionEnumMapper((Class) type);
+ } else {
+ typeMapper = (AbstractTypeMapper) new EnumMapper((Class) type);
+ }
+ }
+ return typeMapper;
+ }
+
+ private void initializeTypeMapper(List> pairs, Parameter parameter, int index, Handler.DataReadable dataReadable) {
+ AbstractTypeMapper typeMapper = getTypeMapper(dataReadable);
+ boolean isStillDefault = true;
+ for (Pair pair : pairs) {
+ if (pair.b.needsParentTypeMapper()) {
+ continue;
+ }
+ if (!isStillDefault) {
+ throw new UnsupportedOperationException("Only one HandlerParameter can be used without a parent TypeMapper");
+ }
+ AbstractTypeMapper temp = pair.b.getTypeMapper(pair.a, parameter, index, dataReadable, null);
+ if (temp != null) {
+ typeMapper = temp;
+ isStillDefault = false;
+ }
+ }
+
+ AbstractTypeMapper current = typeMapper;
+ for (Pair pair : pairs) {
+ if (!pair.b.needsParentTypeMapper()) {
+ continue;
+ }
+ AbstractTypeMapper temp = pair.b.getTypeMapper(pair.a, parameter, index, dataReadable, typeMapper);
+ if (temp != null) {
+ typeMapper = temp;
+ }
+ }
+
+ current = TabCompletionCache.cached(current, typeMapper);
+
+ TabFilterType tabFilterType = TabFilterHandler.getTabFilterType(parameter);
+ switch (tabFilterType) {
+ case NONE:
+ this.typeMapper = current;
+ break;
+ case STARTS_WITH:
+ this.typeMapper = new StartsWithFilter<>(current);
+ break;
+ case CONTAINS:
+ this.typeMapper = new ContainsFilter<>(current);
+ break;
+ }
+ }
+
+ protected Triple argument(E executor, NodeData nodeData) {
+ Object value;
+ boolean usedOptional;
+ try {
+ PreviousArguments previousArguments = nodeData.toPreviousArguments();
+ value = typeMapper.map(executor, previousArguments, nodeData.current());
+ usedOptional = previousArguments.hasUsedOptionalValue();
+ } catch (Exception e) {
+ return new Triple<>(null, false, false);
+ }
+ if (validate(executor, value, nodeData)) {
+ return new Triple<>(value, true, usedOptional);
+ } else {
+ return new Triple<>(null, false, false);
+ }
+ }
+
+ protected boolean validate(E executor, Object value, NodeData nodeData) {
+ for (AbstractTypeValidator validator : validators) {
+ try {
+ if (!validator.validate(executor, value, nodeData)) {
+ return false;
+ }
+ } catch (ClassCastException e) {
+ // Ignore
+ } catch (Throwable e) {
+ return false;
+ }
+ }
+ return true;
+ }
+
+ @Override
+ public boolean equals(Parameter parameter, Node children) {
+ if (!(children instanceof AbstractTypeNode)) {
+ return false;
+ }
+ return super.equals(parameter, children);
+ }
+}
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/graph/AbstractValidationNode.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/graph/AbstractValidationNode.java
new file mode 100644
index 00000000..265e3aa9
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/graph/AbstractValidationNode.java
@@ -0,0 +1,109 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2023 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command.graph;
+
+import de.steamwar.command.AbstractTypeValidator;
+import de.steamwar.command.CommandUtils;
+import de.steamwar.command.Handler;
+import de.steamwar.command.handler.AllowNullHandler;
+import de.steamwar.command.utils.Pair;
+
+import java.lang.annotation.Annotation;
+import java.lang.reflect.Parameter;
+import java.util.*;
+
+public abstract class AbstractValidationNode extends Node {
+
+ private static final AbstractTypeValidator, ?> NON_NULL_VALIDATOR = (AbstractTypeValidator) (sender, value, messageSender) -> value != null;
+
+ protected final List annotations;
+ protected final List> handlerParameters;
+ protected final List> validators = new ArrayList<>();
+
+ protected AbstractValidationNode(Parameter parameter, int index, Handler.DataReadable dataReadable) {
+ super(parameter);
+ annotations = CommandUtils.getAnnotations(parameter, Handler.HandlerParameter.class);
+ List> pairs = new ArrayList<>();
+ for (Annotation annotation : annotations) {
+ Handler.Implementation implementation = annotation.annotationType().getAnnotation(Handler.Implementation.class);
+ try {
+ pairs.add(new Pair<>(annotation, (Handler.HandlerParameter) implementation.value().getConstructor().newInstance()));
+ } catch (Exception e) {
+ throw new SecurityException(e);
+ }
+ }
+ handlerParameters = pairs;
+
+ initializeValidators(handlerParameters, parameter, index, dataReadable);
+ }
+
+ private void initializeValidators(List> pairs, Parameter parameter, int index, Handler.DataReadable dataReadable) {
+ pairs.sort(Comparator.comparingInt(p -> p.b.getValidatorPriority()));
+ for (Pair pair : pairs) {
+ AbstractTypeValidator validator = pair.b.getValidator(pair.a, parameter, index, dataReadable);
+ if (validator != null) {
+ validators.add(validator);
+ }
+ }
+
+ if (!AllowNullHandler.isPresent(parameter)) {
+ validators.add((AbstractTypeValidator) NON_NULL_VALIDATOR);
+ }
+ }
+
+ @Override
+ public boolean equals(Parameter parameter, Node children) {
+ if (this.parameter.getType() != parameter.getType()) {
+ return false;
+ }
+
+ Annotation[] annotations = this.parameter.getAnnotations();
+ Annotation[] currentAnnotations = parameter.getAnnotations();
+
+ if (annotations.length == 0 && currentAnnotations.length == 0) {
+ return true;
+ }
+
+ if (annotations.length != currentAnnotations.length) {
+ return false;
+ }
+
+ Map, Annotation> annotationMap = new HashMap<>();
+ boolean duplicate = false;
+ for (Annotation annotation : annotations) {
+ if (annotationMap.put(annotation.annotationType(), annotation) != null) {
+ duplicate = true;
+ break;
+ }
+ }
+ if (duplicate) {
+ return false;
+ }
+
+ for (Annotation annotation : currentAnnotations) {
+ Annotation other = annotationMap.get(annotation.annotationType());
+ if (!annotation.equals(other)) {
+ continue;
+ }
+ annotationMap.remove(annotation.annotationType());
+ }
+ return annotationMap.isEmpty();
+ }
+}
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/graph/ExecuteNode.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/graph/ExecuteNode.java
new file mode 100644
index 00000000..791c3a4f
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/graph/ExecuteNode.java
@@ -0,0 +1,89 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2023 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command.graph;
+
+import de.steamwar.command.CommandFrameworkException;
+
+import java.lang.reflect.InvocationTargetException;
+import java.lang.reflect.Method;
+import java.lang.reflect.Parameter;
+import java.util.Arrays;
+import java.util.Collection;
+import java.util.List;
+import java.util.stream.Collectors;
+
+public class ExecuteNode extends Node {
+
+ private final Object self;
+ private final Method method;
+
+ public ExecuteNode(Object self, Method method) {
+ super(null);
+ this.self = self;
+ this.method = method;
+ }
+
+ @Override
+ public boolean execute(E executor, NodeData nodeData) {
+ for (Node child : children) {
+ if (child.execute(executor, nodeData)) {
+ return true;
+ }
+ }
+
+ if (nodeData.hasMore()) {
+ return false;
+ }
+
+ try {
+ method.invoke(self, nodeData.mapped());
+ return true;
+ } catch (InvocationTargetException e) {
+ throw new CommandFrameworkException(e, nodeData.alias(), nodeData.args());
+ } catch (IllegalAccessException | RuntimeException e) {
+ return false;
+ }
+ }
+
+ @Override
+ public void tabComplete(E executor, NodeData nodeData, List> completions) {
+ for (Node child : children) {
+ child.tabComplete(executor, nodeData, completions);
+ }
+ }
+
+ @Override
+ public boolean equals(Parameter parameter, Node children) {
+ if (children instanceof ExecuteNode) {
+ String parameters = Arrays.stream(method.getParameters()).map(par -> {
+ String annotations = Arrays.stream(par.getAnnotations())
+ .map(annotation -> "@" + annotation.getClass().getSimpleName())
+ .collect(Collectors.joining(" "));
+ if (par.isVarArgs()) {
+ return annotations + (annotations.isEmpty() ? "" : " ") + par.getType().componentType().getSimpleName() + "...";
+ } else {
+ return annotations + (annotations.isEmpty() ? "" : " ") + par.getType().getSimpleName();
+ }
+ }).collect(Collectors.joining(", "));
+ throw new UnsupportedOperationException("Command with parameters " + parameters + " is already defined in " + self.getClass().getName());
+ }
+ return children instanceof ExecuteNode;
+ }
+}
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/graph/ExecutorTypeNode.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/graph/ExecutorTypeNode.java
new file mode 100644
index 00000000..7bc189c1
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/graph/ExecutorTypeNode.java
@@ -0,0 +1,95 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2023 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command.graph;
+
+import de.steamwar.command.AbstractTypeValidator;
+import de.steamwar.command.Handler;
+
+import java.lang.reflect.Parameter;
+import java.util.Collection;
+import java.util.List;
+import java.util.function.Function;
+
+public class ExecutorTypeNode extends AbstractValidationNode {
+
+ protected final Function executorMapper;
+
+ public ExecutorTypeNode(Parameter parameter, int index, Handler.DataReadable dataReadable) {
+ super(parameter, index, dataReadable);
+ this.executorMapper = (Function) dataReadable.getExecutorMapper(parameter.getType());
+ }
+
+ @Override
+ public boolean execute(E executor, NodeData nodeData) {
+ Object mappedExecutor = executorMapper.apply(executor);
+ if (mappedExecutor == null) return false;
+ for (AbstractTypeValidator validator : validators) {
+ try {
+ if (!validator.validate(executor, executor, nodeData)) {
+ return false;
+ }
+ } catch (ClassCastException e) {
+ // Ignore
+ } catch (Throwable e) {
+ return false;
+ }
+ }
+ nodeData.add(name, mappedExecutor);
+ for (Node child : children) {
+ if (child.execute(executor, nodeData)) return true;
+ }
+ nodeData.remove();
+ return false;
+ }
+
+ @Override
+ public void tabComplete(E executor, NodeData nodeData, List> completions) {
+ Object mappedExecutor = executorMapper.apply(executor);
+ if (mappedExecutor == null) return;
+ for (AbstractTypeValidator validator : validators) {
+ try {
+ if (!validator.validate(executor, executor, nodeData)) {
+ return;
+ }
+ } catch (ClassCastException e) {
+ // Ignore
+ } catch (Throwable e) {
+ return;
+ }
+ }
+ nodeData.add(name, mappedExecutor);
+ for (Node child : children) {
+ child.tabComplete(executor, nodeData, completions);
+ }
+ nodeData.remove();
+ }
+
+ @Override
+ public boolean equals(Parameter parameter, Node children) {
+ if (!(children instanceof ExecutorTypeNode)) {
+ return false;
+ }
+ ExecutorTypeNode other = (ExecutorTypeNode) children;
+ if (executorMapper != other.executorMapper) {
+ return false;
+ }
+ return super.equals(parameter, children);
+ }
+}
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/graph/GreedyArrayNode.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/graph/GreedyArrayNode.java
new file mode 100644
index 00000000..2c02d480
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/graph/GreedyArrayNode.java
@@ -0,0 +1,98 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2023 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command.graph;
+
+import de.steamwar.command.Handler;
+import de.steamwar.command.handler.GreedyHandler;
+import de.steamwar.command.utils.Triple;
+
+import java.lang.reflect.Array;
+import java.lang.reflect.Parameter;
+import java.util.HashSet;
+import java.util.Set;
+
+public class GreedyArrayNode extends AbstractArrayNode {
+
+ protected final int backTrackingDepth;
+
+ public GreedyArrayNode(Parameter parameter, int index, Handler.DataReadable dataReadable) {
+ super(parameter, index, dataReadable);
+ this.backTrackingDepth = GreedyHandler.getBackTrackingDepth(parameter);
+ }
+
+ @Override
+ public boolean execute(E executor, NodeData nodeData) {
+ int min = Math.min(nodeData.unparsedArgumentsSize(), minArrayLength);
+ int max = Math.min(nodeData.unparsedArgumentsSize(), maxArrayLength);
+ if (max < minArrayLength) {
+ nodeData.send(error, 0, minArrayLength);
+ return false;
+ }
+
+ Object array = Array.newInstance(type, max);
+ Set seen = new HashSet<>();
+
+ int i = 0;
+ for (; i < max; i++) {
+ nodeData.add(name, arrayCopy(array, i));
+ Triple argument = argument(executor, nodeData);
+ nodeData.remove();
+
+ if (!argument.b || (unique && !seen.add(argument.a))) {
+ if (i < minArrayLength) {
+ nodeData.send(error, i, minArrayLength);
+ for (; i > 0; i--) nodeData.unconsume();
+ return false;
+ }
+ break;
+ }
+ Array.set(array, i, argument.a);
+ nodeData.consume();
+ }
+
+ int backTrackingDepth = i - this.backTrackingDepth;
+ for (; i >= min; i--) {
+ Object copiedArray = arrayCopy(array, i);
+ nodeData.add(name, copiedArray);
+ if (validate(executor, copiedArray, nodeData)) {
+ for (Node child : children) {
+ if (child.execute(executor, nodeData)) {
+ return true;
+ }
+ }
+ }
+ nodeData.remove();
+ if (i <= backTrackingDepth) {
+ break;
+ }
+ if (i > 0) {
+ nodeData.unconsume();
+ }
+ }
+ if (i < minArrayLength) nodeData.send(error, i, minArrayLength);
+ for (; i > 0; i--) nodeData.unconsume();
+ return false;
+ }
+
+ @Override
+ public int nodeCost() {
+ return -1;
+ }
+}
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/graph/LiteralNode.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/graph/LiteralNode.java
new file mode 100644
index 00000000..b00d176d
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/graph/LiteralNode.java
@@ -0,0 +1,75 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2023 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command.graph;
+
+import java.lang.reflect.Parameter;
+import java.util.Collection;
+import java.util.List;
+
+public class LiteralNode extends Node {
+
+ protected final String literal;
+
+ public LiteralNode(String literal) {
+ super(null);
+ this.literal = literal;
+ }
+
+ @Override
+ public boolean execute(E executor, NodeData nodeData) {
+ if (!nodeData.hasMore()) return false;
+ if (nodeData.current().equalsIgnoreCase(literal)) {
+ nodeData.consume();
+ for (Node child : children) {
+ if (child.execute(executor, nodeData)) {
+ return true;
+ }
+ }
+ nodeData.unconsume();
+ }
+ return false;
+ }
+
+ @Override
+ public void tabComplete(E executor, NodeData nodeData, List> completions) {
+ if (nodeData.hasOneLeft()) {
+ if (literal.startsWith(nodeData.current())) {
+ completions.add(List.of(literal));
+ }
+ return;
+ }
+
+ if (nodeData.current().equalsIgnoreCase(literal)) {
+ nodeData.consume();
+ for (Node child : children) {
+ child.tabComplete(executor, nodeData, completions);
+ }
+ nodeData.unconsume();
+ }
+ }
+
+ @Override
+ public boolean equals(Parameter parameter, Node children) {
+ if (!(children instanceof LiteralNode)) {
+ return false;
+ }
+ return literal.equalsIgnoreCase(((LiteralNode) children).literal);
+ }
+}
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/graph/NoTabCompleteNode.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/graph/NoTabCompleteNode.java
new file mode 100644
index 00000000..d59760c7
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/graph/NoTabCompleteNode.java
@@ -0,0 +1,49 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2023 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command.graph;
+
+import java.lang.reflect.Parameter;
+import java.util.Collection;
+import java.util.List;
+
+public class NoTabCompleteNode extends Node {
+
+ public NoTabCompleteNode() {
+ super(null);
+ }
+
+ @Override
+ public boolean execute(E executor, NodeData nodeData) {
+ for (Node child : children) {
+ if (child.execute(executor, nodeData)) return true;
+ }
+ return false;
+ }
+
+ @Override
+ public void tabComplete(E executor, NodeData nodeData, List> completions) {
+ // Do nothing
+ }
+
+ @Override
+ public boolean equals(Parameter parameter, Node children) {
+ return children instanceof NoTabCompleteNode;
+ }
+}
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/graph/Node.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/graph/Node.java
new file mode 100644
index 00000000..7080d9f4
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/graph/Node.java
@@ -0,0 +1,83 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2023 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command.graph;
+
+import de.steamwar.command.annotations.Name;
+
+import java.lang.reflect.Parameter;
+import java.util.ArrayList;
+import java.util.Collection;
+import java.util.Comparator;
+import java.util.List;
+import java.util.concurrent.atomic.AtomicInteger;
+
+public abstract class Node {
+
+ protected final Parameter parameter;
+ protected final String name;
+ protected final List> children = new ArrayList<>();
+
+ protected Node(Parameter parameter) {
+ this.parameter = parameter;
+ if (parameter == null) {
+ this.name = null;
+ return;
+ }
+
+ Name name = parameter.getAnnotation(Name.class);
+ if (name == null) {
+ this.name = parameter.getName();
+ } else {
+ this.name = name.value();
+ }
+ }
+
+ public abstract boolean execute(E executor, NodeData nodeData);
+ public abstract void tabComplete(E executor, NodeData nodeData, List> completions);
+
+ public final Node addChild(Parameter parameter, Node child) {
+ for (Node currentChild : children) {
+ if (currentChild.equals(parameter, child)) {
+ return currentChild;
+ }
+ }
+ children.add(child);
+ return child;
+ }
+
+ public abstract boolean equals(Parameter parameter, Node children);
+
+ public int nodeCost() {
+ return 2;
+ }
+
+ public final int sort() {
+ AtomicInteger max = new AtomicInteger(0);
+ if (children.size() == 1) {
+ return children.get(0).sort() + nodeCost();
+ }
+ children.sort(Comparator.comparingInt(value -> {
+ int sort = value.sort();
+ if (sort > max.get()) max.set(sort);
+ return -sort;
+ }));
+ return max.get() + nodeCost();
+ }
+}
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/graph/NodeData.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/graph/NodeData.java
new file mode 100644
index 00000000..7966b25a
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/graph/NodeData.java
@@ -0,0 +1,120 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2023 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command.graph;
+
+import de.steamwar.command.AbstractTypeValidator;
+import de.steamwar.command.PreviousArguments;
+import lombok.NonNull;
+
+import java.util.Arrays;
+import java.util.LinkedList;
+
+public class NodeData implements AbstractTypeValidator.MessageSender {
+
+ private final String alias;
+ private final LinkedList parsedArguments = new LinkedList<>();
+ private final LinkedList unparsedArguments;
+ private final LinkedList mapped = new LinkedList<>();
+ private final LinkedList names = new LinkedList<>();
+ private final AbstractTypeValidator.MessageSender messageSender;
+
+ public NodeData(String alias, String[] args, AbstractTypeValidator.MessageSender messageSender) {
+ this.alias = alias;
+ this.unparsedArguments = new LinkedList<>(Arrays.asList(args));
+ this.messageSender = messageSender;
+ }
+
+ public String[] args() {
+ return parsedArguments.toArray(String[]::new);
+ }
+
+ public String alias() {
+ return alias;
+ }
+
+ public String current() {
+ if (unparsedArguments.isEmpty()) return null;
+ return unparsedArguments.getFirst();
+ }
+
+ public boolean hasMore() {
+ return !unparsedArguments.isEmpty();
+ }
+
+ public boolean hasOneLeft() {
+ return unparsedArguments.size() == 1;
+ }
+
+ void consume() {
+ parsedArguments.addLast(unparsedArguments.removeFirst());
+ }
+
+ void unconsume() {
+ unparsedArguments.addFirst(parsedArguments.removeLast());
+ }
+
+ void add(String name, Object mapped) {
+ this.names.addLast(name);
+ this.mapped.addLast(mapped);
+ }
+
+ void remove() {
+ this.names.removeLast();
+ this.mapped.removeLast();
+ }
+
+ public Object getByName(@NonNull String name) {
+ for (int i = mapped.size() - 1; i >= 0; i--) {
+ if (name.equals(names.get(i))) {
+ return mapped.get(i);
+ }
+ }
+ return null;
+ }
+
+ public Object[] mapped() {
+ return mapped.toArray();
+ }
+
+ public int unparsedArgumentsSize() {
+ return unparsedArguments.size();
+ }
+
+ @Override
+ public void send(String s, Object... args) {
+ if (s == null || s.isEmpty()) return;
+ messageSender.send(s, args);
+ }
+
+ PreviousArguments toPreviousArguments() {
+ return new PreviousArguments(args(), mapped(), hasMore(), this::getByName);
+ }
+
+ @Override
+ public String toString() {
+ return "NodeData{" +
+ "alias='" + alias + '\'' +
+ ", parsedArguments=" + parsedArguments + " (" + parsedArguments.size() + ")" +
+ ", unparsedArguments=" + unparsedArguments + " (" + unparsedArguments.size() + ")" +
+ ", mapped=" + mapped + " (" + mapped.size() + ")" +
+ ", names=" + names + " (" + names.size() + ")" +
+ '}';
+ }
+}
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/graph/NonGreedyArrayNode.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/graph/NonGreedyArrayNode.java
new file mode 100644
index 00000000..e2bafc1c
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/graph/NonGreedyArrayNode.java
@@ -0,0 +1,83 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2023 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command.graph;
+
+import de.steamwar.command.Handler;
+import de.steamwar.command.utils.Triple;
+
+import java.lang.reflect.Array;
+import java.lang.reflect.Parameter;
+import java.util.HashSet;
+import java.util.Set;
+
+public class NonGreedyArrayNode extends AbstractArrayNode {
+
+ public NonGreedyArrayNode(Parameter parameter, int index, Handler.DataReadable dataReadable) {
+ super(parameter, index, dataReadable);
+ }
+
+ @Override
+ public boolean execute(E executor, NodeData nodeData) {
+ int min = Math.max(nodeData.unparsedArgumentsSize(), minArrayLength);
+ int max = Math.min(nodeData.unparsedArgumentsSize(), maxArrayLength);
+ if (max < minArrayLength) {
+ nodeData.send(error, 0, minArrayLength);
+ return false;
+ }
+ Object array = Array.newInstance(type, max);
+ Set seen = new HashSet<>();
+
+ int i = 0;
+ do {
+ Object copiedArray = arrayCopy(array, i);
+ nodeData.add(name, copiedArray);
+ if (i >= min && validate(executor, copiedArray, nodeData)) {
+ for (Node child : children) {
+ if (child.execute(executor, nodeData)) return true;
+ }
+ }
+
+ Triple argument = argument(executor, nodeData);
+ nodeData.remove();
+ if (!argument.b || (unique && !seen.add(argument.a))) {
+ if (i < minArrayLength) nodeData.send(error, i, minArrayLength);
+ for (; i > 0; i--) nodeData.unconsume();
+ return false;
+ }
+ nodeData.consume();
+ Array.set(array, i, argument.a);
+ i++;
+ } while (i < max);
+
+ if (i >= min) {
+ Object copiedArray = arrayCopy(array, i);
+ nodeData.add(name, copiedArray);
+ if (validate(executor, copiedArray, nodeData)) {
+ for (Node child : children) {
+ if (child.execute(executor, nodeData)) return true;
+ }
+ }
+ nodeData.remove();
+ }
+ if (i < minArrayLength) nodeData.send(error, i, minArrayLength);
+ for (; i > 0; i--) nodeData.unconsume();
+ return false;
+ }
+}
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/graph/RootNode.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/graph/RootNode.java
new file mode 100644
index 00000000..7030fbb2
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/graph/RootNode.java
@@ -0,0 +1,51 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2023 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command.graph;
+
+import java.lang.reflect.Parameter;
+import java.util.Collection;
+import java.util.List;
+
+public class RootNode extends Node {
+
+ public RootNode() {
+ super(null);
+ }
+
+ @Override
+ public boolean execute(E executor, NodeData nodeData) {
+ for (Node child : children) {
+ if (child.execute(executor, nodeData)) return true;
+ }
+ return false;
+ }
+
+ @Override
+ public void tabComplete(E executor, NodeData nodeData, List> completions) {
+ for (Node child : children) {
+ child.tabComplete(executor, nodeData, completions);
+ }
+ }
+
+ @Override
+ public boolean equals(Parameter parameter, Node children) {
+ return children instanceof RootNode;
+ }
+}
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/graph/SupplierNode.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/graph/SupplierNode.java
new file mode 100644
index 00000000..e1da7416
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/graph/SupplierNode.java
@@ -0,0 +1,100 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2023 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command.graph;
+
+import de.steamwar.command.AbstractTypeSupplier;
+import de.steamwar.command.Handler;
+import de.steamwar.command.PreviousArguments;
+import de.steamwar.command.annotations.Supplier;
+import de.steamwar.command.handler.AllowNullHandler;
+
+import java.lang.reflect.Parameter;
+import java.util.Collection;
+import java.util.List;
+
+public class SupplierNode extends Node {
+
+ protected final AbstractTypeSupplier typeSupplier;
+ protected final boolean allowNull;
+
+ public SupplierNode(Parameter parameter, Handler.DataReadable dataReadable) {
+ super(parameter);
+
+ Supplier annotation = parameter.getAnnotation(Supplier.class);
+ String s = annotation.value() != null && !annotation.value().isEmpty() ? annotation.value() : parameter.getType().getTypeName();
+ typeSupplier = dataReadable.getSupplier(s);
+
+ allowNull = AllowNullHandler.isPresent(parameter);
+ }
+
+ @Override
+ public boolean execute(E executor, NodeData nodeData) {
+ PreviousArguments previousArguments = nodeData.toPreviousArguments();
+ Object value;
+ try {
+ value = typeSupplier.get(executor, previousArguments);
+ } catch (Exception e) {
+ return false;
+ }
+
+ if (!allowNull && value == null) {
+ return false;
+ }
+ nodeData.add(name, value);
+
+ for (Node child : children) {
+ if (child.execute(executor, nodeData)) return true;
+ }
+
+ nodeData.remove();
+ return false;
+ }
+
+ @Override
+ public void tabComplete(E executor, NodeData nodeData, List> completions) {
+ PreviousArguments previousArguments = nodeData.toPreviousArguments();
+ Object value;
+ try {
+ value = typeSupplier.get(executor, previousArguments);
+ } catch (Exception e) {
+ return;
+ }
+
+ if (!allowNull && value == null) {
+ return;
+ }
+ nodeData.add(name, value);
+
+ for (Node child : children) {
+ child.tabComplete(executor, nodeData, completions);
+ }
+
+ nodeData.remove();
+ }
+
+ @Override
+ public boolean equals(Parameter parameter, Node children) {
+ if (children instanceof SupplierNode) {
+ SupplierNode> supplierNode = (SupplierNode>) children;
+ return allowNull == supplierNode.allowNull && typeSupplier == supplierNode.typeSupplier;
+ }
+ return false;
+ }
+}
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/graph/TypeNode.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/graph/TypeNode.java
new file mode 100644
index 00000000..0c9fefbb
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/graph/TypeNode.java
@@ -0,0 +1,84 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2023 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command.graph;
+
+import de.steamwar.command.Handler;
+import de.steamwar.command.PreviousArguments;
+import de.steamwar.command.utils.Triple;
+
+import java.lang.reflect.Parameter;
+import java.util.Collection;
+import java.util.List;
+
+public class TypeNode extends AbstractTypeNode {
+
+ public TypeNode(Parameter parameter, int index, Handler.DataReadable dataReadable) {
+ super(parameter, index, dataReadable);
+ }
+
+ @Override
+ public boolean execute(E executor, NodeData nodeData) {
+ Triple argument = argument(executor, nodeData);
+ if (!argument.b) return false;
+ nodeData.add(name, argument.a);
+ if (!argument.c) nodeData.consume();
+
+ for (Node child : children) {
+ if (child.execute(executor, nodeData)) return true;
+ }
+
+ nodeData.remove();
+ if (!argument.c) nodeData.unconsume();
+ return false;
+ }
+
+ @Override
+ public void tabComplete(E executor, NodeData nodeData, List> completions) {
+ if (nodeData.hasOneLeft()) {
+ PreviousArguments previousArguments = nodeData.toPreviousArguments();
+ Collection tabCompletions = typeMapper.tabComplete(executor, previousArguments, nodeData.current());
+ completions.add(tabCompletions);
+
+ if (typeMapper.appendNextElementTabCompletions()) {
+ for (Node child : children) {
+ child.tabComplete(executor, nodeData, completions);
+ }
+ }
+ return;
+ }
+
+ Triple argument = argument(executor, nodeData);
+ if (!argument.b) return;
+ nodeData.add(name, argument.a);
+ if (!argument.c) nodeData.consume();
+
+ for (Node child : children) {
+ child.tabComplete(executor, nodeData, completions);
+ }
+
+ nodeData.remove();
+ if (!argument.c) nodeData.unconsume();
+ }
+
+ @Override
+ public int nodeCost() {
+ return type == String.class ? 1 : 2;
+ }
+}
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/handler/AllowNullHandler.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/handler/AllowNullHandler.java
new file mode 100644
index 00000000..dd170378
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/handler/AllowNullHandler.java
@@ -0,0 +1,48 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2023 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command.handler;
+
+import de.steamwar.command.Handler;
+import de.steamwar.command.annotations.AllowNull;
+
+import java.lang.reflect.Parameter;
+
+/**
+ * This special Handler is just for validating the AllowNull annotation.
+ */
+public final class AllowNullHandler {
+
+ public static boolean isPresent(Parameter parameter) {
+ return parameter.isAnnotationPresent(AllowNull.class);
+ }
+
+ public static final class Impl implements Handler.HandlerParameter {
+
+ @Override
+ public void check(AllowNull annotation, Parameter parameter, int index, DataCheckable dataCheckable) throws Exception {
+ if (index == 0) {
+ throw new UnsupportedOperationException("AllowNull annotation cannot be used on the first parameter");
+ }
+ if (parameter.getType().isPrimitive()) {
+ throw new UnsupportedOperationException("AllowNull annotation cannot be used on primitive types");
+ }
+ }
+ }
+}
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/handler/ArrayLengthHandler.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/handler/ArrayLengthHandler.java
new file mode 100644
index 00000000..487d13b9
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/handler/ArrayLengthHandler.java
@@ -0,0 +1,62 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2023 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command.handler;
+
+import de.steamwar.command.Handler;
+import de.steamwar.command.annotations.ArrayLength;
+
+import java.lang.reflect.Parameter;
+
+public final class ArrayLengthHandler {
+
+ public static int getMin(Parameter parameter) {
+ ArrayLength arrayLength = parameter.getAnnotation(ArrayLength.class);
+ if (arrayLength == null) return 0;
+ return arrayLength.min();
+ }
+
+ public static int getMax(Parameter parameter) {
+ ArrayLength arrayLength = parameter.getAnnotation(ArrayLength.class);
+ if (arrayLength == null) return Integer.MAX_VALUE;
+ return arrayLength.max();
+ }
+
+ public static String getError(Parameter parameter) {
+ ArrayLength arrayLength = parameter.getAnnotation(ArrayLength.class);
+ if (arrayLength == null) return "";
+ return arrayLength.error();
+ }
+
+ public static final class Impl implements Handler.HandlerParameter {
+
+ @Override
+ public void check(ArrayLength arrayLength, Parameter parameter, int index, DataCheckable dataCheckable) throws Exception {
+ if (index == 0) {
+ throw new UnsupportedOperationException("ArrayLength annotation cannot be used on first parameter");
+ }
+ if (!parameter.getType().isArray()) {
+ throw new UnsupportedOperationException("Parameter " + index + " of " + parameter.getDeclaringExecutable().getName() + " is not an array");
+ }
+ if (arrayLength.min() > arrayLength.max()) {
+ throw new UnsupportedOperationException("Min ArrayLength cannot be smaller than Max ArrayLength");
+ }
+ }
+ }
+}
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/handler/CachedHandler.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/handler/CachedHandler.java
new file mode 100644
index 00000000..59ac3522
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/handler/CachedHandler.java
@@ -0,0 +1,54 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2023 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command.handler;
+
+import de.steamwar.command.AbstractTypeMapper;
+import de.steamwar.command.Handler;
+import de.steamwar.command.TabCompletionCache;
+import de.steamwar.command.annotations.Cached;
+
+import java.lang.reflect.Method;
+
+public final class CachedHandler {
+
+ public static final class Impl implements Handler.HandlerMethod {
+
+ @Override
+ public void check(Cached annotation, Method method, DataCheckable dataCheckable) throws Exception {
+ if (method.getParameterCount() != 0) {
+ throw new UnsupportedOperationException("Cached method must have no parameters");
+ }
+ if (!AbstractTypeMapper.class.isAssignableFrom(method.getReturnType())) {
+ throw new UnsupportedOperationException("Cached method must return AbstractTypeMapper");
+ }
+ }
+
+ @Override
+ public int getRunPriority() {
+ return Integer.MIN_VALUE;
+ }
+
+ @Override
+ public void run(Cached annotation, Method method, DataWritable dataWritable) {
+ AbstractTypeMapper abstractTypeMapper = dataWritable.invoke(method);
+ TabCompletionCache.add(abstractTypeMapper, annotation.global(), annotation.cacheDuration(), annotation.timeUnit());
+ }
+ }
+}
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/handler/ClassMapperHandler.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/handler/ClassMapperHandler.java
new file mode 100644
index 00000000..ab31acb1
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/handler/ClassMapperHandler.java
@@ -0,0 +1,54 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2023 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command.handler;
+
+import de.steamwar.command.AbstractTypeMapper;
+import de.steamwar.command.Handler;
+import de.steamwar.command.annotations.ClassMapper;
+
+import java.lang.reflect.Method;
+
+@Deprecated
+public final class ClassMapperHandler {
+
+ public static final class Impl implements Handler.HandlerMethod {
+
+ @Override
+ public void check(ClassMapper annotation, Method method, DataCheckable dataCheckable) throws Exception {
+ if (method.getParameterCount() != 0) {
+ throw new UnsupportedOperationException("ClassMapper method must have no parameters");
+ }
+ if (!AbstractTypeMapper.class.isAssignableFrom(method.getReturnType())) {
+ throw new UnsupportedOperationException("ClassMapper method must return AbstractTypeMapper");
+ }
+ }
+
+ @Override
+ public int getRunPriority() {
+ return Integer.MIN_VALUE;
+ }
+
+ @Override
+ public void run(ClassMapper annotation, Method method, DataWritable dataWritable) {
+ AbstractTypeMapper abstractTypeMapper = dataWritable.invoke(method);
+ dataWritable.addMapper(annotation.value().getName(), annotation.local(), abstractTypeMapper);
+ }
+ }
+}
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/handler/ClassValidatorHandler.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/handler/ClassValidatorHandler.java
new file mode 100644
index 00000000..a8d64e82
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/handler/ClassValidatorHandler.java
@@ -0,0 +1,54 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2023 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command.handler;
+
+import de.steamwar.command.AbstractTypeValidator;
+import de.steamwar.command.Handler;
+import de.steamwar.command.annotations.ClassValidator;
+
+import java.lang.reflect.Method;
+
+@Deprecated
+public final class ClassValidatorHandler {
+
+ public static final class Impl implements Handler.HandlerMethod {
+
+ @Override
+ public void check(ClassValidator annotation, Method method, DataCheckable dataCheckable) throws Exception {
+ if (method.getParameterCount() != 0) {
+ throw new UnsupportedOperationException("ClassValidator method must have no parameters");
+ }
+ if (!AbstractTypeValidator.class.isAssignableFrom(method.getReturnType())) {
+ throw new UnsupportedOperationException("ClassValidator method must return AbstractValidator");
+ }
+ }
+
+ @Override
+ public int getRunPriority() {
+ return Integer.MIN_VALUE;
+ }
+
+ @Override
+ public void run(ClassValidator annotation, Method method, DataWritable dataWritable) {
+ AbstractTypeValidator abstractTypeValidator = dataWritable.invoke(method);
+ dataWritable.addValidator(annotation.value().getName(), annotation.local(), abstractTypeValidator);
+ }
+ }
+}
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/handler/EndsWithHandler.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/handler/EndsWithHandler.java
new file mode 100644
index 00000000..37ea29ee
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/handler/EndsWithHandler.java
@@ -0,0 +1,84 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2023 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command.handler;
+
+import de.steamwar.command.AbstractTypeMapper;
+import de.steamwar.command.AbstractTypeValidator;
+import de.steamwar.command.Handler;
+import de.steamwar.command.PreviousArguments;
+import de.steamwar.command.annotations.EndsWith;
+import de.steamwar.command.mapper.internal.DelegatingMapper;
+
+import java.lang.reflect.Parameter;
+import java.util.Collection;
+import java.util.stream.Collectors;
+
+public final class EndsWithHandler {
+
+ public static final class Impl implements Handler.HandlerParameter {
+
+ @Override
+ public void check(EndsWith annotation, Parameter parameter, int index, DataCheckable dataCheckable) throws Exception {
+ if (index == 0) {
+ throw new UnsupportedOperationException("EndsWith annotation cannot be used on first parameter");
+ }
+ if (parameter.getType() != String.class) {
+ throw new UnsupportedOperationException("EndsWith annotation cannot be used on String parameter");
+ }
+ }
+
+ @Override
+ public boolean needsParentTypeMapper() {
+ return true;
+ }
+
+ @Override
+ public AbstractTypeMapper getTypeMapper(EndsWith annotation, Parameter parameter, int index, DataReadable dataReadable, AbstractTypeMapper parentTypeMapper) {
+ String endsWith = annotation.value();
+
+ return new DelegatingMapper<>(parentTypeMapper, annotation) {
+ @Override
+ public Collection tabComplete(Object sender, PreviousArguments previousArguments, String s) {
+ return super.tabComplete(sender, previousArguments, s).stream().map(s1 -> {
+ if (s1.startsWith(endsWith)) return s1;
+ return s1 + endsWith;
+ }).collect(Collectors.toList());
+ }
+ };
+ }
+
+ @Override
+ public int getValidatorPriority() {
+ return 0;
+ }
+
+ @Override
+ public AbstractTypeValidator getValidator(EndsWith annotation, Parameter parameter, int index, DataReadable dataReadable) {
+ String endsWith = annotation.value();
+ String error = annotation.error();
+ return (sender, value, messageSender) -> {
+ if (value == null) return true;
+ if (value.endsWith(endsWith)) return true;
+ messageSender.send(error);
+ return false;
+ };
+ }
+ }
+}
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/handler/ErrorMessageHandler.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/handler/ErrorMessageHandler.java
new file mode 100644
index 00000000..df5a278e
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/handler/ErrorMessageHandler.java
@@ -0,0 +1,60 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2023 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command.handler;
+
+import de.steamwar.command.AbstractTypeValidator;
+import de.steamwar.command.Handler;
+import de.steamwar.command.annotations.ErrorMessage;
+
+import java.lang.reflect.Array;
+import java.lang.reflect.Parameter;
+
+public final class ErrorMessageHandler {
+
+ public static final class Impl implements Handler.HandlerParameter {
+
+ @Override
+ public void check(ErrorMessage errorMessage, Parameter parameter, int index, DataCheckable dataCheckable) throws Exception {
+ if (index == 0) {
+ throw new UnsupportedOperationException("ErrorMessage annotation cannot be used on first parameter");
+ }
+ if (!errorMessage.allowEAs() && !(parameter.isVarArgs() || parameter.getType().isArray())) {
+ throw new UnsupportedOperationException("ErrorMessage allowESs cannot be used on non array or varargs parameter");
+ }
+ }
+
+ @Override
+ public int getValidatorPriority() {
+ return Integer.MAX_VALUE;
+ }
+
+ @Override
+ public AbstractTypeValidator getValidator(ErrorMessage errorMessage, Parameter parameter, int index, DataReadable dataReadable) {
+ return (sender, value, messageSender) -> {
+ if (value == null) messageSender.send(errorMessage.value());
+ if (!errorMessage.allowEAs() && value != null && value.getClass().isArray() && Array.getLength(value) == 0) {
+ messageSender.send(errorMessage.value());
+ return false;
+ }
+ return value != null;
+ };
+ }
+ }
+}
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/handler/GreedyHandler.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/handler/GreedyHandler.java
new file mode 100644
index 00000000..1eaa20a0
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/handler/GreedyHandler.java
@@ -0,0 +1,53 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2023 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command.handler;
+
+import de.steamwar.command.Handler;
+import de.steamwar.command.annotations.Greedy;
+
+import java.lang.reflect.Parameter;
+
+/**
+ * This special Handler is just for validating the Greedy annotation.
+ */
+public final class GreedyHandler {
+
+ public static boolean isGreedy(Parameter parameter) {
+ return parameter.isAnnotationPresent(Greedy.class);
+ }
+
+ public static int getBackTrackingDepth(Parameter parameter) {
+ Greedy greedy = parameter.getAnnotation(Greedy.class);
+ if (greedy == null || parameter.isVarArgs()) {
+ return 0;
+ }
+ return greedy.backTrackingDepth();
+ }
+
+ public static final class Impl implements Handler.HandlerParameter {
+
+ @Override
+ public void check(Greedy annotation, Parameter parameter, int index, DataCheckable dataCheckable) throws Exception {
+ if (!parameter.getType().isArray() || parameter.isVarArgs()) {
+ throw new UnsupportedOperationException("Greedy annotation cannot be used on non array parameters");
+ }
+ }
+ }
+}
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/handler/LengthHandler.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/handler/LengthHandler.java
new file mode 100644
index 00000000..9d6ba906
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/handler/LengthHandler.java
@@ -0,0 +1,76 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2023 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command.handler;
+
+import de.steamwar.command.AbstractTypeMapper;
+import de.steamwar.command.Handler;
+import de.steamwar.command.PreviousArguments;
+import de.steamwar.command.annotations.Length;
+import de.steamwar.command.mapper.internal.DelegatingMapper;
+
+import java.lang.reflect.Parameter;
+import java.util.Collection;
+import java.util.List;
+import java.util.stream.Collectors;
+
+public final class LengthHandler {
+
+ public static final class Impl implements Handler.HandlerParameter {
+
+ @Override
+ public void check(Length annotation, Parameter parameter, int index, DataCheckable dataCheckable) throws Exception {
+ if (index == 0) {
+ throw new UnsupportedOperationException("Length annotation cannot be used on first parameter");
+ }
+ }
+
+ @Override
+ public boolean needsParentTypeMapper() {
+ return true;
+ }
+
+ @Override
+ public AbstractTypeMapper getTypeMapper(Length length, Parameter parameter, int index, DataReadable dataReadable, AbstractTypeMapper parentTypeMapper) {
+ int min = length.min();
+ int max = length.max();
+
+ return new DelegatingMapper<>(parentTypeMapper, length) {
+ @Override
+ public Object map(Object sender, PreviousArguments previousArguments, String s) {
+ if (s.length() < min || s.length() > max) return null;
+ return delegate.map(sender, previousArguments, s);
+ }
+
+ @Override
+ public Collection tabComplete(Object sender, PreviousArguments previousArguments, String s) {
+ List tabCompletes = delegate.tabComplete(sender, previousArguments, s)
+ .stream()
+ .filter(str -> str.length() >= min)
+ .map(str -> str.substring(0, Math.min(str.length(), max)))
+ .collect(Collectors.toList());
+ if (s.length() < min) {
+ tabCompletes.add(0, s);
+ }
+ return tabCompletes;
+ }
+ };
+ }
+ }
+}
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/handler/MapperHandler.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/handler/MapperHandler.java
new file mode 100644
index 00000000..a01392c1
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/handler/MapperHandler.java
@@ -0,0 +1,96 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2023 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command.handler;
+
+import de.steamwar.command.AbstractTypeMapper;
+import de.steamwar.command.Handler;
+import de.steamwar.command.annotations.Mapper;
+
+import java.lang.reflect.Method;
+import java.lang.reflect.Parameter;
+import java.util.Optional;
+
+public final class MapperHandler {
+
+ public static final class Impl implements Handler.HandlerMethod, Handler.HandlerParameter {
+
+ @Override
+ public void check(Mapper annotation, Method method, DataCheckable dataCheckable) throws Exception {
+ if (method.getParameterCount() != 0) {
+ throw new UnsupportedOperationException("Mapper method must have no parameters");
+ }
+ if (!AbstractTypeMapper.class.isAssignableFrom(method.getReturnType())) {
+ throw new UnsupportedOperationException("Mapper method must return AbstractTypeMapper");
+ }
+
+ if (annotation.value() != null && !annotation.value().isEmpty()) {
+ return;
+ }
+
+ Optional> genericType = getGenericTypeOfReturn(method);
+ if (annotation.type() == void.class) {
+ if (genericType.isEmpty()) {
+ throw new UnsupportedOperationException("Please supply a class type to the Mapper");
+ }
+ } else {
+ if (genericType.isPresent() && !annotation.type().isAssignableFrom(genericType.get())) {
+ throw new UnsupportedOperationException("Supplied type does not conform to actual type");
+ }
+ }
+ }
+
+ @Override
+ public int getRunPriority() {
+ return Integer.MIN_VALUE;
+ }
+
+ @Override
+ public void run(Mapper annotation, Method method, DataWritable dataWritable) {
+ AbstractTypeMapper abstractTypeMapper = dataWritable.invoke(method);
+ if (annotation.value() != null && !annotation.value().isEmpty()) {
+ dataWritable.addMapper(annotation.value(), annotation.local(), abstractTypeMapper);
+ } else {
+ Class> type = annotation.type();
+ if (type == void.class) type = getGenericTypeOfReturn(method).get();
+ dataWritable.addMapper(type.getName(), annotation.local(), abstractTypeMapper);
+ }
+ }
+
+ @Override
+ public void check(Mapper annotation, Parameter parameter, int index, DataCheckable dataCheckable) throws Exception {
+ if (index == 0) {
+ throw new UnsupportedOperationException("Mapper annotation cannot be used on first parameter");
+ }
+ if (!dataCheckable.hasMapper(annotation.value())) {
+ throw new UnsupportedOperationException("Mapper '" + annotation.value() + "' not found");
+ }
+ }
+
+ @Override
+ public AbstractTypeMapper getTypeMapper(Mapper annotation, Parameter parameter, int index, DataReadable dataReadable, AbstractTypeMapper parentTypeMapper) {
+ String s = annotation.value();
+ AbstractTypeMapper abstractTypeMapper = dataReadable.getMapper(s);
+ if (abstractTypeMapper == null) {
+ throw new IllegalArgumentException("No mapper found for " + s);
+ }
+ return abstractTypeMapper;
+ }
+ }
+}
diff --git a/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/handler/MaxHandler.java b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/handler/MaxHandler.java
new file mode 100644
index 00000000..a44d985c
--- /dev/null
+++ b/CommandFramework/CommandFrameworkBase/src/de/steamwar/command/handler/MaxHandler.java
@@ -0,0 +1,172 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2023 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package de.steamwar.command.handler;
+
+import de.steamwar.command.*;
+import de.steamwar.command.annotations.Max;
+import de.steamwar.command.annotations.Min;
+import de.steamwar.command.mapper.internal.DelegatingMapper;
+
+import java.lang.reflect.Parameter;
+import java.util.ArrayList;
+import java.util.Collection;
+import java.util.function.ToIntFunction;
+
+public final class MaxHandler {
+
+ public static final class Impl implements Handler.HandlerParameter {
+
+ @Override
+ public void check(Max max, Parameter parameter, int index, DataCheckable dataCheckable) throws Exception {
+ if (index == 0) {
+ throw new UnsupportedOperationException("Max annotation cannot be used on first parameter");
+ }
+ Class> type = parameter.getType();
+ if (parameter.isVarArgs()) type = type.getComponentType();
+
+ if (type != int.class && type != Integer.class && type != long.class && type != Long.class && type != float.class && type != Float.class && type != double.class && type != Double.class) {
+ throw new UnsupportedOperationException("Parameter " + index + " of " + parameter.getDeclaringExecutable() + " is not a number.");
+ }
+
+ if (!parameter.isAnnotationPresent(Min.class)) {
+ return;
+ }
+
+ Min min = parameter.getAnnotation(Min.class);
+
+ Number minValue;
+ if (type.equals(int.class) || type.equals(Integer.class)) {
+ minValue = min.intValue();
+ } else if (type.equals(long.class) || type.equals(Long.class)) {
+ minValue = min.longValue();
+ } else if (type.equals(float.class) || type.equals(Float.class)) {
+ minValue = min.floatValue();
+ } else if (type.equals(double.class) || type.equals(Double.class)) {
+ minValue = min.doubleValue();
+ } else {
+ throw new SecurityException();
+ }
+
+ ToIntFunction maxComparator = CommandUtils.createComparator("Max", type, max.intValue(), max.longValue(), max.floatValue(), max.doubleValue());
+ if (!(min.inclusive() && max.inclusive()) && maxComparator.applyAsInt(minValue) == 0) {
+ throw new UnsupportedOperationException("Min and Max cannot be equal if not both are inclusive");
+ } else if (maxComparator.applyAsInt(minValue) > 0) {
+ throw new UnsupportedOperationException("Max must be bigger then Min");
+ }
+ }
+
+ @Override
+ public boolean needsParentTypeMapper() {
+ return true;
+ }
+
+ @Override
+ public AbstractTypeMapper getTypeMapper(Max max, Parameter parameter, int index, DataReadable dataReadable, AbstractTypeMapper parentTypeMapper) {
+ Class> type = parameter.getType();
+ if (parameter.isVarArgs()) type = type.getComponentType();
+
+ int compareValue = max.inclusive() ? 0 : -1;
+ ToIntFunction comparator = CommandUtils.createComparator("Max", type, max.intValue(), max.longValue(), max.floatValue(), max.doubleValue());
+ boolean onlyNegative = comparator.applyAsInt(0) >= 0;
+
+ Min min = parameter.getAnnotation(Min.class);
+
+ Number minValue;
+ Number maxValue;
+ if (type.equals(int.class) || type.equals(Integer.class)) {
+ minValue = min != null ? min.intValue() : null;
+ maxValue = max.intValue();
+ } else if (type.equals(long.class) || type.equals(Long.class)) {
+ minValue = min != null ? min.longValue() : null;
+ maxValue = max.longValue();
+ } else if (type.equals(float.class) || type.equals(Float.class)) {
+ minValue = min != null ? min.floatValue() : null;
+ maxValue = max.floatValue();
+ } else if (type.equals(double.class) || type.equals(Double.class)) {
+ minValue = min != null ? min.doubleValue() : null;
+ maxValue = max.doubleValue();
+ } else {
+ throw new SecurityException();
+ }
+
+ return new DelegatingMapper<>(parentTypeMapper, max) {
+ @Override
+ public Collection