How to use

Sneak and right-click your first circle with your main hand, then do the same to your second owned circle. Messages confirm the saved circle and completed link.

Function

Binding

Both circles must belong to the same caster. They may connect dimensions when EQUIVALENT_DISPLACEMENT_DIMENSIONAL_TRAVEL=true. Sneak and right-click a block that is not a circle to clear the first selection.

Exchanging

When both circles have an eligible entity standing on them, the spell swaps one entity from each circle and charges EQUIVALENT_DISPLACEMENT_MANA_COST, using nearby Mana Circuits before personal mana. Sneaking players are excluded.

Distance

A positive EQUIVALENT_DISPLACEMENT_MAX_DISTANCE limits the straight coordinate distance between endpoints. Zero and negative values impose no distance limit. When dimensional travel is disabled, endpoints in different dimensions do not exchange entities.

Cooldown

After a successful swap, both endpoints wait EQUIVALENT_DISPLACEMENT_RECEIVE_COOLDOWN ticks before another exchange.

Chunk loading

Linked circles maintain chunk tickets so a remote partner can be found. Breaking a circle releases its own ticket.

Operation cycle

Each endpoint checks its space every EQUIVALENT_DISPLACEMENT_BLOCK_CYCLE ticks.

Only one endpoint initiates a particular pair, preventing both sides from performing the same exchange during one check.

Configuration

SettingDefaultRangeEffect
EQUIVALENT_DISPLACEMENT_BLOCK_CYCLEmahoutsukai-server.tomldisplacementequivalent41–100000000 ticksTicks between Equivalent Displacement entity checks.
EQUIVALENT_DISPLACEMENT_RECEIVE_COOLDOWNmahoutsukai-server.tomldisplacementequivalent400–100000000 ticksCooldown applied to both endpoints after a successful Equivalent Displacement exchange.
EQUIVALENT_DISPLACEMENT_MANA_COSTmahoutsukai-server.tomldisplacementequivalent600–100000000 mana per exchange of two entitiesMana required to swap one entity at each linked Equivalent Displacement endpoint.
EQUIVALENT_DISPLACEMENT_MAX_DISTANCEmahoutsukai-server.tomldisplacementequivalent-1-10000000–10000000 blocksMaximum endpoint distance when positive; zero and negative values leave distance unlimited.
EQUIVALENT_DISPLACEMENT_DIMENSIONAL_TRAVELmahoutsukai-server.tomldisplacementequivalenttrue—Allows linked Equivalent Displacement circles to exchange entities across dimensions.