Класс PlayerSpawnHandler

Закрытые статические члены
static bool	LoadData ()
static bool	IsInitialized ()
static PlayerSpawnPreset	GetRandomCharacterPreset ()
static bool	ProcessEquipmentData (PlayerBase player, PlayerSpawnPreset data)
	equips character with the chosen preset
static void	ProcessSlotsEquipment (PlayerBase player, PlayerSpawnPreset data)
	iterates over each object and spawns alternatives
static bool	SelectAndSpawnSlotEquipment (PlayerBase player, PlayerSpawnPresetSlotData slotData)
	selects weighted slot equipment variant
static void	ProcessCargoEquipment (PlayerBase player, PlayerSpawnPreset data)
	chooses one object from the array
static bool	SelectAndSpawnCargoSet (PlayerBase player, PlayerSpawnPreset data)
static bool	SpawnDiscreteCargoItemSet (PlayerBase player, PlayerSpawnPresetDiscreteCargoSetData csd)
static bool	SpawnDiscreteSlotItemSet (PlayerBase player, PlayerSpawnPresetDiscreteItemSetSlotData dis, int slotID)
static bool	SpawnComplexChildrenItems (EntityAI parent, notnull PlayerSpawnPresetItemSetBase data)
	could spawn other items recursively. Parent item is guaranteed here.
static bool	SpawnSimpleChildrenItems (EntityAI parent, PlayerSpawnPresetItemSetBase data)
static void	HandleNewItem (notnull ItemBase item, PlayerSpawnPresetItemSetBase data)
static EntityAI	CreateChildItem (EntityAI parent, string type)
static void	ApplyAttributes (ItemBase item, PlayerSpawnAttributesData attributes)
static bool	IsWeaponAndMagazineType (EntityAI parent, string type)
	Used for exceptions in the system.

Закрытые статические данные
static bool	m_Initialized
static ref PlayerSpawnJsonData	m_Data = new PlayerSpawnJsonData()

Подробное описание

Методы

ApplyAttributes()

static void ApplyAttributes ( ItemBase item, PlayerSpawnAttributesData attributes )

inlinestaticprivate

    {
        if (!attributes)
            return;
        
        float health01 = Math.RandomFloatInclusive(attributes.healthMin,attributes.healthMax);
        item.SetHealth01("","Health",health01);
        
        float quantity01 = Math.RandomFloatInclusive(attributes.quantityMin,attributes.quantityMax);
        if (item.IsMagazine())
        {
            Magazine mag = Magazine.Cast(item);
            /*if (attributes.magazineAmmoOrdered && attributes.magazineAmmoOrdered.Count() > 0)
            {
                mag.ServerSetAmmoCount(0);
                foreach (string bulletType : attributes.magazineAmmoOrdered)
                {
                    mag.ServerStoreCartridge(health01,bulletType);
                }
                mag.SetSynchDirty();
            }
            else*/
            {
                int ammoQuantity = (int)Math.Lerp(0,mag.GetAmmoMax(),quantity01);
                mag.ServerSetAmmoCount(ammoQuantity);
            }
        }
        else //'varQuantityDestroyOnMin' quantity safeguard
        {
            float quantityAbsolute = Math.Lerp(item.GetQuantityMin(),item.GetQuantityMax(),quantity01);
            quantityAbsolute = Math.Round(quantityAbsolute); //avoids weird floats
            if (quantityAbsolute <= item.GetQuantityMin() && item.ConfigGetBool("varQuantityDestroyOnMin"))
                quantityAbsolute++;
            item.SetQuantity(quantityAbsolute);
        }
    }

Перекрестные ссылки Math::Lerp(), Math::RandomFloatInclusive() и Math::Round().

Используется в HandleNewItem() и SpawnSimpleChildrenItems().

CreateChildItem()

static EntityAI CreateChildItem ( EntityAI parent, string type )

inlinestaticprivate

    {
        PlayerBase player;
        ItemBase newItem;
        if (Class.CastTo(player,parent)) //special behavior
        {
            if (Class.CastTo(newItem,player.GetInventory().CreateInInventory(type)))
                return newItem;
            
            Debug.Log("FAILED spawning item: " + type + ", it fits in no cargo or attachment on any worn item","n/a","n/a","CreateChildItem");
            return null;
        }
        
        //weapon magazine exception
        if (GetGame().ConfigIsExisting(CFG_MAGAZINESPATH + " " + type) && parent.IsWeapon())
        {
            Weapon_Base wep
            if (Class.CastTo(wep,parent) && wep.SpawnAmmo(type) && !wep.HasInternalMagazine(-1)) //assuming weps with internal magazine don't attach external magazines
            {
                Magazine mag;
                int muzzleCount = wep.GetMuzzleCount();
                for (int i = 0; i < muzzleCount; i++)
                {
                    if (Class.CastTo(mag,wep.GetMagazine(i)) && mag.GetType() == type)
                        return mag;
                }
            }
            
            return null;
        }
        
        return parent.GetInventory().CreateInInventory(type);
    }

Перекрестные ссылки Class::CastTo(), CFG_MAGAZINESPATH, GetGame() и Debug::Log().

Используется в SpawnComplexChildrenItems() и SpawnSimpleChildrenItems().

GetRandomCharacterPreset()

static PlayerSpawnPreset GetRandomCharacterPreset ( )

inlinestaticprivate

    {
        array<int> weightedPresetIndexes = new array<int>();
        int count = m_Data.presets.Count();
        PlayerSpawnPreset p;
        for (int i = 0; i < count; i++)
        {
            p = m_Data.presets[i];
            if (p.IsValid())
            {
                for (int j = 0; j < p.spawnWeight; j++)
                {
                    weightedPresetIndexes.Insert(i);
                }
            }
        }
        
        return m_Data.presets.Get(weightedPresetIndexes.GetRandomElement());
    } 

Перекрестные ссылки m_Data.

Используется в MissionBase::OnClientNewEvent().

HandleNewItem()

static void HandleNewItem ( notnull ItemBase item, PlayerSpawnPresetItemSetBase data )

inlinestaticprivate

    {
        ApplyAttributes(item,data.attributes);
        
        PlayerBase player;
        if (Class.CastTo(player,item.GetHierarchyRootPlayer()) && data.GetQuickbarIdx() > -1)
            player.SetQuickBarEntityShortcut(item,data.GetQuickbarIdx());
        
        SpawnComplexChildrenItems(item,data);
        SpawnSimpleChildrenItems(item,data);
    }

Перекрестные ссылки ApplyAttributes(), Class::CastTo(), SpawnComplexChildrenItems() и SpawnSimpleChildrenItems().

Используется в SpawnComplexChildrenItems() и SpawnDiscreteSlotItemSet().

IsInitialized()

static bool IsInitialized ( )

inlinestaticprivate

    {
        return m_Initialized;
    }

Перекрестные ссылки m_Initialized.

Используется в MissionBase::OnClientNewEvent().

IsWeaponAndMagazineType()

static bool IsWeaponAndMagazineType ( EntityAI parent, string type )

inlinestaticprivate

Used for exceptions in the system.

    {
        return (GetGame().ConfigIsExisting(CFG_MAGAZINESPATH + " " + type) && parent.IsWeapon());
    }

Перекрестные ссылки CFG_MAGAZINESPATH и GetGame().

Используется в SpawnComplexChildrenItems() и SpawnSimpleChildrenItems().

LoadData()

static bool LoadData ( )

inlinestaticprivate

    {
        array<string> spawnGearPresetFiles = CfgGameplayHandler.GetPlayerSpawnGearPresetFiles();
        if (!spawnGearPresetFiles || (spawnGearPresetFiles && spawnGearPresetFiles.Count() == 0))
            return false;
 
        m_Data.presets = {};
 
        foreach (string spawnPresetFile : spawnGearPresetFiles)
        {
            PlayerSpawnPreset preset;
            string path = "$mission:" + spawnPresetFile;
 
            string errorMessage;
            if (!JsonFileLoader<PlayerSpawnPreset>.LoadFile(path, preset, errorMessage))
            {
                ErrorEx(errorMessage);
                return false;
            }
            
            if (preset != null)
                m_Data.presets.Insert(preset);
        }
 
        m_Initialized = m_Data.presets.Count() > 0;
        
        return true;
    }

Перекрестные ссылки ErrorEx, CfgGameplayHandler::GetPlayerSpawnGearPresetFiles(), m_Data, m_Initialized и path.

Используется в MissionBase::OnInit().

ProcessCargoEquipment()

static void ProcessCargoEquipment ( PlayerBase player, PlayerSpawnPreset data )

inlinestaticprivate

chooses one object from the array

    {
        if (!data.HasDiscreteUnsortedItemSetsDefined())
        {
            Debug.Log("No non-empty 'discreteUnsortedItemSets' array found. Skipping cargo spawns","n/a","n/a","ProcessCargoEquipment");
            return;
        }
        
        SelectAndSpawnCargoSet(player,data);
    }

Перекрестные ссылки Debug::Log() и SelectAndSpawnCargoSet().

Используется в ProcessEquipmentData().

ProcessEquipmentData()

static bool ProcessEquipmentData ( PlayerBase player, PlayerSpawnPreset data )

inlinestaticprivate

equips character with the chosen preset

    {
        if (data.IsValid())
        {
            ProcessSlotsEquipment(player, data);
            ProcessCargoEquipment(player, data);
        }
        
        return true;
    }

Перекрестные ссылки ProcessCargoEquipment() и ProcessSlotsEquipment().

Используется в MissionBase::OnClientNewEvent().

ProcessSlotsEquipment()

static void ProcessSlotsEquipment ( PlayerBase player, PlayerSpawnPreset data )

inlinestaticprivate

iterates over each object and spawns alternatives

    {
        if (!data.HasAttachmentSlotSetsDefined())
        {
            Debug.Log("No non-empty 'attachmentSlotItemSets' array found. Skipping slot spawns","n/a","n/a","ProcessSlotsEquipment");
            return;
        }
        
        foreach (PlayerSpawnPresetSlotData slotData : data.attachmentSlotItemSets)
        {
            SelectAndSpawnSlotEquipment(player,slotData);
        }
    }

Перекрестные ссылки Debug::Log() и SelectAndSpawnSlotEquipment().

Используется в ProcessEquipmentData().

SelectAndSpawnCargoSet()

static bool SelectAndSpawnCargoSet ( PlayerBase player, PlayerSpawnPreset data )

inlinestaticprivate

    {
        array<int> weightedDiscreteSetIndexes = new array<int>();
        int count = data.discreteUnsortedItemSets.Count();
        PlayerSpawnPresetDiscreteCargoSetData csd;
        for (int i = 0; i < count; i++)
        {
            csd = data.discreteUnsortedItemSets[i];
            
            if (csd.IsValid()) //only when the spawnWeight is set
            {
                for (int j = 0; j < csd.spawnWeight; j++)
                {
                    weightedDiscreteSetIndexes.Insert(i);
                }
            }
        }
        
        csd = null;
        if (weightedDiscreteSetIndexes.Count() > 0)
            csd = data.discreteUnsortedItemSets.Get(weightedDiscreteSetIndexes.GetRandomElement());
        return SpawnDiscreteCargoItemSet(player,csd);
    }

Перекрестные ссылки SpawnDiscreteCargoItemSet().

Используется в ProcessCargoEquipment().

SelectAndSpawnSlotEquipment()

static bool SelectAndSpawnSlotEquipment ( PlayerBase player, PlayerSpawnPresetSlotData slotData )

inlinestaticprivate

selects weighted slot equipment variant

    {
        int slotID;
        if (!slotData.TranslateAndValidateSlot(player,slotID))
            return false;
        
        if (!slotData.IsValid())
            return false;
        
        array<int> weightedDiscreteSetIndexes = new array<int>();
        int count = slotData.discreteItemSets.Count();
        PlayerSpawnPresetDiscreteItemSetSlotData dis;
        for (int i = 0; i < count; i++)
        {
            dis = slotData.discreteItemSets[i];
            
            if (dis.IsValid()) //only when the type exists and spawnWeight is set
            {
                for (int j = 0; j < dis.spawnWeight; j++)
                {
                    weightedDiscreteSetIndexes.Insert(i);
                }
            }
        }
        
        dis = null;
        if (weightedDiscreteSetIndexes.Count() > 0)
            dis = slotData.discreteItemSets.Get(weightedDiscreteSetIndexes.GetRandomElement());
        return SpawnDiscreteSlotItemSet(player,dis,slotID);
    }

Перекрестные ссылки SpawnDiscreteSlotItemSet().

Используется в ProcessSlotsEquipment().

SpawnComplexChildrenItems()

static bool SpawnComplexChildrenItems ( EntityAI parent, notnull PlayerSpawnPresetItemSetBase data )

inlinestaticprivate

could spawn other items recursively. Parent item is guaranteed here.

    {
        if (!data.complexChildrenTypes || data.complexChildrenTypes.Count() < 1) //no children defined, still valid!
        {
            return false;
        }
        
        foreach (PlayerSpawnPresetComplexChildrenType cct : data.complexChildrenTypes)
        {
            if (cct.itemType == string.Empty)
            {
                Debug.Log("Empty item type found in 'complexChildrenTypes' of parent : " + parent,"n/a","n/a","SpawnSimpleChildrenItems");
                continue;
            }
            
            ItemBase item;
            Class.CastTo(item,CreateChildItem(parent,cct.itemType));
            
            if (item)
            {
                HandleNewItem(item,cct);
            }
            else
            {
                Weapon_Base wep;
                if (!Class.CastTo(wep,parent) || !IsWeaponAndMagazineType(parent,cct.itemType) || !wep.HasInternalMagazine(-1))
                    Debug.Log("FAILED spawning item: " + cct.itemType + " of parent: " + parent,"n/a","n/a","SpawnComplexChildrenItems");
            }
        }
        
        return true;
    }

Перекрестные ссылки Class::CastTo(), CreateChildItem(), HandleNewItem(), IsWeaponAndMagazineType() и Debug::Log().

Используется в HandleNewItem() и SpawnDiscreteCargoItemSet().

SpawnDiscreteCargoItemSet()

static bool SpawnDiscreteCargoItemSet ( PlayerBase player, PlayerSpawnPresetDiscreteCargoSetData csd )

inlinestaticprivate

    {
        SpawnComplexChildrenItems(player,csd);
        SpawnSimpleChildrenItems(player,csd);
        return true;
    }

Перекрестные ссылки SpawnComplexChildrenItems() и SpawnSimpleChildrenItems().

Используется в SelectAndSpawnCargoSet().

SpawnDiscreteSlotItemSet()

static bool SpawnDiscreteSlotItemSet ( PlayerBase player, PlayerSpawnPresetDiscreteItemSetSlotData dis, int slotID )

inlinestaticprivate

    {
        if (!dis)
        {
            Debug.Log("No PlayerSpawnPresetDiscreteItemSet found. Skipping spawn for slot: " + InventorySlots.GetSlotName(slotID),"n/a","n/a","SpawnDiscreteSlotItemSet");
            return false;
        }
        
        ItemBase item;
        if (slotID == InventorySlots.HANDS) //hands exception
            item = ItemBase.Cast(player.GetHumanInventory().CreateInHands(dis.itemType));
        else
            item = ItemBase.Cast(player.GetInventory().CreateAttachmentEx(dis.itemType,slotID));
        
        if (item)
        {
            HandleNewItem(item,dis);
        }
        else if (dis.itemType != string.Empty)
        {
            Debug.Log("FAILED spawning item type: " + dis.itemType + " into slot: " + InventorySlots.GetSlotName(slotID) + " of parent: " + player,"n/a","n/a","SpawnDiscreteSlotItemSet");
            return false;
        }
        
        return item != null;
    }

Перекрестные ссылки InventorySlots::GetSlotName(), HandleNewItem() и Debug::Log().

Используется в SelectAndSpawnSlotEquipment().

SpawnSimpleChildrenItems()

static bool SpawnSimpleChildrenItems ( EntityAI parent, PlayerSpawnPresetItemSetBase data )

inlinestaticprivate

    {
        if (!data || !data.simpleChildrenTypes || data.simpleChildrenTypes.Count() < 1) //no children defined, still valid!
        {
            return false;
        }
        
        int count = data.simpleChildrenTypes.Count();
        string itemType;
        for (int i = 0; i < count; i++)
        {
            itemType = data.simpleChildrenTypes[i];
            if (itemType == string.Empty)
            {
                Debug.Log("Empty item type found at idx: " + i.ToString() + " of 'simpleChildrenTypes' array. Skipping","n/a","n/a","SpawnSimpleChildrenItems");
                continue;
            }
            
            ItemBase item;
            Class.CastTo(item,CreateChildItem(parent,itemType));
            
            if (item)
            {
                if (!data.simpleChildrenUseDefaultAttributes)
                    ApplyAttributes(item,data.attributes);
            }
            else
            {
                Weapon_Base wep;
                if (!Class.CastTo(wep,parent) || !IsWeaponAndMagazineType(parent,itemType) || !wep.HasInternalMagazine(-1))
                    Debug.Log("FAILED spawning item type: " + itemType + " to parent: " + parent,"n/a","n/a","SpawnSimpleChildrenItems");
            }
        }
        return true;
    }

Перекрестные ссылки ApplyAttributes(), Class::CastTo(), CreateChildItem(), Empty, IsWeaponAndMagazineType() и Debug::Log().

Используется в HandleNewItem() и SpawnDiscreteCargoItemSet().

Поля

m_Data

ref PlayerSpawnJsonData m_Data = new PlayerSpawnJsonData()

staticprivate

Используется в GetRandomCharacterPreset() и LoadData().

m_Initialized

bool m_Initialized

staticprivate

Используется в IsInitialized() и LoadData().

---

Объявления и описания членов класса находятся в файле:

• D:/Ishodniki/scripts/4_World/Classes/PlayerGearSpawn/CfgPlayerSpawnHandler.c