星影库

星影库

Starshadow模组库文件

基础库

★ Starshadow Lib

Starshadow 系列模组的基础。

Starshadow Lib 是一个面向 Minecraft Fabric 模组的共享控件工具包与实用库。它提供了支撑 Starshadow 配置界面、模组列表和启动画面的基础构件——你也可以在自己的模组中使用它们。

“控件、布局与渲染——这些无聊的部分,已妥善完成。”


✨ 特性

🎛️ 控件工具包

基于原版界面组件构建的即用型 Minecraft GUI 控件:

控件 描述
ToggleWidget 带动画的开关切换控件
SliderWidget 可配置范围的数值滑块
IntStepperWidget 带 +/- 按钮的整数值控件
EnumCycleWidget 点击循环切换枚举值
StarWidget 用于构建自定义控件的基础控件类

📐 布局系统

用于实现一致、响应式 GUI 布局的实用工具:

组件 描述
EntryRow 标签 + 控件行,对齐方式一致
Spacing 用于保持 UI 一致性的标准化间距常量

📦 容器控件

用于组织内容的高级容器:

容器 描述
ScrollablePanel 支持平滑滚动的可滚动内容区域
SectionCard 带标题栏和可折叠内容的卡片式容器
VerticalTabBar 用于多区块界面的标签栏

🎨 渲染实用工具

工具 描述
RenderBridge 跨版本渲染抽象层
Colors 标准化调色板常量

🔧 日志辅助工具

工具 描述
LogLevelHelper 用于调试日志开关的动态 Log4j2 级别控制

📦 安装

面向模组开发者

添加到你的 build.gradle.kts:

dependencies {
    modstitchModImplementation("com.starshadow:starshadow-lib:${property("starshadow_version")}")
    include("com.starshadow:starshadow-lib:${property("starshadow_version")}")
}

面向玩家

Starshadow Lib 已内置在使用它的模组中——通常你不需要单独安装它。如果某个模组将其作为外部依赖:

  1. 为你的 Minecraft 版本安装 Fabric Loader
  2. 安装 Fabric API
  3. 将 Starshadow Lib 的 .jar 文件放入你的 mods/ 文件夹
  4. 启动 Minecraft

支持版本: Minecraft 1.20.1 · 1.20.4 · 1.21.1 — 仅限 Fabric


🔨 使用示例

开关控件

ToggleWidget toggle = new ToggleWidget(x, y, width, height,
    Text.literal("Enable Feature"),
    () -> config.isEnabled(),
    value -> config.setEnabled(value));

滑块控件

SliderWidget slider = new SliderWidget(x, y, width, height,
    Text.literal("Volume"),
    0, 100, config.getVolume(),
    value -> config.setVolume(value));

可滚动面板

ScrollablePanel panel = new ScrollablePanel(x, y, width, height);
panel.addChild(new EntryRow(label, widget));
panel.addChild(new EntryRow(label2, widget2));

🧩 兼容性

模组 兼容性
Fabric API ✅ 必需
Starshadow Config ✅ 使用 Lib 构建配置界面控件
Starshadow Menu ✅ 使用 Lib 构建模组列表界面
Starshadow Splash ✅ 通过 Config 间接使用 Lib

📋 要求

依赖 是否必需?
Fabric Loader ✅ 是
Fabric API ✅ 是

除 Fabric 本身之外,Starshadow Lib 没有任何依赖——它就是基础层。


🌟 构建更好的 UI

不要再为每个模组重复造控件了。Starshadow Lib 提供了一套一致且经过测试的 UI 组件,让你可以专注于让你的模组与众不同的部分。


由 Ghent Starshadow 用 ❤️ 制作 基于 MPL-2.0 许可——可自由使用、分享和修改。