0 of 0

File information

Last updated

Original upload

Created by

Gmishaolem

Uploaded by

jakj

Virus scan

Safe to use

Tags for this mod

About this mod

Automatically picks up items on the ground, produced by machines, harvested, and more. Safer in multiplayer than alternatives. Leaves items alone if you drop them on purpose, so you can still plant stuff. Adjustable range (including infinite). Configurable blacklist of item types to not pick up.

Requirements
Permissions and credits
This mod will automatically pick up items for you and add them to your inventory, instead of having to do it yourself manually. It has multiple options in the configuration file.

This mod does not have any option to configure how often it picks up items, because it has been written specifically with performance in mind and is very fast unless you have a legendary number of dropped items on the ground at once (which, presumably, you won't, because you are using an auto-pickup mod). In singleplayer, items are thus picked up instantly as soon as you harvest a tree, kill an animal, walk close enough to some meat and bones on the ground, and so forth. (Special note about multiplayer below.)

When you deliberately throw items on the ground from your inventory or a container, the mod will mark them so that they don't get picked up automatically from that point on. You can still pick them up manually, and other players around you can pick them up both automatically and manually. This is so that you can still throw fruit on the ground to bury, place meat in traps, give items to other players, and so forth.

You can configure the "reach" distance of the autopickup in the config file, and you can also set it to infinite, which means items will be picked up literally anywhere around you. If you are in the deep mine, only items in the deep mine will be picked up. If you are above-ground, the infinite reach will work both inside and outside, meaning you will pick up items no matter how far away on the island they are, even if you are inside a house. In fact, if there are two people in different houses and both have infinite range turned on, they can throw items to each other without leaving the houses.

There is a configurable blacklist, which lets you specify items you don't want at all, such as feathers and poo. You can still manually pick up these items, but the autopickup never will.

To configure the blacklist, you need to be outside, and you need to have a container holding at least one of each item you don't want to pick up. Go up to the chest as if you were going to open it, but instead of opening it, type the chat command "/autopick blacklist". (You do need to have opened the chest at least once since you entered the world, which presumably you did when you put the items in it, but you will get an informational message if you didn't.)

The mod will look at all the items in the container and make note of them, and a chat message will pop up telling you what it saw. You can then take the items back and remove the container, if you want, or just leave it there so you can easily change the blacklist at any time. When you save your game by sleeping, the blacklist is saved as well. If you uninstall the mod, your blacklist will not be deleted, so it will still be there if you reinstall the mod.

To clear the blacklist out so that all items will be picked up, use the command on a container that is empty.

IMPORTANT MULTIPLAYER INFORMATION
  • The base game implements items on the ground (both dropping them and picking them up) in a way that allows for both unintended item duplication and unintended item deletion. This mod cannot prevent these issues entirely, but does include mitigations that reduce the chance of them happening to be minuscule and thus nothing to worry about.
  • In a multiplayer setting with more than one player in the same world at the same time, this autopickup mod will not pick up items immediately, but will wait for them to "settle".
  • This is a randomly chosen amount of time from 1 to 2 seconds.
  • If more than one player tries to pick up an item at the same time, the game will give it to both of them. By randomizing the pickup delay, it becomes extremely unlikely that multiple players will make the attempt at the same time.
  • If one player is rapidly dropping items (such as repeatedly pressing Q), and another player starts picking up those items while they are still dropping more, some of the items can get deleted. The 1-2 second delay is renewed every time a new item is dropped onto the same spot, so the mod won't actually try to pick anything up until it's been there not changing for 1-2 seconds.
  • Because the delay is randomized, if more than one player is using this mod, it will thus be random each time which player gets to pick up the item.
  • When playing in singleplayer, or when there are no remote clients connected to the world you are hosting, the 1-2 second random delay will not happen and items will be picked up instantly.
  • I know this mandatory multiplayer delay is inconvenient, but it is necessary to mitigate the item duplication and item loss issues. Hopefully in the future a game update will change the item pickup code to be server-authoritative so that I can remove this delay. Other mods without the delay are available, if you would rather items be picked up faster but less safely.

"ModEnabled" will turn the mod on and off entirely.

"PickupRange" is the maximum number of tiles away from you (in a straight line in 3D) that autopickup will grab stuff. "InfinitePickupDistance", if set to 'true', will pick up items from anywhere on the entire island no matter where you are (though it's pretty much limited to your view distance anyway, because nothing beyond your view distance will be loaded and producing anything to pick up).

"DefaultToOn" determines whether or not autopickup is active by default whenever you enter a world.

"ToggleKey" is a keybind (by default unset, so if you want to use it you have to set it yourself) that will switch the autopickup on and off. The chat commands "/autopick on", "/autopick off", and "/autopick toggle" can also be used to turn autopickup on and off.

"NotifyFullPockets" turns on and off the notification that pops up telling you that you can't pick up any more stuff. This does not affect the full-pockets notification for the entire game: Just for the autopickup.

This mod is safe to remove at any time, as it does not affect your save file in any way. If you uninstall and reinstall the mod, your blacklist settings will still be there.

This mod requires the TR Tools modding framework to function.

This is a standard BepInEx 6 mod, so follow the standard Dinkum modding instructions and put the DLL file in your plugins folder.