New Toolset-based Trigger Area Sample

Please checkout the "Lost Isle 3" scene included with Visual3D v9.5 (Beta 5) release (when available), where you can see an example of a Trigger Area placed in the scene and setup using the toolset, instead of via C# code.

Older Tutorial on Creating Trigger Areas via C# Code

 

This is a short tutorial about how to create a triggered event in your game. With this you could easily have a wall collapsing, turn the enemies from aggressive to friendly and reverse, or anything else you want to happen. There are still a few things to look out for and change in here, but it’s a good starting point for other programmers in different game teams.

 

Adding objects to a scene

 

There are several ways to add objects to a scene.   Three of the ways are: 

 

1.  You can add objects from the BaseDemoRegion  in OnLoadStaticContent by Spatial.AddChild(scene_object_name);

 

2. You can add objects from the Architect  see

http://game-engine.visual3d.net/wiki/tutorial-adding-asset-your-world

 

3.  Using Triggered Areas

 

 

Setting up ScriptedCTF.cs

 

The current ScritedCTF.cs without any changes when selected as a scene will look like the following:

 

 

I made the following changes to ScritedCTF.cs make the scene look more like My First Tutorial:

 

1.  Change camera, focus, and sky.

 

            public ScriptedCTFScene()

            {

            InitialCameraPosition = new Vector3(-10f, 3f, -10f);

            InitialCameraFocusPoint = new Vector3(0f, 0f, 0f);

 

            InitialCameraSpeed = 1f;

            InitialAmbientLight = new VColor(128, 128, 128);

            InitialSkyDefinitionName = "Afternoon.sky.xml";

            }

 

2.  Change terrain

 

And I changed the terrain in BaseDemoRegion OnLoadStaticContent to:

 

InfiniteTerrain terrain = InfiniteTerrain.SetSceneTerrain("GrassyFlat.InfiniteTerrain.xml");

 

 

3.  Change call to scripted tasks

 

Now to call my own scripted tasks, I made the following change to ScritedCTF.cs.

 

Change in ScriptedCTFScene. OnStarted change:

 

                  // С# tasks:

                  //tm.LoadTasks(new StaticSupport(typeof(Visual3D.ScriptedCTF.CTFTasks)));

 

to:

 

            // С# tasks:

            tm.LoadTasks(new StaticSupport(typeof(Visual3D.ScriptedCTF.MyTasks)));

 

4. Create MyTasks.cs

 

      On the Solution Explorer right click on DemoAssets.ScriptedCFT.Taks  - add new class

 

 

Cut and paste the following code into MyTasks.cs created by the new class:

 

 

using System;

using System.Collections.Generic;

using System.Text;

using Visual3D.Demo.Actors;

using Visual3D.Scripting.API;

using Visual3D.Demo;

using Microsoft.Xna.Framework;

using Visual3D.Scripting.BehaviorSystem;

using Visual3D.Scripting.Tasking;

using Visual3D.Scripting.Tasking.Events;

 

 

namespace Visual3D.ScriptedCTF

{

    public sealed class MyTasks : StaticScript

    {

 

        public MyTasks()

        {

 

        }

 

        public override void Registration()

        {

            // One more variant of registration of a task

            //ScriptLanguagesSupport.AddTask("StartScene", new SceneLoad(), true);

        }

 

        static TaskMethod StartSceneDesc = new TaskMethod(true, new SceneLoad());

        public void StartScene(SceneLoad e)

        {

 

 

            SEntitySystem.Create<AssaultDroid>("my demo droid", new Vector3(0f, 0, 0));

 

        }

 

    }

}

 

 

5.  Build the solution

 

 

 

 

6. Add triggered Event

 

In this step we will add a home location for the droid to move to.  When the droid moves to the home location, it will trigger an event in this case display a message on the screen.

 

 1.  Add new object “droid_home” 

 

To MyTasks.cs StartScene add:

 

SEntitySystem.Create<DroidHome>("TestHome", new Vector3(10f, 0f, 10));

 

 

2.  Create a new routine that will handle the trigger.

 

After the StartScene routine add the following code:

 

        static TaskMethod TestTriggerDesc = new TaskMethod(new AreaTrigger("TestHome", "", IntersectType.Enter));

        public void TestTrigger(AreaTrigger e)

        {

            SSystem.ShowCaption("Trigger activated");

        }

 

3.  Build Solution

 

Complete code of MyTasks.cs will look like:

 

using System;

using System.Collections.Generic;

using System.Text;

using Visual3D.Demo.Actors;

using Visual3D.Scripting.API;

using Visual3D.Demo;

using Microsoft.Xna.Framework;

using Visual3D.Scripting.BehaviorSystem;

using Visual3D.Scripting.Tasking;

using Visual3D.Scripting.Tasking.Events;

 

 

namespace Visual3D.ScriptedCTF

{

    public sealed class MyTasks : StaticScript

    {

 

        public MyTasks()

        {

 

        }

 

        public override void Registration()

        {

            // One more variant of registration of a task

            //ScriptLanguagesSupport.AddTask("StartScene", new SceneLoad(), true);

        }

 

        static TaskMethod StartSceneDesc = new TaskMethod(true, new SceneLoad());

        public void StartScene(SceneLoad e)

        {

 

 

            SEntitySystem.Create<AssaultDroid>("my demo droid", new Vector3(0f, 0, 0));

 

            SEntitySystem.Create<DroidHome>("TestHome", new Vector3(10f, 0f, 10));

 

        }

 

 

        static TaskMethod TestTriggerDesc = new TaskMethod(new AreaTrigger("TestHome", "", IntersectType.Enter));

        public void TestTrigger(AreaTrigger e)

        {

            SSystem.ShowCaption("Trigger activated");

        }

    }

}

 

4. Run Tech Demos/scriptedCTF and double click on the droid and walk him onto the home location and see the “Trigger activated” message come up.

 

 

  Mike Hoisington, based on work by Tashi Duane, Eliot Freedman, Mike Wetherill

 

Other Notes on Creating Trigger Areas via C# Code