☉Getting Started

    Documentation

    Framework Basics

    Framework Basics


    At its core, the Machinations framework is based on:

    info

    6 types of Basic Nodes

    1. Pools collect Resources
    2. Sources create Resources
    3. Drains consume/destroy Resources
    4. Converters transmute various types of Resources into another
    5. Traders exchange Resources
    6. Gates redistribute Resources

    info

    2 types of Connections:

    1. Resource Connections determine how Resources flow through a diagram
    2. State Connections modify the state of diagram elements

    All game systems consist of elements in a constant flow of Resources.

    Resources can be anything from money and property in Monopoly, ammo and HP in an FPS, or XP and equipment in an RPG.

    success

    Resources, together with the entities or actions that cause them to be produced, consumed and exchanged, make up the games’ internal economy.

    info

    Any Resource flow can be represented in a Machinations diagram.

    Entities are represented by Nodes and the way in which Resources are produced, consumed and exchanged is determined by Connections.

    Below is an example of how Sources, Pools, and Drains work. Notice the Nodes are linked together by Resource Connections (arrows) with a Formula representing the rule by which the Resources will flow between Nodes.

    1. Once you click the Source, it produces 3 Resources which will be transferred to the Pool
    2. The Drain consumes 3 Resources from the Pool
    3. The Random Source randomly produces between 1 and 6 Resources each time it’s clicked. The D6 Formula notation stands for “Die 6”. To establish the flow rate for each Step, Machinations simulates the throw of a 6-faces die and the Source produces the resulted number of Resources
    4. The Drain All Drain consumes all Resources in the Pool

    1. The Automatic Converter transmutes 3 Resources from the origin Pool into 2 other Resource
    2. The Automatic Trader exchanges 2 Coins for 3 Wood and moves these Resources into their respective repository: Coins to Pocket; Wood to Woodshed
    3. The Interactive Multiple Converter – when clicking on it, the Converter transmutes 4 gold and 2 Rubies into 1 Skin
    4. The Simplified Interactive Trader – when clicking on it, the Trader exchanges 2 blue Resources for 3 Red. The difference being that the Pools store both types of Resources.

    Gates are more complex Nodes, but the basic is that they redistribute Resources deterministically or probabilistically.

    1. The Deterministic Gate redistributes 9 Resources from the origin Pool and transfers them to each of the target Pool, according to the Labels, which in this case represent the weights of the outcomes
    2. The Random Gate redistributes the 10 Resources from the origin Pool and transfers them to each of the target Pools according to the probability on their Labels

    All the examples above feature Resource Connections. Full arrows that determine the way in which Resources flow through the diagram. More on this:

    State Connections, on the other hand, modify the state of an element. Here’s how:

    In the example above, the State Connection modifies the Formula on the Resource Connection and alters the flow of Resources function to the number of Resources in the Pool. As such, it adds to the initial Formula parameter (1) the number of Resources stored by the Pool after each Step.

    There’s more to State Connections than this, though. They can modify Nodes’ states and act as triggers or activators.

    Contents

    Used by 2500+ game studios all over the world

    350+ universities & academic institutions use Machinations

    All Rights Reserved © Machinations S.àr.l

    8217, Mamer, Luxembourg, accounts at BGL BNP PARIBAS, VAT number: LU30464284

    We use cookies for marketing and analytics. We also share information about your use of our site with our marketing and analytics partners who may combine it with other information that you’ve provided to them. You consent to our cookies if you continue to use our site. Learn more