创建一个Demo

创建Screen

首先以TestPage()作为内容进行演示。TestPage()是框架的示例页,位于可选的 demo 产物(src/demo)中;只在核心 jar 的 classpath 上时它不存在,需要把 demoJar 一起放进开发/预览 classpath。自己的模组不需要它。 如果要显示一个Screen,可以编写如下代码:

showScreen {
    TestPage()
}

这会直接调用setScreen(),让界面出现在画面上。

showScreen是一个顶层函数,需要在DslExecuteContext环境中调用,例如写在clickable {}等回调里。

如果要获得创建的Screen对象,如下:

val screen = root.screenFactory.create("DSL Screen") {
    TestPage()
}.screen as Screen

create的第一个参数是Screen的标题。这里必须进行类型转换,因为要跨版本支持。

不要在mod初始化过程中执行上述代码。那时平台还没发布(DslRuntime.start之前),建不了界面。使用按键或者modmenu等入口点触发这些代码。

创建自己的Page

只需要用自己的内容替换TestPage()即可。一个简单的示例:

showScreen {
    Button(Modifier.size(60.scaled,20.scaled)) {}
    DefaultBackground()
}

你将看到一个深色泥土背景(这取决于后端)和正中间的一个按钮。这个按钮不可点击。

在下一章节会开始更复杂、功能更强的ui界面。


This site uses Just the Docs, a documentation theme for Jekyll.