From b98164eccd8f66a99af27887bb379bccb7a98bf3 Mon Sep 17 00:00:00 2001 From: "False.Genesis" Date: Mon, 2 Sep 2019 03:51:47 +0200 Subject: [PATCH] Created nodes (markdown) --- nodes.md | 57 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 57 insertions(+) create mode 100644 nodes.md diff --git a/nodes.md b/nodes.md new file mode 100644 index 0000000..a979fc0 --- /dev/null +++ b/nodes.md @@ -0,0 +1,57 @@ +![Node edit mode](http://fg.wzff.de/pub/aquaria/wikidata/editmode-nodes.jpg) + +Nodes are scriptable points, regions, and paths that can be used for a variety of purposes. + +A node has a at least one point (the center point) and spans a rectangular or circular area. Additional path points can be added if needed. + +Example use cases: +* Place currents and steam +* Make entities or the camera follow a path +* Provide hints for nearby entities or other nodes +* Perform an action when an entity enters a region +* ... + +# In the map editor + +See [[Editor controls|editor-controls#node-edit-mode-f7]] for how to manipulate nodes. + +The only way to create or delete nodes is via the map editor. + + +# Builtin nodes + +The game recognizes certain node names and performs a built-in function. Some built-in functions take parameters, these follow after the node name (separated by spaces). + +* __seting *ingredient* *amount*__ - short for _set ingredient_; instructs certain entities covered by the node area to spawn the specified ingredient on some condition (e.g. song plants, pullable leaves). +* __setent *entityname*__ - short for _set entity_, instructs an entity to spawn another entity on some condition. +* __current *alpha*__ - places a current that follows the path. Must have at least 2 path points. `Alpha` is used to control transparency. The width of the node area controls the current thickness. Can be enabled or disabled via `node_setActive()`. +* __gem *gemname*__ - when Naija enters the area, a gem is placed on the minimap. +* __waterbubble__ - When placed in air, the covered area acts like it's filled with water. Can be enabled or disabled via `node_setActive()`. +* __cook__ - places a map gem when first entered. Can use 3 cooking slots when in the area. +* __zoom *amount* *time*__ - When Naija is inside the area, set map zoom to `zoom` over `time` seconds. +* __radarhide__ - When Naija is inside the area, the minimap is blacked out and the main map is blocked. +* __bgsfxloop *sound*__ - When Naija is inside the area, play `sound` in a loop. +* __savepoint__ - Node is displayed as a save point icon on the world map. The actual saving functionality is scripted. +* __steam *speed*__ - Similar to a __current__ node. Steam flows along the individual path points. Can be enabled or disabled with `node_setActive()`. +* __warpnode *map* *nodename* *flip*__ - When Naija is inside the area, warp to the node `nodename` on `map`. By default Naija will face left after the warp. Pass `flip` = 1 to face right. See [[warping between maps|map-warps]] for details. +* __warplocalnode *nodename* *type*__ - When Naija is inside the area, warp to `nodename` on the current map. `Type` can be "in" or "out". See [[warping between maps|map-warps]] for details. +* __warp *map* *type*__ - When Naija is inside the area, warp to the corresponding node on map `map`. See [[warping between maps|map-warps]] for details. +* __spiritportal *map* *nodename*__ - When Naija is inside the area, revert to normal form and warp to the node `nodename` on `map`. _This node type is never used by the game and likely a leftover from the development process._ +* __spiritbeacon__ - When Naija is inside the area and the spirit form beacon ability is used, revert to normal form in place ("teleport the body to the spirit"). +* __vox *file* *re*__ - When Naija is inside the area, play voice `file`. Once the voice was played a permanent entry is set in the save file and this node will never play again. To allow the voice to play again, pass anything as `re`. The node will be active again after the next map load. +* __voice *file* *re*__ - Alias for __vox__. +* __se *name* *distance* *number*__ - _"spawn enemy"_ - When Naija is not within `distance`, spawn `number` enemies of type `name`. _Compatibility note_: There is only one map in the vanilla game that uses this. Using this node is not recommended since [[it may cause problems with scripting|entity-scripting#function-postinitme]]. +* __pe *name*__ - _"particle effect"_ - This node continuously plays the specified particle effect. Commonly used: __pe bubbles01__. _Due to a bug the particle effect is updated twice per frame, resulting in twice the intensity. Since the vanilla maps were designed with this bug present, it is to be considered a feature_. The particle emitter can be enabled or disabled via `node_setActive()`. +* __naijastart__. Places Naija on this node if the map is entered without a set position. Used to position Naija on the starting map. Also useful to specify a default position to start at when loading the map in the editor. If not present, Naija is placed at position (0, 0) (upper left corner). + + +# Node scripts + +Each node may have an attached script. See [[Node scripting|node-scripting]] for details. + +The script is independent of the builtin function; both will be handled if present. A good example for this is the _savepoint_ node: The world map gem functionality is built-in, but the right-click activation is scripted. + +There is no way to disable built-in functionality, but some nodes can be toggled using `node_setActive()`. + +Nodes can not be deleted or created via scripting. Existing nodes can be moved via `node_setPosition(me, x, y)`, although it is not recommended since a node is permanently moved once the map is saved. +