diff --git a/documentation/docs/docs/03-creating-stories/04-entity-extension/03-conditional-showing.mdx b/documentation/docs/docs/03-creating-stories/04-entity-extension/03-conditional-showing.mdx new file mode 100644 index 0000000000..95fa36658b --- /dev/null +++ b/documentation/docs/docs/03-creating-stories/04-entity-extension/03-conditional-showing.mdx @@ -0,0 +1,40 @@ +--- +difficulty: Normal +--- + +import EntrySearch from "@site/src/components/EntrySearch"; +import Image from "@site/src/components/Image"; + +# Conditional NPC showing +:::warning[NPC created] +In this tutorial, we assume you already have created an entity.\ +If you haven't done that yet, please follow the [entity extension tutorial](./index.mdx) first. +::: +In this tutorial, you will learn how to conditionally show an entity using audiences. + +## Adding an audience entry +There are a lot of different audience entries available. For this tutorial, we will use cinematic audience, but all others have similar features. + + +Firstly, click on the + icon in the top right corner of the panel and search for `New Cinematic Audience`. Add it to your page by clicking on the + icon. + + + +## Adding it onto your entity instance. +Now hold your entity instance and drag it onto the `New Cinematic Audience` entry. This will link the audience to the entity. + +It should now look something like this: + +Audience Entity Link + +## Configuring the audience +Inside the audience entry, there are 2 fields: +* **Cinematic**: This is the cinematic that the audience will be linked to. +* **Inverted**: This will invert the audience, meaning that the entity will only be shown when the audience is not met. + +## Result + +:::info[Result] +Result will be later added. +TODO: Add result video +::: \ No newline at end of file diff --git a/documentation/docs/docs/03-creating-stories/04-entity-extension/index.mdx b/documentation/docs/docs/03-creating-stories/04-entity-extension/index.mdx index 220c1554e1..eace3056dd 100644 --- a/documentation/docs/docs/03-creating-stories/04-entity-extension/index.mdx +++ b/documentation/docs/docs/03-creating-stories/04-entity-extension/index.mdx @@ -11,7 +11,6 @@ import EntrySearch from "@site/src/components/EntrySearch"; You must have installed the Entity Extension before starting this tutorial. ::: - Any good storytelling requires other characters to be present in the world. Typewriter has its own entity extension, that allows you to create and control entities like NPCs. diff --git a/documentation/docs/docs/assets/entity-extension/audience-entity-link.png b/documentation/docs/docs/assets/entity-extension/audience-entity-link.png new file mode 100644 index 0000000000..f2a4437b32 Binary files /dev/null and b/documentation/docs/docs/assets/entity-extension/audience-entity-link.png differ