feat:新增/ctnh hand /ctnh showtag两个命令

.gitignore

@@ -117,3 +117,7 @@ runs/
 
 # Avoid ignoring Gradle wrapper jar file (.jar files are usually ignored)
 !gradle-wrapper.jar
+
+#OMO
+.omo
+

src/main/java/com/ctnhlang/IgnoreLang.java

@@ -7,5 +7,4 @@
 
 @Retention(RetentionPolicy.RUNTIME)
 @Target(ElementType.FIELD)
-public @interface IgnoreLang {
-}
+public @interface IgnoreLang {}

src/main/java/com/ctnhlang/langprovider/LangKeyBuilder.java

@@ -93,7 +93,8 @@ private static ClassMetadata fromClass(Class<?> ownerClass) {
         return new ClassMetadata(
                 domain != null ? domain.value() : "",
                 "",
-                resolveCategory(domain != null ? domain.value() : "", category != null ? category.value() : "", ownerClass.getSimpleName()),
+                resolveCategory(domain != null ? domain.value() : "", category != null ? category.value() : "",
+                        ownerClass.getSimpleName()),
                 prefix != null ? resolveAffix(prefix.value(), ownerClass.getSimpleName()) : "",
                 suffix != null ? resolveAffix(suffix.value(), ownerClass.getSimpleName()) : "");
     }
@@ -119,7 +120,8 @@ private static ClassMetadata fromClassNode(ClassNode classNode) {
             }
         }
 
-        return new ClassMetadata(domain, root, resolveCategory(domain, category, simpleName(classNode.name)), prefix, suffix);
+        return new ClassMetadata(domain, root, resolveCategory(domain, category, simpleName(classNode.name)), prefix,
+                suffix);
     }
 
     private static String getExplicitKey(Field field) {
@@ -158,9 +160,7 @@ private static String resolveCategory(String domain, String explicitCategory, St
     }
 
     private static String resolveAffix(String explicitValue, String className) {
-        return explicitValue == null || explicitValue.isEmpty()
-                ? className.toLowerCase(Locale.ROOT)
-                : explicitValue;
+        return explicitValue == null || explicitValue.isEmpty() ? className.toLowerCase(Locale.ROOT) : explicitValue;
     }
 
     private static String simpleName(String internalName) {

src/main/java/tech/vixhentx/mcmod/ctnhlib/command/CTNHCommandChatHelper.java

@@ -0,0 +1,195 @@
+package tech.vixhentx.mcmod.ctnhlib.command;
+
+import net.minecraft.ChatFormatting;
+import net.minecraft.network.chat.ClickEvent;
+import net.minecraft.network.chat.Component;
+import net.minecraft.network.chat.HoverEvent;
+import net.minecraft.network.chat.MutableComponent;
+import net.minecraft.network.chat.Style;
+
+import java.util.ArrayList;
+import java.util.List;
+import java.util.function.Function;
+
+/**
+ * 用于构建 /ctnh 检查命令的点击复制聊天行的辅助工具。
+ * 每行输出的文本在点击时会复制对应值内容，并显示悬浮提示。
+ */
+public final class CTNHCommandChatHelper {
+
+    /** 单个聊天行值的最大长度，超过该长度将拆分为多个块。 */
+    public static final int MAX_VALUE_LINE_LENGTH = 256;
+
+    private CTNHCommandChatHelper() {}
+
+    /**
+     * 为带标签的值构建一个或多个可点击的聊天行。长值将被拆分为
+     * 额外的可复制续行，以避免聊天窗口静默丢弃内容。
+     *
+     * @param label 本地化标签
+     * @param value 原始值字符串（不能为 null）
+     * @return 一个或多个可发送的 {@link Component} 行
+     */
+    public static List<Component> labeledLines(Component label, String value) {
+        return labeledLines(label, value, ChatFormatting.WHITE);
+    }
+
+    /**
+     * 为带标签的值构建一个或多个可点击的聊天行，并用指定颜色显示值部分。
+     * 长值将被拆分为额外的可复制续行，以避免聊天窗口静默丢弃内容。
+     *
+     * @param label      本地化标签
+     * @param value      原始值字符串（不能为 null）
+     * @param valueColor 值文本颜色
+     * @return 一个或多个可发送的 {@link Component} 行
+     */
+    public static List<Component> labeledLines(Component label, String value, ChatFormatting valueColor) {
+        return labeledLines(label, value, value, valueColor);
+    }
+
+    /**
+     * 为带标签的值构建一个或多个可点击的聊天行，并允许显示值和复制值不同。
+     */
+    public static List<Component> labeledLines(Component label, String value, String copyText,
+                                               ChatFormatting valueColor) {
+        List<Component> lines = new ArrayList<>();
+        String safe = value == null ? "" : value;
+        String safeCopy = copyText == null ? safe : copyText;
+        if (safe.length() <= MAX_VALUE_LINE_LENGTH) {
+            lines.add(buildLine(label, safe, safeCopy, valueColor));
+            return lines;
+        }
+        int total = safe.length();
+        int chunkIndex = 0;
+        for (int start = 0; start < total; start += MAX_VALUE_LINE_LENGTH) {
+            int end = Math.min(total, start + MAX_VALUE_LINE_LENGTH);
+            String chunk = safe.substring(start, end);
+            if (chunkIndex == 0) {
+                lines.add(buildLine(label.copy(), chunk, chunk, valueColor));
+            } else {
+                lines.add(buildContinuationLine(label, chunk, chunk, valueColor,
+                        Component.translatable("command.ctnhlib.copy.hover")));
+            }
+            chunkIndex++;
+        }
+        // 尾部摘要行（不可复制，仅用于提示信息）。
+        lines.add(Component.translatable("command.ctnhlib.value.truncated", total)
+                .withStyle(ChatFormatting.GRAY));
+        return lines;
+    }
+
+    /** 为多个标签 ID 构建逐行显示的可复制聊天行，每行点击时仅复制标签 ID。 */
+    public static List<Component> labeledTagLines(Component label, List<String> tagIds, ChatFormatting tagColor) {
+        return labeledTagLines(label, tagIds, tagColor,
+                ignored -> Component.translatable("command.ctnhlib.copy.hover"));
+    }
+
+    /** 为多个标签 ID 构建逐行显示的可复制聊天行，并允许每行使用自定义悬浮提示。 */
+    public static List<Component> labeledTagLines(Component label,
+                                                  List<String> tagIds,
+                                                  ChatFormatting tagColor,
+                                                  Function<String, Component> hoverFactory) {
+        List<Component> lines = new ArrayList<>();
+        if (tagIds == null || tagIds.isEmpty()) {
+            lines.addAll(labeledLines(label,
+                    Component.translatable("command.ctnhlib.value.empty").getString(),
+                    tagColor));
+            return lines;
+        }
+        for (int i = 0; i < tagIds.size(); i++) {
+            String tagId = tagIds.get(i);
+            String safe = tagId == null ? "" : tagId;
+            Component hover = hoverFactory == null ? Component.translatable("command.ctnhlib.copy.hover") :
+                    hoverFactory.apply(safe);
+            if (i == 0) {
+                lines.add(buildLine(label.copy(), safe, safe, tagColor, hover));
+            } else {
+                lines.add(buildContinuationLine(label, safe, safe, tagColor, hover));
+            }
+        }
+        return lines;
+    }
+
+    /**
+     * 构建单个聊天行，其可见文本为 "label: value"，单击事件将逐字复制提供的 {@code copyText}。
+     */
+    public static Component buildLine(Component label, String value, String copyText) {
+        return buildLine(label, value, copyText, ChatFormatting.WHITE);
+    }
+
+    /**
+     * 构建单个聊天行，其可见文本为 "label: value"，单击事件将逐字复制提供的 {@code copyText}。
+     */
+    public static Component buildLine(Component label, String value, String copyText, ChatFormatting valueColor) {
+        return buildLine(label, value, copyText, valueColor, Component.translatable("command.ctnhlib.copy.hover"));
+    }
+
+    /**
+     * 构建单个聊天行，其可见文本为 "label: value"，并使用自定义悬浮提示。
+     */
+    public static Component buildLine(Component label,
+                                      String value,
+                                      String copyText,
+                                      ChatFormatting valueColor,
+                                      Component hoverText) {
+        MutableComponent labelStyled = label.copy().withStyle(ChatFormatting.AQUA);
+        MutableComponent valueStyled = Component.literal(value).withStyle(valueColor);
+        MutableComponent line = Component.empty()
+                .append(labelStyled)
+                .append(Component.literal(": ").withStyle(ChatFormatting.GRAY))
+                .append(valueStyled);
+
+        Style style = Style.EMPTY
+                .withClickEvent(new ClickEvent(ClickEvent.Action.COPY_TO_CLIPBOARD, copyText))
+                .withHoverEvent(new HoverEvent(HoverEvent.Action.SHOW_TEXT, hoverText));
+        return line.withStyle(style);
+    }
+
+    /**
+     * 构建续行（无标签和冒号），仅显示与首行值列对齐的值部分。
+     * 使用空格填充来匹配首行 "label: " 的宽度，然后仅追加带颜色的值。
+     */
+    private static Component buildContinuationLine(Component label, String value, String copyText,
+                                                   ChatFormatting valueColor, Component hoverText) {
+        int pad = label.getString().length() + 2; // "label: "
+        MutableComponent spacer = Component.literal(" ".repeat(Math.max(0, pad)));
+        MutableComponent valueStyled = Component.literal(value).withStyle(valueColor);
+        MutableComponent line = Component.empty().append(spacer).append(valueStyled);
+
+        Style style = Style.EMPTY
+                .withClickEvent(new ClickEvent(ClickEvent.Action.COPY_TO_CLIPBOARD, copyText))
+                .withHoverEvent(new HoverEvent(HoverEvent.Action.SHOW_TEXT, hoverText));
+        return line.withStyle(style);
+    }
+
+    /** 分区标题行（无复制点击事件）。 */
+    public static Component heading(Component component) {
+        return component.copy().withStyle(ChatFormatting.GOLD);
+    }
+
+    /** 简单的信息提示行，例如"未包含流体"，无复制事件。 */
+    public static Component info(Component component) {
+        return component.copy().withStyle(ChatFormatting.GRAY);
+    }
+
+    /** 命令失败时使用的红色错误行。 */
+    public static Component error(Component component) {
+        return component.copy().withStyle(ChatFormatting.RED);
+    }
+
+    /**
+     * 构建单个点击复制聊天行，其可见文本为提供的
+     * {@code visible} 组件（无自动标签前缀），点击事件将复制提供的 {@code copyText}。
+     */
+    public static Component clickableLine(MutableComponent visible, String copyText) {
+        return clickableLine(visible, copyText, Component.translatable("command.ctnhlib.copy.hover"));
+    }
+
+    /** 使用自定义悬浮提示构建无标签点击复制聊天行。 */
+    public static Component clickableLine(MutableComponent visible, String copyText, Component hoverText) {
+        Style style = Style.EMPTY
+                .withClickEvent(new ClickEvent(ClickEvent.Action.COPY_TO_CLIPBOARD, copyText))
+                .withHoverEvent(new HoverEvent(HoverEvent.Action.SHOW_TEXT, hoverText));
+        return visible.withStyle(style);
+    }
+}