createDino
Creates a cryopod containing the specified dino. Dinos can be random like a natural spawn or can have very specific details.
Signatures
beacon.createDino(characterId, dinoPath);
beacon.createDino(characterId, dinoPath, dinoInfo);
Parameters
characterId
The Sentinel UUID of the survivor this dino should be given to.
dinoPath
The blueprint path of the desired dino species.
dinoInfo
An object describing one or more specific details about the dino to create. It supports the following properties:
Property | Type | Notes |
---|---|---|
level | Number | The desired dino level. A random level will be chosen if omitted. |
age | Number | To create a baby, specify a value less than 1. Baby is less than 0.1, juvenille is less than 0.5, and adolescent is less than 1. The default is 1. |
isFemale | Boolean | Specify true to create a female, false to create a male. Default is random. It is possible to use this to assign gender to a dino that does not normally have a gender. |
isSterilized | Boolean | Specify true to create a dino that has been spayed or neutered. Default is false. |
name | String | The name for the dino. Defaults to empty. |
imprint | Number | Created dinos are automatically imprinted to the survivor they are given to. This 0-1 number specifies the amount of imprinting quality. Defaults to 0. |
stats | Object | Allows specifying the number of stat points for each stat. Ark stat points are capped at 255. Attempting to send a value less than 0 or greater than 255 will trigger an exception. Valid keys are 0 , health , 1 , stamina , 2 , torpor , 3 , oxygen , 4 , food , 5 , water , 6 , temperature , temp , 7 , weight , 8 , melee , 9 , speed , 10 , fortitude , fort , 11 , crafting , crafting_speed , craft , craftingSpeed , craft_speed , craftSpeed . Yes, there is a lot of overlap in this list. This is to allow for human errors. |
colors | Array | An array of exactly 6 color names. Not numeric color values. Full color list is available at usebeacon.app. Use the values from the Official Name column. |
traits | Array | An array of dino traits. It is valid to include the same trait multiple times. Full trait list is available at usebeacon.app. Use the values from the Official Name column. |
Examples
Give a player random dodo
const characterId = '305b1849-c7ac-5a4b-afe9-86628d91bf23';
const dinoPath = '/Game/PrimalEarth/Dinos/Dodo/Dodo_Character_BP.Dodo_Character_BP';
beacon.createDino(characterId, dinoPath);
Give a player an albino kaprosuchus
const characterId = '305b1849-c7ac-5a4b-afe9-86628d91bf23';
const dinoPath = '/Game/PrimalEarth/Dinos/Kaprosuchus/Kaprosuchus_Character_BP.Kaprosuchus_Character_BP';
const dinoInfo = {
colors: [
'White',
'White',
'White',
'White',
'White',
'White',
],
};
beacon.createDino(characterId, dinoPath, dinoInfo);
Give a player an imprinted spayed female rex
const characterId = '305b1849-c7ac-5a4b-afe9-86628d91bf23';
const dinoPath = '/Game/PrimalEarth/Dinos/Rex/Rex_Character_BP.Rex_Character_BP';
const dinoInfo = {
isFemale: true,
isSterilized: true,
imprint: 1.0,
};
beacon.createDino(characterId, dinoPath, dinoInfo);