Add account status badge and addon API across Forge targets

Author: F1xGOD

README.md

@@ -159,16 +159,21 @@ Allows a short same-IP reconnect grace period after a verified player disconnect
 auth.showJoinFeedback = true
 ```
 
-Show join feedback Title/chat messages for premium, skin-site, offline fallback, and single-player states. Set to `false` to silence those messages without changing authentication or skin refresh behavior.
+Show the join feedback chat message for premium, skin-site, offline fallback, and single-player states. Set to `false` to silence it without changing authentication or skin refresh behavior.
+
+```toml
+auth.showJoinTitle = false
+```
+
+Additionally show a full-screen title/subtitle on join. Off by default, because the persistent account-status overlay below already reports the same state without interrupting the screen. Set to `true` to restore the old title behavior.
 
 ```toml
 auth.showAccountOverlay = true
 ```
 
-Shows a small top-left client badge after a TrueUUID handshake. Green means
-premium verified; red means the server accepted its configured offline
-fallback. It is client-local and only appears after a TrueUUID-enabled server
-has responded.
+Shows a small client-side badge after a TrueUUID handshake: green `Premium` or
+red `Offline`, drawn as plain corner text with no backdrop. It is client-local
+and only appears after a TrueUUID-enabled server has responded.
 
 Default feedback and disconnect messages are sent as Minecraft translation keys and rendered by the player's client language files (`en_us` / `zh_cn`). If you previously generated a config with custom bilingual strings, change those message values back to `trueuuid.*` keys or regenerate the config to use client-side localization.
 
@@ -190,6 +195,60 @@ auth.yggdrasil.apiRootWhitelist = []
 
 Allowlist for Yggdrasil/authlib-injector `hasJoined` hosts. An empty list rejects all client-reported endpoints and keeps Mojang as the safe default. Add an exact host such as `"littleskin.cn"`, or an explicit wildcard such as `"*.example.com"`. Custom endpoints must pass HTTPS/443, path, DNS/IP, response-size, timeout, and no-redirect checks.
 
+The account-status badge position is configurable:
+
+```toml
+auth.overlayCorner = "bottom_right"
+auth.overlayOffsetX = 0
+auth.overlayOffsetY = 0
+auth.overlayScale = 1.25
+```
+
+`overlayCorner` accepts `top_left`, `top_right`, `bottom_left`, or `bottom_right`.
+`bottom_right` is the default because vanilla keeps status effects and
+advancement toasts in the top right, chat in the bottom left, and other mods
+commonly claim the top left. The offsets nudge the badge by that many pixels
+(positive = right/down) if it still collides with another mod's HUD.
+`overlayScale` sizes the padlock and label together; whole numbers (`1.0`, `2.0`)
+keep Minecraft's bitmap font perfectly crisp, values in between are slightly soft.
+
+These options behave identically on every supported target.
+
+## Addon API
+
+TrueUUID exposes a small server-side API (`cn.alini.trueuuid.api`) so other mods
+can branch on whether an online player authenticated as premium or through
+offline fallback — for example, sending offline players to a separate spawn.
+
+`AccountStatus` is one of `PREMIUM_VERIFIED`, `ONLINE_MODE`, `OFFLINE_FALLBACK`,
+or `UNKNOWN` (with `isPremium()` / `isOffline()` helpers).
+
+Query a player's status at any time while they are online:
+
+```java
+import cn.alini.trueuuid.api.TrueuuidApi;
+import cn.alini.trueuuid.api.AccountStatus;
+
+AccountStatus status = TrueuuidApi.getStatus(serverPlayer);
+if (status.isOffline()) {
+    // e.g. restrict permissions, or teleport to an offline-only world
+}
+```
+
+Or register a callback fired on the server thread the moment a player's status
+is known at join (register once during your mod's setup):
+
+```java
+TrueuuidApi.registerLoginCallback((player, status) -> {
+    if (status.isOffline()) {
+        // first-join spawn handling for offline accounts
+    }
+});
+```
+
+Also available: `TrueuuidApi.isKnownPremiumName(name)` and
+`TrueuuidApi.getPremiumUuid(name)` for the persistent verified-name registry.
+
 ## Compatibility Notes
 
 - Proxies: Mojang's `hasJoined` IP parameter is optional. Verification can still work when the real client IP is hidden by a proxy.

platform/forge-1.20.1/src/main/java/cn/alini/trueuuid/client/ClientAccountStatus.java

@@ -11,11 +11,82 @@
 import net.minecraftforge.eventbus.api.SubscribeEvent;
 import net.minecraftforge.fml.common.Mod;
 
-/** Client-local account state derived from the TrueUUID login handshake. */
+/**
+ * Client-local account badge: a closed padlock + green "Premium", or an open
+ * padlock + red "Offline".
+ *
+ * <p>1.20.1 is an independent adapter, so this mirrors the modern Forge line's
+ * {@code platform/forge-common} badge deliberately — same sprite, colours, config
+ * and layout — so every supported target looks identical. Keep the two in step
+ * when either changes. The padlock is painted with {@code fill} rather than a blit
+ * texture to match that shared implementation.
+ */
 @Mod.EventBusSubscriber(modid = Trueuuid.MODID, value = Dist.CLIENT, bus = Mod.EventBusSubscriber.Bus.MOD)
 public final class ClientAccountStatus {
     private static volatile Status status = Status.NONE;
 
+    // Sprites generated from the source PNGs. Palette: 1-4 shackle, 5/6/8/9 body,
+    // 7 body highlight, g/G green check, r/R red cross. ' ' is transparent.
+    // Both frames share one 11x16 grid: the open shackle sits a pixel higher, and
+    // a shared grid keeps the bodies aligned so the badge does not jump.
+    private static final String[] LOCK_CLOSED = {
+        "           ",
+        "   11111   ",
+        "  1233331  ",
+        " 121111431 ",
+        " 121   431 ",
+        "55555555556",
+        "57777777786",
+        "57999999g56",
+        "5799999gG56",
+        "57g999gG956",
+        "57Gg9gG9956",
+        "579GgG99956",
+        "5799G999956",
+        "57999999956",
+        "68555555556",
+        "66666666666",
+    };
+    private static final String[] LOCK_OPEN = {
+        "   11111   ",
+        "  1233331  ",
+        " 121111431 ",
+        " 121   431 ",
+        " 121       ",
+        "55555555556",
+        "57777777786",
+        "579R999R956",
+        "57RrR9RrR56",
+        "579RrRrR956",
+        "5799RrR9956",
+        "579RrRrR956",
+        "57RrR9RrR56",
+        "579R999R956",
+        "68555555556",
+        "66666666666",
+    };
+
+    private static final int ICON_W = 11;
+    private static final int ICON_H = 16;
+    private static final int GAP = 3;
+    private static final int MARGIN = 4;
+    /**
+     * Rows spanned by the padlock body, the shackle sitting above it. The label is
+     * centred on the body rather than on the whole sprite: the sprite's midpoint
+     * lands inside the shackle, which makes the text visibly ride high.
+     */
+    private static final int BODY_TOP = 5;
+    private static final int BODY_BOTTOM = 16;
+    /**
+     * Label scale relative to the padlock. The art is {@link #ICON_H}px tall while
+     * Minecraft's font is 8px, so the lock reads larger than its label. Fix that by
+     * redrawing the source PNGs at roughly the font's height and regenerating the
+     * sprite below -- do not resample here: the art has one-pixel shackle lines and
+     * a one-pixel mark, so nearest-neighbour shreds them and a smooth filter blends
+     * the green/red mark into the yellow body.
+     */
+    private static final float TEXT_SCALE = 1.0F;
+
     public static void markPremium() { status = Status.PREMIUM; }
     public static void markOffline() { status = Status.OFFLINE; }
 
@@ -27,18 +98,91 @@ public static void registerOverlay(RegisterGuiOverlaysEvent event) {
     private static void render(ForgeGui gui, GuiGraphics graphics, float partialTick, int width, int height) {
         Minecraft minecraft = Minecraft.getInstance();
         if (!TrueuuidConfig.showAccountOverlay() || minecraft.player == null || status == Status.NONE) return;
-        Component text = Component.translatable("trueuuid.overlay.label", Component.translatable(status.translationKey));
-        int textWidth = minecraft.font.width(text);
-        int x = 6;
-        int y = 6;
-        graphics.fill(x - 3, y - 3, x + textWidth + 3, y + 12, 0xA0000000);
-        graphics.drawString(minecraft.font, text, x, y, status.color, true);
+
+        Component text = Component.translatable(status.translationKey);
+        float lockScale = TrueuuidConfig.overlayScale();
+        float textScale = lockScale * TEXT_SCALE;
+
+        // Lay the badge out in screen pixels, since the padlock and the label are
+        // drawn at different scales.
+        float lockWidth = ICON_W * lockScale;
+        float gapWidth = GAP * lockScale;
+        float textWidth = minecraft.font.width(text) * textScale;
+        float drawnWidth = lockWidth + gapWidth + textWidth;
+        float drawnHeight = ICON_H * lockScale;
+
+        boolean right = TrueuuidConfig.overlayCorner().endsWith("right");
+        boolean bottom = TrueuuidConfig.overlayCorner().startsWith("bottom");
+        float screenX = (right ? width - MARGIN - drawnWidth : MARGIN) + TrueuuidConfig.overlayOffsetX();
+        float screenY = (bottom ? height - MARGIN - drawnHeight : MARGIN) + TrueuuidConfig.overlayOffsetY();
+
+        // Each element is drawn inside its own scale and positioned by converting
+        // the screen anchor back into that scale's units.
+        graphics.pose().pushPose();
+        try {
+            graphics.pose().scale(lockScale, lockScale, 1.0F);
+            drawSprite(graphics, Math.round(screenX / lockScale), Math.round(screenY / lockScale),
+                    status == Status.PREMIUM ? LOCK_CLOSED : LOCK_OPEN);
+        } finally {
+            graphics.pose().popPose();
+        }
+
+        float bodyCentre = screenY + (BODY_TOP + BODY_BOTTOM) / 2.0F * lockScale;
+        float textTop = bodyCentre - minecraft.font.lineHeight * textScale / 2.0F;
+        graphics.pose().pushPose();
+        try {
+            graphics.pose().scale(textScale, textScale, 1.0F);
+            graphics.drawString(minecraft.font, text,
+                    Math.round((screenX + lockWidth + gapWidth) / textScale),
+                    Math.round(textTop / textScale),
+                    0xFF000000 | status.color, true);
+        } finally {
+            graphics.pose().popPose();
+        }
+    }
+
+    /** Paints one pixel-art sprite, coalescing each row into horizontal runs. */
+    private static void drawSprite(GuiGraphics graphics, int x, int y, String[] rows) {
+        for (int row = 0; row < rows.length; row++) {
+            String line = rows[row];
+            int column = 0;
+            while (column < line.length()) {
+                char pixel = line.charAt(column);
+                if (pixel == ' ') {
+                    column++;
+                    continue;
+                }
+                int run = 1;
+                while (column + run < line.length() && line.charAt(column + run) == pixel) run++;
+                graphics.fill(x + column, y + row, x + column + run, y + row + 1, colorOf(pixel));
+                column += run;
+            }
+        }
+    }
+
+    private static int colorOf(char pixel) {
+        return switch (pixel) {
+            case '1' -> 0xFF575C71;
+            case '2' -> 0xFFC9CBD8;
+            case '3' -> 0xFFACB0C1;
+            case '4' -> 0xFF3F4656;
+            case '5' -> 0xFFB26411;
+            case '6' -> 0xFF752702;
+            case '7' -> 0xFFFDF55F;
+            case '8' -> 0xFFDC9613;
+            case '9' -> 0xFFE9B114;
+            case 'g' -> 0xFF4AB85C;
+            case 'G' -> 0xFF259B4A;
+            case 'r' -> 0xFFEE3934;
+            case 'R' -> 0xFFBD2E2E;
+            default -> 0;
+        };
     }
 
     private enum Status {
         NONE("", 0),
-        PREMIUM("trueuuid.overlay.premium", 0x55FF55),
-        OFFLINE("trueuuid.overlay.offline", 0xFF5555);
+        PREMIUM("trueuuid.overlay.premium", 0x259B4A),
+        OFFLINE("trueuuid.overlay.offline", 0xBD2E2E);
 
         private final String translationKey;
         private final int color;

platform/forge-1.20.1/src/main/java/cn/alini/trueuuid/config/TrueuuidConfig.java

@@ -34,6 +34,10 @@ public static void register() {
     public static String onlineShortSubtitle() { return COMMON.onlineShortSubtitle.get(); }
     public static boolean showJoinFeedback() { return COMMON.showJoinFeedback.get(); }
     public static boolean showAccountOverlay() { return COMMON.showAccountOverlay.get(); }
+    public static String overlayCorner() { return COMMON.overlayCorner.get(); }
+    public static int overlayOffsetX() { return COMMON.overlayOffsetX.get(); }
+    public static int overlayOffsetY() { return COMMON.overlayOffsetY.get(); }
+    public static float overlayScale() { return COMMON.overlayScale.get().floatValue(); }
 
     // 新增：策略相关 (Added: Strategy related)
     public static boolean knownPremiumDenyOffline() { return COMMON.knownPremiumDenyOffline.get(); }
@@ -58,6 +62,10 @@ public static final class Common {
         public final ForgeConfigSpec.ConfigValue<String> onlineShortSubtitle;
         public final ForgeConfigSpec.BooleanValue showJoinFeedback;
         public final ForgeConfigSpec.BooleanValue showAccountOverlay;
+        public final ForgeConfigSpec.ConfigValue<String> overlayCorner;
+        public final ForgeConfigSpec.IntValue overlayOffsetX;
+        public final ForgeConfigSpec.IntValue overlayOffsetY;
+        public final ForgeConfigSpec.DoubleValue overlayScale;
 
         // authlib-injector / Yggdrasil 皮肤站白名单
         public final ForgeConfigSpec.ConfigValue<List<? extends String>> apiRootWhitelist;
@@ -93,6 +101,16 @@ public static final class Common {
                     .define("showJoinFeedback", true);
             showAccountOverlay = b.comment("Show a small client account-status overlay after a TrueUUID login handshake. / 在 TrueUUID 登录握手后显示小型客户端账号状态覆盖层。")
                     .define("showAccountOverlay", true);
+            // Keep these identical to the modern Forge line (platform/forge-common)
+            // so the badge behaves the same on every supported target.
+            overlayCorner = b.comment("Screen corner for the account-status badge: top_left, top_right, bottom_left, bottom_right. Default bottom_right: vanilla keeps status effects and advancement toasts in the top right, chat in the bottom left, and mods commonly take the top left. / 账号状态角标所在屏幕角落。默认 bottom_right。")
+                    .defineInList("overlayCorner", "bottom_right", java.util.List.of("top_left", "top_right", "bottom_left", "bottom_right"));
+            overlayOffsetX = b.comment("Extra horizontal pixels for the badge, to dodge another mod's HUD. Positive moves right. / 角标水平像素偏移，正值向右。")
+                    .defineInRange("overlayOffsetX", 0, -4096, 4096);
+            overlayOffsetY = b.comment("Extra vertical pixels for the badge, to dodge another mod's HUD. Positive moves down. / 角标垂直像素偏移，正值向下。")
+                    .defineInRange("overlayOffsetY", 0, -4096, 4096);
+            overlayScale = b.comment("Size of the account-status badge, scaling the padlock and label together. Whole numbers (1.0, 2.0) keep the bitmap font crisp. / 账号状态角标缩放，整数值字体最清晰。")
+                    .defineInRange("overlayScale", 1.0D, 0.5D, 4.0D);
 
             // 策略项 (Strategy items)
             knownPremiumDenyOffline   = b.comment("Once a name has been verified as premium/skin-site, deny later offline fallback for that name. / 一旦该名字成功验证过正版或皮肤站，后续鉴权失败时禁止以离线身份进入。")

platform/forge-1.20.1/src/main/resources/assets/trueuuid/lang/en_us.json

@@ -10,9 +10,8 @@
   "trueuuid.chat.offline_fallback": "Notice: You joined in Offline Mode. If you own a premium account, verification may have failed because of network issues. Please relog and try again. If you continue playing, player data may need migration after a later successful verification.",
   "trueuuid.chat.premium": "[TrueUUID] Premium account verified.",
   "trueuuid.chat.skin_site": "[TrueUUID] Skin-site account verified by %s.",
-  "trueuuid.overlay.label": "Account: %s",
-  "trueuuid.overlay.premium": "Premium verified",
-  "trueuuid.overlay.offline": "Offline fallback",
+  "trueuuid.overlay.premium": "Premium",
+  "trueuuid.overlay.offline": "Offline",
   "trueuuid.auth_source.premium": "Premium verification",
   "trueuuid.auth_source.skin_site": "Skin-site login",
   "trueuuid.auth_source.skin_site.with_name": "Skin-site login (%s)",

platform/forge-1.20.1/src/main/resources/assets/trueuuid/lang/zh_cn.json

@@ -10,9 +10,8 @@
   "trueuuid.chat.offline_fallback": "注意：你当前以离线模式进入服务器；如果你是正版账号，可能是网络原因导致无法成功鉴权，请重新登录重试。继续游玩后，若后续鉴权成功，可能需要迁移玩家数据。",
   "trueuuid.chat.premium": "[TrueUUID] 正版账号验证成功。",
   "trueuuid.chat.skin_site": "[TrueUUID] 已通过 %s 验证皮肤站账号。",
-  "trueuuid.overlay.label": "账号：%s",
-  "trueuuid.overlay.premium": "正版验证通过",
-  "trueuuid.overlay.offline": "离线兜底",
+  "trueuuid.overlay.premium": "正版",
+  "trueuuid.overlay.offline": "离线",
   "trueuuid.auth_source.premium": "正版验证",
   "trueuuid.auth_source.skin_site": "皮肤站登录",
   "trueuuid.auth_source.skin_site.with_name": "皮肤站登录（%s）",

platform/forge-1.21.1/build.gradle

@@ -58,8 +58,12 @@ minecraft {
                 }
             }
         }
-        client { property 'forge.enabledGameTestNamespaces', 'trueuuid' }
+        client {
+            workingDirectory project.file('run/client')
+            property 'forge.enabledGameTestNamespaces', 'trueuuid'
+        }
         server {
+            workingDirectory project.file('run/server')
             property 'forge.enabledGameTestNamespaces', 'trueuuid'
             args '--nogui'
         }

platform/forge-1.21.1/src/main/java/cn/alini/trueuuid/TrueuuidForgeEvents.java

@@ -21,6 +21,11 @@ public static void onPlayerLoggedIn(PlayerEvent.PlayerLoggedInEvent event) {
         ForgeAdapterRuntime.onPlayerLoggedIn(event);
     }
 
+    @SubscribeEvent
+    public static void onPlayerLoggedOut(PlayerEvent.PlayerLoggedOutEvent event) {
+        ForgeAdapterRuntime.onPlayerLoggedOut(event);
+    }
+
     @SubscribeEvent
     public static void onServerStopping(ServerStoppingEvent event) {
         ForgeAdapterRuntime.shutdown();