Skip to content

Repository files navigation

AutoLoot

An ACEmulator server mod that automatically loots items from creature corpses based on configurable rules. Built with ACE.BaseMod and Harmony.


What it does

When a player kills a creature, AutoLoot checks the corpse and moves matching items directly into the player's inventory — no manual looting required. Each player controls their own settings independently; one player's filters have no effect on anyone else.

Each kill is processed in three passes:

  1. Profile pass — checks every item against the server's available .utl loot profiles (VirindiTank-compatible rule files placed by server admins)
  2. VendorTrash pass — picks up any unclaimed item whose sell value is at least N× its burden (configurable ratio)
  3. Unknown Scrolls pass — picks up any unclaimed scroll the player hasn't learned yet

After looting, a chat summary tells you what was picked up and why.


Installation

  1. Build the project (or download a release) and copy the output folder to C:\ACE\Mods\AutoLoot\
  2. Place the server's .utl loot profiles in C:\ACE\Mods\AutoLoot\LootProfiles\
  3. Restart the server or hot-reload with /mod f AutoLoot
  4. Players can type /autoloot in-game to get started

Commands

All commands start with /autoloot.

Command Description
/autoloot Show the full menu — available profiles, filter status, and all commands
/autoloot on Enable everything (all profiles + VendorTrash + Scrolls)
/autoloot off Disable everything
/autoloot <#> Toggle a profile on/off by its index number
/autoloot <name> Toggle a profile on/off by partial name match
/autoloot details Toggle loot notifications in chat on/off
/autoloot vt Toggle the VendorTrash filter on/off
/autoloot vt <ratio> Set a custom value:burden ratio and enable VendorTrash (e.g. /autoloot vt 30)
/autoloot scrolls Toggle the Unknown Scrolls filter on/off
/autoloot rares Toggle server-wide broadcast when you loot a rare item

Server Loot Profiles

Profiles are .utl files placed by the server admin in the LootProfiles/ folder. Players cannot create or upload their own — they simply toggle the server's profiles on or off. Any VirindiTank-compatible .utl file added to LootProfiles/ will automatically appear in every player's toggle list.

The following profiles are included out of the box:

Profile What it loots
PyrealsTradeNotes.utl Pyreals and Trade Notes (enabled by default for new characters)
AltCurrency.utl Alternative currency items
Rares.utl All rare items
PincerTuskMatron.utl Pincer, Tusk, and Matron quest turn-in pieces
PyrealMotes.utl Pyreal Motes
Peas.utl Peas

Loot Notifications

When loot notifications are on (the default), AutoLoot sends a chat message after each kill:

[AutoLoot] You've looted a Trade Note, 150 Pyreals, and a Fine Leather Coat [$]!
[AutoLoot] [!] You can learn: War Magic VI
  • [$] — item was picked up by the VendorTrash filter (good value-to-weight ratio)
  • [!] — scroll contains a spell you haven't learned yet

Turn notifications off with /autoloot details.


Persistence

Every player's settings are saved to a JSON file when changed and restored automatically on their next session — even if the server restarts. Settings that persist:

  • Which profiles are active
  • Whether loot notifications are on
  • VendorTrash on/off and the custom ratio
  • Unknown Scrolls on/off
  • Rare broadcast on/off

Files are stored at: LootProfiles/PlayerData/{character-guid}.json


Quest Item Protection

AutoLoot includes a safeguard against using it to bypass quest timers. Items matching names in the NoDuplicateNames list (default: Pincer, Tusk, Matron) will not be looted if the player already has one of the same type anywhere in their inventory — including inside backpacks. This prevents stockpiling quest turn-in pieces ahead of cooldown timers.

Server admins can expand this list in Settings.json.


Server Configuration (Settings.json)

Setting Default Description
LootProfilePath Mods/AutoLoot/LootProfiles Folder where .utl profiles are stored
DefaultProfile PyrealsTradeNotes.utl Profile auto-enabled for new characters
NoDuplicateNames ["Pincer", "Tusk", "Matron"] Name fragments that trigger the one-per-player quest item check

Requirements

About

ACE mod that allows for opt-in automatic looting of corpses based on server-wide profiles

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages