# AnvilLib<\/p>\n
\n
\n
\n<\/p>\n
**AnvilLib** is a NeoForge mod library developed by Anvil Dev, providing Minecraft mod developers with a
\nseries of practical tools and frameworks.<\/p>\n
## Features<\/p>\n
AnvilLib adopts a modular design and includes the following functional modules:<\/p>\n
| Module | Description |
\n|—————————|—————————————————|
\n| **Config** | Annotation-based configuration system |
\n| **Integration** | Mod compatibility integration framework |
\n| **Network** | Networking API with automatic packet registration |
\n| **Recipe** | In-world recipe system |
\n| **Moveable Entity Block** | Support for block entities movable by pistons |
\n| **Registrum** | Simplified registration system |
\n| **Main** | Aggregated module that bundles all submodules |<\/p>\n
## Module Introduction<\/p>\n
### Config Module<\/p>\n
Provides an annotation-based configuration management system to simplify the definition and management of mod configurations.<\/p>\n
**Key Features:**<\/p>\n
– Define configuration classes using `@Config` annotation
\n– Add configuration comments with `@Comment`
\n– Define numerical ranges with `@BoundedDiscrete`
\n– Create nested configurations with `@CollapsibleObject`
\n– Automatically generate client configuration GUI<\/p>\n
**Usage Example:**<\/p>\n
“`java<\/p>\n
@Config(name = “my_mod”, type = ModConfig.Type.COMMON)
\npublic class MyModConfig {
\n @Comment(“Enable debug mode”)
\n public boolean debugMode = false;<\/p>\n
@Comment(“Maximum count”)
\n @BoundedDiscrete(min = 1, max = 100)
\n public int maxCount = 10;
\n}<\/p>\n
\/\/ Register configuration
\nMyModConfig config = ConfigManager.register(“my_mod”, MyModConfig::new);
\n“`<\/p>\n
### Integration Module<\/p>\n
Provides a framework for mod integrations, supporting automatic loading of integration code based on the presence of other mods.<\/p>\n
**Key Features:**<\/p>\n
– Declare integration classes with `@Integration` annotation
\n– Support for version range matching
\n– Support for different runtime environments (CLIENT \/ DEDICATED_SERVER \/ DATA)<\/p>\n
**Usage Example:**<\/p>\n
“`java<\/p>\n
@Integration(value = “jei”, version = “19.0,)”)
\npublic class JEIIntegration {
\n public void init() {
\n \/\/ JEI integration logic
\n }
\n}
\n“`<\/p>\n
### Network Module<\/p>\n
Provides a NeoForge networking abstraction with package-based packet auto-registration.<\/p>\n
**Key Features:**<\/p>\n
– Define packet direction using `IClientboundPacket` \/ `IServerboundPacket` \/ `IInsensitiveBiPacket`
\n– Automatically register packet classes in a package via `NetworkRegistrar.register(…)`
\n– Supports `PLAY`, `CONFIGURATION`, and `COMMON` protocols<\/p>\n
**Usage Example:**<\/p>\n
“`java<\/p>\n
@SubscribeEvent
\npublic static void onRegisterPayload(RegisterPayloadHandlersEvent event) {
\n PayloadRegistrar registrar = event.registrar(“1”);
\n NetworkRegistrar.register(registrar, “my_mod”);
\n}
\n“`<\/p>\n
### Recipe Module<\/p>\n
Provides an in-world recipe system, allowing recipes to be executed in the world (rather than in crafting tables).<\/p>\n
**Key Features:**<\/p>\n
– Supports custom recipe triggers (Trigger)
\n– Supports recipe predicates (Predicate) for conditional checks
\n– Supports multiple recipe outcomes (Outcome)
\n– Built-in priority system
\n– Full datapack support<\/p>\n
**Recipe Components:**<\/p>\n
– **Trigger**: Conditions to trigger the recipe (e.g., item dropping, explosions)
\n– **Predicate**: Recipe matching conditions
\n– **Outcome**: Recipe execution results (e.g., spawning items, setting blocks)<\/p>\n
### Moveable Entity Block Module<\/p>\n
Allows blocks with block entities to be pushed by pistons while preserving their data.<\/p>\n
**Usage Example:**<\/p>\n
“`java
\npublic class MyBlock extends Block implements IMoveableEntityBlock {
\n @Override
\n public CompoundTag clearData(Level level, BlockPos pos) {
\n \/\/ Return block entity data to preserve
\n BlockEntity be = level.getBlockEntity(pos);
\n return be != null ? be.saveWithoutMetadata(level.registryAccess()) : new CompoundTag();
\n }<\/p>\n
@Override
\n public void setData(Level level, BlockPos pos, CompoundTag nbt) {
\n \/\/ Restore block entity data at new position
\n BlockEntity be = level.getBlockEntity(pos);
\n if (be != null) {
\n be.loadAdditional(nbt, level.registryAccess());
\n }
\n }
\n}
\n“`<\/p>\n
### Registrum Module<\/p>\n
A registration system based on [Registrate, simplifying the registration process for items, blocks,
\nentities, etc.<\/p>\n
**Key Features:**<\/p>\n
– Chain-style API design
\n– Automatic language file generation
\n– Automatic datapack generation
\n– Support for various builders<\/p>\n
**Usage Example:**<\/p>\n
“`java
\npublic static final Registrum REGISTRUM = Registrum.create(“my_mod”);<\/p>\n
public static final RegistryEntry ### Main Module<\/p>\n `anvillib-neoforge-1.21.1` is the aggregate artifact. It bundles and re-exports:<\/p>\n – `config` ## Dependency Integration<\/p>\n ### Gradle (Groovy DSL)<\/p>\n “`groovy dependencies { \/\/ Or import individual modules as needed ### Gradle (Kotlin DSL)<\/p>\n “`kotlin dependencies { \/\/ Optional single-module example > Keep the dependency version aligned with release tags (current project property is `mod_version=2.0.0`).<\/p>\n ## Building the Project<\/p>\n “`bash # Build on macOS \/ Linux # Build on Windows (PowerShell \/ CMD) ## Requirements<\/p>\n – Java 21+ ## License<\/p>\n This project is licensed under the MIT License.<\/p>\n Part of the Registrum module code is based on Registrate and follows the Mozilla Public License ## Author<\/p>\n – **Gugle** – Main developer<\/p>\n ## Links<\/p>\n – GitHub Repository AnvilLib is a NeoForge mod library developed by Anvil-Dev, providing Minecraft mod developers with a series of practical tools and frameworks.<\/p>\n","protected":false},"featured_media":16454,"template":"","meta":{"_minecraft_slug":"anvil-lib","_minecraft_project_id":"nKAcAL9b","_minecraft_author":"Gu-ZT","_minecraft_license":"MIT","_minecraft_downloads":787,"_minecraft_follows":1,"_minecraft_client_side":"required","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"anvil-lib.zip","_minecraft_size_bytes":239985245,"_minecraft_version_count":354,"_minecraft_updated_at":"2026-05-15T21:21:02.811818Z","_minecraft_date_created":"2026-03-26T03:42:18.517746Z","_minecraft_date_modified":"2026-05-11T20:21:47.057313Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/anvil-lib","_minecraft_icon_attachment_id":16454,"_minecraft_imported_at":"2026-05-31T19:06:13+00:00","_minecraft_import_hash":"c68ed221c51de5827d2369d2d7dffecc","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[873,158],"mod_loader":[160],"minecraft_version":[37,40,41,73,74,38,78,79,80,81,82,83,163],"class_list":["post-16453","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-library","mod_category-neoforge","mod_loader-neoforge","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-2"],"yoast_head":"\n
\n .item(“my_item”, Item::new)
\n .properties(p -> p.stacksTo(16))
\n .register();
\n“`<\/p>\n
\n– `integration`
\n– `network`
\n– `recipe`
\n– `moveable-entity-block`
\n– `registrum`<\/p>\n
\nrepositories {
\n mavenCentral() \/\/ This project is already uploaded to Maven Central
\n}<\/p>\n
\n \/\/ Full library
\n implementation “dev.anvilcraft.lib:anvillib-neoforge-1.21.1:2.0.0”<\/p>\n
\n implementation “dev.anvilcraft.lib:anvillib-config-neoforge-1.21.1:2.0.0”
\n implementation “dev.anvilcraft.lib:anvillib-integration-neoforge-1.21.1:2.0.0”
\n implementation “dev.anvilcraft.lib:anvillib-network-neoforge-1.21.1:2.0.0”
\n implementation “dev.anvilcraft.lib:anvillib-recipe-neoforge-1.21.1:2.0.0”
\n implementation “dev.anvilcraft.lib:anvillib-moveable-entity-block-neoforge-1.21.1:2.0.0”
\n implementation “dev.anvilcraft.lib:anvillib-registrum-neoforge-1.21.1:2.0.0”
\n}
\n“`<\/p>\n
\nrepositories {
\n mavenCentral() \/\/ This project is already uploaded to Maven Central
\n}<\/p>\n
\n implementation(“dev.anvilcraft.lib:anvillib-neoforge-1.21.1:2.0.0”)<\/p>\n
\n implementation(“dev.anvilcraft.lib:anvillib-network-neoforge-1.21.1:2.0.0”)
\n}
\n“`<\/p>\n
\n# Clone repository
\ngit clone https:\/\/github.com\/Anvil-Dev\/AnvilLib.git
\ncd AnvilLib<\/p>\n
\n.\/gradlew build<\/p>\n
\ngradlew.bat build
\n“`<\/p>\n
\n– Minecraft 1.21.1
\n– NeoForge 21.1.x<\/p>\n
\n2.0.<\/p>\n
\n– Issue Tracking<\/p>\n","protected":false},"excerpt":{"rendered":"