Pactum

Pactum is a multiplayer-focused magical contract mod for Minecraft 1.21.1 NeoForge.

Create blood-bound agreements with real consequences. Exchange items, offer experience levels, surrender a soul, or grant another player the right to teleport to you.

Each pact is negotiated at the Contract Table and becomes binding only when both participants sign.

Quick Guide

1. Craft a Blank Contract, a Ritual Needle, and a Contract Table.
2. Use the Ritual Needle to obtain a blood sample from each participant.
3. Place both blood samples, the Blank Contract, and a Feather into the Contract Table.
4. Start the ritual.
5. Each participant configures their own side of the agreement.
6. Choose your clauses and review the terms on the parchment.
7. Both players must sign.
8. When the second signature is added, Pactum finalizes the agreement.

Changing the terms before the pact is finalized invalidates previous signatures.

You can right-click a signed contract to read it later.

Available Clauses

Items

Deposit items to offer them to the other participant.

Once both players sign, the offered items are transferred to the opposite party. Only the player identified by each blood sample can modify that side’s deposit.

Matching item entries are grouped in the document, making larger offers easier to read.

Experience

Offer experience levels as part of your agreement.

Adjust the amount and preview the resulting levels before signing. The selected amount appears in the parchment and is transferred when the contract is finalized.

Changing the experience offer invalidates previous signatures.

Soul

One participant may surrender their soul to the other.

If the holder would die and a vanilla Totem of Undying does not save them first, Pactum can claim an available bound soul:

• The player who surrendered the soul dies instead.
• The holder survives with 50% of their maximum health.
• That soul binding is consumed.

The player whose soul is claimed must be online, alive, and not in spectator mode. If the holder owns several souls, Pactum uses the oldest available binding first.

Soul protection does not prevent /kill, and a sacrificial death cannot trigger another soul sacrifice.

Protection from the void: Pactum attempts to return the holder to their last recorded safe position in the same dimension. If that spot is no longer valid, it searches for safe ground within 8 blocks. If no valid destination exists, the holder dies without consuming the bound soul.

Pactum also prevents duplicate soul ownership, self-binding, and invalid chains of soul ownership.

Teleportation

Offer another player up to 10 teleports to you.

When the pact is signed, the beneficiary receives a Teleportation Orb:

• Right-click to teleport directly to the player who offered the clause.
• Travel works across dimensions.
• Only the designated bearer can use the orb.
• A usage bar and tooltip show the remaining teleports.
• Successful use starts a 5-second cooldown.
• Failed attempts consume no uses.
• The orb disappears after its final use.

The destination player must be online and alive. Teleportation places you directly at their position, so use it at your own risk.

Only one participant can offer teleportation in a contract. You cannot create a teleportation agreement with yourself or exchange teleports for teleports.

Orbs resist damage, but they can still be lost to the void or disappear after the normal time on the ground. Lost uses are not refunded.

Non-Aggression

One participant may promise not to harm the other. Both players can offer this clause to make the protection mutual.

Pactum blocks damage attributable to the player who made the promise, including supported projectiles and owned entities. Damage from other mods is covered when its source identifies the responsible player.

Attempting to attack the protected participant applies penalties:

• Weakness I for 20 seconds, plus 5 seconds per full heart of damage prevented, accumulating up to 2 minutes.
• Attacks worth 3 or more hearts also apply Wither I, with a duration that increases with damage.
• Attempting an attack does not cancel the agreement.

Combined with Soul or Teleportation: Non-aggression remains active until all soul and teleportation obligations in that contract are fulfilled. Destroying the parchment ends the agreement without a breach penalty.

Without Soul or Teleportation: Each participant receives a linked document: the Signed Contract and a Signed Contract Copy. Destroying either ends the agreement and turns the other into a Consumed Scroll.

For a consensual cancellation, one participant must first collect both documents. Pactum checks the last recorded participant who held each document; if both records match, destroying either document ends the agreement without punishment.

Breaking the agreement without consent penalizes the last participant who held the destroyed document:

• 3 maximum hearts are lost per breach, stacking down to a minimum of 1 heart.
• Lost hearts return only upon death.
• Weakness 256 lasts for 20 minutes of time spent online and alive.
• Milk cannot remove this Weakness, and dying does not clear its remaining duration.
• Breaking another agreement resets the Weakness timer to 20 minutes.

Simply dropping a document does not cancel the pact, but its destruction or despawning does.

Combining Clauses

Items, experience, souls, and teleportation can be included in the same agreement.

Items and experience are exchanged when the pact is finalized. Soul and teleportation obligations can remain active afterward.

A contract combining a soul and teleportation is not consumed until both obligations are resolved:

• Spending the final teleport leaves the contract active if the soul is still bound.
• Consuming the soul leaves unused teleports available if the orb is stored.
• If the soul is consumed while the orb is dropped on the ground, the remaining teleports are revoked and the contract ends.

Messages notify the participants when teleports run out, an orb is lost, or the pact ends.

Contracts Matter

Signed contracts are more than decorative items.

Pactum stores contract identities, soul bindings, and teleportation progress persistently using player UUIDs and unique contract IDs.

Destroying an active parchment ends its remaining magical obligations:

• Any soul still bound by that contract is released.
• Its linked Teleportation Orb loses its power.

Simply dropping the parchment does not immediately cancel the pact. However, destruction or normal item despawning does.

Once its ongoing obligations are fulfilled, the parchment becomes a Consumed Scroll, preserving the history of the agreement without its magical power.

Multiplayer

Pactum is designed primarily for multiplayer.

Each side of the contract is identified by its blood sample, not simply by whoever opens the interface. Players can view the agreement, but only the corresponding participant can edit their offer or sign for that side.

The server verifies these permissions using player UUIDs.

English and Spanish translations are included.

Future Updates

Pactum is under active development. Future updates may expand the mod with:

• Additional clauses and contract mechanics.
• More interactions with signed contracts.
• Greater depth for soul-related agreements.
• More consequences for fulfilling or breaking pacts.
• Further ritual effects, visual polish, and compatibility improvements.

The goal is to make contracts a meaningful part of trading, roleplay, alliances, betrayals, and long-term player relationships.

Bugs and Feedback

Bugs and unexpected interactions may still occur as Pactum develops.

If you encounter an issue, please leave a comment with your mod version, what happened, and any steps needed to reproduce it. For crashes, include a crash report or relevant log.

Suggestions and balance feedback are welcome!