# Prey
{% hint style="success" %}
**COPY/PASTE PARAMETERS**
New in GM 0.11! Right click on a behaviour or component to copy. Then open an object, add the same behaviour or component, and right click it to paste identical parameter settings.
{% endhint %}
{% hint style="info" %}
This behaviour has not yet been migrated for use in multiplayer Experiences.
{% endhint %}
##  Prey
* Walk within a defined zone
* Eat specific assets within its range
* The eating frequency can be changed within its parameters
* Once it detects a predator, it tries to escape by increasing its speed and running away from the predator
* Once an asset gets eaten, it goes for another one if its hunger hasn’t reached its maximum
* Peaceful creature that doesn’t attack any targets
## Common Uses
* A creature that flees from Predators and seeks a food source, which will stop seeking food when hunger parameters are met
* Removing Objects from an Experience at a more consistent rate than the Farmer Behaviour's random and continuous "harvesting"
## Communications
Inputs:
Detects specified Tags as targets to flee (default Tag is Predator)
Detects specified Tags as targets to eat (default Tag is Plant)
Outputs:
If any of its Tags to Flee are detected, moves away
If any of its Food Tags are detected, moves toward a random object with the tag(s), displays its eating animation, and makes the target object disappear (no death/destroy animation)
Walk Speed (slider) - Determines the amount of blocks travelled per second by your Object when walking.
This parameter's max value is determined by the ASSET's Speed stat.
Flee Speed (slider) - Determines the amount of blocks travelled per second by your Object when fleeing.
This parameter's max value is determined by the ASSET's Speed stat.
|
|  |
Food Tag - Tags that the Object will look for to eat. You may add more than one tag or remove unwanted tags.
Tags to Flee - Tags that the Object will flee from if the tags enter their Enemy Detection Range.
|
|  |
Enemy Detection Range (slider) - Defines the area in which the Object will detect Tags to Flee.
This parameter is visualised with a yellow circle Gizmo that adjusts as you move the slider or change the value.
This parameter's max value is determined by the ASSET's Defense stat.
Food Detection Range (slider) - Defines the area in which the Object will detect Food Tags.
This parameter is visualised with a green circle Gizmo that adjusts as you move the slider or change the value.
This parameter's max value is determined by the ASSET's Luck stat.
|
|  |
Food Value - Determines the amount of hunger your Object earns from eating a target.
Max Hunger - The maximum hunger value that can be reached by the Object. When the Prey is hungry, it will look for Food Tags.
Hunger Decrease Rate - How much hunger your Object loses automatically per second.
Eating Duration - The time, in seconds, that it takes for the Object to eat a target.
Hunger Threshold - Determines at which hunger level your Object must be to look for Food Tags.
|
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.sandbox.game/en/creator/game-maker/docs/behaviours/npc-ai-pawns/prey.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
