refactor(wand): 重构魔杖插件界面系统

- 移除旧的屏幕和菜单回调方法，统一使用 buildUi 方法构建界面
- 更新 AutoCharge 插件实现，使用新的界面构建方式
- 修改 Coordinate 类，移除预存储的窗口尺寸，改为实时获取
- 简化 BasePlugin 抽象类的界面相关方法定义

Author: creepebucket

src/main/java/org/creepebucket/programmable_magic/gui/lib/api/Coordinate.java

@@ -21,25 +21,11 @@ public class Coordinate {
     public final BiFunction<Integer, Integer, Integer> y;
 
     /**
-     * 构造时捕获的窗口宽（缩放后）。
-     */
-    public final int sw;
-
-    /**
-     * 构造时捕获的窗口高（缩放后）。
-     */
-    public final int sh;
-
-    /**
-     * 创建一个坐标计算器，并捕获当前窗口缩放后的尺寸。
+     * 创建一个坐标计算器。
      */
     public Coordinate(BiFunction<Integer, Integer, Integer> x, BiFunction<Integer, Integer, Integer> y) {
         this.x = x;
         this.y = y;
-
-        var window = Minecraft.getInstance().getWindow();
-        this.sw = window.getGuiScaledWidth();
-        this.sh = window.getGuiScaledHeight();
     }
 
     /**
@@ -59,12 +45,18 @@ public int toMenuY() {
     /**
      * 计算屏幕坐标 X。
      */
-    public int toScreenX() { return this.x.apply(this.sw, this.sh); }
+    public int toScreenX() {
+        var window = Minecraft.getInstance().getWindow();
+        return this.x.apply(window.getGuiScaledWidth(), window.getGuiScaledHeight());
+    }
 
     /**
      * 计算屏幕坐标 Y。
      */
-    public int toScreenY() { return this.y.apply(this.sw, this.sh); }
+    public int toScreenY() {
+        var window = Minecraft.getInstance().getWindow();
+        return this.y.apply(window.getGuiScaledWidth(), window.getGuiScaledHeight());
+    }
 
     /**
      * 以屏幕左上角为基准创建坐标。

src/main/java/org/creepebucket/programmable_magic/gui/lib/ui/UiRuntime.java

@@ -74,6 +74,14 @@ public void addWidget(Widget widget) {
         widget.onInitialize();
     }
 
+    /**
+     * 移除全部控件并触发其移除回调。
+     */
+    public void clearWidgets() {
+        for (var w : this.widgets) w.onRemoved();
+        this.widgets.clear();
+    }
+
     /**
      * 移除一个控件并触发其移除回调。
      */
@@ -90,9 +98,15 @@ public void tick() {
     }
 
     /**
-     * 渲染所有控件。
+     * 渲染背景控件。
+     */
+    public void renderBackground(GuiGraphics graphics, int mouseX, int mouseY, float partialTick) {
+    }
+
+    /**
+     * 渲染前景控件。
      */
-    public void render(GuiGraphics graphics, int mouseX, int mouseY, float partialTick) {
+    public void renderForeground(GuiGraphics graphics, int mouseX, int mouseY, float partialTick) {
         for (var w : this.widgets) w.onRender(graphics, mouseX, mouseY, partialTick);
     }
 

src/main/java/org/creepebucket/programmable_magic/gui/lib/ui/UiScreenBase.java

@@ -15,6 +15,7 @@
  * UI 屏幕基类：将 Minecraft 的输入/渲染生命周期桥接到 {@link UiRuntime}。
  */
 public abstract class UiScreenBase<Menu extends UiMenuBase> extends SlotManipulationScreen<Menu> {
+    private float lastPartialTick = 0.0F;
 
     /**
      * 创建 UI 屏幕。
@@ -28,6 +29,8 @@ public UiScreenBase(Menu menu, Inventory playerInv, Component title) {
      */
     @Override
     protected void init() {
+        this.imageWidth = this.width;
+        this.imageHeight = this.height;
         super.init();
 
         updateUiBounds();
@@ -44,6 +47,8 @@ protected void init() {
      */
     @Override
     public void resize(int width, int height) {
+        this.imageWidth = width;
+        this.imageHeight = height;
         super.resize(width, height);
         updateUiBounds();
     }
@@ -58,16 +63,26 @@ protected void containerTick() {
     }
 
     /**
-     * 渲染原生容器界面后，再渲染 UI 运行时控件。
+     * 渲染原生容器界面后，再渲染 UI 前景控件。
      */
     @Override
     public void render(GuiGraphics graphics, int mouseX, int mouseY, float partialTick) {
+        this.lastPartialTick = partialTick;
         super.render(graphics, mouseX, mouseY, partialTick);
-        this.menu.ui().render(graphics, mouseX, mouseY, partialTick);
+        this.renderTooltip(graphics, mouseX, mouseY);
     }
 
     /**
-     * 该基类不绘制背景；具体背景交由子类或控件自行实现。
+     * 在标签层（renderLabels）渲染 UI 前景控件，确保其处于原生控件之后、tooltip 之前。
+     */
+    @Override
+    protected void renderLabels(GuiGraphics graphics, int mouseX, int mouseY) {
+        super.renderLabels(graphics, mouseX, mouseY);
+        this.menu.ui().renderForeground(graphics, mouseX, mouseY, this.lastPartialTick);
+    }
+
+    /**
+     * 默认在背景层渲染 UI 背景控件。
      */
     @Override
     protected void renderBg(GuiGraphics graphics, float partialTick, int mouseX, int mouseY) {

src/main/java/org/creepebucket/programmable_magic/gui/lib/widgets/ImageButtonWidget.java

@@ -0,0 +1,52 @@
+package org.creepebucket.programmable_magic.gui.lib.widgets;
+
+import net.minecraft.client.gui.GuiGraphics;
+import net.minecraft.client.input.MouseButtonEvent;
+import net.minecraft.client.renderer.RenderPipelines;
+import net.minecraft.resources.Identifier;
+import org.creepebucket.programmable_magic.gui.lib.api.Coordinate;
+import org.creepebucket.programmable_magic.gui.lib.api.Widget;
+
+import java.util.function.Consumer;
+
+public class ImageButtonWidget extends Widget {
+    private final Coordinate pos;
+    private final int width;
+    private final int height;
+    private final Identifier normal;
+    private final Identifier hover;
+    private final Consumer<MouseButtonEvent> onPress;
+
+    public ImageButtonWidget(Coordinate pos, int width, int height, Identifier normal, Identifier hover, Runnable onPress) {
+        this(pos, width, height, normal, hover, e -> onPress.run());
+    }
+
+    public ImageButtonWidget(Coordinate pos, int width, int height, Identifier normal, Identifier hover, Consumer<MouseButtonEvent> onPress) {
+        this.pos = pos;
+        this.width = width;
+        this.height = height;
+        this.normal = normal;
+        this.hover = hover;
+        this.onPress = onPress;
+    }
+
+    @Override
+    public void onRender(GuiGraphics graphics, int mouseX, int mouseY, float partialTick) {
+        int sx = this.pos.toScreenX();
+        int sy = this.pos.toScreenY();
+        boolean hovered = mouseX >= sx && mouseX < sx + this.width && mouseY >= sy && mouseY < sy + this.height;
+        var tex = hovered ? this.hover : this.normal;
+        graphics.blit(RenderPipelines.GUI_TEXTURED, tex, this.pos.toMenuX(), this.pos.toMenuY(), 0, 0, this.width, this.height, this.width, this.height);
+    }
+
+    @Override
+    public boolean mouseClicked(MouseButtonEvent event, boolean fromMouse) {
+        int x = this.pos.toScreenX();
+        int y = this.pos.toScreenY();
+        double mx = event.x();
+        double my = event.y();
+        if (mx < x || mx >= x + this.width || my < y || my >= y + this.height) return false;
+        this.onPress.accept(event);
+        return true;
+    }
+}

src/main/java/org/creepebucket/programmable_magic/gui/lib/widgets/ScrollRegionWidget.java

@@ -0,0 +1,43 @@
+package org.creepebucket.programmable_magic.gui.lib.widgets;
+
+import org.creepebucket.programmable_magic.gui.lib.api.Coordinate;
+import org.creepebucket.programmable_magic.gui.lib.api.Widget;
+
+import java.util.function.IntConsumer;
+import java.util.function.IntSupplier;
+
+public class ScrollRegionWidget extends Widget {
+    private final Coordinate pos;
+    private final IntSupplier width;
+    private final IntSupplier height;
+    private final IntSupplier getValue;
+    private final IntSupplier maxValue;
+    private final IntConsumer setValue;
+
+    public ScrollRegionWidget(Coordinate pos, IntSupplier width, IntSupplier height, IntSupplier getValue, IntSupplier maxValue, IntConsumer setValue) {
+        this.pos = pos;
+        this.width = width;
+        this.height = height;
+        this.getValue = getValue;
+        this.maxValue = maxValue;
+        this.setValue = setValue;
+    }
+
+    @Override
+    public boolean mouseScrolled(double mouseX, double mouseY, double scrollX, double scrollY) {
+        int x = this.pos.toScreenX();
+        int y = this.pos.toScreenY();
+        int w = this.width.getAsInt();
+        int h = this.height.getAsInt();
+        if (mouseX < x || mouseX >= x + w || mouseY < y || mouseY >= y + h) return false;
+        int d = scrollY > 0 ? -1 : (scrollY < 0 ? 1 : 0);
+        int cur = this.getValue.getAsInt();
+        int next = cur + d;
+        int max = Math.max(0, this.maxValue.getAsInt());
+        if (next < 0) next = 0;
+        if (next > max) next = max;
+        if (next == cur) return true;
+        this.setValue.accept(next);
+        return true;
+    }
+}

src/main/java/org/creepebucket/programmable_magic/gui/lib/widgets/SelectableImageButtonWidget.java

@@ -0,0 +1,47 @@
+package org.creepebucket.programmable_magic.gui.lib.widgets;
+
+import net.minecraft.client.gui.GuiGraphics;
+import net.minecraft.client.input.MouseButtonEvent;
+import net.minecraft.client.renderer.RenderPipelines;
+import net.minecraft.resources.Identifier;
+import org.creepebucket.programmable_magic.gui.lib.api.Coordinate;
+import org.creepebucket.programmable_magic.gui.lib.api.Widget;
+
+import java.util.function.BooleanSupplier;
+
+public class SelectableImageButtonWidget extends Widget {
+    private final Coordinate pos;
+    private final int width;
+    private final int height;
+    private final Identifier normal;
+    private final Identifier selected;
+    private final BooleanSupplier isSelected;
+    private final Runnable onPress;
+
+    public SelectableImageButtonWidget(Coordinate pos, int width, int height, Identifier normal, Identifier selected, BooleanSupplier isSelected, Runnable onPress) {
+        this.pos = pos;
+        this.width = width;
+        this.height = height;
+        this.normal = normal;
+        this.selected = selected;
+        this.isSelected = isSelected;
+        this.onPress = onPress;
+    }
+
+    @Override
+    public void onRender(GuiGraphics graphics, int mouseX, int mouseY, float partialTick) {
+        var tex = this.isSelected.getAsBoolean() ? this.selected : this.normal;
+        graphics.blit(RenderPipelines.GUI_TEXTURED, tex, this.pos.toMenuX(), this.pos.toMenuY(), 0, 0, this.width, this.height, this.width, this.height);
+    }
+
+    @Override
+    public boolean mouseClicked(MouseButtonEvent event, boolean fromMouse) {
+        int x = this.pos.toScreenX();
+        int y = this.pos.toScreenY();
+        double mx = event.x();
+        double my = event.y();
+        if (mx < x || mx >= x + this.width || my < y || my >= y + this.height) return false;
+        this.onPress.run();
+        return true;
+    }
+}

src/main/java/org/creepebucket/programmable_magic/gui/lib/widgets/SlotWidget.java

@@ -24,6 +24,11 @@ public SlotWidget(Slot slot, Coordinate pos) {
     /**
      * 持续更新槽位的客户端坐标。
      */
+    @Override
+    public void onInitialize() {
+        onTick();
+    }
+
     @Override
     public void onTick() {
         ClientSlotManager.setClientPosition(this.slot, this.pos.toMenuX(), this.pos.toMenuY());

src/main/java/org/creepebucket/programmable_magic/gui/lib/widgets/TextWidget.java

@@ -0,0 +1,29 @@
+package org.creepebucket.programmable_magic.gui.lib.widgets;
+
+import net.minecraft.client.Minecraft;
+import net.minecraft.client.gui.GuiGraphics;
+import org.creepebucket.programmable_magic.gui.lib.api.Coordinate;
+import org.creepebucket.programmable_magic.gui.lib.api.Widget;
+
+import java.util.function.IntSupplier;
+import java.util.function.Supplier;
+
+public class TextWidget extends Widget {
+    private final Coordinate pos;
+    private final Supplier<String> text;
+    private final IntSupplier color;
+
+    public TextWidget(Coordinate pos, Supplier<String> text, IntSupplier color) {
+        this.pos = pos;
+        this.text = text;
+        this.color = color;
+    }
+
+    @Override
+    public void onRender(GuiGraphics graphics, int mouseX, int mouseY, float partialTick) {
+        graphics.drawString(Minecraft.getInstance().font, this.text.get(),
+                this.pos.toMenuX(),
+                this.pos.toMenuY(),
+                this.color.getAsInt());
+    }
+}

src/main/java/org/creepebucket/programmable_magic/gui/lib/widgets/TextureWidget.java

@@ -32,7 +32,7 @@ public TextureWidget(Coordinate pos, Identifier texture, int width, int height)
     @Override
     public void onRender(GuiGraphics graphics, int mouseX, int mouseY, float partialTick) {
         graphics.blit(RenderPipelines.GUI_TEXTURED, this.texture,
-                this.pos.toScreenX(), this.pos.toScreenY(),
+                this.pos.toMenuX(), this.pos.toMenuY(),
                 0, 0,
                 this.width, this.height,
                 this.width, this.height);