ShipEntity(PureAI) Category Reference

Instance Methods
(void)	- setStateTo:
(void)	- pauseAI:
(void)	- randomPauseAI:
(void)	- dropMessages:
(void)	- debugDumpPendingMessages
(void)	- setDestinationToCurrentLocation
(void)	- setDesiredRangeTo:
(void)	- setDesiredRangeForWaypoint
(void)	- setSpeedTo:
(void)	- setSpeedFactorTo:
(void)	- setSpeedToCruiseSpeed
(void)	- setThrustFactorTo:
(void)	- setTargetToPrimaryAggressor
(void)	- scanForNearestMerchantman
(void)	- scanForRandomMerchantman
(void)	- scanForLoot
(void)	- scanForRandomLoot
(void)	- setTargetToFoundTarget
(void)	- checkForFullHold
(void)	- getWitchspaceEntryCoordinates
(void)	- setDestinationFromCoordinates
(void)	- setCoordinatesFromPosition
(void)	- fightOrFleeMissile
(void)	- setCourseToPlanet
(void)	- setTakeOffFromPlanet
(void)	- landOnPlanet
(void)	- checkTargetLegalStatus
(void)	- checkOwnLegalStatus
(void)	- exitAIWithMessage:
(void)	- setDestinationToTarget
(void)	- setDestinationWithinTarget
(void)	- checkCourseToDestination
(void)	- checkAegis
(void)	- checkEnergy
(void)	- checkHeatInsulation
(void)	- scanForOffenders
(void)	- setCourseToWitchpoint
(void)	- setDestinationToWitchpoint
(void)	- setDestinationToStationBeacon
(void)	- performHyperSpaceExit
(void)	- performHyperSpaceExitWithoutReplacing
(void)	- wormholeGroup
(void)	- commsMessage:
(void)	- commsMessageByUnpiloted:
(void)	- ejectCargo
(void)	- scanForThargoid
(void)	- scanForNonThargoid
(void)	- thargonCheckMother
(void)	- becomeUncontrolledThargon
(void)	- checkDistanceTravelled
(void)	- fightOrFleeHostiles
(void)	- suggestEscort
(void)	- escortCheckMother
(void)	- checkGroupOddsVersusTarget
(void)	- scanForFormationLeader
(void)	- messageMother:
(void)	- setPlanetPatrolCoordinates
(void)	- setSunSkimStartCoordinates
(void)	- setSunSkimEndCoordinates
(void)	- setSunSkimExitCoordinates
(void)	- patrolReportIn
(void)	- checkForMotherStation
(void)	- sendTargetCommsMessage:
(void)	- markTargetForFines
(void)	- markTargetForOffence:
(void)	- storeTarget
(void)	- recallStoredTarget
(void)	- scanForRocks
(void)	- setDestinationToDockingAbort
(void)	- requestNewTarget
(void)	- rollD:
(void)	- scanForNearestShipWithPrimaryRole:
(void)	- scanForNearestShipHavingRole:
(void)	- scanForNearestShipWithAnyPrimaryRole:
(void)	- scanForNearestShipHavingAnyRole:
(void)	- scanForNearestShipWithScanClass:
(void)	- scanForNearestShipWithoutPrimaryRole:
(void)	- scanForNearestShipNotHavingRole:
(void)	- scanForNearestShipWithoutAnyPrimaryRole:
(void)	- scanForNearestShipNotHavingAnyRole:
(void)	- scanForNearestShipWithoutScanClass:
(void)	- setCoordinates:
(void)	- checkForNormalSpace
(void)	- setTargetToRandomStation
(void)	- setTargetToLastStation
(void)	- addFuel:
(void)	- scriptActionOnTarget:
(void)	- sendScriptMessage:
(void)	- ai_throwSparks
(void)	- explodeSelf
(void)	- ai_debugMessage:
(void)	- targetFirstBeaconWithCode:
(void)	- targetNextBeaconWithCode:
(void)	- setRacepointsFromTarget
(void)	- performFlyRacepoints
(void)	- addPrimaryAggressorAsDefenseTarget
(void)	- addFoundTargetAsDefenseTarget
(void)	- findNewDefenseTarget
(void)	- setDestinationToJinkPosition [implementation]
(void)	- disengageAutopilot [implementation]
(void)	- messageSelf: [implementation]
(void)	- scanForNearestShipMatchingPredicate: [implementation]
(void)	- safeScriptActionOnTarget: [implementation]

Detailed Description

Definition at line 72 of file ShipEntityAI.m.

Method Documentation

addFoundTargetAsDefenseTarget

- (void) addFoundTargetAsDefenseTarget

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    Entity* fTarget = [self foundTarget];
    if (fTarget != nil)
    {
        if ([fTarget isShip] && ![(ShipEntity *)fTarget isFriendlyTo:self])
        {
            [self addDefenseTarget:fTarget];
        }
    }
}

addFuel:

- (void) addFuel:

(NSString *)

fuel_number

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

                :(NSString*) fuel_number
{
    [self setFuel:[self fuel] + [fuel_number intValue] * 10];
}

addPrimaryAggressorAsDefenseTarget

- (void) addPrimaryAggressorAsDefenseTarget

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    Entity *primeAggressor = [self primaryAggressor];
    if (!primeAggressor)
        return;
    if ([self isDefenseTarget:primeAggressor])
        return;
    
    if ([primeAggressor isShip] && ![(ShipEntity*)primeAggressor isFriendlyTo:self])
    {
        [self addDefenseTarget:primeAggressor];
    }
}

ai_debugMessage:

- (void) ai_debugMessage:

(NSString *)

message

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

                        :(NSString *)message
{
    NSString *desc = [NSString stringWithFormat:@"%@ %d", [self name], [self universalID]];
    if ([self isPlayer])  desc = @"player autopilot";
    OOLog(@"ai.takeAction.debugMessage", @"DEBUG: AI MESSAGE from %@: %@", desc, message);
}

ai_throwSparks

- (void) ai_throwSparks

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    [self setThrowSparks:YES];
}

becomeUncontrolledThargon

- (void) becomeUncontrolledThargon

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    int         ent_count =     UNIVERSE->n_entities;
    Entity**    uni_entities =  UNIVERSE->sortedEntities;   // grab the public sorted list
    int i;
    for (i = 0; i < ent_count; i++) if (uni_entities[i]->isShip)
    {
        ShipEntity *other = (ShipEntity*)uni_entities[i];
        if ([other primaryTarget] == self)
        {
            [other removeTarget:self];
        }
        if ([other isDefenseTarget:self])
        {
            [other removeDefenseTarget:self];
        }
    }
    // now we're just a bunch of alien artefacts!
    scanClass = CLASS_CARGO;
    reportAIMessages = NO;
    [self setAITo:@"dumbAI.plist"];
    DESTROY(_primaryTarget);
    [self setSpeed: 0.0];
    [self setGroup:nil];
}

checkAegis

- (void) checkAegis

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    switch (aegis_status)
    {
        case AEGIS_CLOSE_TO_MAIN_PLANET: 
            [shipAI message:@"AEGIS_CLOSE_TO_MAIN_PLANET"];
            // It's been a few years since 1.71 - it should be safe enough to comment out the line below for 1.77/1.78 -- Kaks 20120917
            //[shipAI message:@"AEGIS_CLOSE_TO_PLANET"];         // fires only for main planets, kept for compatibility with pre-1.72 AI plists.
            return;
        case AEGIS_CLOSE_TO_ANY_PLANET:
        {
            Entity<OOStellarBody> *nearest = [self findNearestStellarBody];
            
            if([nearest isSun])
            {
                [shipAI message:@"CLOSE_TO_SUN"];
            }
            else
            {
                [shipAI message:@"CLOSE_TO_PLANET"];
                if ([nearest planetType] == STELLAR_TYPE_MOON)
                {
                    [shipAI message:@"CLOSE_TO_MOON"];
                }
                else
                {
                    [shipAI message:@"CLOSE_TO_SECONDARY_PLANET"];
                }
            }
            return;
        }
        case AEGIS_IN_DOCKING_RANGE:
            [shipAI message:@"AEGIS_IN_DOCKING_RANGE"];
            return;
        case AEGIS_NONE:
            [shipAI message:@"AEGIS_NONE"];
            return;
    }
    
    NSLog(@"Aegis status for %@ has taken on invalid value %i. This is an internal error, please report it.", self, aegis_status);
    aegis_status = AEGIS_NONE;
    [shipAI message:@"AEGIS_NONE"];
}

checkCourseToDestination

- (void) checkCourseToDestination

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    Entity *hazard = [UNIVERSE hazardOnRouteFromEntity: self toDistance: desired_range fromPoint: _destination];
    
    if (hazard == nil || ([hazard isShip] && HPdistance(position, [hazard position]) > scannerRange) || ([hazard isPlanet] && aegis_status == AEGIS_NONE)) 
        [shipAI message:@"COURSE_OK"]; // Avoid going into a waypoint.plist for far away objects, it cripples the main AI a bit in its funtionality.
    else
    {
        if ([hazard isShip] && (weapon_damage * 24.0 > [hazard energy]))
        {
            [shipAI reactToMessage:@"HAZARD_CAN_BE_DESTROYED" context:@"checkCourseToDestination"];
        }
        
        _destination = [UNIVERSE getSafeVectorFromEntity:self toDistance:desired_range fromPoint:_destination];
        [shipAI message:@"WAYPOINT_SET"];
    }
}

checkDistanceTravelled

- (void) checkDistanceTravelled

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    if (distanceTravelled > desired_range)
        [shipAI message:@"GONE_BEYOND_RANGE"];
}

checkEnergy

- (void) checkEnergy

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    if (energy == maxEnergy)
    {
        [shipAI message:@"ENERGY_FULL"];
        return;
    }
    if (energy >= maxEnergy * 0.75)
    {
        [shipAI message:@"ENERGY_HIGH"];
        return;
    }
    if (energy <= maxEnergy * 0.25)
    {
        [shipAI message:@"ENERGY_LOW"];
        return;
    }
    [shipAI message:@"ENERGY_MEDIUM"];
}

checkForFullHold

- (void) checkForFullHold

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    if (!max_cargo)
    {
        [shipAI message:@"NO_CARGO_BAY"];
    }
    else if ([cargo count] >= [self maxAvailableCargoSpace])
    {
        [shipAI message:@"HOLD_FULL"];
    }
    else
    {
        [shipAI message:@"HOLD_NOT_FULL"];
    }
}

checkForMotherStation

- (void) checkForMotherStation

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    ShipEntity *motherStation = [[self group] leader];
    if ((!motherStation) || (!(motherStation->isStation)))
    {
        [shipAI message:@"NOTHING_FOUND"];
        return;
    }
    double found_d2 = scannerRange * scannerRange;
    HPVector v0 = motherStation->position;
    if (HPdistance2(v0,position) > found_d2)
    {
        [shipAI message:@"NOTHING_FOUND"];
        return;
    }
    [shipAI message:@"STATION_FOUND"];      
}

checkForNormalSpace

- (void) checkForNormalSpace

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    if ([UNIVERSE sun] && [UNIVERSE planet])
        [shipAI message:@"NORMAL_SPACE"];
    else
        [shipAI message:@"INTERSTELLAR_SPACE"];
}

checkGroupOddsVersusTarget

- (void) checkGroupOddsVersusTarget

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    NSUInteger ownGroupCount = [[self group] count] + (ranrot_rand() & 3);          // add a random fudge factor
    NSUInteger targetGroupCount = [[[self primaryTarget] group] count] + (ranrot_rand() & 3);   // add a random fudge factor
    
    if (ownGroupCount == targetGroupCount)
    {
        [shipAI message:@"ODDS_LEVEL"];
    }
    else if (ownGroupCount > targetGroupCount)
    {
        [shipAI message:@"ODDS_GOOD"];
    }
    else
    {
        [shipAI message:@"ODDS_BAD"];
    }
}

checkHeatInsulation

- (void) checkHeatInsulation

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    float minInsulation = 1000 / [self maxFlightSpeed] + 1;
    
    if ([self heatInsulation] < minInsulation)
    {
        [shipAI message:@"INSULATION_POOR"];
        return;
    }
    [shipAI message:@"INSULATION_OK"];
}

checkOwnLegalStatus

- (void) checkOwnLegalStatus

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    if (scanClass == CLASS_THARGOID)
    {
        [shipAI message:@"SELF_THARGOID"];
        return;
    }
    int ls = [self legalStatus];
    if (ls > 50)
    {
        [shipAI message:@"SELF_FUGITIVE"];
        return;
    }
    if (ls > 20)
    {
        [shipAI message:@"SELF_OFFENDER"];
        return;
    }
    if (ls > 0)
    {
        [shipAI message:@"SELF_MINOR_OFFENDER"];
        return;
    }
    [shipAI message:@"SELF_CLEAN"];
}

checkTargetLegalStatus

- (void) checkTargetLegalStatus

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    ShipEntity  *other_ship = [self primaryTarget];
    if (!other_ship)
    {
        [shipAI message:@"NO_TARGET"];
        return;
    }
    else
    {
        int ls = [other_ship legalStatus];
        if (ls > 50)
        {
            [shipAI message:@"TARGET_FUGITIVE"];
            return;
        }
        if (ls > 20)
        {
            [shipAI message:@"TARGET_OFFENDER"];
            return;
        }
        if (ls > 0)
        {
            [shipAI message:@"TARGET_MINOR_OFFENDER"];
            return;
        }
        [shipAI message:@"TARGET_CLEAN"];
    }
}

commsMessage:

- (void) commsMessage:

(NSString *)

valueString

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

                     :(NSString *)valueString
{
    [self commsMessage:valueString withUnpilotedOverride:NO];
}

commsMessageByUnpiloted:

- (void) commsMessageByUnpiloted:

(NSString *)

valueString

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

                                :(NSString *)valueString
{
    [self commsMessage:valueString withUnpilotedOverride:YES];
}

debugDumpPendingMessages

- (void) debugDumpPendingMessages

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    [shipAI debugDumpPendingMessages];
}

disengageAutopilot

- (void) disengageAutopilot

implementation

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    OOLogERR(@"ai.invalid.notPlayer", @"Error in %@:%@, AI method endAutoPilot is only applicable to the player.", [shipAI name], [shipAI state]);
}

dropMessages:

- (void) dropMessages:

(NSString *)

messageString

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

                     :(NSString *)messageString
{
    NSArray             *messages = nil;
    NSEnumerator        *messageEnum = nil;
    NSString            *message = nil;
    NSCharacterSet      *whiteSpace = [NSCharacterSet whitespaceCharacterSet];
    
    messages = [messageString componentsSeparatedByString:@","];
    for (messageEnum = [messages objectEnumerator]; (message = [messageEnum nextObject]); )
    {
        [shipAI dropMessage:[message stringByTrimmingCharactersInSet:whiteSpace]];
    }
}

ejectCargo

- (void) ejectCargo

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    OOCargoQuantity i, cargo_to_go = 0.1 * [self maxAvailableCargoSpace];
    while (cargo_to_go > 15)
    {
        cargo_to_go = ranrot_rand() % cargo_to_go;
    }
    [self dumpCargo];
    for (i = 1; i < cargo_to_go; i++)
    {
        [self performSelector:@selector(dumpCargo) withObject:nil afterDelay:0.75 * i]; // drop 3 canisters per 2 seconds
    }
}

escortCheckMother

- (void) escortCheckMother

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    ShipEntity   *mother = [self owner];
    
    if ([mother acceptAsEscort:self])
    {
        [self setOwner:mother];
        [self setGroup:[mother escortGroup]];
        [shipAI message:@"ESCORTING"];
    }
    else
    {
        [self setOwner:self];
        if ([self group] == [mother escortGroup])  [self setGroup:nil];
        [shipAI message:@"NOT_ESCORTING"];
    }
}

exitAIWithMessage:

- (void) exitAIWithMessage:

(NSString *)

message

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

                          :(NSString *)message
{
    if ([message length] == 0)  message = @"RESTARTED";
    [shipAI exitStateMachineWithMessage:message];
}

explodeSelf

- (void) explodeSelf

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    [self getDestroyedBy:nil damageType:kOODamageTypeEnergy];
}

fightOrFleeHostiles

- (void) fightOrFleeHostiles

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    [self addDefenseTarget:[self foundTarget]];
    
    if ([self hasEscorts])
    {
        Entity *leTarget = [self lastEscortTarget];
        if (leTarget != nil)
        {
            [self setFoundTarget:leTarget];
            [shipAI message:@"FLEEING"];
            return;
        }
        
        [self setPrimaryAggressor:[self foundTarget]];
        [self addTarget:[self foundTarget]];
        [self deployEscorts];
        [shipAI message:@"DEPLOYING_ESCORTS"];
        [shipAI message:@"FLEEING"];
        return;
    }
    
    // consider launching a missile
    if (missiles > 2)   // keep a reserve
    {
        if (randf() < 0.50)
        {
            [self setPrimaryAggressor:[self foundTarget]];
            [self addTarget:[self foundTarget]];
            [self fireMissile];
            [shipAI message:@"FLEEING"];
            return;
        }
    }
    
    // consider fighting
    if (energy > maxEnergy * 0.80)
    {
        [self setPrimaryAggressor:[self foundTarget]];
        //[self performAttack];
        [shipAI message:@"FIGHTING"];
        return;
    }
    
    [shipAI message:@"FLEEING"];
}

fightOrFleeMissile

- (void) fightOrFleeMissile

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    // find an incoming missile...
    //
    ShipEntity          *missile =  nil;
    unsigned            i;
    NSEnumerator        *escortEnum = nil;
    ShipEntity          *escort = nil;
    ShipEntity          *target = nil;
    
    [self checkScannerIgnoringUnpowered];
    for (i = 0; (i < n_scanned_ships)&&(missile == nil); i++)
    {
        ShipEntity *thing = scanned_ships[i];
        if (thing->scanClass == CLASS_MISSILE)
        {
            target = [thing primaryTarget];
            
            if (target == self)
            {
                missile = thing;
            }
            else
            {
                for (escortEnum = [self escortEnumerator]; (escort = [escortEnum nextObject]); )
                {
                    if (target == escort)
                    {
                        missile = thing;
                    }
                }
            }
        }
    }
    
    if (missile == nil)  return;
    
    [self addTarget:missile];
    [self addDefenseTarget:missile];
    
    // Notify own ship script that we are being attacked.   
    ShipEntity *hunter = [missile owner];
    [self doScriptEvent:OOJSID("shipBeingAttacked") withArgument:hunter];
    [hunter doScriptEvent:OOJSID("shipAttackedOther") withArgument:self];
    
    if ([self isPolice])
    {
        // Notify other police in group of attacker.
        // Note: prior to 1.73 this was done only if we had ECM.
        NSEnumerator    *policeEnum = nil;
        ShipEntity      *police = nil;
        
        for (policeEnum = [[self group] mutationSafeEnumerator]; (police = [policeEnum nextObject]); )
        {
            [police setFoundTarget:hunter];
            [police setPrimaryAggressor:hunter];
        }
    }
    
    // if I'm a copper and you're not, then mark the other as an offender!
    if ([self isPolice] && ![hunter isPolice])  [hunter markAsOffender:64 withReason:kOOLegalStatusReasonAttackedPolice];
 
    if ([self hasECM])
    {
        // use the ECM and battle on
        
        [self setPrimaryAggressor:hunter];  // lets get them now for that!
        [self setFoundTarget:hunter];
        
        [self fireECM];
        return;
    }
    
    // RUN AWAY !!
    desired_range = 10000;
    [self performFlee];
    [shipAI message:@"FLEEING"];
}

findNewDefenseTarget

- (void) findNewDefenseTarget

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    [self checkScanner];
    unsigned i;
    for (i = 0; i < n_scanned_ships ; i++)
    {
        ShipEntity *ship = scanned_ships[i];
        if (![ship isCloaked] && (([ship primaryTarget] == self && [ship hasHostileTarget]) || [ship isMine] || ([ship isThargoid] != [self isThargoid])))
        {
            if (![self isDefenseTarget:ship])
            {
                [self addDefenseTarget:ship];
                return;
            }
        }
    }
}

getWitchspaceEntryCoordinates

- (void) getWitchspaceEntryCoordinates

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    /*- calculates coordinates from the nearest station it can find, or just fly 10s forward -*/
    if (!UNIVERSE)
    {
        Vector  vr = vector_multiply_scalar(v_forward, maxFlightSpeed * 10.0);  // 10 second flying away
        coordinates = HPvector_add(position, vectorToHPVector(vr));
        return;
    }
    //
    // find the nearest station...
    //
    // we don't use "checkScanner" because we must rely on finding a present station.
    //
    StationEntity   *station =  nil;
    station = [UNIVERSE nearestShipMatchingPredicate:IsStationPredicate
                                           parameter:nil
                                    relativeToEntity:self];
    
    if (station && HPdistance2([station position], position) < SCANNER_MAX_RANGE2) // there is a station in range.
    {
        Vector  vr = vector_multiply_scalar([station rightVector], 10000);  // 10km from station
        coordinates = HPvector_add([station position], vectorToHPVector(vr));
    }
    else
    {
        Vector  vr = vector_multiply_scalar(v_forward, maxFlightSpeed * 10.0);  // 10 second flying away
        coordinates = HPvector_add(position, vectorToHPVector(vr));
    }
}

landOnPlanet

- (void) landOnPlanet

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    // Selects the nearest planet it can find.
    [self landOnPlanet:[self findNearestPlanet]];
}

markTargetForFines

- (void) markTargetForFines

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    ShipEntity *ship = [self primaryTarget];
    if ((ship == nil) || ([ship status] == STATUS_DEAD) || ([ship status] == STATUS_DOCKED))
    {
        [self noteLostTarget];
        return;
    }
    if ([ship markForFines])  [shipAI message:@"TARGET_MARKED"];
}

markTargetForOffence:

- (void) markTargetForOffence:

(NSString *)

valueString

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

                             :(NSString *)valueString
{
    if ((isStation)||(scanClass == CLASS_POLICE))
    {
        ShipEntity *ship = [self primaryTarget];
        if ((ship == nil) || ([ship status] == STATUS_DEAD) || ([ship status] == STATUS_DOCKED))
        {
            [self noteLostTarget];
            return;
        }
        NSString *finalValue = OOExpand(valueString);   // expand values
        [ship markAsOffender:[finalValue intValue] withReason:kOOLegalStatusReasonSeenByPolice];
    }
}

messageMother:

- (void) messageMother:

(NSString *)

msgString

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

                      :(NSString *)msgString
{
    ShipEntity *mother = [self owner];
    if (mother != nil && mother != self)
    {
        NSString *context = nil;
#ifndef NDEBUG
        context = [NSString stringWithFormat:@"%@ messageMother", [self shortDescription]];
#endif
        [mother reactToAIMessage:msgString context:context];
    }
}

messageSelf:

- (void) messageSelf: (NSString *) msgString

implementation

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

                    :(NSString *)msgString
{
    [self sendAIMessage:msgString];
}

patrolReportIn

- (void) patrolReportIn

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    // Set a report time in the patrolled station to delay a new launch.
    ShipEntity *the_station = [[self group] leader];
    if(!the_station || ![the_station isStation]) the_station = [UNIVERSE station];
    [(StationEntity*)the_station acceptPatrolReportFrom:self];
}

pauseAI:

- (void) pauseAI:

(NSString *)

intervalString

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

                :(NSString *)intervalString
{
    [shipAI setNextThinkTime:[UNIVERSE getTime] + [intervalString doubleValue]];
}

performFlyRacepoints

- (void) performFlyRacepoints

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    next_navpoint_index = 0;
    desired_range = collision_radius;
    behaviour = BEHAVIOUR_FLY_THRU_NAVPOINTS;
}

performHyperSpaceExit

- (void) performHyperSpaceExit

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    [self performHyperSpaceExitReplace:YES];
}

performHyperSpaceExitWithoutReplacing

- (void) performHyperSpaceExitWithoutReplacing

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    [self performHyperSpaceExitReplace:NO];
}

randomPauseAI:

- (void) randomPauseAI:

(NSString *)

intervalString

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

                      :(NSString *)intervalString
{
    NSArray*    tokens = ScanTokensFromString(intervalString);
    double start, end;
    
    if ([tokens count] != 2)
    {
        OOLog(@"ai.syntax.randomPauseAI", @"***** ERROR: cannot read min and max value for randomPauseAI:, needs 2 values: '%@'.", intervalString);
        return;
    }
    
    start = [tokens oo_doubleAtIndex:0];
    end   = [tokens oo_doubleAtIndex:1];
    
    [shipAI setNextThinkTime:[UNIVERSE getTime] + (start + (end - start)*randf())];
}

recallStoredTarget

- (void) recallStoredTarget

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    ShipEntity  *oldTarget = (ShipEntity*)[self rememberedShip];
    BOOL    found = NO;
    
    if (oldTarget && ![oldTarget isCloaked])
    {
        GLfloat range2 = HPdistance2([oldTarget position], position);
        if (range2 <= scannerRange * scannerRange && range2 <= SCANNER_MAX_RANGE2)
        {
            found = YES;
        }
    }
    
    if (found)
    {
        [self setFoundTarget:oldTarget];
        [shipAI message:@"TARGET_FOUND"];
    }
    else
    {
        if (oldTarget == nil) DESTROY(_rememberedShip); // ship no longer exists
        [shipAI message:@"NOTHING_FOUND"];
    }
    
}

requestNewTarget

- (void) requestNewTarget

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    ShipEntity *mother = [[self group] leader];
    if (mother == nil)
    {
        [shipAI message:@"MOTHER_LOST"];
        return;
    }
    
    /*-- Locates all the ships in range targeting the mother ship and chooses the nearest/biggest --*/
    DESTROY(_foundTarget);
    [self checkScanner];
    unsigned i;
    GLfloat found_d2 = scannerRange * scannerRange;
    GLfloat max_e = 0;
    for (i = 0; i < n_scanned_ships ; i++)
    {
        ShipEntity *thing = scanned_ships[i];
        GLfloat d2 = distance2_scanned_ships[i];
        GLfloat e1 = [thing energy];
        if ((d2 < found_d2) && ![thing isCloaked] && (([thing isThargoid] && ![mother isThargoid]) || (([thing primaryTarget] == mother) && [thing hasHostileTarget])))
        {
            if (e1 > max_e)
            {
                [self setFoundTarget:thing];
                max_e = e1;
            }
        }
    }
    
    [self checkFoundTarget];
}

rollD:

- (void) rollD:

(NSString *)

die_number

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

              :(NSString *)die_number
{
    int die_sides = [die_number intValue];
    if (die_sides > 0)
    {
        int die_roll = 1 + (ranrot_rand() % die_sides);
        NSString* result = [NSString stringWithFormat:@"ROLL_%d", die_roll];
        [shipAI reactToMessage:result context:@"rollD:"];
    }
    else
    {
        OOLog(@"ai.rollD.invalidValue", @"***** ERROR: invalid value supplied to rollD: '%@'.", die_number);
    }
}

safeScriptActionOnTarget:

- (void) safeScriptActionOnTarget: (NSString *) action

implementation

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

                                 :(NSString *)action
{
    PlayerEntity    *player = PLAYER;
    ShipEntity      *targEnt = [self primaryTarget];
    ShipEntity      *oldTarget = nil;
    
    if ([targEnt isShip])
    {
        oldTarget = [player scriptTarget];
        [player setScriptTarget:(ShipEntity*)targEnt];
        [player runUnsanitizedScriptActions:[NSArray arrayWithObject:action]
                          allowingAIMethods:YES
                            withContextName:[NSString stringWithFormat:@"<AI \"%@\" state %@ - safeScriptActionOnTarget:>", [[self getAI] name], [[self getAI] state]]
                                  forTarget:targEnt];
        [player setScriptTarget:oldTarget];
    }
}

scanForFormationLeader

- (void) scanForFormationLeader

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    //-- Locates the nearest suitable formation leader in range --//
    DESTROY(_foundTarget);
    [self checkScannerIgnoringUnpowered];
    unsigned i;
    GLfloat found_d2 = scannerRange * scannerRange;
    for (i = 0; i < n_scanned_ships; i++)
    {
        ShipEntity *ship = scanned_ships[i];
        if ((ship != self) && (!ship->isPlayer) && (ship->scanClass == scanClass) && [ship primaryTarget] != self && ![ship isCloaked]) // look for alike
        {
            GLfloat d2 = distance2_scanned_ships[i];
            if ((d2 < found_d2) && [ship canAcceptEscort:self])
            {
                found_d2 = d2;
                [self setFoundTarget:ship];
            }
        }
    }
    
    if ([self foundTarget] != nil)  [shipAI message:@"TARGET_FOUND"];
    else
    {
        [shipAI message:@"NOTHING_FOUND"];
        if ([self hasPrimaryRole:@"wingman"])
        {
            // become free-lance police :)
            [self setAITo:@"route1patrolAI.plist"]; // use this to avoid referencing a released AI
            [self setPrimaryRole:@"police"]; // other wingman can now select this ship as leader.
        }
    }
    
}

scanForLoot

- (void) scanForLoot

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    /*-- Locates the nearest debris in range --*/
    if (!isStation)
    {
        if (![self hasCargoScoop])
        {
            [shipAI message:@"NOTHING_FOUND"];      //can't collect loot if you have no scoop!
            return;
        }
        if ([cargo count] >= [self maxAvailableCargoSpace])
        {
            if (max_cargo)  [shipAI message:@"HOLD_FULL"];  //can't collect loot if holds are full!
            [shipAI message:@"NOTHING_FOUND"];      //can't collect loot if holds are full!
            return;
        }
    }
    else
    {
        if (magnitude2([self velocity]))
        {
            [shipAI message:@"NOTHING_FOUND"];      //can't collect loot if you're a moving station
            return;
        }
    }
    
    [self checkScanner];
    
    double found_d2 = scannerRange * scannerRange;
    DESTROY(_foundTarget);
    unsigned i;
    for (i = 0; i < n_scanned_ships; i++)
    {
        ShipEntity *other = (ShipEntity *)scanned_ships[i];
        if ([other scanClass] == CLASS_CARGO && [other cargoType] != CARGO_NOT_CARGO && [other status] != STATUS_BEING_SCOOPED)
        {
            if ((![self isPolice]) || ([[other commodityType] isEqualToString:@"slaves"])) // police only rescue lifepods and slaves
            {
                GLfloat d2 = distance2_scanned_ships[i];
                if (d2 < found_d2)
                {
                    found_d2 = d2;
                    [self setFoundTarget:other];
                }
            }
        }
    }
    [self checkFoundTarget];
}

scanForNearestMerchantman

- (void) scanForNearestMerchantman

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    float               d2, found_d2;
    unsigned            i;
    ShipEntity          *ship = nil;
    
    //-- Locates the nearest merchantman in range.
    [self checkScannerIgnoringUnpowered];
    
    found_d2 = scannerRange * scannerRange;
    DESTROY(_foundTarget);
    
    for (i = 0; i < n_scanned_ships ; i++)
    {
        ship = scanned_ships[i];
        if ([ship isPirateVictim] && ([ship status] != STATUS_DEAD) && ([ship status] != STATUS_DOCKED) && ![ship isCloaked])
        {
            d2 = distance2_scanned_ships[i];
            if (PIRATES_PREFER_PLAYER && (d2 < desired_range * desired_range) && ship->isPlayer && [self isPirate])
            {
                d2 = 0.0;
            }
            else d2 = distance2_scanned_ships[i];
            if (d2 < found_d2)
            {
                found_d2 = d2;
                [self setFoundTarget:ship];
            }
        }
    }
    [self checkFoundTarget];
}

scanForNearestShipHavingAnyRole:

- (void) scanForNearestShipHavingAnyRole:

(NSString *)

scanRoles

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

                                        :(NSString *)scanRoles
{
    NSSet *set = [NSSet setWithArray:ScanTokensFromString(scanRoles)];
    [self scanForNearestShipWithPredicate:HasRoleInSetPredicate parameter:set];
}

scanForNearestShipHavingRole:

- (void) scanForNearestShipHavingRole:

(NSString *)

scanRole

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

                                     :(NSString *)scanRole
{
    [self scanForNearestShipWithPredicate:HasRolePredicate parameter:scanRole];
}

scanForNearestShipMatchingPredicate:

- (void) scanForNearestShipMatchingPredicate: (NSString *) predicateExpression

implementation

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

                                            :(NSString *)predicateExpression
{
    /*  Takes a boolean-valued JS expression where "ship" is the ship being
     evaluated and "this" is our ship's ship script. the expression is
     turned into a JS function of the form:
     
     function _oo_AIScanPredicate(ship)
     {
     return $expression;
     }
     
     Examples of expressions:
     ship.isWeapon
     this.someComplicatedPredicate(ship)
     function (ship) { ...do something complicated... } ()
     */
    
    static NSMutableDictionary  *scriptCache = nil;
    NSString                    *aiName = nil;
    NSString                    *key = nil;
    OOJSFunction                *function = nil;
    JSContext                   *context = NULL;
    
    context = OOJSAcquireContext();
    
    if (predicateExpression == nil)  predicateExpression = @"false";
    
    aiName = [[self getAI] name];
#ifndef NDEBUG
    /*  In debug/test release builds, scripts are cached per AI in order to be
     able to report errors correctly. For end-user releases, we only cache
     one copy of each predicate, potentially leading to error messages for
     the wrong AI.
     */
    key = [NSString stringWithFormat:@"%@\n%@", aiName, predicateExpression];
#else
    key = predicateExpression;
#endif
    
    // Look for cached function
    function = [scriptCache objectForKey:key];
    if (function == nil)
    {
        NSString                    *predicateCode = nil;
        const char                  *argNames[] = { "ship" };
        
        // Stuff expression in a function.
        predicateCode = [NSString stringWithFormat:@"return %@;", predicateExpression];
        function = [[OOJSFunction alloc] initWithName:@"_oo_AIScanPredicate"
                                                scope:NULL
                                                 code:predicateCode
                                        argumentCount:1
                                        argumentNames:argNames
                                             fileName:aiName
                                           lineNumber:0
                                              context:context];
        [function autorelease];
        
        // Cache function.
        if (function != nil)
        {
            if (scriptCache == nil)  scriptCache = [[NSMutableDictionary alloc] init];
            [scriptCache setObject:function forKey:key];
        }
    }
    
    if (function != nil)
    {
        JSFunctionPredicateParameter param =
        {
            .context = context,
            .function = [function functionValue],
            .jsThis = OOJSObjectFromNativeObject(context, self)
        };
        [self scanForNearestShipWithPredicate:JSFunctionPredicate parameter:&param];
    }
    else
    {
        // Report error (once per occurrence)
        static NSMutableSet         *errorCache = nil;
        
        if (![errorCache containsObject:key])
        {
            OOLog(@"ai.scanForNearestShipMatchingPredicate.compile.failed", @"Could not compile JavaScript predicate \"%@\" for AI %@.", predicateExpression, [[self getAI] name]);
            if (errorCache == nil)  errorCache = [[NSMutableSet alloc] init];
            [errorCache addObject:key];
        }
        
        // Select nothing
        DESTROY(_foundTarget);
        [[self getAI] message:@"NOTHING_FOUND"];
    }
    
    JS_ReportPendingException(context);
    OOJSRelinquishContext(context);
}

scanForNearestShipNotHavingAnyRole:

- (void) scanForNearestShipNotHavingAnyRole:

(NSString *)

scanRoles

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

                                           :(NSString *)scanRoles
{
    NSSet *set = [NSSet setWithArray:ScanTokensFromString(scanRoles)];
    [self scanForNearestShipWithNegatedPredicate:HasRoleInSetPredicate parameter:set];
}

scanForNearestShipNotHavingRole:

- (void) scanForNearestShipNotHavingRole:

(NSString *)

scanRole

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

                                        :(NSString *)scanRole
{
    [self scanForNearestShipWithNegatedPredicate:HasRolePredicate parameter:scanRole];
}

scanForNearestShipWithAnyPrimaryRole:

- (void) scanForNearestShipWithAnyPrimaryRole:

(NSString *)

scanRoles

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

                                             :(NSString *)scanRoles
{
    NSSet *set = [NSSet setWithArray:ScanTokensFromString(scanRoles)];
    [self scanForNearestShipWithPredicate:HasPrimaryRoleInSetPredicate parameter:set];
}

scanForNearestShipWithoutAnyPrimaryRole:

- (void) scanForNearestShipWithoutAnyPrimaryRole:

(NSString *)

scanRoles

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

                                                :(NSString *)scanRoles
{
    NSSet *set = [NSSet setWithArray:ScanTokensFromString(scanRoles)];
    [self scanForNearestShipWithNegatedPredicate:HasPrimaryRoleInSetPredicate parameter:set];
}

scanForNearestShipWithoutPrimaryRole:

- (void) scanForNearestShipWithoutPrimaryRole:

(NSString *)

scanRole

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

                                             :(NSString *)scanRole
{
    [self scanForNearestShipWithNegatedPredicate:HasPrimaryRolePredicate parameter:scanRole];
}

scanForNearestShipWithoutScanClass:

- (void) scanForNearestShipWithoutScanClass:

(NSString *)

scanScanClass

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

                                           :(NSString *)scanScanClass
{
    NSNumber *parameter = [NSNumber numberWithInt:OOScanClassFromString(scanScanClass)];
    [self scanForNearestShipWithNegatedPredicate:HasScanClassPredicate parameter:parameter];
}

scanForNearestShipWithPrimaryRole:

- (void) scanForNearestShipWithPrimaryRole:

(NSString *)

scanRole

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

                                          :(NSString *)scanRole
{
    [self scanForNearestShipWithPredicate:HasPrimaryRolePredicate parameter:scanRole];
}

scanForNearestShipWithScanClass:

- (void) scanForNearestShipWithScanClass:

(NSString *)

scanScanClass

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

                                        :(NSString *)scanScanClass
{
    NSNumber *parameter = [NSNumber numberWithInt:OOScanClassFromString(scanScanClass)];
    [self scanForNearestShipWithPredicate:HasScanClassPredicate parameter:parameter];
}

scanForNonThargoid

- (void) scanForNonThargoid

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    /*-- Locates all the non thargoid ships in range and chooses the nearest --*/
    DESTROY(_foundTarget);
    
    [self checkScanner];
    unsigned i;
    GLfloat found_d2 = scannerRange * scannerRange;
    for (i = 0; i < n_scanned_ships ; i++)
    {
        ShipEntity *thing = scanned_ships[i];
        GLfloat d2 = distance2_scanned_ships[i];
        if (([thing scanClass] != CLASS_CARGO) && ([thing status] != STATUS_DOCKED) && ![thing isThargoid] && ![thing isCloaked] && (d2 < found_d2))
        {
            [self setFoundTarget:thing];
            if ([thing isPlayer]) d2 = 0.0;   // prefer the player
            found_d2 = d2;
        }
    }
 
    [self checkFoundTarget];
}

scanForOffenders

- (void) scanForOffenders

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    /*-- Locates all the ships in range and compares their legal status or bounty against ranrot_rand() & 255 - chooses the worst offender --*/
    NSDictionary        *systeminfo = [UNIVERSE currentSystemData];
    float gov_factor =  0.4 * [(NSNumber *)[systeminfo objectForKey:KEY_GOVERNMENT] intValue]; // 0 .. 7 (0 anarchic .. 7 most stable) --> [0.0, 0.4, 0.8, 1.2, 1.6, 2.0, 2.4, 2.8]
    //
    if ([UNIVERSE sun] == nil)
        gov_factor = 1.0;
    //
    DESTROY(_foundTarget);
    
    // find the worst offender on the scanner
    //
    [self checkScanner];
    unsigned i;
    float   worst_legal_factor = 0;
    GLfloat found_d2 = scannerRange * scannerRange;
    OOShipGroup *group = [self group];
    for (i = 0; i < n_scanned_ships ; i++)
    {
        ShipEntity *ship = scanned_ships[i];
        if ((ship->scanClass != CLASS_CARGO)&&([ship status] != STATUS_DEAD)&&([ship status] != STATUS_DOCKED)&& ![ship isCloaked])
        {
            GLfloat d2 = distance2_scanned_ships[i];
            float   legal_factor = [ship legalStatus] * gov_factor;
            int random_factor = ranrot_rand() & 255;   // 25% chance of spotting a fugitive in 15s
            if ((d2 < found_d2)&&(random_factor < legal_factor)&&(legal_factor > worst_legal_factor))
            {
                if (group == nil || group != [ship group])  // fellows with bounty can't be offenders
                {
                    [self setFoundTarget:ship];
                    worst_legal_factor = legal_factor;
                }
            }
        }
    }
    
    [self checkFoundTarget];
}

scanForRandomLoot

- (void) scanForRandomLoot

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    /*-- Locates the all debris in range and chooses a piece at random from the first sixteen found --*/
    if (![self isStation] && ![self hasCargoScoop])
    {
        [shipAI message:@"NOTHING_FOUND"];      //can't collect loot if you have no scoop!
        return;
    }
    //
    [self checkScanner];
    //
    ShipEntity* thing_uids_found[16];
    unsigned things_found = 0;
    DESTROY(_foundTarget);
    unsigned i;
    for (i = 0; (i < n_scanned_ships)&&(things_found < 16) ; i++)
    {
        ShipEntity *other = scanned_ships[i];
        if ([other scanClass] == CLASS_CARGO && [other cargoType] != CARGO_NOT_CARGO && [other status] != STATUS_BEING_SCOOPED)
        {
            thing_uids_found[things_found++] = other;
        }
    }
    
    if (things_found != 0)
    {
        [self setFoundTarget:thing_uids_found[ranrot_rand() % things_found]];
        [shipAI message:@"TARGET_FOUND"];
    }
    else
        [shipAI message:@"NOTHING_FOUND"];
}

scanForRandomMerchantman

- (void) scanForRandomMerchantman

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    unsigned            n_found, i;
    
    //-- Locates one of the merchantman in range.
    [self checkScannerIgnoringUnpowered];
    ShipEntity*     ids_found[n_scanned_ships];
    
    n_found = 0;
    DESTROY(_foundTarget);
    for (i = 0; i < n_scanned_ships ; i++)
    {
        ShipEntity *ship = scanned_ships[i];
        if (([ship status] != STATUS_DEAD) && ([ship status] != STATUS_DOCKED) && [ship isPirateVictim] && ![ship isCloaked])
            ids_found[n_found++] = ship;
    }
    if (n_found == 0)
    {
        [shipAI message:@"NOTHING_FOUND"];
    }
    else
    {
        i = ranrot_rand() % n_found;    // pick a number from 0 -> (n_found - 1)
        [self setFoundTarget:ids_found[i]];
        [shipAI message:@"TARGET_FOUND"];
    }
}

scanForRocks

- (void) scanForRocks

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    /*-- Locates the all boulders and asteroids in range and selects nearest --*/
    
    // find boulders then asteroids within range
    //
    DESTROY(_foundTarget);
    [self checkScanner];
    unsigned i;
    GLfloat found_d2 = scannerRange * scannerRange;
    for (i = 0; i < n_scanned_ships; i++)
    {
        ShipEntity *thing = scanned_ships[i];
        if ([thing isBoulder])
        {
            GLfloat d2 = distance2_scanned_ships[i];
            if (d2 < found_d2)
            {
                [self setFoundTarget:thing];
                found_d2 = d2;
            }
        }
    }
    if ([self foundTarget] == nil)
    {
        for (i = 0; i < n_scanned_ships; i++)
        {
            ShipEntity *thing = scanned_ships[i];
            if ([thing hasRole:@"asteroid"])
            {
                GLfloat d2 = distance2_scanned_ships[i];
                if (d2 < found_d2)
                {
                    [self setFoundTarget:thing];
                    found_d2 = d2;
                }
            }
        }
    }
    
    [self checkFoundTarget];
}

scanForThargoid

- (void) scanForThargoid

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    return [self scanForNearestShipWithPrimaryRole:@"thargoid"];
}

scriptActionOnTarget:

- (void) scriptActionOnTarget:

(NSString *)

action

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

                             :(NSString *)action
{
    PlayerEntity    *player = PLAYER;
    ShipEntity      *targEnt = [self primaryTarget];
    ShipEntity      *oldTarget = nil;
    
#ifndef NDEBUG
    static BOOL     deprecationWarning = NO;
    
    if (!deprecationWarning)
    {
        deprecationWarning = YES;
        OOLog(@"script.deprecated.scriptActionOnTarget", @"----- WARNING in AI %@: the AI method scriptActionOnTarget: is deprecated and should not be used. It is slow and has unpredictable side effects. The recommended alternative is to use sendScriptMessage: to call a function in a ship's JavaScript ship script instead. scriptActionOnTarget: should not be used at all from scripts. An alternative is safeScriptActionOnTarget:, which is similar to scriptActionOnTarget: but has less side effects.", [AI currentlyRunningAIDescription]);
    }
    else
    {
        OOLog(@"script.deprecated.scriptActionOnTarget.repeat", @"----- WARNING in AI %@: the AI method scriptActionOnTarget: is deprecated and should not be used.", [AI currentlyRunningAIDescription]);
    }
#endif
    
    if ([targEnt isShip])
    {
        oldTarget = [player scriptTarget];
        [player setScriptTarget:(ShipEntity*)targEnt];
        [player runUnsanitizedScriptActions:[NSArray arrayWithObject:action]
                          allowingAIMethods:YES
                            withContextName:[NSString stringWithFormat:@"<AI \"%@\" state %@ - scriptActionOnTarget:>", [[self getAI] name], [[self getAI] state]]
                                  forTarget:targEnt];
        [player checkScript];   // react immediately to any changes this makes
        [player setScriptTarget:oldTarget];
    }
}

sendScriptMessage:

- (void) sendScriptMessage:

(NSString *)

message

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

                          :(NSString *)message
{
    NSArray *components = ScanTokensFromString(message);
    
    if ([components count] == 1)
    {
        [self doScriptEvent:OOJSIDFromString(message)];
    }
    else
    {
        NSString *function = [components objectAtIndex:0];
        components = [components subarrayWithRange:NSMakeRange(1, [components count] - 1)];
        [self doScriptEvent:OOJSIDFromString(function) withArgument:components];
    }
}

sendTargetCommsMessage:

- (void) sendTargetCommsMessage:

(NSString *)

message

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

                               :(NSString*) message
{
    ShipEntity *ship = [self primaryTarget];
    if ((ship == nil) || ([ship status] == STATUS_DEAD) || ([ship status] == STATUS_DOCKED))
    {
        [self noteLostTarget];
        return;
    }
    [self sendExpandedMessage:message toShip:[self primaryTarget]];
}

setCoordinates:

- (void) setCoordinates:

(NSString *)

system_x_y_z

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

                       :(NSString *)system_x_y_z
{
    NSArray*    tokens = ScanTokensFromString(system_x_y_z);
    NSString*   systemString = nil;
    NSString*   xString = nil;
    NSString*   yString = nil;
    NSString*   zString = nil;
    
    if ([tokens count] != 4)
    {
        OOLog(@"ai.syntax.setCoordinates", @"***** ERROR: cannot setCoordinates: '%@'.",system_x_y_z);
        return;
    }
    
    systemString = (NSString *)[tokens objectAtIndex:0];
    xString = (NSString *)[tokens objectAtIndex:1];
    if ([xString hasPrefix:@"rand:"])
        xString = [NSString stringWithFormat:@"%.3f", bellf([(NSString*)[[xString componentsSeparatedByString:@":"] objectAtIndex:1] intValue])];
    yString = (NSString *)[tokens objectAtIndex:2];
    if ([yString hasPrefix:@"rand:"])
        yString = [NSString stringWithFormat:@"%.3f", bellf([(NSString*)[[yString componentsSeparatedByString:@":"] objectAtIndex:1] intValue])];
    zString = (NSString *)[tokens objectAtIndex:3];
    if ([zString hasPrefix:@"rand:"])
        zString = [NSString stringWithFormat:@"%.3f", bellf([(NSString*)[[zString componentsSeparatedByString:@":"] objectAtIndex:1] intValue])];
    
    HPVector posn = make_HPvector([xString floatValue], [yString floatValue], [zString floatValue]);
    GLfloat scalar = 1.0;
    
    coordinates = [UNIVERSE coordinatesForPosition:posn withCoordinateSystem:systemString returningScalar:&scalar];
    
    [shipAI message:@"APPROACH_COORDINATES"];
}

setCoordinatesFromPosition

- (void) setCoordinatesFromPosition

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    coordinates = position;
}

setCourseToPlanet

- (void) setCourseToPlanet

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    /*- selects the nearest planet it can find -*/
    OOPlanetEntity  *the_planet =  [self findNearestPlanetExcludingMoons];
    if (the_planet)
    {
        double variation = (aegis_status == AEGIS_NONE ? 0.5 : 0.2); // more random deviation when far from planet.
        HPVector p_pos = the_planet->position;
        double p_cr = the_planet->collision_radius;     // the surface
        HPVector p1 = HPvector_between(p_pos, position);
        p1 = HPvector_normal(p1);           // vector towards ship
        p1.x += variation * (randf() - variation);
        p1.y += variation * (randf() - variation);
        p1.z += variation * (randf() - variation);
        p1 = HPvector_normal(p1); 
        _destination = HPvector_add(p_pos, HPvector_multiply_scalar(p1, p_cr)); // on surface
        desired_range = collision_radius + 100.0;   // +100m from the destination
    }
    else
    {
        [shipAI message:@"NO_PLANET_FOUND"];
    }
}

setCourseToWitchpoint

- (void) setCourseToWitchpoint

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    if (UNIVERSE)
    {
        _destination = [UNIVERSE getWitchspaceExitPosition];
        desired_range = 10000.0;   // 10km away
    }
}

setDesiredRangeForWaypoint

- (void) setDesiredRangeForWaypoint

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    desired_range = fmax(maxFlightSpeed / max_flight_pitch / 6, 50.0); // some ships need a longer range to reach a waypoint.
}

setDesiredRangeTo:

- (void) setDesiredRangeTo:

(NSString *)

rangeString

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

                          :(NSString *)rangeString
{
    desired_range = [rangeString doubleValue];
}

setDestinationFromCoordinates

- (void) setDestinationFromCoordinates

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    _destination = coordinates;
}

setDestinationToCurrentLocation

- (void) setDestinationToCurrentLocation

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    // randomly add a .5m variance
    _destination = HPvector_add(position, OOHPVectorRandomSpatial(0.5));
}

setDestinationToDockingAbort

- (void) setDestinationToDockingAbort

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    Entity *the_target = [self targetStation];
    if (!the_target) {
        /* Probably the player trying to dock with docking computer
         * from out of scanner range */
        the_target = [UNIVERSE station];
    }
    double bo_distance = 8000; //   8km back off
    HPVector v0 = position;
    HPVector d0 = (the_target) ? the_target->position : kZeroHPVector;
    v0.x += (randf() - 0.5)*collision_radius;   v0.y += (randf() - 0.5)*collision_radius;   v0.z += (randf() - 0.5)*collision_radius;
    v0.x -= d0.x;   v0.y -= d0.y;   v0.z -= d0.z;
    v0 = HPvector_normal_or_fallback(v0, make_HPvector(0, 0, -1));
    
    v0.x *= bo_distance;    v0.y *= bo_distance;    v0.z *= bo_distance;
    v0.x += d0.x;   v0.y += d0.y;   v0.z += d0.z;
    coordinates = v0;
    _destination = v0;
}

setDestinationToJinkPosition

- (void) setDestinationToJinkPosition

implementation

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    Vector front = vector_multiply_scalar([self forwardVector], flightSpeed / max_flight_pitch * 2);
    _destination = HPvector_add(position, vectorToHPVector(vector_add(front, OOVectorRandomSpatial(100))));
    pitching_over = YES; // don't complete roll first, but immediately start with pitching. 
}

setDestinationToStationBeacon

- (void) setDestinationToStationBeacon

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    if ([UNIVERSE station])
    {
        _destination = [[UNIVERSE station] beaconPosition];
    }
}

setDestinationToTarget

- (void) setDestinationToTarget

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    Entity *the_target = [self primaryTarget];
    if (the_target)
        _destination = the_target->position;
}

setDestinationToWitchpoint

- (void) setDestinationToWitchpoint

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    _destination = [UNIVERSE getWitchspaceExitPosition];
}

setDestinationWithinTarget

- (void) setDestinationWithinTarget

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    Entity *the_target = [self primaryTarget];
    if (the_target)
    {
        HPVector pos = the_target->position;
        Quaternion q;   quaternion_set_random(&q);
        Vector v = vector_forward_from_quaternion(q);
        GLfloat d = (randf() - randf()) * the_target->collision_radius;
        _destination = make_HPvector(pos.x + d * v.x, pos.y + d * v.y, pos.z + d * v.z);
    }
}

setPlanetPatrolCoordinates

- (void) setPlanetPatrolCoordinates

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    // check we've arrived near the last given coordinates
    HPVector r_pos = HPvector_subtract(position, coordinates);
    if (HPmagnitude2(r_pos) < 1000000 || patrol_counter == 0)
    {
        Entity *the_sun = [UNIVERSE sun];
        ShipEntity *the_station = [[self group] leader];
        if(!the_station || ![the_station isStation]) the_station = [UNIVERSE station];
        if ((!the_sun)||(!the_station))
            return;
        HPVector sun_pos = the_sun->position;
        HPVector stn_pos = the_station->position;
        HPVector sun_dir = HPvector_subtract(sun_pos,stn_pos);
        Vector vSun = make_vector(0, 0, 1);
        if (sun_dir.x||sun_dir.y||sun_dir.z)
            vSun = HPVectorToVector(HPvector_normal(sun_dir));
        Vector v0 = [the_station forwardVector];
        Vector v1 = cross_product(v0, vSun);
        Vector v2 = cross_product(v0, v1);
        switch (patrol_counter)
        {
            case 0:     // first go to 5km ahead of the station
                coordinates = make_HPvector(stn_pos.x + 5000 * v0.x, stn_pos.y + 5000 * v0.y, stn_pos.z + 5000 * v0.z);
                desired_range = 250.0;
                break;
            case 1:     // go to 25km N of the station
                coordinates = make_HPvector(stn_pos.x + 25000 * v1.x, stn_pos.y + 25000 * v1.y, stn_pos.z + 25000 * v1.z);
                desired_range = 250.0;
                break;
            case 2:     // go to 25km E of the station
                coordinates = make_HPvector(stn_pos.x + 25000 * v2.x, stn_pos.y + 25000 * v2.y, stn_pos.z + 25000 * v2.z);
                desired_range = 250.0;
                break;
            case 3:     // go to 25km S of the station
                coordinates = make_HPvector(stn_pos.x - 25000 * v1.x, stn_pos.y - 25000 * v1.y, stn_pos.z - 25000 * v1.z);
                desired_range = 250.0;
                break;
            case 4:     // go to 25km W of the station
                coordinates = make_HPvector(stn_pos.x - 25000 * v2.x, stn_pos.y - 25000 * v2.y, stn_pos.z - 25000 * v2.z);
                desired_range = 250.0;
                break;
            default:    // We should never come here
                coordinates = make_HPvector(stn_pos.x + 5000 * v0.x, stn_pos.y + 5000 * v0.y, stn_pos.z + 5000 * v0.z);
                desired_range = 250.0;
                break;
        }
        patrol_counter++;
        if (patrol_counter > 4)
        {
            if (randf() < .25)
            {
                // consider docking
                [self setTargetStation:the_station];
                [self setAITo:@"dockingAI.plist"];
                return;
            }
            else
            {
                // go around again
                patrol_counter = 1;
            }
        }
    }
    [shipAI message:@"APPROACH_COORDINATES"];
}

setRacepointsFromTarget

- (void) setRacepointsFromTarget

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    // two point - one at z - cr one at z + cr
    ShipEntity *ship = [self primaryTarget];
    if (ship == nil)
    {
        [shipAI message:@"NOTHING_FOUND"];
        return;
    }
    Vector k = ship->v_forward;
    GLfloat c = ship->collision_radius;
    HPVector o = ship->position;
    navpoints[0] = make_HPvector(o.x - c * k.x, o.y - c * k.y, o.z - c * k.z);
    navpoints[1] = make_HPvector(o.x + c * k.x, o.y + c * k.y, o.z + c * k.z);
    navpoints[2] = make_HPvector(o.x + 2.0 * c * k.x, o.y + 2.0 * c * k.y, o.z + 2.0 * c * k.z);
    number_of_navpoints = 2;
    next_navpoint_index = 0;
    _destination = navpoints[0];
    [shipAI message:@"RACEPOINTS_SET"];
}

setSpeedFactorTo:

- (void) setSpeedFactorTo:

(NSString *)

speedString

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

                         :(NSString *)speedString
{
    desired_speed = maxFlightSpeed * [speedString doubleValue];
}

setSpeedTo:

- (void) setSpeedTo:

(NSString *)

speedString

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

                   :(NSString *)speedString
{
    desired_speed = [speedString doubleValue];
}

setSpeedToCruiseSpeed

- (void) setSpeedToCruiseSpeed

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    desired_speed = cruiseSpeed;
}

setStateTo:

- (void) setStateTo:

(NSString *)

state

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

                   :(NSString *)state
{
    [[self getAI] setState:state];
}

setSunSkimEndCoordinates

- (void) setSunSkimEndCoordinates

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    if ([UNIVERSE sun] == nil)
    {
        [shipAI message:@"NO_SUN_FOUND"];
        return;
    }
    
    coordinates = [UNIVERSE getSunSkimEndPositionForShip:self];
    [shipAI message:@"APPROACH_COORDINATES"];
}

setSunSkimExitCoordinates

- (void) setSunSkimExitCoordinates

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    Entity *the_sun = [UNIVERSE sun];
    if (the_sun == nil)  return;
    HPVector v1 = [UNIVERSE getSunSkimEndPositionForShip:self];
    HPVector vs = the_sun->position;
    HPVector vout = HPvector_subtract(v1,vs);
    if (vout.x||vout.y||vout.z)
        vout = HPvector_normal(vout);
    else
        vout.z = 1.0;
    v1.x += 10000 * vout.x; v1.y += 10000 * vout.y; v1.z += 10000 * vout.z;
    coordinates = v1;
    [shipAI message:@"APPROACH_COORDINATES"];
}

setSunSkimStartCoordinates

- (void) setSunSkimStartCoordinates

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    if ([UNIVERSE sun] == nil)
    {
        [shipAI message:@"NO_SUN_FOUND"];
        return;
    }
    
    HPVector v0 = [UNIVERSE getSunSkimStartPositionForShip:self];
    
    if (!HPvector_equal(v0, kZeroHPVector))
    {
        coordinates = v0;
        [shipAI message:@"APPROACH_COORDINATES"];
    }
    else
    {
        [shipAI message:@"WAIT_FOR_SUN"];
    }
}

setTakeOffFromPlanet

- (void) setTakeOffFromPlanet

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    /*- selects the nearest planet it can find -*/
    OOPlanetEntity  *the_planet =  [self findNearestPlanet];
    if (the_planet)
    {
        _destination = HPvector_add([the_planet position], HPvector_multiply_scalar(
                                                                               HPvector_normal(HPvector_subtract([the_planet position],position)),-10000.0-the_planet->collision_radius));// 10km straight up
        desired_range = 50.0;
    }
    else
    {
        OOLog(@"ai.setTakeOffFromPlanet.noPlanet", @"%@", @"***** Error. Planet not found during take off!");
    }
}

setTargetToFoundTarget

- (void) setTargetToFoundTarget

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    if ([self foundTarget] != nil)
    {
        [self addTarget:[self foundTarget]];
    }
    else
    {
        [shipAI message:@"TARGET_LOST"]; // to prevent the ship going for a wrong, previous target. Should not be a reactToMessage.
    }
}

setTargetToLastStation

- (void) setTargetToLastStation

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    Entity  *station = [self targetStation];
    
    if (station != nil && [station isStation])
    {
        [self addTarget:station];
    }
    else
    {
        [shipAI message:@"NO_STATION_FOUND"];
        [self setTargetStation:nil];
    }
    
}

setTargetToPrimaryAggressor

- (void) setTargetToPrimaryAggressor

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    Entity *primeAggressor = [self primaryAggressor];
    if (!primeAggressor)
        return;
    if ([self primaryTarget] == primeAggressor)
        return;
    
    // a more considered approach here:
    // if we're already busy attacking a target we don't necessarily want to break off
    //
    if ([self hasHostileTarget] && randf() < 0.75)  // if I'm attacking, ignore 75% of new aggressor's attacks
    {
                // but add them as a secondary target anyway
        [self addDefenseTarget:(ShipEntity*)primeAggressor];
        return;
    }
    // react only if the primary aggressor is not a friendly ship, else ignore it
    if ([primeAggressor isShip] && ![(ShipEntity *)primeAggressor isFriendlyTo:self])
    {
        // inform our old target of our new target
        //
        Entity *primeTarget = [self primaryTarget];
        if ((primeTarget)&&(primeTarget->isShip))
        {
            ShipEntity *currentShip = [self primaryTarget];
            [[currentShip getAI] message:[NSString stringWithFormat:@"%@ %d %d", AIMS_AGGRESSOR_SWITCHED_TARGET, universalID, [[self primaryAggressor] universalID]]];
            [currentShip doScriptEvent:OOJSID("shipAttackerDistracted") withArgument:[self primaryAggressor]];
        }
        
        // okay, so let's now target the aggressor
        [self addTarget:[self primaryAggressor]];
    }
}

setTargetToRandomStation

- (void) setTargetToRandomStation

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    /*- selects the nearest station it can find -*/
    int             ent_count = UNIVERSE->n_entities;
    Entity          **uni_entities = UNIVERSE->sortedEntities;  // grab the public sorted list
    Entity          *my_entities[ent_count];
    StationEntity   *station = nil, *my_station = nil;
    double          maxRange2 = desired_range * desired_range;
    int             i;
    int             station_count = 0;
    
    for (i = 0; i < ent_count; i++)
    {
        // find stations within range but exclude carriers.
        if (uni_entities[i]->isStation)
        {
            my_station = (StationEntity*)uni_entities[i];
            if ([my_station maxFlightSpeed] == 0 && [my_station hasNPCTraffic] && HPdistance2(position, [my_station position]) < maxRange2)
            {
                my_entities[station_count++] = [uni_entities[i] retain];        //  retained
            }
        }
    }
    
    if (station_count != 0)
    {
        // select a random station
        station = (StationEntity *)my_entities[ranrot_rand() % station_count];
        // if more than one candidate do not select main station
        if (station == [UNIVERSE station] && station_count > 1)
        {
            while (station == [UNIVERSE station])
            {
                station = (StationEntity *)my_entities[ranrot_rand() % station_count];
            }
        }
    }
    
    for (i = 0; i < station_count; i++)
        [my_entities[i] release];       //  released
    //
    if (station)
    {
        [self addTarget:station];
        [self setTargetStation:station];
        [shipAI message:@"STATION_FOUND"];
    }
    else
    {
        [shipAI message:@"NO_STATION_IN_RANGE"];
    }
}

setThrustFactorTo:

- (void) setThrustFactorTo:

(NSString *)

thrustFactorString

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

                          :(NSString *)thrustFactorString
{
    thrust = OOClamp_0_1_f([thrustFactorString doubleValue]) * max_thrust;
}

storeTarget

- (void) storeTarget

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    Entity  *target = [self primaryTarget];
    
    if (target)
    {
        [self setRememberedShip:target];
    }
    else
    {
        DESTROY(_rememberedShip);
    }
    
}

suggestEscort

- (void) suggestEscort

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    ShipEntity   *mother = [self primaryTarget];
    [self suggestEscortTo:mother];
}

targetFirstBeaconWithCode:

- (void) targetFirstBeaconWithCode:

(NSString *)

code

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

                                  :(NSString*) code
{
    NSArray         *all_beacons = [UNIVERSE listBeaconsWithCode: code];
    if ([all_beacons count])
    {
        [self addTarget:(ShipEntity*)[all_beacons objectAtIndex:0]];
        [shipAI message:@"TARGET_FOUND"];
    }
    else
        [shipAI message:@"NOTHING_FOUND"];
}

targetNextBeaconWithCode:

- (void) targetNextBeaconWithCode:

(NSString *)

code

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

                                 :(NSString*) code
{
    NSArray         *all_beacons = [UNIVERSE listBeaconsWithCode: code];
    ShipEntity      *current_beacon = [self primaryTarget];
    
    if ((!current_beacon)||(![current_beacon isBeacon]))
    {
        [shipAI message:@"NO_CURRENT_BEACON"];
        [shipAI message:@"NOTHING_FOUND"];
        return;
    }
    
    // find the current beacon in the list..
    NSUInteger i = [all_beacons indexOfObject:current_beacon];
    
    if (i == NSNotFound)
    {
        [shipAI message:@"NOTHING_FOUND"];
        return;
    }
    
    i++;    // next index
    
    if (i < [all_beacons count])
    {
        // locate current target in list
        [self addTarget:(ShipEntity*)[all_beacons objectAtIndex:i]];
        [shipAI message:@"TARGET_FOUND"];
    }
    else
    {
        [shipAI message:@"LAST_BEACON"];
        [shipAI message:@"NOTHING_FOUND"];
    }
}

thargonCheckMother

- (void) thargonCheckMother

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    ShipEntity   *mother = [self owner];
    if (mother == nil && [self group])  mother = [[self group] leader];
    
    double  maxRange2 = scannerRange * scannerRange;
    
    if (mother && mother != self && HPdistance2(mother->position, position) < maxRange2)
    {
        [shipAI message:@"TARGET_FOUND"]; // no need for scanning, we still have our mother.
    }
    else
    {
        // we lost the old mother, search for a new one
        [self scanForNearestShipHavingRole:@"thargoid-mothership"]; // the scan will send further AI messages.
        if ([self foundTarget] != nil)
        {
            mother = (ShipEntity*)[self foundTarget];
            [self setOwner:mother];
            if ([mother group] != [mother escortGroup]) // avoid adding thargon to an escort group.
            {
                [self setGroup:[mother group]];
            }
        };
    }
}

wormholeGroup

- (void) wormholeGroup

Extends class ShipEntity.

Definition at line 1 of file ShipEntityAI.m.

{
    NSEnumerator        *shipEnum = nil;
    ShipEntity          *ship = nil;
    WormholeEntity      *whole = nil;
    
    whole = [self primaryTarget];
    if (![whole isWormhole])  return;
    
    for (shipEnum = [[self group] mutationSafeEnumerator]; (ship = [shipEnum nextObject]); )
    {
        [ship addTarget:whole];
        [ship reactToAIMessage:@"ENTER WORMHOLE" context:@"wormholeGroup"];
        [ship doScriptEvent:OOJSID("wormholeSuggested") withArgument:whole];
    }
}

---

The documentation for this category was generated from the following file:

• src/Core/Entities/ShipEntityAI.m