Tags
Creators
Details
All versions
1.21-2.1
Release
[NeoForge 1.21] v2.1last year 57
Compatibility
Minecraft: Java Edition
1.21–1.21.1
Platform
NeoForge
Supported environments
Client and server
Changes
Xunlib v2.1 Changelog
Registration System Overhaul
- Renamed
Registrar→Register: Simplified naming for core registration API. - New Registry Paradigm:
- Replaced lazy registry references with strongly-typed holders:
RegistryHolder: Base for all registry objectsRegistryItem: Specialized holder for itemsRegistryBlock: Specialized holder for blocks
- Benefits: Type safety, explicit lifecycle control, and loader-agnostic initialization.
- Replaced lazy registry references with strongly-typed holders:
Breaking Changes
- Forge Support Removed:
- Discontinued due to API incompatibilities with the finite registration system.
- Still Supported: Fabric and NeoForge
- Deprecated/Removed:
- All lazy registry references (migrate to
RegistryHoldersubclasses).
- All lazy registry references (migrate to
Improvements
- Stable Registration Flow:
- Resolved issues from v1.6.x for reliable multi-loader registration.
Migration Guide:
- Replace
Registrar<T>withRegister - Use
RegistryItem/RegistryBlockinstead of lazy references - Forge users: Switch to Fabric/NeoForge or stay on v1.6.x
Supplementary resources
Projects on Modrinth are automatically available through a Maven repository for use with JVM build tools such as Gradle. To learn more about the Modrinth Maven API, click here.
Note: When available, you should use the creator's maven repo instead as it will have transitive dependency information that the Modrinth Maven API does not. You may also end up with duplicate dependencies if you use a mix of Modrinth and non-Modrinth Maven repositories for your dependencies, because the group identifier will be different when served through the Modrinth Maven API.
Maven coordinates:
Version ID:
build.gradle:
repositories {
exclusiveContent {
forRepository {
maven {
name = "Modrinth"
url = "https://api.modrinth.com/maven"
}
}
// forRepositories(fg.repository) // Uncomment when using ForgeGradle
filter {
includeGroup "maven.modrinth"
}
}
}
// Standard Gradle dependency
dependencies {
implementation "maven.modrinth:Y91RXtkK:i3kvC5ji"
}
// Legacy Loom dependency
dependencies {
modImplementation "maven.modrinth:Y91RXtkK:i3kvC5ji"
}

