Function

Block placement

While Foresight is active, attempting to place an ordinary block postpones the placement and creates a butterfly beside the target position.

A creature, item, or projectile can trigger the recorded placement. The block is placed if the destination is still empty and block protection permits it; otherwise it drops as an item.

Block breaking

Attempting to break an ordinary block leaves it intact and creates a butterfly that records the break. Blocks that store extra data are processed immediately.

A creature, item, or projectile can trigger the break. It succeeds only if the block is unchanged and block protection permits it.

Attack

Swinging into empty air creates a butterfly that records the hand items, aim, active effects, and attack strength. Direct attacks against creatures resolve immediately.

A living target triggers the recorded attack. Targets protected by Contract are ignored.

Limits

When BUTTERFLY_EFFECT_SINGLE_USE=true, creating a butterfly removes Foresight. Otherwise, more butterflies can be made until the effect expires.

BUTTERFLY_EFFECT_BLOCK_LIMIT and BUTTERFLY_EFFECT_CHUNK_LIMIT cap existing butterflies at one recorded block position and in one chunk. Setting either limit to 0 disables Butterfly creation.

Eligible triggers exclude the caster and other butterflies. Butterflies persist through world saves and remain until triggered or otherwise removed.

Visibility

The caster can always see their own butterflies. BUTTERFLY_EFFECT_VISIBLE_TO_OTHERS=false hides them from other players; setting it to true makes them visible to everyone.

Configuration

SettingDefaultRangeEffect
BUTTERFLY_EFFECT_MANA_COSTmahoutsukai-server.tomlfamiliarbutterfly effect1000–100000000 mana per castMana cost of releasing a Butterfly Effect scroll.
BUTTERFLY_EFFECT_BLOCK_LIMITmahoutsukai-server.tomlfamiliarbutterfly effect40–100000000 butterflies per block positionMaximum counted butterflies that may share one recorded block position; zero disables Butterfly creation.
BUTTERFLY_EFFECT_CHUNK_LIMITmahoutsukai-server.tomlfamiliarbutterfly effect400–100000000 butterflies per chunkMaximum counted butterflies allowed in one chunk; zero disables Butterfly creation.
BUTTERFLY_EFFECT_DURATIONmahoutsukai-server.tomlfamiliarbutterfly effect4000–100000000 ticksDuration of the Foresight effect applied by Butterfly Effect.
BUTTERFLY_EFFECT_SINGLE_USEmahoutsukai-server.tomlfamiliarbutterfly effectfalse—Removes Foresight after the first butterfly is successfully created when true.
BUTTERFLY_EFFECT_VISIBLE_TO_OTHERSmahoutsukai-server.tomlfamiliarbutterfly effectfalse—Makes a caster's butterflies visible to other players when true; the caster can always see their own.