Quartz [WIP/Alpha/Unstable]

A Kotlin DSL for NeoForge modding. Declarative block/item registration with auto-BlockItem and built-in datagen.

⚠️ Developer Library Quartz is a library mod for developers and does not add any content to the game by itself. You only need to install this if another mod explicitly requires it.

Quick Start

class ModBlocks : BlockRegistry("modid") {
    val myBlock by block {
        configureBlock { strength(2f) }
    }

    val myStair by stair(Blocks.STONE) {
        texture("minecraft:block/polished_andesite")
    }

    val mySlab by slab {
        configureBlock { strength(1.5f) }
    }
}

class ModItems : ItemRegistry("modid") {
    val myItem by item {
        configureProperties { stacksTo(16) }
        texture("modid:item/custom_thing")
    }

    val mySword by sword(Tiers.IRON) {
        attackDamage = 4f
        attackSpeed = -2.8f
    }
}

// In your @Mod class:
class MyMod(modEventBus: IEventBus) {
    init {
        ModBlocks.register(modEventBus)
        ModItems.register(modEventBus)
        QuartzDataGatherers.register(modEventBus)
    }
}

Block Types

When baseBlock is provided, the texture defaults to the base block's registry ID (namespace:block/path). When omitted, the texture auto-resolves from the property name by stripping the type suffix (e.g. my_stairs → block/my, oak_fence_gate → block/oak).

Item Types

Textures default to modid:item/<snake_case_name>. Override with texture("modid:path").

Datagen

Call QuartzDataGatherers.register(modEventBus) in your @Mod class.

Each block type auto-generates:

• Blockstate JSON
• Block models
• Item model
• Loot table (self-drop by default, configurable)

Each item type auto-generates:

• Item model (item/generated or item/handheld for tools)
• Tag entries (tools only)

License

MIT. See LICENSE for details.