Game set – Ylands

Overview

Game set is a "bundle" of custom games linked together. All games included in a Game set can share same Persistent Data and, if there are free instance slots, Players can be transferred between those games.

• To be fully included in the set, custom games have to be uploaded onto workshop.
• Player transfer can be achieved only between already running game instances. It is not possible to transfer player when game is run locally.
  • Game instance = game running on official dedicated server.
  • Target instances are chosen automatically.
  • If there wont be any instances running, new instances will be spawned automatically.

Game set storage

• Work similar way as Game storage, but can be accessed from any game in the set.
• Game set storage data are always unique to a specific player.
• Storage data can be updated only if owning player is actually connected to the game (it will not work on disconnected players).

Create and add games to Game set

First step in order to have one more custom games in one set is to create new Game set.

Create new Game set

• Open Custom game which you want to include in a set
• Navigate Editor menu -> Game set manager to open Game set window
• Click "Create game set" button and enter name

Add game

• Open a game set by clicking the "Edit" button.
• If currently opened custom game is not part of the game set "Add current game" button should be available.
• Add current game to game set -> game should appear in the list with note "Added locally"
  • Local games are not yet part of the Game set
  • In order to update the Game set with new game on back-end, it is necesery to publish that games to workshop.
• Export the game.
• Publish (or update) the game onto Workshop.
• Open the Game set manager and observe the published game in the list without "Added locally" note.

• 

  Game set manager

• 

  Game set manager

Add Game set variables

• All games used in a Game set can share same Persistent Storage.
• Use "Storage" tab in Game set properties to modify the storage.
• Use "Add new variable" button to add new variable to storage.
• Set variable name, type and default value.
• Important
  • Pay attention to variable type setting, this cannot be changed later!
  • New variable is committed to Game storage right after variable settings are confirmed.
  • Once committed, storage variables cannot be deleted, only marked as "obsolete" (to assure continuous game compatibility).
• Storage variables will become available in Visual scripting under Variables -> Game set category.
• Game storage variables can be used in same way as entity storage variables, but in this case the owner always have to be a player.

• 

  Game set storage

• 

  Game set variables

How to transfer player between games

• Once a game is part of a Game set it possible to transfer players between these games via Visual scripting.
• Relevant script instructions can be found in category Game -> Multiplayer in Visual scripting.
  • Reserve game session - This instruction will try to reserve a session for given players.
  • Dispatch game session - This instruction will dispatch players to reserved session.
• To obtain Game ID (Guid) open the Game set and click Get ID button.

• 

  Instructions

• 

  Example

• 

  Obtain game ID