success

Resource Connections (C) transfer Resources between Nodes and are essential when building a game or system that requires the movement of Resources from point A to point B.

info

The number of resources transferred each step on a connections is specified by its Type and Formula

⚠️Since resource tokens represent real life entities the connection formula should include only positive integer values.

Properties

You can adjust the properties of a selected Resource Connections, such as Label, Formula, Interval, Transfer, Resource color, Limits, Style, and Position, in the Properties panel on the right.

We will talk about properties unique to Resource Connections below.

Label & Description

You can add descriptive text or annotations in the Label and Description fields. This will make it easier to identify the purpose of the connection as well as specific properties you might set. It is also good practice and will make your diagram more accessible to others.

Formula Type & Value

Resource Connections can transfer Resources at different rates and with different representations. Here is a list of all the possible Formula Types and how and when to use them:

Number Type

This is the go-to Type for resource connections as this value represents the number of resource tokens used in the transfer. Remember, resource tokens are always positive integers. This type should be used when modeling transfers with deterministic values (static or dynamically adjusted using Modifier state connections).

Chance Type

Selecting this type for the formula, the origin node will have an X percent chance to transfer one resource; X% must be specified in the Formula’s input box.

When entering a value above 100%, the origin node will divide the percentage by 100; the quotient of the result will represent how many guaranteed resources will be transferred, and the mod of the result will represent the percentage to transfer an extra resource. As such, when formula = 250% – 2 guaranteed resources will be transfered + 50% chance for an extra resource

All Type

Using the “all” formula will ensure that, during a simulation step, all available resources from the input are transferred to the output of the resource connection. Pools are the only compatible input node for an “all” connection since they require a quantifiable number of resources. Use this formula type when you want to transfer all the contents from pool A to pool B, or when targeting a drain or delay

Dice Roll Type

The Dice Roll formula type should be applied when the diagram requires random values on resource transfers. The first input field of this formula type represents the number of dice you would like to roll, and the second one (next to the “D” notation) represents the number of dice sides. As such, if you type 2D6, the formula will roll 2 dice with 6 faces, outputting a random integer value between 2 and 12. It is important to note that since this formula follows real-life random distributions, 2d6 is not equal to d12. For the d12 formula, the distribution of values is equal, while for 2d6 rolling 12 is 3 times more unlikely than rolling a 7 (the most probable outcome)

success

Dice Roll formula type will produce a new random value at the start of each simulation step.

Formula Type

The formula type is the jack of all trades since you can construct more advanced operations while also using the rest of the options. Additionally, this type is preferred (but not required) when typing Custom Variables names and functions from the math.js library. We recommend using this type when performing basic operations or when adding specific math.js formulas such as randomInt(). Additionally, this formula type works well combined with a dice roll: if you type 10+ D6 the formula will output a random value in the interval [11,16].

Weights Type (Gate Only)

The Weights formula type can be applied only when the input node of the resource connection is a Gate node. Similar to the “number” type, this value should always be a positive integer value and represents how likely each gate outcome is to be selected. If all gate outputs have the same weights, the distribution on the outcomes will be equal. If a gate has 2 outputs, one with 1 weight and the second one with 3 weights, the second output will be selected 3 times more often. Read more about this type on our Weighted gates documentation page.

Condition (Gate Only)

For the Condition gate, the transfer on the connection is commanded by the number of the execution step. If you would like to activate a specific output only when the simulation reaches step x, conditional output on gates should be used. Once the gate is activated, it will count how many triggers it received and will activate paths where the number of steps matches the condition of the formula. As such, if you have 2 outputs where the condition is greater than 6, the gate will output resources on both outputs after 6 triggers. Read more about this type on our Conditional gates documentation page

Additional Info about Types

We recommend taking a look at our Formulas article to learn more about all the possible ConnectionTypes.

warning

Resource Connection will blink with an orange highlight if there are not enough Resources to be transferred or if the Resources available can’t be accepted by the Target.

info

Machinations diagrams do not handle fractional values.

To emulate fractional values, you can express your game’s Resources in sub-units so that

1 sub-unit = 1 Resource

✅ An analogy for this would be working with the amount in ¢ (cents) instead of the amount in $ (dollars). To work with transferring 3.14 Resources, you’d need to multiply the whole flow by 100, resulting in 314 Resources.

✅ A second solution to this representation would be to simply use the round() formula to remove the fractional part, if the decimal accuracy of the result is not needed in the system.

Interval

The Interval determines the number of Steps between transfers. If you want a Node in your diagram to be activated less than every Step, intervals are your best friend.

You can use this if your model requires transferring Resources every “x” Steps. E.g.: Formula = 1; Interval = 3 means 1 Resource is transferred every 3 Steps.

Please look at our Interval article to find out more.

Transfer (Interval vs. Instant)

The transfer of Resources between Nodes can be set to Interval (default) or Instant.

Interval: All Resources are transferred individually within 1 Step. If more Resources are being transferred between 2 Nodes, each will be treated as an individual entity.

Instant: All Resources are transferred simultaneously, at the beginning of the Step.

info

This option is purely visual and it does not change the result of the transfer. It is recommended to use Instant transfers for more complex diagrams where low performance might be an issue.

Filtering Custom Resources

Custom resources serve as defined properties that transform complex economic and gameplay concepts into quantifiable visual tokens. By assigning specific names and icons to nodes, you can intuitively track everything from manufacturing materials to player stats using distinct, real-time visual counterparts.

The Resource Filter option for Resource connections is a great tool when it comes to pools with multiple resource types stored simultaneously. As such, when you want to create a distribution system with multiple resource types, make sure that the Resource Filter is selected.

You can find out more about this in our Filter [Color coding] article.

Shuffle Origin

Use the Shuffle Origin option in a Resource Connection’s Properties panel to randomize the transfer of differently colored Resources coming from the same origin Node.

By default, Resources from multiple Sources are transferred according to the LIFO principle (last in, first out). When using Shuffle Origin, Resources will be transferred randomly from their origin to the target Node.

To emphasize, in the example above, we used the Custom Resource Filter.

Limits

You can limit the amount of Resources being transported by setting a minimum and maximum limit.

In the example below, the Resource Connection is set to move 10 Resources from the Source to the Pool. However, due to its Limit being set to a maximum of 3, only 3 Resources will be moved.

Style Properties

You may use various styles to organize, emphasize, or highlight certain game system elements. In the Style section, you can modify the connection’s drawing style, line color and size, the labels’ font size and alignment, and the z position of a connection. However, using these does not affect the flow rate of a Resource Connection.

Connection Styles

There are 4 styles available:

Straight Connections – The behavior of the Straight Connection Style is designed to offer users greater flexibility when drawing connections. Here’s how it works:
Orthogonal Connections
Curved Connections
Entity Connections – This style does not use additional waypoints, as they will keep their diagonal design and automatically adjust their length based on the distance between nodes.

info

By selecting “Remember connection style”, Machinations will remember the last style selected in the proprieties panel and will automatically apply it to all subsequent connections.

Romain Guillôme

Product

Solutions

Roles

Resources

Compare

Pricing

Company