Tutorial Area Transitions - OpenKotOR/PyKotor GitHub Wiki

Tutorial: Area transitions

This tutorial shows how to link two modules with area transitions. You will:

  • Create a new module with the Map Builder
  • Add a door transition from the new module to the Jedi Enclave
  • Add a trigger transition from the Jedi Enclave to the new module
  • Create waypoints that the transitions use

1. Create a module with the Map Builder

Open File -> Indoor Map Builder. Download the Enclave Surface kit if needed (File -> Download Kits). Create a simple layout.

Layout

Open File -> Settings and set the warp code (e.g. nthenc). Build via File -> Build. Test in-game with warp nthenc.

Settings Build

2. Configure the door (new module -> Jedi Enclave)

In the main window Modules tab click Refresh, find your module, and open its GIT. Select the door between the two hallway models; right-click -> Edit Instance.

Modules tab Edit door

Set:

  • Links To Waypoint -- transition will teleport to a waypoint in the target module
  • Link To Module -- danm13 (Jedi Enclave warp code)
  • Link To Tag -- tag of the waypoint in the target module we will teleport to (e.g. from_nthenc)
  • Transition Name -- text shown when facing the transition

Door settings

3. Waypoint in the new module (arrival from Enclave)

Right-click in the new module -> Insert Instance -> add a waypoint in front of the door. Right-click it -> Edit Instance. Set ResRef and Tag (e.g. from_danm13). Right-click -> Edit Resource to create the waypoint file; match ResRef/Tag. Save the GIT.

Waypoint Waypoint instance Waypoint resource

4. Trigger in the Jedi Enclave (Enclave -> new module)

Open the Jedi Enclave module GIT (e.g. danm13).

Enclave module

Right-click behind the Ebon Hawk -> Insert Trigger. Right-click the trigger -> Edit Instance. Set:

  • ResRef and Tag -- e.g. from_nthenc (Tag must match the door’s Link To Tag in the new module)
  • Links To Waypoint
  • Link To Module -- nthenc (your new module)
  • Link To Tag -- from_danm13 (waypoint in the new module)
  • Transition Name

Trigger instance

Right-click trigger -> Edit Resource; set Type to Transition. Use Edit Geometry to draw the trigger volume (right-click -> Insert vertices, drag, then Finish Editing).

Trigger resource Trigger geometry

5. Waypoint in the Enclave (arrival from new module)

Right-click -> Insert Waypoint in front of the trigger (away from the door). Edit Instance: set Tag and ResRef to from_nthenc. Edit Resource to create the waypoint file with the same values. Save the GIT.

Waypoint in Enclave Waypoint resource

6. Test

You should be able to move between the Jedi Enclave and the new module via the door and the trigger.

Result Result

See also