Factorio.com|Forums|Wiki|Mod Portal|API Docs

# Factorio Prototype Docs Version 2.0.77

# UnitAISettings - Prototype Docs

## UnitAISettings :: struct

Used by UnitPrototype and SpiderUnitPrototype.

## Properties

- default
- sorted

destroy_when_commands_fail optional | :: boolean | If enabled, units that repeatedly fail to succeed at commands will be destroyed.
If enabled, units that repeatedly fail to succeed at commands will be destroyed.
allow_try_return_to_spawner optional | :: boolean | If enabled, units that have nothing else to do will attempt to return to a spawner.
If enabled, units that have nothing else to do will attempt to return to a spawner.
do_separation optional | :: boolean | If enabled, units will try to separate themselves from nearby friendly units.
If enabled, units will try to separate themselves from nearby friendly units.
path_resolution_modifier optional | :: int8 | Must be between -8 and 8.
Must be between -8 and 8.
strafe_settings optional | :: PrototypeStrafeSettings |
size_in_group optional | :: float | The amount of slots in a unit group this unit takes up. [...]
The amount of slots in a unit group this unit takes up. [...]
join_attacks optional | :: boolean | If enabled, the unit is permitted to join attack groups.
If enabled, the unit is permitted to join attack groups.

allow_try_return_to_spawner optional | :: boolean | If enabled, units that have nothing else to do will attempt to return to a spawner.
If enabled, units that have nothing else to do will attempt to return to a spawner.
destroy_when_commands_fail optional | :: boolean | If enabled, units that repeatedly fail to succeed at commands will be destroyed.
If enabled, units that repeatedly fail to succeed at commands will be destroyed.
do_separation optional | :: boolean | If enabled, units will try to separate themselves from nearby friendly units.
If enabled, units will try to separate themselves from nearby friendly units.
join_attacks optional | :: boolean | If enabled, the unit is permitted to join attack groups.
If enabled, the unit is permitted to join attack groups.
path_resolution_modifier optional | :: int8 | Must be between -8 and 8.
Must be between -8 and 8.
size_in_group optional | :: float | The amount of slots in a unit group this unit takes up. [...]
The amount of slots in a unit group this unit takes up. [...]
strafe_settings optional | :: PrototypeStrafeSettings |

## Properties

### destroy_when_commands_fail :: boolean optional

Default: `false`

If enabled, units that repeatedly fail to succeed at commands will be destroyed.

### allow_try_return_to_spawner :: boolean optional

Default: `false`

If enabled, units that have nothing else to do will attempt to return to a spawner.

### do_separation :: boolean optional

Default: `true`

If enabled, units will try to separate themselves from nearby friendly units.

### path_resolution_modifier :: int8 optional

Default: `0`

Must be between -8 and 8.

### strafe_settings :: PrototypeStrafeSettings optional

### size_in_group :: float optional

Default: `1.0`

The amount of slots in a unit group this unit takes up. For example, a unit with `groupingSize` of 2 will count as 2 normal-sized units when filling up a unit group. Must be greater than 0.

### join_attacks :: boolean optional

Default: `true`

If enabled, the unit is permitted to join attack groups.

Type used in

- SpiderUnitPrototype::ai_settings
- UnitPrototype::ai_settings