Hello, World!

Hello and welcome to Bitpart! For those of you looking for a quick and easy introduction to our product, Hello, World will be just that. We'll cover the basics needed to get you started.

If you’re interested in a more immersive learning experience, start with Tutorial 1: Getting Started.

Resources you'll need for this tutorial...

1. Bitpart Plugin for Unreal (Installed)

2. A Coppola Account

Content Creation in Coppola

1. Click the link above to sign-up for a Coppola account and download our desktop app, if you haven't already.

2. Once you're signed in, click on the folder icon to navigate to the project page. Open the "Hello, World" project.

1. Click on the "Hello, World" task within the project to open it. The task should be empty aside from two existing task parameters. Create a new task method. You can do so right-clicking "Hello, World!" and selecting Add Method. Name the new task method "Chit Chat".

2. Add a step to this new method:

   1. Action: Speak To

   2. Instigator: NPC

   3. Target: Player

   4. Utterance: Hello, world!

3. Save changes.

4. Add another step to the method:

   1. Action: Speak To

   2. Instigator: Player

   3. Target: NPC

   4. Utterance: Hello to you, too.

5. Save changes.

6. You're task method should look like the following:

1. If you haven't already, click Set game directory in the upper right-hand corner. Find the project where you have the plugin installed in File Explorer and assign the BitpartDomainArtifacts folder as the assigned directory. Hit Build project.

   1. "Build project" outputs two artifacts—a JSON file and a .CSV—to the Game Directory you've specified that you will use later in this tutorial. The JSON is the planning domain and the .CSV is a list of all utterances by character.

Before You Begin: Unreal Setup

1. Open your Unreal Project that has the Bitpart Plugin installed.

1. Check to make sure you have Engine Content and Plugin Content toggled on in the Content Browser. To do this, click the settings gear in the Content Browser and confirm that Show Engine Content and Show Plugin Content are clicked on.

Unreal Level

1. Open the Unreal project you created when you installed the plugin. In the Content Browser navigate to Engine → Plugins → Bitpart AI SDK | Character Engine Content → Starter Pack → Base Demo.

2. Open DemoMap-Base-Archetype. The map should look like this:

1. In the Base-Demo folder in the Content Browser, open BDA_Base. Under File Path click on the ellipses and hook the asset up to your project's BitpartDomainArtifacts folder (the one we used above).

2. To be sure that your new content has been uploaded to the domain asset, click Import from Json File and choose the file you downloaded above. Save and close out of the asset.

1. Open up BDS_base-archetype asset. You should see Base Task and Hello, World! under task selection. Toggle Base Task off. You can save and close out of the asset.

2. 
3. In the same folder open DT_HelloWorld. Under the Data Table Details tab there should be a section called File Path. Click on the ellipses and upload the .csv file from your build (in the BitpartDomainArtifacts folder if you followed the above instructions).

4. Go back to the Data Table tab and choose Reimport. You should see your two lines of dialogue appear. Save and close out of the asset.

1. Right-click on the DT_HelloWorld asset in the Content Browser and choose Bitpart Actions → Import Utterances. Then hit Import again when a modal pops up.

1. The folder should have two utterance assets to the folder: DA_Player and DA_NPC. Each asset is pre-assigned to it's corresponding character blueprint. These will update with the new data you just imported.

   1. If you'd like to take a peek at what that looks like, open BP_NPC. Be sure to open up the Full Blueprint Editor. Under Character Component → Details → Bitpart → Utterance you'll see the assigned utterance asset.

2. Hit play! You should see the NPC approach you and say, "Hello, world!"