Lib39 is a loose collection of utilities, mixins, events, etc originating in our content mod Yttr — people constantly talk about "stealing" mixins from Yttr since it has so many random useful things in it, so we decided it'd be a good thing to split it up into a library.
39 is the atomic number of Yttrium. You can pronounce it as "lib thirty nine", "lib three nine", "lib miku", whatever you want.
Getting Started
Lib39 is distributed on the Sleeping Town Maven. Merge the following with your 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")
// put any other modules you want here
// loom won't JiJ transitive deps, so you need to include all of them
}
Lib39 is also distributed on Modrinth, but you are strongly encouraged to JiJ the modules. They're small.
Exact module sizes when JIJ'd if you care
| Module |
Size |
| Lockpick |
4.38KiB |
| AQI |
5.20KiB |
| Util |
5.58KiB |
| Ripple |
6.06KiB |
| Sandman |
6.56KiB |
| Deferral |
6.57KiB |
| Crowbar |
6.83KiB |
| Dessicant |
9.23KiB |
| Wrangle |
9.62KiB |
| Recoil |
9.79KiB |
| Phantom |
12.10KiB |
| Mesh |
13.99KiB |
| Weld |
16.69KiB |
| Waypoint |
22.33KiB |
| Core |
26.12KiB |
| Tunnel |
27.85KiB |
| Machination |
33.06KiB |
| Keygen |
34.88KiB |
| Total |
257KiB |
Replace core with whatever the module (or modules) you want is/are.
Lib39 1.4 and earlier only support 1.19-1.19.2. Lib39 1.5 adds 1.18.2 and 1.19.3 support, and a series of "experimental" builds provide 1.20.1 support. Lib39 2.0 is API-compatible with 1.x and is presently only available for 1.20.1, and is developed in tandem with Yttr.
Modules
- Core
Random utility classes such as AutoRegistry, AutoMixin, and shared classes with the other modules.
Also contains random small tidbits, such as crafting sounds.
- Lockpick
Mixins to allow removing artificial limits, such as model rotation angles, crafting recipe sizes,
and more. Various other related utilities as well, such as the ability to inherit elements from
parent models.
- Ripple
Allows customizing splash texts.
- Tunnel
Adds a convenient networking system based on Concrete Network from 1.12.
- Phantom
Adds the ability to "phase" blocks out of the world temporarily. The blocks are never removed from
the world, simply hidden.
- Waypoint
Adds an additional baked world layer with additive blending for rendering various kinds of glowy
effects.
- Weld
Adds a "big blocks" system for creating "prefab" blocks like vanilla beds, but way nicer and with
theoretically no size limit.
- Sandman
Adds the ability to make items "always tick", leveraging random ticks.
- Crowbar
Adds events for low-level world generation phases, such as constructing surface rules, and raw
access to chunks during the surface and population phases for invoking custom generators.
- Keygen
Adds the ability to load music in XM, S3M, and MOD format via IBXM2.
- Dessicant
Implements "logical defaults" for loot tables, and automatically manages recipe unlocks based on a
"discovered_by" key in recipe JSONs. Blockstates and block/item models soon.
- Machination
Adds new recipe types, such as a "soaking" recipe for throwing items in a fluid and a "smashing" recipe for crushing a block between two others with a piston. Comes with EMI support.
- Recoil
Events to let you mess with the camera and FOV, and a way to suppress vanilla behavior and catch raw attack/use. Everything you need to make a satisfying gun mod, basically.
- Util
Random utility classes. No docs yet.
- AQI
Fixes vanilla particle rendering behind translucent blocks on Fancy/Fast graphics by rendering in two passes, like pre-1.14.
- Mesh
Adds an efficient graph-based block network system, for pipes and the like. No docs yet.
- Wrangle
Adds a "control hints" system. No docs yet.
Former modules
Future modules
Yttr has a lot of weird mixins and utilities in it, and I'd be here a while were I to factor them all out at once. Here's some things I want to separate out but haven't gotten around to yet:
- Equivalence
Adds a "substitutes" system, for making items functionally the same as others in recipe ingredients and tags.
- Conflagration
Adds a CSS-based configuration system and a framework for making GUIs that interact with it.
