feat: Add fallback /mimic command

Author: osipxd

mimic-bukkit/src/main/kotlin/command/ConfigMessage.kt

@@ -12,10 +12,10 @@ import ru.endlesscode.mimic.config.StringSetConfigProperty
 import ru.endlesscode.mimic.internal.append
 import ru.endlesscode.mimic.internal.appendClickable
 import ru.endlesscode.mimic.internal.appendLine
-import ru.endlesscode.mimic.internal.buildTextComponent
+import ru.endlesscode.mimic.internal.text
 
 @OptIn(ExperimentalMimicApi::class)
-internal fun buildConfigMessage(mimic: Mimic, config: MimicConfig): TextComponent = buildTextComponent {
+internal fun buildConfigMessage(mimic: Mimic, config: MimicConfig): TextComponent = text {
     appendLine("----[ Mimic Config ]----")
     appendSelectablePropertyConfig(
         property = MimicConfig.LEVEL_SYSTEM,
@@ -53,7 +53,7 @@ private fun TextComponent.Builder.appendSelectablePropertyConfig(
             availableOptions,
             hint = "Click to select",
             color = NamedTextColor.GRAY,
-            resolveCommand = { "/mimic config ${property.path} $it" },
+            resolveCommand = { "/$COMMAND_NAME config ${property.path} $it" },
         )
     }
 
@@ -76,14 +76,14 @@ private fun TextComponent.Builder.appendSetPropertyConfig(
         hint = "Click to add",
         color = NamedTextColor.GRAY,
         nonClickableOptions = permanentOptions,
-        resolveCommand = { "/mimic config ${property.path} add $it" },
+        resolveCommand = { "/$COMMAND_NAME config ${property.path} add $it" },
     )
 
     appendLine()
     appendPropertyPath(property)
     append("[")
     appendSelectableOptions(values, hint = "Click to remove") {
-        "/mimic config ${property.path} remove $it"
+        "/$COMMAND_NAME config ${property.path} remove $it"
     }
     append("]")
 }
@@ -103,7 +103,7 @@ private fun TextComponent.Builder.appendSelectableOptions(
     resolveCommand: (String) -> String,
 ) = append(
     options.mapIndexed { index, option ->
-        buildTextComponent {
+        text {
             color(color)
             if (index != 0) append(", ")
             if (option !in nonClickableOptions) {

mimic-bukkit/src/main/kotlin/command/FallbackCommand.kt

@@ -0,0 +1,41 @@
+package ru.endlesscode.mimic.command
+
+import net.kyori.adventure.text.Component
+import net.kyori.adventure.text.event.ClickEvent
+import net.kyori.adventure.text.event.HoverEvent
+import net.kyori.adventure.text.format.NamedTextColor
+import net.kyori.adventure.text.format.TextDecoration
+import org.bukkit.command.CommandSender
+import org.bukkit.command.defaults.BukkitCommand
+import ru.endlesscode.mimic.internal.append
+import ru.endlesscode.mimic.internal.appendLine
+import ru.endlesscode.mimic.internal.text
+
+internal class FallbackCommand(
+    private val pluginFullName: String
+) : BukkitCommand(
+    COMMAND_NAME,
+    COMMAND_INFO_DESCRIPTION,
+    "/$COMMAND_NAME",
+    emptyList(),
+) {
+
+    override fun execute(sender: CommandSender, commandLabel: String, args: Array<out String>?): Boolean {
+        val message = text {
+            appendLine(pluginFullName, NamedTextColor.GREEN)
+            color(NamedTextColor.GRAY)
+            append("Install ")
+            append(commandApiLink())
+            append(" to unlock all Mimic commands.")
+        }
+        sender.sendMessage(message)
+        return true
+    }
+
+    private fun commandApiLink() = text {
+        color(NamedTextColor.YELLOW)
+        append("CommandAPI", TextDecoration.UNDERLINED)
+        hoverEvent(HoverEvent.showText(Component.text("Open CommandAPI website")))
+        clickEvent(ClickEvent.openUrl("https://docs.commandapi.dev/user-setup/install"))
+    }
+}

mimic-bukkit/src/main/kotlin/command/MainCommand.kt

@@ -8,16 +8,19 @@ import ru.endlesscode.mimic.config.MimicConfig
 import ru.endlesscode.mimic.internal.append
 import ru.endlesscode.mimic.internal.appendClickable
 import ru.endlesscode.mimic.internal.appendLine
-import ru.endlesscode.mimic.internal.buildTextComponent
+import ru.endlesscode.mimic.internal.text
+
+internal const val COMMAND_NAME = "mimic"
+internal const val COMMAND_INFO_DESCRIPTION = "Show info about Mimic"
 
 /** Registers command '/mimic' and all subcommands. */
 internal fun registerCommand(
     mimic: Mimic,
     config: MimicConfig,
     pluginFullName: String,
-) = commandAPICommand("mimic") {
+) = commandAPICommand(COMMAND_NAME) {
     withPermission("mimic.admin")
-    withShortDescription("Show info about Mimic")
+    withShortDescription(COMMAND_INFO_DESCRIPTION)
     executes(infoExecutor(pluginFullName))
 
     configSubcommand(mimic, config)
@@ -28,7 +31,7 @@ internal fun registerCommand(
 }
 
 private fun infoExecutor(pluginFullName: String) = CommandExecutor { sender, _ ->
-    val message = buildTextComponent {
+    val message = text {
         appendLine(pluginFullName, NamedTextColor.GREEN)
         color(NamedTextColor.GRAY)
         append("Use ")
@@ -38,9 +41,9 @@ private fun infoExecutor(pluginFullName: String) = CommandExecutor { sender, _ -
     sender.sendMessage(message)
 }
 
-private fun createClickableCommand() = buildTextComponent {
+private fun createClickableCommand() = text {
     color(NamedTextColor.YELLOW)
     appendClickable(CONFIG_COMMAND, "Click to execute", CONFIG_COMMAND)
 }
 
-private const val CONFIG_COMMAND = "/mimic config"
+private const val CONFIG_COMMAND = "/$COMMAND_NAME config"

mimic-bukkit/src/main/kotlin/command/MimicCommands.kt

@@ -19,9 +19,11 @@ internal class MimicCommands {
         if (commandApiPlugin == null) {
             Log.w("CommandAPI not found. Mimic commands won't be registered.")
             Log.w("Consider installing CommandAPI: https://docs.commandapi.dev/")
+            registerFallbackCommand(plugin)
             return
         } else if (!commandApiPlugin.isEnabled) {
             Log.w("CommandAPI loaded, but not enabled. Mimic commands won't be registered.")
+            registerFallbackCommand(plugin)
             return
         }
 
@@ -33,6 +35,13 @@ internal class MimicCommands {
         )
     }
 
+    private fun registerFallbackCommand(plugin: JavaPlugin) {
+        plugin.server.commandMap.register(
+            plugin.name.lowercase(),
+            FallbackCommand(plugin.pluginMeta.displayName),
+        )
+    }
+
     fun unregister() {
         if (registered) CommandAPI.unregister("mimic")
     }

mimic-bukkit/src/main/kotlin/internal/TextComponent.kt

@@ -7,7 +7,9 @@ import net.kyori.adventure.text.event.HoverEvent
 import net.kyori.adventure.text.format.TextColor
 import net.kyori.adventure.text.format.TextDecoration
 
-internal fun buildTextComponent(builder: TextComponent.Builder.() -> Unit): TextComponent = Component.text(builder)
+// See: https://github.com/KyoriPowered/adventure/tree/main/4/extra-kotlin
+
+internal fun text(builder: TextComponent.Builder.() -> Unit): TextComponent = Component.text(builder)
 
 internal fun TextComponent.Builder.appendLine(
     text: String,