# Sulfur Cube Archetypes

> Define custom sulfur cube archetypes for Minecraft 26.2+ with Kore's Kotlin DSL. Configure attribute modifiers, buoyancy, contact damage, explosion, knockback and item contents.

Updated 2026-09-23. Canonical: https://kore.ayfri.com/docs/data-driven/sulfur-cube-archetypes

Sulfur cube archetypes are data-driven JSON files that control the attribute modifiers, buoyancy, contact damage,
explosion, knockback, and valid item contents of a sulfur cube. Each archetype is referenced by its file name and can
be assigned to sulfur cube entities to change their behavior.

## File Structure

```
data/<namespace>/sulfur_cube_archetype/<name>.json
```

## Creating an Archetype

Use `sulfurCubeArchetype` on your `DataPack`. Pass an `ItemTagArgument` describing which items the sulfur cube can
hold and the knockback it deals via `horizontalKnockbackPower`/`verticalKnockbackPower`, then add attribute modifiers
with `modifier`, contact damage with `contactDamage`, and an explosion with `explosion`:

```kotlin
import io.github.ayfri.kore.commands.AttributeModifierOperation
import io.github.ayfri.kore.features.sulfurcubearchetype.contactDamage
import io.github.ayfri.kore.features.sulfurcubearchetype.explosion
import io.github.ayfri.kore.features.sulfurcubearchetype.modifier
import io.github.ayfri.kore.features.sulfurcubearchetype.soundSettings
import io.github.ayfri.kore.features.sulfurcubearchetype.sulfurCubeArchetype
import io.github.ayfri.kore.generated.Attributes
import io.github.ayfri.kore.generated.DamageTypes
import io.github.ayfri.kore.generated.SoundEvents
import io.github.ayfri.kore.generated.Tags

datapack.sulfurCubeArchetype(
	"regular",
	items = Tags.Item.SWORDS,
	horizontalKnockbackPower = 0.4f,
	verticalKnockbackPower = 0.2f,
) {
	buoyant = true

	contactDamage(amount = 3f, damageType = DamageTypes.GENERIC, attributeToSource = true)
	explosion(fuse = 80, power = 3, causesFire = true)

	modifier(
		amount = 4.0,
		attribute = Attributes.MAX_HEALTH,
		id = "sulfur_cube_archetype:regular",
		operation = AttributeModifierOperation.ADD_VALUE,
	)

	soundSettings(
		hitSound = SoundEvents.Entity.SulfurCube.Hot.HIT,
		pushSound = SoundEvents.Entity.SulfurCube.Sticky.PUSH,
		pushSoundCooldown = 5f,
		pushSoundImpulseThreshold = 0.6f,
	)
}
```

## SulfurCubeArchetype Fields

| Field                | Type                                                | Description                                                               |
|----------------------|-----------------------------------------------------|---------------------------------------------------------------------------|
| `attributeModifiers` | `MutableList<SulfurCubeArchetypeAttributeModifier>` | Attribute modifiers applied while the archetype is active.                |
| `buoyant`            | `Boolean`                                           | Whether the sulfur cube floats on liquids.                                |
| `contactDamage`      | `SulfurCubeArchetypeContactDamage?`                 | Damage dealt to entities that touch the sulfur cube, omitted when `null`. |
| `explosion`          | `SulfurCubeArchetypeExplosion?`                     | The explosion triggered by the sulfur cube, omitted when `null`.          |
| `items`              | `ItemTagArgument`                                   | Item tag defining which items the sulfur cube can hold. **Required.**     |
| `knockbackModifiers` | `SulfurCubeArchetypeKnockbackModifiers`             | Knockback dealt to entities that touch the sulfur cube. **Required.**     |
| `soundSettings`      | `SulfurCubeArchetypeSoundSettings`                  | Hit and push sounds, required by the game, vanilla `regular` by default.  |

### SulfurCubeArchetypeAttributeModifier Fields

| Field       | Type                         | Description                                               |
|-------------|------------------------------|-----------------------------------------------------------|
| `amount`    | `Double`                     | The amount applied by the modifier.                       |
| `attribute` | `AttributeArgument`          | The attribute being modified.                             |
| `id`        | `String`                     | The identifier of the modifier.                           |
| `operation` | `AttributeModifierOperation` | How `amount` is combined with the attribute's base value. |

### SulfurCubeArchetypeContactDamage Fields

| Field               | Type                 | Description                                                        |
|---------------------|----------------------|--------------------------------------------------------------------|
| `amount`            | `Float`              | The amount of damage dealt.                                        |
| `attributeToSource` | `Boolean`            | Whether the damage is attributed to the sulfur cube as its source. |
| `damageType`        | `DamageTypeArgument` | The type of damage dealt.                                          |

### SulfurCubeArchetypeExplosion Fields

| Field        | Type      | Description                                         |
|--------------|-----------|-----------------------------------------------------|
| `causesFire` | `Boolean` | Whether the explosion sets blocks on fire.          |
| `fuse`       | `Int`     | The delay, in ticks, before the explosion goes off. |
| `power`      | `Int`     | The explosion's power.                              |

### SulfurCubeArchetypeKnockbackModifiers Fields

| Field             | Type    | Description                     |
|-------------------|---------|---------------------------------|
| `horizontalPower` | `Float` | The horizontal knockback power. |
| `verticalPower`   | `Float` | The vertical knockback power.   |

### SulfurCubeArchetypeSoundSettings Fields

| Field                       | Type                 | Description                                                |
|-----------------------------|----------------------|------------------------------------------------------------|
| `hitSound`                  | `SoundEventArgument` | The sound played when the sulfur cube is hit.              |
| `pushSound`                 | `SoundEventArgument` | The sound played when the sulfur cube pushes an entity.    |
| `pushSoundCooldown`         | `Float`              | The delay, in ticks, before `pushSound` can play again.    |
| `pushSoundImpulseThreshold` | `Float`              | The minimum push impulse required for `pushSound` to play. |

## See Also

- [Item Predicates](https://kore.ayfri.com/docs/concepts/components.md#item-predicates) - Match items against tags
- [Tags](https://kore.ayfri.com/docs/data-driven/tags.md) - Group items into reusable tags for `items`

### External Resources

- [Minecraft Wiki: Sulfur cube archetype definition](https://minecraft.wiki/w/Sulfur_cube_archetype_definition)