> For the complete documentation index, see [llms.txt](https://xgine.gitbook.io/xgine-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://xgine.gitbook.io/xgine-docs/advanced-features/entity-filter.md).

# Entity Filter

Take full control over what your character targets and collects with the powerful Entity Filter system.

***

## 🎯 Overview

The Entity Filter system lets you:

* **Target specific monsters** — Focus on what you want to farm
* **Filter loot** — Only pick up valuable items
* **Avoid players** — Stay safe from PK situations

***

## 👹 Monster Filtering

### Target Mobs (Whitelist)

Focus on specific monsters:

1. Click **Add** to open monster selection
2. Search by name
3. Select monsters to target
4. Only listed monsters will be attacked

{% hint style="success" %}
**Pro Tip:** Use the target list to efficiently farm specific monsters for cards or materials.
{% endhint %}

### Blacklist Mode

Alternatively, attack everything **except** listed monsters — useful when you want to avoid certain dangerous mobs.

***

## 💎 Loot Filtering

### Target Loots

Control which items to pick up:

| Configuration      | Behavior                  |
| ------------------ | ------------------------- |
| **Specific Items** | Only collect listed items |
| **Empty List**     | Collect all dropped items |

### Loot Settings

| Setting      | Description                    |
| ------------ | ------------------------------ |
| **Distance** | Maximum range to pick up items |
| **Priority** | Loot before or after combat    |

{% hint style="info" %}
Setting loot priority to "After Combat" prevents interrupting your attacks to pick up items.
{% endhint %}

***

## 👥 Player Detection

Stay aware of other players in your area:

### Player Avoidance

| Mode         | When to Use                         |
| ------------ | ----------------------------------- |
| **Always**   | Maximum safety — avoid all players  |
| **PK Only**  | Only avoid in PK-enabled situations |
| **Disabled** | No player avoidance                 |

***

## ⚡ Performance Settings

Fine-tune detection performance based on your system:

| Setting             | Low-End PC | Balanced | High-End PC |
| ------------------- | :--------: | :------: | :---------: |
| **Detection Speed** |   Slower   |  Normal  |    Faster   |
| **CPU Usage**       |     Low    |  Medium  |    Higher   |

{% hint style="warning" %}
Higher detection speeds use more CPU. Use balanced settings unless you have performance issues.
{% endhint %}

***

## 💡 Tips & Best Practices

<details>

<summary><strong>Optimizing Your Filter Setup</strong></summary>

1. **Be Specific** — Only add monsters you actually want to farm
2. **Loot Wisely** — Filter out junk items to save inventory space
3. **Balance Performance** — Use balanced settings for most situations
4. **Test First** — Verify your filters work correctly before AFK farming

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://xgine.gitbook.io/xgine-docs/advanced-features/entity-filter.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.