文字

TextFlatten {
    "a".emit(color = Color.RED)
    "b".emit(style = DslCharStyle().italic)
}

不要忘记emit(),否则这个字符串不会显示。可以为字符串的每个部分指定字号、样式、颜色。

size建议指定为9.px的整数倍。

换行

TextFlatten永远是一行,即使里面有\n字符也会自动去掉。如果要用\n换行应该使用TextFoldable。如果想让文字填满长度后自动换行,应该使用TextAutoFold。

它们会自动计算布局所需的最小空间,并“撑开”外部空间。TextAutoFold的最小宽度是0。

翻译

语言文件(assets/<modid>/lang/<语言>.json)是翻译的唯一来源,键就是点分路径:

{
    "mymod.page.title": "我的页面",
    "mymod.page.count": "共 %s 项"
}

在 DSL 里用translate取值,查不到时原样显示键名:

TextFlatten { translate("mymod.page.title").emit() }
TextFlatten { translate("mymod.page.count", 3).emit() }

额外参数会先转成字符串再替换占位符。游戏在读取语言文件时已把%d、%f这类数字占位符统一改写成%s,所以实际只有%s一种占位符。

不在 DSL 上下文里(例如入口的元数据)用translateGlobal。

框架自己的键都以kotlinmcui.开头。


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