Hi all,

This guide is an addition to the provided Modding documentation. Before jumping in, make sure you've read the Entity section under Assets. It explains how a scene should be structured and this structure is crucial for the export. Here is a quick reference from the Modding docs regarding the scene and the materials.

Origin

• An empty object or an armature - this is mandatory. The origin is parent of the mesh.
  
• Everything will be positioned relative to this object.
  
• This way you can organize the scene better.

Entity Mesh

• Meshes are what's visible inside the game.
  
• It's a mesh object parented to an Origin.
  
• Multiple mesh objects can be part of the same entity mesh. (Note that this is different to Blender mesh object structure; it allows Stranded-Alien Dawn to use sub-meshes.)
  
• Mesh objects are associated with Entities.
  
• Mesh objects must be a part of at least one state (enforced by the UI).

Spot

• Spots are logical points attached to a mesh.
  
• Represented as an empty object parented to an entity mesh.
  
• When a mesh is animated, the spots must be parented to the specific bone they should move along with (Ctrl+P → Bone).
  
• Note that an origin spot is added automatically.

Surface

• Surfaces are mesh objects used for things like Collision (check the dropdown list “Surface type” to see possible usages).
  
• Surfaces are mesh objects parented to an entity mesh.
  
• Surfaces cannot be animated.

Stranded - Alien Dawn uses PBR-based materials using the Metalness workflow. Textures should be supplied in 24-bit or 32-bit uncompressed TGA format. Material settings can be edited only inside the Haemimont Material panel in the Material properties (other changes will be ignored/overridden). All textures should use the first (and only) UV map. The following textures can be associated with an object:

Base colour

• The albedo for diffuse surfaces, or the specular colour for glossy surfaces. If the BaseColor texture contains alpha channel, the option Use Alpha Test under Haemimont Material in Material tab, should be checked.

Normal

• Normal map - DirectX.

Roughness/metallic

• R channels - “roughness” (0 - polished surface, 1 - rough surface). B channel - “metalness” (0 - dielectric, 1 - metal).

AO

• Grayscale ambient occlusion.

Self illumination

• Grayscale emissive level (self-illumination). Pure white (1.0) is treated as extra emissive (HDR), e.g. the surface of light sources.

Colorization

• Texture used for colorizing meshes.

The Blender Add-on will try to replicate what will be seen in the game as closely as possible using the Eevee engine. Use this as a reference only - the entity will appear differently in the game, since the Eevee engine is not identical to Haemimont Games engine. In case the add-on doesn't update the shader nodes automatically, you can use the “Recreate shader nodes” button in the HGE Tools panel.
Also, an appropriate number should be set for the “Number of masked colors in CM” property, depending on the number of parts the model is separated into. This property can be found inside the Haemimont Material. This can be found in Blender by following the steps:

Select object → “Materials Properties” tab → Haemimont Material → Maps → “Colorization mask” and “Colorization mask colors”.
The maximum number of parts is 4. The texture will act as four masks combined into one:

• Black color (#000000ff) will be ignored.
  
• Red color (#ff0000ff) will mark the “first” part.
  
• Green color (#00ff00ff) will mark the “second” part.
  
• Blue color (#0000ffff) will mark the “third” part.
  
• The alpha channgel (#00000000) will mark the “fourth” part.

There cannot be any mixing at the edges between two different parts and all colors must match those hex codes exactly. The Base Color texture should also be prepared. Parts that will be colorized should be grayscale. Recomended values range from 190 to 220.

Open Blender and load the Haemimont games Exporter Add-on.

1. From top menu -> Edit -> Preferences
2. Add-Ons -> Install -> Locate the file in …Steam\steamapps\common\Stranded – Alien Dawn\ModTools -> HGBlenderExporter.zip -> Enable add-on



3. This will add a new panel – HGE tools - for the settings of the mesh when exported.

We will use a colorful cube as an example for this guide.

1. Place an empty object and name it "Origin"
2. Place a cube
3. Duplicate the cube and name the second one "Collision" - you can make this invisible so you don't edit it by mistake.
4. Parent the objects as the order above -> Origin is parent of cube ->Cube is parent of Collision.
5. You can load texture files using the Haemimont Material/Maps panel under Material Properties. In this case we'll use Blender to create and paint a texture:

• Select the cube and open the Image Editor tab (Shift F10). Draw your texture.

6. Save the image - there is a menu the texturing panel, under the top menu that is labeled "Image"
7. Select the cube and use the Haemimont Material/Maps panel under Material Properties to select your texture

Click on the image below for zoomed view and check out the structure of the scene and the Materials settings.

When you are ready with the scene, you can export it. The tool will provide sufficient information if there are any errors, keep an eye on the following:
• Entity name – name of the Entity in the engine
• Mesh – Name of the mesh object in Blender
• State - States are defined variations a given Entity. For example, the Entity 'ElectricHeater' has two states - 'idle' and 'working' States are defined in two places - State name field in the Object panel of the HGE Tools sidebar. Plants have the following entity spec <ENTITY_BASE><STATE><SEASON><VV>:
- ENTITY_BASE is selected depending on the plant's growth from the entities below and its variant (the digits at the end) are removed;
- STATE is "Decay_" if the plant is in decay, "Fruits_" if it has fruits or "";
- SEASON is one of the several season suffixes for the current season - the first one which produces valid entity is selected; e.g in winter the entities tested are "Winter_", "LateFall_", "" - so if no special winter entity is provided the plant will use its LateFall or default (summer) entity;
- VV is a two digit variant - each entity can have any number of variants and the plant will choose randomly one

When ready, press export. The new entity will be placed in %AppData%\Roaming\Stranded - Alien Dawn\ExportedEntities. The file will have .ent extension.

To use your entity in a Mod, you will need to add an Entity mod item first. Create a new mod, fill in name, id and description and add an Entity Mod item (Assets -> Entity).

1. Import the entity by pressing […] button and locating the exported entity in %AppData%\Roaming\Stranded - Alien Dawn\ExportedEntities. Press import. This will autofill in Name and Entity name. Save.



2. Create the mod item type that you want to use the entity for. You can start by copying from already existing preset in the game. In this case, statue is used as an example.



3. Replace the entity in the building section with the one just imported. Change names and descriptions.



4. If you want the Statue to be enabled in the beginning, define the lock state as “enabled” in the Lock state.



5. In my case the “Build menu” section defines how the Statue will be visualized and in which category it will be placed.
a. Reminder: Icon should be in the Mod folder. The size for this icon is 100x100

An example asset was provided by the creators of Beyond Stranded mod and the asset was adjusted by the devs with additional approach points and collision, so the stool works as the chairs in the game.




You can download and examine the structure of the scene at this link:download here[drive.google.com]

Mod editor helps!
When you are in the Mod editor, there are a few useful tricks you can apply to check if your entity is working properly, Cheats are enabled by default on the modding map. Let's start with some cheats that will unlock everything and provide resources, so you can start testing right away.

• Alt + O - will spawn resources
  
• Alt + U - will unlock everything in the build menu
  
• Alt + B - will automatically construct the buildings

When you select an object, you will also see the info panel cheats - in our case we need collision, spots and approach points.


Those can be enabled/disabled, and they can help you arrange your Blender scene. The spots will also come in handy for naming the empty objects in Blender that are used for spots. Mind that the annotations (after the Spot name) should be filled in as well.