SpawnEntityOnCursorDir()

EntityAI PluginBase::SpawnEntityOnCursorDir ( PlayerBase player, string item_name, float quantity, float distance, float health = -1, bool special = false, string presetName = "", bool withPhysics = false )

inlineprotected

spawns entity in direction of cursor at specified distance

Аргументы

[in]	health	health of the item
[in]	quantity	quantity to set if item.HasQuantity() (-1 == set to max)
[in]	distance	distance of the item from player

Возвращает

entity if ok, null otherwise

См. определение в файле PluginDeveloper.c строка 459

    {
 
        if ( GetGame().IsServer() )
        {       
            // Client -> Server Spawning: Server Side
            EntityAI entity = player.SpawnEntityOnGroundOnCursorDir(item_name, distance);
            
            if ( entity )
            {
                if ( !entity.IsBuilding() && health < 0 && entity.GetMaxHealth() > 0)//check for default (-1)
                {
                    health = entity.GetMaxHealth();
                }
                SetupSpawnedEntity( player,entity, health, quantity, special, presetName );
            }
            else
                OnSpawnErrorReport( item_name );
            
            InventoryItem item;
            if (Class.CastTo(item, entity) && withPhysics)
                item.ThrowPhysically(null, "0 0 0");
            
            return entity;
        }
        else
        {       
            // Client -> Server Spawning: Client Side
            Param7<string, float, float, float, bool, string, bool> params = new Param7<string, float, float, float, bool, string, bool>(item_name, quantity, distance, health, special, presetName, withPhysics);
            player.RPCSingleParam(ERPCs.DEV_RPC_SPAWN_ITEM_ON_CURSOR, params, true);
        }
        return NULL;
    }

Перекрестные ссылки Class::CastTo(), GetGame(), EntityAI::IsBuilding(), OnSpawnErrorReport() и SetupSpawnedEntity().

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