Contributing: Items - Silverfeelin/SkyGame-Planner GitHub Wiki
To help us add new items or make changes to existing items the item editor may be used.
There are a few ways to access the item editor.
- By clicking on "Suggest changes" on any item page, i.e. https://sky-planner.com/item/EEQZwFIJRs
- By clicking on "Suggest new item" on the items page at https://sky-planner.com/item, or visiting http://sky-planner.com/editor/item/0 directly.
- To go to the item page from a spirit tree: click on 'Unlock' in the top left of the tree, then 'Navigate', then the item.
- By adding a "Custom item" in the spirit tree editor, as described in Contributing: Spirit trees.
Item details
Item name
The name of the item. In a lot of cases the exact name of the item is not known. Consult the Sky: Children of the Light Wiki if you're not sure about the name.
For most spirit cosmetics, it is recommended to use the name of the spirit and the type of the cosmetic. For example, "Pointing Candlemaker Hair".
Item type
The type of the item. In most cases this is pretty straightforward. Please check closely in which closet the items are located.
| Item type | Sky closet Icon |
|---|---|
| Hair accessory | Sunlight Hat |
| Head accessory | Hermit Horns |
| Face accessory | Glasses |
| Necklace | Bow tie |
| Held | Harp |
| Furniture | Shelf |
| Placeable Prop | Cup |
Emote level
When adding emotes, you can choose the level of the emote. For multiple levels, you can add one and then duplicate it to quickly add the other levels.
Item subtype
The subtype adds context to some items. In most cases this can be left empty.
| Item subtype | Description |
|---|---|
| Instrument | For items that can be used as an instrument. |
| FriendEmote | For emotes that are specific to friends (i.e. Handshake). |
Item group
The group adds context for the availability of the item. In most cases this can be left empty.
| Item group | Description |
|---|---|
| Elder | For items that are only available from the Elders. These typically cost ascended candles. |
| SeasonPass | For items that are available from the Season Pass. This group should be used for everything locked behind the Season Pass, except for the ultimates. |
| Ultimate | For ultimate items that are available from the Season Pass. The season pendant also belongs to this group. The other items part of this group typically cost season hearts. |
| Limited | For items that are not planned to return. This group typically covers items as part of a collaboration or a limited time event. Items that have returned on a special occassion still belong to this group (i.e. TLP Sword Outfit). |
Icon link
A link to an image of the item icon. Please refer to Preview images.
Preview image link
A link to an image of the item preview. Please refer to Preview images.
Dyes
The amount of dye slots (separate sections that can be dyed). Please refer to Dye preview images.
Dye preview link
A link to an image of the dye preview.
Dye info link
A link to an image of the dye preview, with highlighted dyeable sections. Please refer to Dye preview images.
Preview images
The Sky Planner website has received permission from the admins of the Sky: Children of the Light Wiki to use their images. For icons and preview images, please copy the link from the wiki. You can do this by right-clicking on the image and selecting "Copy image address".
You should get an address that looks like this: https://static.wikia.nocookie.net/sky-children-of-the-light/images/a/a1/MemoryWhisperer-2.png/revision/latest?cb=20241011083652
Image hosting
If you can not source an image from the wiki, a placeholder will suffice. You can upload the image to a free image hosting service such as Imgur. Just make sure you use a direct link or the icon will not load properly. Ultimately, the image will likely be replaced once one is available on the wiki.
Dye preview images
The Sky Planner website includes many preview images to showcase dyeable cosmetics, contributed largely by cysketch and kotoeri. New images should be added to the project through a PR. All available dye previews can be found here: https://github.com/Silverfeelin/SkyGame-Planner/tree/master/src/assets/game/dyes
The dye preview links entered on the website should be relative to the domain https://sky-planner.com.
Example
| Type | Link | Result |
|---|---|---|
| Preview | /assets/game/dyes/outfit/Performance_storyteller.jpg |
Image |
| Info | /assets/game/dyes/outfit/2slots_Performance_storyteller.jpg |
Image |
Saving
When you're done with the item, you can press the "Save" button. This downloads a JSON file to your computer. Please attach this JSON file with your new issue! If you're adding or changing multiple items, please attach all of them in a single issue.
For custom items in the spirit tree editor, the items you use in the spirit tree are automatically included in the spirit tree export!