Setting up a new TileSystem

In order to create a new tilesystem, you need to create a new GameObject in a scene and add the following scripts:

• TileSystem

• TileResourceLoader

Furthermore in order to use the creator, you will need to add the ConstructionMenu prefab to the scene.

Startup

When playing in runtime, the TileSystem will automatically try to load a saved tilemap from the StreamingAssets folder and recreate it using ScriptableObjects found by the TileResourceLoader.

Internal structure

When placed, the tilemap uses the following structure to keep track of all tiles. Ranked in order from the lowest element to the highest:

1. PlacedItemObject - This script is attached to every itemthat is spawned on the map. Ensures spawning/despawning and is always attached to a GameObject.

2. PlacedTileObject - This script is attached to every object that is spawned on the map. Ensures spawning/despawning and holds references to any adjacency connectors. Always attached to a GameObject.

3. TileObject - This class represents a single object on a single layer and can contain one PlacedTileObject. So for each tile position in the world, there is are (number of layers) amount of TileObjects. Not attached to a GameObject.

Other parts of the system

• TileResourceLoader - Reads and holds the ScriptableObjects for each item and tile that can be placed. Used by the TileSystem to figure out what object is placed.

• Saved-X-Object - Used to hold the state of the corresponding class/struct and is serializable. Used for saving and loading.

• BuildChecker - Used to validate combinations of placed objects and can check whether an object can be placed. For example, no objects can be build on the Turf layer if a Plenum is missing.

Getting Started

To get started with the creator, run the game and press B after spawning. This will bring the creator menu up.

Controls

• Press left mouse button to place an object

• Press R to rotate an object

• Hold left shift to replace an existing object on the same layer

Building indicators

Building layers

Each tile can hold multiple objects on different layers. The following layers are implemented:

• Plenums - These form the foundations of the station. Always required to be present before another layer can be build

• Turfs - Walls and floors go on this layer

• Wires - High, medium and low voltage wires

Creating ScriptableObjects

To add a new item or object to the tilemap system, a new scriptableobject needs to be created.

Location

Make sure to save the item/tile ScriptableObjects under the corresponding "Content/Data/TileMap/Resources/" folder

Details

The following information can be filled in for a TileObjectSo:

Tile objects

• Name String - describes the name of the object

• Prefab - which prefab to spawn

• Icon - Icon which is used by the creator and construction interface

Items

Items can be added in a similar way:

The design of the system can be found in the the link below.

Adjacency connections refers to when a tilemap object is connectable to its neighbors, walls being the typical example of this.

Adjacency Connectors

In order to make walls and tables connect to each other, you need to make use of a adjacency connector. This keeps track of which neighbours it is connected to and will replace and rotate meshes accordingly.

The different adjacency connectors

There are different types of adjacencies supported right now.

1. Simple - Used for simple connections without a lot of use cases. Covers the basic shapes such as I, U, O, T and X.

2. Advanced - Expansion of the Simple type with a lot more edge cases covered.

3. Offset - Used for meshes which are not placed in the middle (thus offset). Used by pipes for example.

Implementing an adjacency connector

The first thing you need is to implement the IAdjacencyConnector interface.

If your tile object connects only with things from the same layer, adjacent to it, you might want to look at the AbstractHorizontalConnector class and inherit from it.

It will only ask you to implement the IsConnected() method, as it varies a lot from one connector to another. Door, simple, advanced, offset, pipe all inherits from it. Chances your connector could too.

If the connections are weirder, such as disposal pipes able to connect to disposal furniture, a different object on a different layer, with a different connector, and with special behavior when it connects, then directly implement the IAdjacencyConnector interface.

Make a tile object connectable

Add the right adjacency connector script to your prefab's root game object. You can recognise a Connector script because it implements the IAdjacencyConnector interface. To know which specific script to use, check the connectables design pages.

Connectable scripts usually ask you to add specific mesh for specific configurations. You need to fill them all up for the connector to work properly.

Check the Connectables design page for more informations about your specific connector and how the meshes should look.

Also know that the connectables scripts assume the mesh you link are rotated in a specific fashion, otherwise they may appear incorrectly in game. If you have this issue of meshes badly rotated, try to rotate the models you use, out of the game.

Alain suggested spatial hashing to network big quantities of objects.

Well, bare in mind that this is the design idea, which we haven't executed yet:

Exit Button

Simply the button to exit the map editor.

Tools Menu

This menu contains all the tools to edit the tilemap, and has the following tools:

1. Select

   1. Move around with the mouse.

2. Edit

View Menu

This menu contains all options relating to menu, HUD and view modes.

1. Reset position to 0

   1. Resets the camera position, zoom, and rotation to the initial values.

2. Layer view mode

Map Editing Modes

The map editing modes are menus to select the list of objects that can be selected to place:

1. Upper

2. Lower

3. Items

Map Editing Subcategories

For the Upper mode:

1. Flooring

2. Turfs

3. Doors

For the Layer mode:

1. Piping

2. Disposals

3. Base tiles

Items

1. Items. Bananas, sodas, janicarts.

Scripting & Placements

1. Spawn placements

2. Random item spawners

   1. Triggers.

Object List

This menu contains the selected list of objects based on the map editing modes and subcategories.

Search Bar

Panel containing a search bar to search usign tags, names or keywords

For mapping design see the Maps Design document linked below.

The tilemap system forms the basis of the space station and is responsible for the creation and management of all items and 2-dimensional tiles that compose the station. Every static object such as floors, walls and bolted objects (i.e., fixtures) are part of the tilemap. Other systems such as construction or atmospherics have a close integration with the tilemap.

Features

Grid-based design with chunks The new design leverages collections more, which allows us to go faster through objects that are on the same layer. Next to that, the map is divided into chunks of 16 x 16 tiles. This should allow more flexibility in the future in cases where we only need to look at objects nearby, without the need to go through the entire map.

Saving and loading The tilemap is now fully serialized and can be saved and loaded at will. This allows a few options like the ability to save chaotic stations at the end of a round for other game modes, but will also make resolving merge conflicts in the map easier.

Multi-tile objects Objects that are bigger than a single tile can now be successfully added to the map. You can now place a cryo tube again without having to worry about it colliding with other nearby objects.

Items Items are now part of the tilemap and can be placed and removed. This means that they are also part of the save system.