Game export – Ylands

From Bohemia Interactive Community
Jump to navigation Jump to search
(Created page with "=Overview= As of 0.12, Genesys projects (games made in Editor) cannot be played from Main menu directly any more. Before doing so, game has to exported from Editor. In similar...")
 
m (Text replacement - "[[Ylands " to "[[Ylands:")
 
(19 intermediate revisions by 2 users not shown)
Line 1: Line 1:
=Overview=
=Overview=
As of 0.12, Genesys projects (games made in Editor) cannot be played from Main menu directly any more. Before doing so, game has to exported from Editor. In similar fashion, before uploading a game to Workshop, the game has to be exported.
In order to publish and play Genesys projects (games made in Editor), they have to be exported from Editor and uploaded to Workshop. Workshop is the primary way how to distribute custom games, both single player and multiplayer, among other players. Its is also possible to export and play games locally, but this is primary intended for testing purposes.  


Local export → creates /updates local playable version of Genesys project.
To export a game see '''Export Game''' in editor menu
Workshop export → creates / updates workshop version of Genesys project.
*'''Workshop export''' optimize the game and create workshop version of Genesys project
In this export process, two things are happening:
*'''Optimise''' → it is also possible to optimise the game in advance, so that the export will take less time
*'''Show Workshop files''' → opens folder with exported games


The game template (actual game file) is created → new *.ygt file will appear.
=== PC vs Universal games ===
The game is optimized and "support data" are created → new *.ysd file will appear.
It is possible to determine target platform of a game. This is specified in Game settings / Common settings
During local export, these files will be stored stored in [local account]\Share\Games
*'''PC only''' → when checked, the game could be run without limitations but only on PC
*'''Universal''' → universal games can be run on both PC and mobile devices, but their play areas is limited by maximum terrain size of 3x3x3 chunks
**Universal games do not support Dynamic terrain
 
== Publishing to workshop ==
*When workshop export is used, a single *.yca file is generated. This file can be then uploaded to ylands workshop (https://workshop.ylands.com)
*It is possible to label the game as '''protected'''
**Protected games cannot be downloaded from Workshop by other users, played locally or copied
**Games containing custom monetization are automatically protected
**Unprotected games can be downloaded from workshop and played locally, their files can be freely copied
 
=== Important note ===
*The author of *.yca file and user logged onto Workshop has to be same person -> meaning that their game account and workshop account has to be linked
 
== Local export (advanced user only) ==
*It is possible to use '''/exportlocal''' command via console (chat - press enter)
*When local export is used, two files are generated
**The '''game template''' (actual game file) is created → new *.ygt file will appear.
**The '''game is optimized''' and "support data" are created → new *.ysd file will appear.
***If "Dynamic terrain" option is disabled in "Game settings", static terrain will get compiled and stored as "support data" which increases game performance rapidly.
***This process can take a while, depending on size of static terrain.
*Local files can be found in your Steam user profile: <Steam>\userdata\<yourid>\298610\remote\Games
*Local games can be played trough the Main menu → All games → My local games
 
= See also =
*[[Ylands:Monetization description|Monetization]]


Show in folder button can be used to view "local files" (*.ysd + *.ygt).
During workshop export, these files will be packed in to a *.yca file and uploaded to Workshop automatically. There ought to be no need to upload *.yca manually.


----
----
{{Ylands scripting navbox}}
{{Navbox/Ylands}}
{{DEFAULTSORT:{{#sub:{{PAGENAME}}|7}}}}
 
[[Category: Editor: How To]]

Latest revision as of 16:35, 16 November 2022

Overview

In order to publish and play Genesys projects (games made in Editor), they have to be exported from Editor and uploaded to Workshop. Workshop is the primary way how to distribute custom games, both single player and multiplayer, among other players. Its is also possible to export and play games locally, but this is primary intended for testing purposes.

To export a game see Export Game in editor menu

  • Workshop export → optimize the game and create workshop version of Genesys project
  • Optimise → it is also possible to optimise the game in advance, so that the export will take less time
  • Show Workshop files → opens folder with exported games

PC vs Universal games

It is possible to determine target platform of a game. This is specified in Game settings / Common settings

  • PC only → when checked, the game could be run without limitations but only on PC
  • Universal → universal games can be run on both PC and mobile devices, but their play areas is limited by maximum terrain size of 3x3x3 chunks
    • Universal games do not support Dynamic terrain

Publishing to workshop

  • When workshop export is used, a single *.yca file is generated. This file can be then uploaded to ylands workshop (https://workshop.ylands.com)
  • It is possible to label the game as protected
    • Protected games cannot be downloaded from Workshop by other users, played locally or copied
    • Games containing custom monetization are automatically protected
    • Unprotected games can be downloaded from workshop and played locally, their files can be freely copied

Important note

  • The author of *.yca file and user logged onto Workshop has to be same person -> meaning that their game account and workshop account has to be linked

Local export (advanced user only)

  • It is possible to use /exportlocal command via console (chat - press enter)
  • When local export is used, two files are generated
    • The game template (actual game file) is created → new *.ygt file will appear.
    • The game is optimized and "support data" are created → new *.ysd file will appear.
      • If "Dynamic terrain" option is disabled in "Game settings", static terrain will get compiled and stored as "support data" which increases game performance rapidly.
      • This process can take a while, depending on size of static terrain.
  • Local files can be found in your Steam user profile: <Steam>\userdata\<yourid>\298610\remote\Games
  • Local games can be played trough the Main menu → All games → My local games

See also