โ While we're transitioning from OpenPype, there are a lot of details the are factually incorrect. We're working on resolving all of them. โ
๐ View the live documentation.
๐ช Check out our community discussions forum.
โ๏ธ Want to know even more about AYON? Get in contact.
๐ Need some support or want something custom? Take a look at our services.
If you spot something incorrect or just think a page could do with some improvement, help us out!
- Make the changes to the relevant markdown file.
- Make a PR documenting the changes.
- Install Node.js https://nodejs.org/en/download
npm install -g yarn
yarn add docusaurus --dev
cd {ayon-doc-repo}/website
yarn start
Every addon is resembled by a typescript or JSON file in src/data/addons/data
.
- duplicate template.ts (or any other addon) in the data folder as a template to get started
- rename the file to your addon name (e.g. myAddon.ts)
- fill in the addon data
- add the preview or logo image in the addons/img folder "myAddon-icon.png" or "myAddon-preview.png"
- add addon name ("myAddon") to either officialAddons or communityAddons
You can use either a .ts (recommended) or .json file If you use a .ts file you can use intellisense to help you write the file Take a look at the types.ts file to see what you can add to the addon object
Icon images should be 1:1 ratio (square) and have a transparent background When using an icon image, a blurred background will be generated and a color palette will be extracted from the image
Sometimes logo images doesn't work as expected, in that case you can add a preview image that will be used instead Preview images should be around 1:2 ratio (landscape), include a blurred background and have the text "myAddon Addon" baked into the image. It's harder to match a preview image to the rest of the addons so it's recommended to use an icon image when possible
Attribute | Description | Example |
---|---|---|
title | The title of the addon | Blender |
description | A short description of the addon | Blender is a great addon |
descriptionLong | A long description of the addon | Blender is a great addon that does a lot of things |
preview | A preview image of the addon | blender.png |
icon | A logo image of the addon | blender-icon.png |
features | An array of features that the addon supports | ['workfiles', 'loader'] |
families | An array of families that the addon supports | ['image', 'video', 'model'] |
addons | An array of addons that the addon supports | ['nuke', 'maya'] |
docs | An object of documentation links for the addon | { user: artist_hosts_blender, admin: admin_hosts_blender, developer: dev_publishing } |
github | A link to the github code repository of the addon | - |
discussion | A link to the discussion forum of the addon | - |
id | The id of the addon, if not set (recommended) it will be the same as the filename | blender |