Contributing: Spirit trees - Silverfeelin/SkyGame-Planner GitHub Wiki
It is recommended to create or modify spirit trees on a computer. Although the spirit tree editor should work fine on mobile, it can be quite tedious to use.
Type of spirit tree
Before you start, please consider what type of spirit tree you're trying to create or modify.
New spirit trees
If a spirit tree is missing, you can create your own in the Spirit Tree Editor (also accessible from Menu > Spirits > Create spirit tree).
Modifying spirit trees
If a spirit tree has changed in-game, you can make changes to the tree.
- For small revisions, such as corrections to wrong data, the existing tree should be modified.
For example, if the website shows a price of 45 candles while the in-game price is 55 candles. - If a spirit tree changes in Sky, or a spirit revisits, then a new version of the tree should be created.
For example, when a Traveling Spirit appears or when a Season Guide starts charging 3 candles for their hearts. - When a placeholder tree is shown (empty tree with one question mark), please always create a new version of the tree. The placeholder tree is reused across multiple pages.
To modify or copy a spirit tree, access the "Edit tree" button from the menu in the top right of any spirit tree:
In the prompt that appears, press "Yes" or "OK" to clone the spirit tree when you're planning on making a new version of the tree. Press "No" or "Cancel" to modify the existing tree instead.
Editor
Nodes
In the spirit tree we call each item a "node". The node refers to the position in the spirit tree and the price it costs to unlock the attached item. The node belongs to the spirit tree while the item (such as a cosmetic) can potentially be found on multiple spirit trees.
In the example below, two different nodes are shown for the same Sassy Drifter stance.
Modifying nodes
- To add a node, first click on any node followed by the Left/Top/Right connection buttons. This will attach a new node in the given direction.
- To remove a node, repeat the above step. You will be warned as this will remove all nodes connected to the given direction.
- To swap two nodes, drag and drop the nodes.
Changing prices
To set the price for a node, first click on the node to highlight it and then enter the cost and currency type next to the spirit tree. Make sure you hit the Apply button.
Changing items
- To choose an item for the highlighted node, scroll down and click on an item from the items list.
- If you're looking for a specific item you can select an existing spirit by opening the "Spirit trees" section. Then, click on any item inside of these trees.
- Add new items from the "Special items" section.
- Example 1: a season spirits visits for the first time. A new Wing Buff is introduced.
You should choose the Wing Buff from the Special items section. - Example 2: a season spirit revisits for the second time. The Wing Buff should be reused from their previous visit.
- Example 1: a season spirits visits for the first time. A new Wing Buff is introduced.
- When new cosmetics are introduced, they might not be available yet in the item list. You can add new items by opening the "Custom items" section. Please refer to the Custom items section below for more information.
Custom items
If an item is not yet available in the Sky Planner, you can add it yourself. Custom items are remembered in your browser and can be used in new and existing spirit trees. To get started, open the "Custom items" section and click on the "Add" button.
Adding custom items works as described in Contributing: Items.
Saving
When you're done with the spirit tree, you can press the "Export data" button. Please attach this JSON file with your new issue! If you're creating multiple spirit trees, please attach all of them in a single issue.