KubeRoot-AutoItemPickup icon


Automatically distributes items among players when items drop and/or the teleporting begins

Last updated a month ago
Total downloads 56995
Total rating 10 
Categories Mods Tweaks Server-side
Dependency string KubeRoot-AutoItemPickup-1.7.0
Dependants 12 other mods depend on this mod

This mod requires the following mods to function

bbepis-BepInExPack-5.4.1905 icon

Unified BepInEx all-in-one modding pack - plugin framework, detour library

Preferred version: 5.4.1905
tristanmcpherson-R2API-4.3.5 icon

A modding API for Risk of Rain 2

Preferred version: 4.3.5
RiskofThunder-HookGenPatcher-1.2.3 icon

MMHOOK generation at runtime.

Preferred version: 1.2.3



Automatically grants items on the ground to players when the teleport is initiated or an item spawns.

NOTE: Please check out the config options in BepInEx/config/com.kuberoot.autoitempickup.cfg before usage. Distributing items on drop is disabled by default.

Support me on Ko-fi


  • Distributing on item drop and/or teleport
  • Can grant items to dead players
  • Server-only - the mod does not need to be installed on clients
  • Filtering by item tier, ignores lunar items by default
  • By default items from printers/cauldrons/similar go to the activator upon distribution, as long as the activator is still a valid target
  • Items can be blacklisted from pickup individually, using a comma-separated config entry. Items can be blacklisted by english name (EN_US locale) or ItemIndex name. For example:
    • ItemBlacklist = Bustling Fungus, Syringe, Infusion, BleedOnHit, Backup Magazine
  • Features 4 distribution modes:
    • Sequential - Grants one item to each player, looping over players when they run out, roughly equally distributed
    • Random - Distributes items randomly
    • Closest - Grants each item to the nearest player
    • LeastItems - Grants each item to the player with least items of its rarity
  • Enabling TeleportCommandCubes makes selection cubes teleport to you or the teleporter
    • TL;DR: Enable this for limited distribution when playing with Command
    • If distributing items on drop is enabled and the item that would've dropped matches the config, the command drop is teleported to the appropriate player using the distributor.
      • NOTE: The LeastItems distributor does not care about command cubes that have been teleported to a player but haven't yet been picked up, so they might pool up at one player
    • If distributing items on teleport is enabled, the command drops whose items would've matched the config will teleport around the teleporter with those conditions:
      • When the teleporter finishes charging, all matching command drops will teleport around the teleporter.
      • If the teleporter finished charging and an item matches the on teleport config but not the on drop config, the command drops will teleport around the teleporter.


Copy the AutoItemPickup folder to Risk of Rain 2/BepInEx/plugins

Patch notes:

  • 1.7.0
    • Update for SotV patch 1.2.3
  • 1.6.1
    • Fix error when giving items to dead players
    • Fix error with Closest distributor when distributing to dead players is enabled and some players are dead
    • Fix off-by-one issues with selecting random players, affecting mostly random distribution, that would prevent the last player from getting items
    • Add support in code for unloading the mod at runtime
    • The Sequential distributor will now try to preserve the current target when a player joins or leaves
  • 1.6.0 - Update to RoR2 Survivors of the Void
    • Teleporting command essences on teleport will now space them away from the center of the teleporter
  • 1.4.3 - Update to RoR2 1.0 update
    • Remove code to snap command cubes to the ground, since they now have gravity
  • 1.4.2 - Hotfix: Fix error when distributing command cubes if the stage doesn't have a teleporter
  • 1.4.1 - Fixes for Command
    • Items chosen from command cubes go to the person selecting the item
    • Command cubes that are moved when the teleporter finishes charging are now properly synchronised for clients
  • 1.4.0 - Update to RoR2 Artifacts update
    • Added TeleportCommandCubes for simple Artifact of Command compatibility
  • 1.3.2 - Update to RoR2 Skills 2.0 update
  • 1.3.1 - Update to RoR2 Scorched Acres update
  • 1.3.0 - Update to BepInExPack 2.0.0 and R2API 2.0.6; no changes to function.
  • 1.2.1 - Fixed error related to changes in language handling in latest RoR2 update (Build #3830295)
  • 1.2.0 - Added item blacklisting, separate for drop and teleport.
  • 1.1.4 - Fixed missing UpdateTargets condition, which caused Closest distributor to throw after first stage. Added additional exception handling in distributor to avoid interfering with game code.
  • 1.1.3 - Fixed Closest distribution mode throwing exceptions and preventing teleportation when dead players are not ignored and a player is dead
  • 1.1.2 - Fixed Closest distribution mode presumably being completely broken, without actually testing to make sure the fix isn't broken. Have fun!
  • 1.1.1 - Added OverridePrinterTarget config option that ensures the activator receives printer result as long as they're valid
  • 1.1.0
    • Added on-drop distribution setting
    • Made on-teleport distribution togglable
    • Reworked code structure
    • Fixed wrong code that could've lead to errors when ignoring dead players
    • Added filtering for white, green, red and boss items
    • Added separate filtering options for teleport and drop
  • 1.0.2 - Added config option for ignoring lunar items
  • 1.0.1 - Added website url
  • 1.0.0 - Initial release

Available versions

Please note that the install buttons only work if you have compatible client software installed, such as the Thunderstore Mod Manager. Otherwise use the zip download links instead.

Upload date Version number Downloads Download link  
2022-4-23 1.7.0 3337 Version 1.7.0 Install
2022-3-11 1.6.1 5897 Version 1.6.1 Install
2022-3-9 1.6.0 1001 Version 1.6.0 Install
2021-4-19 1.5.2 15254 Version 1.5.2 Install
2021-4-19 1.5.1 93 Version 1.5.1 Install
2021-4-17 1.5.0 526 Version 1.5.0 Install
2020-8-16 1.4.3 14983 Version 1.4.3 Install
2020-4-15 1.4.2 2491 Version 1.4.2 Install
2020-4-15 1.4.1 253 Version 1.4.1 Install
2020-4-9 1.4.0 674 Version 1.4.0 Install
2019-10-14 1.3.2 3123 Version 1.3.2 Install