From fd63a506038b58379fb40ec35e9602ecb5545c21 Mon Sep 17 00:00:00 2001
From: Fabric Bot <159731069+FabricMCBot@users.noreply.github.com>
Date: Tue, 28 Jan 2025 16:33:25 +0000
Subject: [PATCH] New translations custom-screens.md (Chinese Traditional)

---
 .../develop/rendering/gui/custom-screens.md   | 64 +++++++++++++++++++
 1 file changed, 64 insertions(+)
 create mode 100644 translated/zh_tw/develop/rendering/gui/custom-screens.md

diff --git a/translated/zh_tw/develop/rendering/gui/custom-screens.md b/translated/zh_tw/develop/rendering/gui/custom-screens.md
new file mode 100644
index 000000000..42f4de80a
--- /dev/null
+++ b/translated/zh_tw/develop/rendering/gui/custom-screens.md
@@ -0,0 +1,64 @@
+---
+title: 自訂畫面
+description: 了解如何為你的模組製作自訂畫面
+authors:
+  - IMB11
+---
+
+# 自訂畫面 {#custom-screens}
+
+:::info
+這篇教學只包含一般介面，不包含同步介面 `HandledScreen`，一般畫面只會在客戶端顯示，不會與伺服器同步。
+:::
+
+畫面就是玩家可以互動的圖形介面，例如：主畫面，暫停選單。
+
+你可以建立自己的畫面來顯示自訂內容、設定等。
+
+## 創建一個畫面 {#creating-a-screen}
+
+創建一個畫面會需要繼承（extend）`Screen` 類別和重寫 （override）`init` 函式，你也可以重寫（override）`render` 函式，但請確保呼叫父類函式（super），不然背景以及畫面元件不會被顯示。
+
+請注意：
+
+- 畫面元件不應該在建構子裡被創造，因為畫面還沒建構完成，部分變數（例如：寬度 `width`、高度 `height`）還無法被存取或是不準確。
+- `init` 函式是在畫面被創建時呼叫的，所以創建畫面元件最適合在裡面執行。
+  - `addDrawableChild`函式負責顯示畫面元件，他可以顯示任何可以被繪製（drawable）的畫面元件。
+- `render` 函式每幀都會被執行，在函式中可以獲取圖形繪器 `DrawContext` 和滑鼠位置 `mouseX` `mouseY`。
+
+我們將創建一個簡單的畫面，畫面包含一個按鈕和一串標示。
+
+@[code lang=java transcludeWith=:::1](@/reference/latest/src/client/java/com/example/docs/rendering/screens/CustomScreen.java)
+
+![自訂畫面 1](/assets/develop/rendering/gui/custom-1-example.png)
+
+## 打開畫面 {#opening-the-screen}
+
+你可以透過 `MinecraftClient` 的 `setScreen` 函式來打開自訂畫面，開啟的方法可以有很多（例如：按鍵，指令，封包）。
+
+```java
+MinecraftClient.getInstance().setScreen(
+  new CustomScreen(Text.empty())
+);
+```
+
+## 關閉畫面 {#closing-the-screen}
+
+如果你想要關閉畫面回到遊戲，可以使用 `setScreen(null)` 函式。
+
+```java
+MinecraftClient.getInstance().setScreen(null);
+```
+
+如果你想要回到上一個畫面，在現在的畫面的建構子裡傳入上一個畫面，並將它保存到參數裡，然後在 `close` 函式裡呼叫 `setScreen(/* 剛剛保存的畫面 */)` 。
+
+@[code lang=java transcludeWith=:::2](@/reference/latest/src/client/java/com/example/docs/rendering/screens/CustomScreen.java)
+
+這樣當你在開啟新的畫面時，你可以把現在的畫面傳入建構子中，然後在 `CustomScreen#Close` 執行時，就可以回到上個畫面了。
+
+```java
+Screen currentScreen = MinecraftClient.getInstance().currentScreen;
+MinecraftClient.getInstance().setScreen(
+  new CustomScreen(Text.empty(), currentScreen)
+);
+```