Lib39

Lib39 是一个松散的实用工具、Mixin、事件等集合，最初源自我们的内容模组 Yttr——由于 Yttr 包含了许多随机但实用的功能，人们经常谈论“借用”其中的 Mixin，因此我们决定将其拆分为一个独立的库。

39 是钇的原子序数。你可以将其读作“lib thirty nine”、“lib three nine”、“lib miku”，随你喜欢。

开始使用

Lib39 在 Sleeping Town Maven 上分发。将以下内容合并到你的 build.gradle 文件中：

repositories {
	maven {
    	url 'https://repo.sleeping.town'
        content {
        	includeGroup 'com.unascribed'
        }
    }
}

dependencies {
	modApi include("com.unascribed:lib39-core:2.0.7+1.20.1")
	// 在此处添加你需要的其他模块
	// Loom 不会自动包含传递依赖，因此你需要手动包含所有模块
}

Lib39 也在 Modrinth 上分发，但强烈建议你将模块打包进你的模组中。它们体积很小。

如果你关心，这里是打包后的各模块精确大小

将 core 替换为你需要的模块（或多个模块）。

Lib39 1.4 及更早版本仅支持 1.19-1.19.2。Lib39 1.5 增加了对 1.18.2 和 1.19.3 的支持，一系列“实验性”构建提供了对 1.20.1 的支持。Lib39 2.0 与 1.x 版本 API 兼容，目前仅适用于 1.20.1，并与 Yttr 同步开发。

模块

• Core

随机实用类，如 AutoRegistry、AutoMixin，以及与其他模块共享的类。

还包含各种小功能，例如合成音效。

• Lockpick

用于移除人为限制的 Mixin，例如模型旋转角度、合成配方大小等。

还包括其他相关实用工具，例如从父模型继承元素的能力。

• Ripple

允许自定义启动画面文本。

• Tunnel

添加了一个基于 1.12 版本 Concrete Network 的便捷网络系统。

• Phantom

添加了将方块暂时“虚化”出世界的能力。这些方块永远不会从世界中移除，只是被隐藏。

• Waypoint

添加了一个额外的烘焙世界层，使用加法混合来渲染各种发光效果。

• Weld

添加了一个“大块”系统，用于创建像原版床那样的“预制”方块，但更美观且理论上没有大小限制。

• Sandman

添加了使物品“始终滴答”的能力，利用随机刻。

• Crowbar

为低级世界生成阶段添加事件，例如构建表面规则，以及在表面和填充阶段原始访问区块以调用自定义生成器。

• Keygen

添加了通过 IBXM2 加载 XM、S3M 和 MOD 格式音乐的能力。

• Dessicant

为战利品表实现“逻辑默认值”，并根据配方 JSON 中的“discovered_by”键自动管理配方解锁。方块状态和方块/物品模型功能即将推出。

• Machination

添加新的配方类型，例如将物品扔入流体中的“浸泡”配方，以及用活塞在两个方块之间压碎方块的“粉碎”配方。附带 EMI 支持。

• Recoil

允许你调整相机和视场角的事件，以及抑制原版行为并捕获原始攻击/使用的方法。基本上，制作一个令人满意的枪械模组所需的一切。

• Util

随机实用类。暂无文档。

• AQI

通过像 1.14 之前那样分两次渲染，修复了在花哨/快速图形设置下，半透明方块后方粒子的渲染问题。

• Mesh

添加了一个高效的基于图的方块网络系统，适用于管道等。暂无文档。

• Wrangle

添加了一个“控制提示”系统。暂无文档。

已移除的模块

• [Fractal](Fractal)

添加了一个“子分组”系统，用于进一步拆分创造模式标签页。现由 DaFuqs 作为独立库维护。

未来模块

Yttr 中有许多奇怪的 Mixin 和实用工具，如果一次性全部拆分出来，我会花很长时间。以下是一些我想分离但尚未完成的内容：

• Equivalence

添加一个“替代品”系统，用于在配方成分和标签中使物品功能上等同于其他物品。

• Conflagration

添加一个基于 CSS 的配置系统，以及一个用于制作与之交互的 GUI 的框架。