> For the complete documentation index, see [llms.txt](https://neo-soft-entertainment.gitbook.io/advanced-loot-generator/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://neo-soft-entertainment.gitbook.io/advanced-loot-generator/readme.md).

# Neo Loot Generator

A data driven, rarity weighted loot generator with server side spawning for Unreal Engine.

A loot framework for Unreal Engine. You describe items, tables and pools as data assets. You drop a component on an enemy or a chest. The server rolls the loot, scatters the item actors and hands you the result. Rarity is yours: you define the tiers with Gameplay Tags.

No hardcoded drop logic in your enemy classes. No duplicated weight math. One roll pipeline that designers can tune without touching code.

{% hint style="info" %}
Official support: <https://discord.gg/HA2CBfdCFT>
{% endhint %}

## Start here

{% content-ref url="/pages/ZUIyVmqwml2GuIGHgQ7Y" %}
[How it works](/advanced-loot-generator/start-here/how-it-works.md)
{% endcontent-ref %}

{% content-ref url="/pages/Smt3U3gYhOZPpJYn3dmS" %}
[What you get](/advanced-loot-generator/start-here/what-you-get.md)
{% endcontent-ref %}

{% content-ref url="/pages/8GVpDj0WMySm8VdWxn0V" %}
[Core concepts in 5 minutes](/advanced-loot-generator/start-here/core-concepts.md)
{% endcontent-ref %}

{% content-ref url="/pages/ygxa0eEVMkeSlYlHS6d4" %}
[Your first loot drop](/advanced-loot-generator/start-here/your-first-loot-drop.md)
{% endcontent-ref %}

{% hint style="info" %}
**New to the plugin?** Read [Core concepts in 5 minutes](/advanced-loot-generator/start-here/core-concepts.md), then build [Your first loot drop](/advanced-loot-generator/start-here/your-first-loot-drop.md). The rarity setup is the step people skip, and every entry needs it.
{% endhint %}

## What it does

|                      |                                                                                             |
| -------------------- | ------------------------------------------------------------------------------------------- |
| **Data driven loot** | Entries, tables and pools are data assets. Add an item without touching code                |
| **Your own rarity**  | Rarity is a Gameplay Tag you define. The plugin ships no default tiers                      |
| **Weighted rolls**   | Flat weighted or tiered random, with per-entry weight and quantity range                    |
| **Luck**             | A luck value scales each entry's weight. Per entry sensitivity, per player luck             |
| **Conditions**       | Instanced condition objects filter entries at roll time. Write your own in Blueprint or C++ |
| **Exclusion groups** | Stop two items of the same kind from dropping in one roll                                   |
| **Scatter**          | Point, circle, sphere or box spawn shapes with a height offset                              |
| **Server authority** | Rolls and spawns run on the server. Containers replicate their opened state                 |
| **Seeded rolls**     | Pass a seed to get the same result again                                                    |
| **Blueprint API**    | A function library and a world subsystem cover everyday use                                 |

## What comes in the box

**The plugin.** Two modules: `NeoLootGenerator` (runtime) and `NeoLootGeneratorEditor` (asset creation menu entries). Engine modules only.

**Components and an actor.** `UNeoLootDropComponent`, `UNeoLootContainerComponent` and a ready `ANeoLootContainerActor`.

**No demo content.** The plugin does not ship a demo map or sample items. The first guide builds a working setup in about ten minutes.

## Requirements

|                    |                                                                |
| ------------------ | -------------------------------------------------------------- |
| **Engine**         | Unreal Engine 5                                                |
| **Language**       | C++ modules with a Blueprint API                               |
| **Network modes**  | Standalone, listen server, dedicated server                    |
| **Dependencies**   | Engine modules: `GameplayTags`, `DeveloperSettings`, `NetCore` |
| **Plugin version** | 2.0                                                            |

## Links

* Support: [Discord](https://discord.gg/HA2CBfdCFT)
* [Changelog](/advanced-loot-generator/updates/changelog.md)
* [FAQ](/advanced-loot-generator/resources/faq.md)
* [Troubleshooting](/advanced-loot-generator/resources/troubleshooting.md)