Matchmaking – Ylands
Jump to navigation
Jump to search
(Created page with " ---- {{Ylands editor navbox}} Category: Ylands: How To") |
No edit summary |
||
| Line 1: | Line 1: | ||
[[Image:{{PAGENAME}}.png]] | |||
*Instructions allowing to transfer players between [[Ylands Game set|'''Game set''']] games. | |||
===Reserve session=== | |||
*If a '''free game instance''' is available, this instruction will try to reserve a '''game session''' for selected players. | |||
**Game instance = game running on official dedicated server. | |||
**Target game instance is chosen automatically. | |||
**If there wont be any instance available, new instance will be spawned automatically. | |||
*In order to reserve session, following input parameters has to be entered | |||
**'''Guid''' - [[Ylands Change Game ID|'''Game ID''']] obtained via [[Ylands Game set|'''Game set manager''']] | |||
**'''Players''' - list of players ([[Ylands Tile category - Array|'''Array''']]) to be transferred. | |||
*If the reservation will be successful, the instruction will return a '''Session object'''. | |||
**Session object - contains target server and list of players to be dispatched. | |||
*If the reservation will fail, the instruction will return a '''Fail reason'''. | |||
===Dispatch session=== | |||
*This instruction will '''dispatch''' selected players using the '''Session object'''. | |||
===Fail reason=== | |||
*Reason why the reservation has failed. | |||
*Can be compared with [[Ylands Tile - Reservation fail type|'''coresponding enumerator''']]. | |||
===Example=== | |||
<gallery> | |||
Image: Ylands-Game-set-session-2.png|Example | |||
</gallery> | |||
---- | ---- | ||
{{Ylands | {{Ylands scripting navbox}} | ||
{{DEFAULTSORT:{{#sub:{{PAGENAME}}|14}}}} | |||
[[Category: Ylands | [[Category: Instructions]] | ||
[[Category: Ylands 1.4]] | |||
Revision as of 15:19, 7 September 2020
- Instructions allowing to transfer players between Game set games.
Reserve session
- If a free game instance is available, this instruction will try to reserve a game session for selected players.
- Game instance = game running on official dedicated server.
- Target game instance is chosen automatically.
- If there wont be any instance available, new instance will be spawned automatically.
- In order to reserve session, following input parameters has to be entered
- Guid - Game ID obtained via Game set manager
- Players - list of players (Array) to be transferred.
- If the reservation will be successful, the instruction will return a Session object.
- Session object - contains target server and list of players to be dispatched.
- If the reservation will fail, the instruction will return a Fail reason.
Dispatch session
- This instruction will dispatch selected players using the Session object.
Fail reason
- Reason why the reservation has failed.
- Can be compared with coresponding enumerator.
Example
Example
