Getting Started

Welcome to Wing's Contracts! This mod allows you to make and obtain bulk-order contracts as a way to incentivize automation and trade.

The Contract Portal

All of the features of this mod are gated behind the Contract Portal. The Contract Portal is a block that allows you to fulfill contracts.

Some notes on the Contract Portal:

• If you have Create installed, you can hold [W] while hovering over the Contract Portal item to view its ponders.
• On most servers, you can right-click an empty Contract Portal to view the Abyssal Contract Pool
  • The Abyssal Contract Pool is shared between all players, and by default refreshes every 24 hours.
  • By default, you can choose only one contract during every 24 hour period. On some servers, you can save up picks over multiple refreshes.
• Right-click an empty Contract Portal with any contract to turn it on. Right-click again with an empty hand to retrieve your contract and any stored rewards.
• While the portal is active, you can throw items that match the contract into the top of the portal. The portal will automatically exchange these according to the contained contract.
• Contract Portals output a comparator signal according to how many cached rewards they contain.
• When powered by a redstone signal, Contract Portals pause all exchanging.
• Placing a wool block next to the portal mutes it.
• Contract Portals support hopper input from the top, and you can take out the rewards with a hopper on the bottom.
• Contract Portals support Create mod's Engineer's Goggles, Factory Gauges, and Display Links.

Abyssal Contracts

Abyssal Contracts are the central feature of Wing's Contracts. They allow you to exchange certain items with the server for rewards. Each Abyssal Contract has:

• A set of accepted items, tags, and/or conditions
• A per-unit reward and exchange rate
• A cycle duration
• (Optionally) a level and max level
• (Optionally) an expiration time, in cycles

Note

On most servers, all Abyssal Contracts will have the same cycle length (by default 24 hours).

The contract's first cycle begins the moment you acquire it.

During each cycle, you can exchange items using the Abyssal Contract. You can exchange items up to the contract's unit limit for that cycle. At the start of each cycle the contract renews, allowing you to fill it up to its unit limit once again.

As an Abyssal Contract levels up, it becomes bigger and bigger, accepting more units. By default, most Abyssal Contracts double in size with each level up, allowing you to acquire many more rewards with higher-level contracts. Abyssal Contracts will automatically level up under the following conditions:

• Your server has leveling enabled for that contract.
• The contract is below its max level (by default most contracts have a max level of 10).
• Every unit of the contract was fulfilled last cycle.

Obtaining Abyssal Contracts

Depending on the server you're playing on, some or all of the following methods of obtaining Abyssal Contracts may be available:

• Right-click an empty Contract Portal and pick a contract from the pool.
• Craft a Blank Abyssal Contract (recipe shown in next section) and right-click with it in your hand.
• Use either the /contract load or /contract random commands (see: Commands).

B2B Sales... in Minecraft

Bound Contracts allow you to link two players' portals with a custom contract. Linked Contract Portals can exchange items across any distance and across dimensions, as long as the chunks on both sides are loaded. Bound Contracts allow endless two-way exchange, as long as both sides keep pumping in items. Thus, Bound Contracts do not use cycles and cannot level up.

The Bound Contract pictured above creates a pair with each half named "Wing's Bound Contract". This contract pair allows two players to use their Contract Portals to endlessly exchange Oak Logs or Spruce Logs for Iron Ingots, at a rate of 8 logs per ingot. To finish creating the Bound Contract pair, press the golden quill button on the bottom right.

Warning

In order to balance out their usefulness in interdimensional item transport, 10% of all items exchanged via a Bound Contract are destroyed.

This can be changed in your server's configs.

Note: at some times you may see an exclamation appoint above a Contract Portal containing a Bound Contract, rather than the usual floating item. A yellow exclamation mark means that the linked Bound Contract is not placed in a portal, or that it is placed in a portal inside an unloaded chunk. A red exclamation mark means that the same player placed both sides of the Bound Contract, which is not allowed on some servers. Either way, you can still drop items into the Contract Portal; they will resume exchanging inputs as soon as the problem is resolved.