Idiot proof guide to implementing ink?

Announcements, support questions, and discussion for the Dialogue System.
Post Reply
MoonMoon
Posts: 2
Joined: Sun Jan 26, 2025 1:33 pm

Idiot proof guide to implementing ink?

Post by MoonMoon »

I totally accept that a reasonable answer might be: 'if you've messed this up, you'll not be able to grasp Unity, just give up now!'

So: I'm used to using Ink, so was hoping to keep using it rather than swapping to some of the things the Dialogue System seems to have built in (I hate Twine, I could probably learn yaml if I had to).

I saw this: https://www.pixelcrushers.com/dialogue_ ... l/ink.html
so know it is possible to do.

I initially failed at step 2:
"Import the unitypackage Plugins ► Pixel Crushers ► Dialogue System ► Third Party Support ► Ink Support"
because I had no idea it wasn't talking about using a menu item within Unity, and was instead directing me to a file path. (Shared because I'm revealing just how bad at this I am.) My partner managed to work this much out, at least.
I skip step 3 because I shouldn't need more than story/knot/stitch.

At 4. I'm... 'now draw the rest of the owl'. HOW do I add the Dialogue System Ink Integration component? Is this something in or outside Unity? There's no menu options, I've checked them all. I cannot find a way to get the image in the screenshot up.
User avatar
Tony Li
Posts: 22886
Joined: Thu Jul 18, 2013 1:27 pm

Re: Idiot proof guide to implementing ink?

Post by Tony Li »

Hi,

I'll make a tutorial video this week (hopefully by Tuesday) that steps through the process. You should be able to follow the video to get things working. If you don't like videos, let me know and I'll type up something with more details in text.

Briefly for now:

For step 4, there's a prefab named "Dialogue Manager" in the folder Assets > Plugins > Pixel Crushers > Dialogue System > Prefabs.
  • Drag this from the Unity editor's Project view into your scene (e.g., into the Hierarchy window). This will add an instance of the Dialogue Manager prefab to the scene.
  • Then click on it in the Hierarchy window to inspect it. You'll see its details in the Inspector window.
  • In the Dialogue System Controller component (in the Inspector window), click "Create" next to the Initial Database field. This will let you create an empty dialogue database in the Project view, which it will automatically assign to the Initial Database field.
  • Then scroll all the way down to the bottom of the Inspector window and click "Add Component". Start typing "Dialogue System Ink Integration" until you see it in the menu options. Click the menu option to add Dialogue System Ink Integration as a component on the Dialogue Manager.
  • Assuming your Ink files (the processed ones ending ".json") are in the Project already, drag them into the Dialogue System Ink Integration component's Ink JSON Assets list.
MoonMoon
Posts: 2
Joined: Sun Jan 26, 2025 1:33 pm

Re: Idiot proof guide to implementing ink?

Post by MoonMoon »

Thank you! I shall give this a try. I confess that attempting this while very tired and having a bad day wasn't my brightest idea, so I'll have a go with your steps and if that doesn't work, the video. :)
User avatar
Tony Li
Posts: 22886
Joined: Thu Jul 18, 2013 1:27 pm

Re: Idiot proof guide to implementing ink?

Post by Tony Li »

I'm a little delayed on the video. I came back with Covid after showing a game at MAGFest this weekend, and you don't want to have to sit through a super-scratchy voice for the whole video. :D Tomorrow should be a different story!
User avatar
Tony Li
Posts: 22886
Joined: Thu Jul 18, 2013 1:27 pm

Re: Idiot proof guide to implementing ink?

Post by Tony Li »

Hi,

I gave up on not having a scratchy voice in the video. :-)

yvan
Posts: 1
Joined: Thu Mar 13, 2025 11:01 pm

Re: Idiot proof guide to implementing ink?

Post by yvan »

Hi, I followed the video and did not see the dialogue system ink integration. I think I downloaded the latest version from Unity and imported it just before I started this.
Hausl
Posts: 8
Joined: Thu Mar 06, 2025 4:05 am

Re: Idiot proof guide to implementing ink?

Post by Hausl »

Hi Yvan,

what do you mean with you didn´t see the ink integration? :)
Did you import the native Ink Integratiion and the thirdparty ink support package from the dialogue system?
User avatar
Tony Li
Posts: 22886
Joined: Thu Jul 18, 2013 1:27 pm

Re: Idiot proof guide to implementing ink?

Post by Tony Li »

Here's a link to Inkle's Ink Integration on the Asset Store: https://assetstore.unity.com/packages/t ... nity-60055

The Dialogue System's Ink integration (which works on top of Inkle's Ink integration) is in your project in Assets > Plugins > Pixel Crushers > Dialogue System > Third Party Support > Ink Support.unitypackage
Post Reply