StardewUI

作者 focustense·版本 v0.6.1·更新於 2025-11-05

爲星露谷物語模組構建用戶界面的終極框架

截圖 共 6 張

模組介紹 作者原文

爲星露谷物語模組構建用戶界面的終極框架

StardewUI

🎨 模組開發者的新時代

React誕生於2013年,Windows Presentation Foundation在2006年首次亮相,Qt更是從*1991年*就存在了。爲什麼你還在使用相當於骨針和赭石的計算方式來構建用戶界面?我保證,*有*更好的方法!放下那把由未知但明顯廉價材料製成的生鏽舊鎬,升級到銥制熱度的工具吧!

✨ 框架特色

StardewUI提供:

  • **豐富的組件庫** 📦 - 包含框架、佈局、按鈕、下拉菜單等標準視圖和部件,甚至還有按鍵綁定編輯器和文本輸入框
  • **專屬UI語言** 💻 - StarML語言類似HTML,用10行標記就能完成原本需要數百甚至數千行代碼的工作
  • **數據綁定系統** 🔗 - 支持數據綁定和事件綁定,讓你可以按偏好實現MVP、MVVM或任何MV模式
  • **動態實時佈局** 🎯 - 再也不需要手動計算像素位置
  • **熱重載功能** 🔥 - 自定義資源處理,支持熱重載;在你喜歡的編輯器中修改UI定義並實時查看變化
  • **控制器支持** 🎮 - 內置焦點和交互功能,不再需要爲讓菜單勉強支持手柄而做大量額外工作
  • **高度可擴展** 🚀 - 大量擴展功能,更多功能持續添加中

🛠️ 語法高亮

StarML*類似*HTML,但它*不是*HTML。爲Visual Studio、Visual Studio Code和Notepad++提供了語法高亮支持。你可以從最新GitHub發佈下載這些擴展;由於它們僅供模組開發者使用,不會在上發佈。更多信息請訪問編輯器設置頁面。

❓ 普通玩家需要下載嗎?

只有在你安裝需要此框架的模組時才需要下載。單獨安裝StardewUI對你的遊戲沒有任何影響。這是一個模組開發者框架,類似於SpaceCore或Item Extensions。

🔧 兼容性

StardewUI幾乎完全是一個獨立的框架;它只修補了一個方法,用於處理SMAPI的未知資源,以便能夠將StarML視圖作爲常規資源加載。

換句話說,StardewUI不會破壞任何其他模組。但是,它可能*被*其他模組破壞,特別是如果它們改變了某些核心MonoGame圖形功能的工作方式,比如SpriteBatch。話雖如此,它已經與像Clear Glasses這樣的模組進行了測試,通常工作得很好。

---

📚 相關鏈接

  • 官方文檔
  • 源代碼
  • 更新日誌

準備好開始了嗎?前往入門指南——是的,StardewUI有*真正的文檔*!——或者查看一些示例(隨着時間的推移會添加更多)。

安裝與使用 安裝:SMAPI 模組(星露谷物語標準流程)

  1. 先安裝 SMAPI(星露谷模組載入器):從 smapi.io 下載安裝包,執行 install on Windows.bat,按提示選擇遊戲目錄完成安裝。
  2. 解壓本站下載的壓縮包,找到包含 manifest.json 的那層資料夾(這就是一個模組)。
  3. 把該模組資料夾整個複製到 Stardew Valley/Mods/ 目錄下。
  4. 透過 SMAPI 啟動遊戲(執行 StardewModdingAPI.exe 或按指引設定啟動項),標題畫面前的控制台會列出每個模組的載入結果。

修改器類工具可能無需 SMAPI,解壓後按包內說明直接執行即可。 修改存檔前建議先備份;SMAPI 會在控制台列出載入失敗的模組。

檔案與校驗

檔案名稱
StardewUI
檔案大小
824.4 KiB
SHA-256
3814552cc94b7081de664ef966b2c806b69c93dbf3d5fd7447d8059f2b1b72b1
入庫時間
2026-10-10 21:54