-
Notifications
You must be signed in to change notification settings - Fork 9
Nodes
Node system is a powerful feature that is used by events, dialogues and quest chains features to represent complex node relationships.
Here is an example of an event that represent a very primitive dirt or diamonds lootbox system:
Let's say you created a new event called new
in the event editor. The first step to start working with nodes is to either right click on the editor, and add a single node of your choice (Command node for example), or press one of the Ctrl + Number keybind to add a node (see available node adding keybinds in F9
menu).
Once the node was added, it will be selected, and you can edit its properties in the bottom left corner of the node editor. Now, create a couple of more nodes, like 5 of them. Once you're comfortable with creation of nodes, try removing a node. To remove a node, click on it, then right click anywhere and click on ➖ Remove selected nodes context menu item.
To start moving node(s) around, you can click on a node and start immediately dragging, if you want to move only one node. If you want to move multiple nodes, you need to select them first.
To select multiple nodes you click on any node, then press and hold Shift key, and click any other nodes you want to add to selection. Once multiple nodes are selected, you can move them around by clicking on one of the nodes and dragging them around.
Alternatively, you can select multiple nodes by click dragging while holding Shift key:
When you have multiple nodes selected, you can notice that there are multiple blue selections, and only one lighter blue selection. The lighter blue selection signifies the active node that can edit in the bottom left node panel editor. If you have multiple nodes selected, and you want to switch active selection to another node, simply click on the node that you want to make active while holding Shift key.
Cool, now you have all those nodes by themselves. The main feature of nodes is their ability to being tied to another nodes. To tie two nodes together, you can click on a node's bottom outlet and drag it to another node's top outlet.
The opposite is also possible, you can drag from a node's top outlet to another node's bottom outlet.
Alternatively, you can select two (or more) nodes and tie them by pressing F
(or right click and Tie selected nodes). Ensure that the node to which you want to connect other nodes has a lighter blue selection color (see above how to change active node), and if it's not then Shift click on it again, and either press F
to connect, or right click and Tie selected. Then the nodes will be connected:
Great! As you can see based on the node connection flow animation, the bottom node is being the input node, because the flow animation circulates into the direction of the input node, and the top node is the output node. If you want to untie these two nodes, what you have to do is to select two nodes, and either press U
to untie, or right click and Untie selected.
Note: nodes an be connected circularly, however no node can be tied to itself.
In event and dialogue node systems, you have to specify a main node, that's the node from which the entire execution flow starts. When you create a new event, after creating the first node, you'll see this in the top left corner:
To mark a node as a main simply select a node (by clicking it) and press M
on the keyboard, or right click the node and click on Mark entry node context menu item. That will mark the node as main, and it will have this arrow down icon:
If parts of the wiki don't make sense with Mappet's latest version, or you weren't able to recreate examples (i.e. outdated information), feel free to report the page and section that is out of date on community's Discord server (make sure to mention which Mappet’s version did you use).