
星影库
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 已内置在使用它的模组中——通常你不需要单独安装它。如果某个模组将其作为外部依赖:
- 为你的 Minecraft 版本安装 Fabric Loader
- 安装 Fabric API
- 将 Starshadow Lib 的
.jar文件放入你的mods/文件夹 - 启动 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 许可——可自由使用、分享和修改。
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。