Skip to content

Maps_Locations

Jump to bottom
Jack Brett edited this page May 9, 2024 · 9 revisions

A core concept of LoGaCulture is location. Location of heritage sites, people and history is the heart of this project and therefore using locations in LUTE is a key aspect of the tool.

Locations are defined as custom Variables which use a string to store coordinates (latitude and longitude); this string is converte into a vector 2 of type double (for precision) for the purposes of converting physical locations to game space positions.

Locations are used in a myriad of Orders, Nodes and Condition statements. A common use of a location will be to tie it to a specific Node - ensuring that the location provided must match the Node's location before it executes the first Order in the list.

Adding Locations

To first add a location you must open the map up. To do so:

  1. Ensure you have the Flow Engine Window open and a Flow Engine selected in the scene.
  2. Select Show Map in the top left toolbar of the Flow Engine Window.

showMapButton

  1. We suggest docking the map window somewhere for ease of use.

mapDocked

Setting Map Visuals

When opening the map, the Inspector Window will update to show the settings for the Map. Feel free to customise your settings but please play close attention to changing map layers:

  1. Unfold the drop-down IMAGE
  2. Select the drop-down for Data Source

mapSource

  1. Choose your preferred style. Please note that the style chosen will be visible in the editor and will also be used in the final experience (i.e, from the player's perspective)

Navigating the Map

To pan the map (akin to how you would navigate any other map software) you can hold left-click and drag the mouse when inside the bounds of the map window. Alternatively, you can use the keyboard controls WASD. Settings for panning speeds can be adjusted in the Map Inspector Window.

You can zoom in and out of the map using the scroll wheel or find the zoom level under the GENERAL drop-down in the Map Inspector Window.

Under the GENERAL drop-down you can also search for specific locations using key-words. To do so:

  1. Select 'Search'.

mapSearch

  1. Begin typing your location.
  2. Select the desired location from the list if it appears or continue to refine your search until it does.

mapSearchWindow

  1. The map will update with the desired location.

Creating a new Location Variable

Adding a new Location Variable can be done in two ways:

  1. You can find coordinates of a specific location, create a variable in the Flow Engine Inspector and copy the coordinates into the value
  2. Add a location using the Map Window by right-clicking where you wish your desired location to be and enter the details you wish for the location:

mapLocationWindow

When adding a new location on the map you will be offered to add extra information on this location:

  1. The name of the location.
  2. Whether or not to show the name on the map (or just show the icon).
  3. If showing the name, the colour of the name label.
  4. A custom icon for this location.

In our example, we name our location 'Info Hub' with the colour white and a custom information icon:

mapInfoLocation

Adding custom icons will require you to ensure that the locations are not too big or too small on the map but pleae ping us on Discord/Issue request on GitHub for more information on this.

Using Location Variable on Nodes

Using Locations in Condition Statements

Demo Map Mode

Going Further with the Map

Clone this wiki locally