feature: MiniMessageTranslator

text-minimessage/src/main/java/net/kyori/adventure/text/minimessage/translation/ArgumentTag.java

@@ -0,0 +1,39 @@
+package net.kyori.adventure.text.minimessage.translation;
+
+import java.util.List;
+import java.util.Objects;
+import net.kyori.adventure.text.ComponentLike;
+import net.kyori.adventure.text.minimessage.Context;
+import net.kyori.adventure.text.minimessage.ParsingException;
+import net.kyori.adventure.text.minimessage.tag.Tag;
+import net.kyori.adventure.text.minimessage.tag.resolver.ArgumentQueue;
+import net.kyori.adventure.text.minimessage.tag.resolver.TagResolver;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+public class ArgumentTag implements TagResolver {
+ private static final String NAME = "argument";
+ private static final String NAME_1 = "arg";
+
+ private final List<? extends ComponentLike> argumentComponents;
+
+ public ArgumentTag(final @NotNull List<? extends ComponentLike> argumentComponents) {
+ this.argumentComponents = Objects.requireNonNull(argumentComponents, "argumentComponents");
+ }
+
+ @Override
+ public @Nullable Tag resolve(final @NotNull String name, final @NotNull ArgumentQueue arguments, final @NotNull Context ctx) throws ParsingException {
+ final int index = arguments.popOr("No argument number provided").asInt().orElseThrow(() -> ctx.newException("Invalid argument number", arguments));
+
+ if (index < 0 || index >= argumentComponents.size()) {
+ throw ctx.newException("Invalid argument number", arguments);
+ }
+
+ return Tag.inserting(argumentComponents.get(index));
+ }
+
+ @Override
+ public boolean has(final @NotNull String name) {
+ return name.equals(NAME) || name.equals(NAME_1);
+ }
+}

text-minimessage/src/main/java/net/kyori/adventure/text/minimessage/translation/MiniMessageTranslator.java

@@ -0,0 +1,77 @@
+/*
+ * This file is part of adventure, licensed under the MIT License.
+ *
+ * Copyright (c) 2017-2022 KyoriPowered
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+package net.kyori.adventure.text.minimessage.translation;
+
+import java.text.MessageFormat;
+import java.util.Locale;
+import java.util.Objects;
+import net.kyori.adventure.text.Component;
+import net.kyori.adventure.text.TranslatableComponent;
+import net.kyori.adventure.text.minimessage.MiniMessage;
+import net.kyori.adventure.translation.Translator;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+public abstract class MiniMessageTranslator implements Translator {
+
+ final MiniMessage miniMessage;
+
+ public MiniMessageTranslator() {
+ this(MiniMessage.miniMessage());
+ }
+
+ public MiniMessageTranslator(final @NotNull MiniMessage miniMessage) {
+ this.miniMessage = Objects.requireNonNull(miniMessage, "miniMessage");
+ }
+
+ protected abstract @Nullable String getMiniMessageString(final @NotNull String key, final @NotNull Locale locale);
+
+ @Override
+ public final @Nullable MessageFormat translate(final @NotNull String key, final @NotNull Locale locale) {
+ return null;
+ }
+
+ @Override
+ public @Nullable Component translate(final @NotNull TranslatableComponent component, final @NotNull Locale locale) {
+ final String miniMessageString = getMiniMessageString(component.key(), locale);
+
+ if (miniMessageString == null) {
+ return null;
+ }
+
+ final Component resultingComponent;
+
+ if (component.args().isEmpty()) {
+ resultingComponent = MiniMessage.miniMessage().deserialize(miniMessageString);
+ } else {
+ resultingComponent = MiniMessage.miniMessage().deserialize(miniMessageString, new ArgumentTag(component.args()));
+ }
+
+ if (component.children().isEmpty()) {
+ return resultingComponent;
+ } else {
+ return resultingComponent.children(component.children());
+ }
+ }
+}

text-minimessage/src/main/java/net/kyori/adventure/text/minimessage/translation/package-info.java

@@ -0,0 +1,27 @@
+/*
+ * This file is part of adventure, licensed under the MIT License.
+ *
+ * Copyright (c) 2017-2022 KyoriPowered
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+/**
+ * Tools for working with Adventure's translation API.
+ */
+package net.kyori.adventure.text.minimessage.translation;