Entity welding – Ylands

From Bohemia Interactive Community
Jump to navigation Jump to search
No edit summary
No edit summary
Line 1: Line 1:
=Overview=
=Overview=
Entity welding is feature, which allows to merge multiple entities in to one. Entities welded together will have new, optimized collision envelope, which leads to better performance in game. Welding large structures consisting from hundreds of individual pieces is resource demanding proces and could taje even several minutes to complete, but it is essential optimization tool.
Entity welding is feature, which allows to merge multiple entities in to one. Entities welded together will have new, optimized collision envelope, which leads to better performance in game. Welding large structures consisting from hundreds of individual pieces is resource demanding proces and could take even several minutes to complete, but it is essential optimization tool.


Images below show comparison between welded and unwelded entity, improvement in this particular case is 62%.
Images below show comparison between welded and unwelded entity, improvement in this particular case is 62%. '''Note:''' These are not actual entity colors, but collision visualization.
<gallery>
<gallery>
Image:Ylands-Editor-entity_welding_before.jpg|Colliders before weld
Image:Ylands-Editor-entity_welding_before.jpg|Colliders before weld
Line 13: Line 12:
==Welding entities==
==Welding entities==


When valid entities are selected, Weld entities option in object selection menu will become available. This button will initiate the merge process and create Entity weld. If incompatible entities are selected, they will be automatically excluded from the welding process.
When valid entities are selected, "Weld entities" option in object selection menu will become available. This button will initiate the merge process and create Entity weld. If incompatible entities are also selected, they will be automatically excluded from the welding process.


===Entities that cannot be welded===
===Entities that cannot be welded===
Line 22: Line 21:
*Entities referenced in script
*Entities referenced in script


 
===Example===
<gallery>
Image:Ylands-Editor-entity welding example1.png|Entities to weld
Image:Ylands-Editor-entity welding example2.png|Weld + excluded entities
</gallery>





Revision as of 14:38, 15 April 2019

Overview

Entity welding is feature, which allows to merge multiple entities in to one. Entities welded together will have new, optimized collision envelope, which leads to better performance in game. Welding large structures consisting from hundreds of individual pieces is resource demanding proces and could take even several minutes to complete, but it is essential optimization tool.

Images below show comparison between welded and unwelded entity, improvement in this particular case is 62%. Note: These are not actual entity colors, but collision visualization.

Welding works similar as object grouping, but it is available only for compatible entities. Entity weld is new game object and is threatened in same manner as entity - it can be referenced in script or included in a groups. Weld also provides similar editing options as Object group - it is possible to cancel the weld or edit welded entities on individual level.

Welding entities

When valid entities are selected, "Weld entities" option in object selection menu will become available. This button will initiate the merge process and create Entity weld. If incompatible entities are also selected, they will be automatically excluded from the welding process.

Entities that cannot be welded

  • Pickable entities (can be disabled)
  • Entities with interactions (e.g chairs, doors)
  • Entities with animations (e.g trees, grass)
  • Entities in labels
  • Entities referenced in script

Example


Vehicle construction mode

Game optimizations


Template:Ylands scripting navbox