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:

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?`	Archetype-specific hit and push sounds, omitted when `null`.

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.