How to download

Please back up your config. Your config will automatically be updated to a v3.10 config, but if you decide to temporarily switch back to v3.9 or older (for example, due to bugs), your v3.10 config will not work.

https://umod.org/plugins/Backpacks.cs?version=3.10.0&branch=v3-10

If you download, I suggest clicking the "Watch" button on the top right to subscribe to notifications to this thread for updates to the beta.

Documentation

https://github.com/LaserHydra/Backpacks/tree/v3.10

How to provide feedback

If you have questions, issues or suggestions regarding the beta, please open a new thread and prefix the thread's title with [Beta v3.10].

Summary of changes

New features

• You can now limit which items can be kept from wipe to wipe. Previously, this was an all-or-nothing config option and permission. You can limit the max number of item slots kept, as well as which item categories, short names, and skin IDs can be kept. You can configure different rulesets according to permissions.
• Players will now receive feedback when attempting to place restricted items into their backpack. The chat message can be configured in the localization files ("Backpack Item Rejected"). The default English chat message is "That item is not allowed in the backpack". In addition to the chat message, a configurable effect prefab will be played (Item Restrictions > Feedback effect), which you can set to "" to disable. The default effect is the same as when attempting to open a locked door or container.
• Sign images, photographs, cassette audio, egg suit drawings, pager frequencies, as well as pager & mobile phone silent mode are now saved as part of the backpack data file, allowing such data to be transferred across servers and wipes. This also fixes a very minor entity leak that applies to some of those item types.
• Added permission backpacks.gather which allows players to toggle Gather mode per backpack page, which automatically transfers newly acquired inventory items to the backpack. This was inspired by the Bag of Holding plugin. It's not our intent to rip off that plugin or reduce its sales, though that may be an inevitable consequence of introducing this feature and the recent feature for multiple pages. Consider purchasing that plugin if you want to support the author for creating the first publicly available decent implementation of that idea. There are also various ways it can synergize with Backpacks, and we have worked closely to ensure compatibility.
• Added permission backpacks.retrieve which allows players to toggle Retrieve mode per backpack page, which automatically retrieves items from the backpack when building, crafting and more. Requires the Item Retriever plugin which is not yet available on uMod because it is still early access, but it can be found on GitHub here.

Improvements

• The GUI button will now be hidden while conversing with NPCs.

Changes being considered for future versions

I am not currently planning to add more features to v3.10, but the following requested features are being considered for future releases (v3.11+).

• Display the number of occupied/total slots on the GUI button
• Require a specific item to use your backpack
• Command to put an item into a backpack, opposite of backpack.fetch
• Allows players to configure which side of the belt the GUI button is displayed
• Allow configuring alternate GUI buttons according to the occupied/total capacity of the backpack

A new revision of v3.10.0 has been released which includes multiple bug fixes and a stability fix. Please redownload the file from the above link.

Merged post

Yet another revision of v3.10.0 has been released which includes a bug fix related to gather mode and Bag of Holding. Please redownload the file from the above link.

Merged post

Yet again, a new revision of v3.10.0 has been released which includes bug fixes. Please redownload the file from the above link. The version number has not changed, but the code has.

Also, the v3.10 beta will fail to compile with this coming force wipe on February 2nd. When updating Rust and Oxide on that date, please switch to the following staging version of the plugin.

https://umod.org/plugins/Backpacks.cs?version=3.10.0&branch=v3-10-staging

!! Installing this update before the force wipe will not work (the plugin will not compile). This version will only work on the staging branch OR after the February 2nd force wipe.

!! Failure to have this version installed when your new save file is generated at the force wipe, will result in backpacks not wiping, because the plugin must be successfully loaded at that time in order for backpacks to be automatically wiped. To correctly update on February 2nd, shut down your server, install Rust + Oxide + Backpacks v3.10-staging (in any order), THEN start your server. If you do this wrong, you will have to manually wipe backpacks by deleting the files in the oxide/data/Backpacks/ folder.

A new revision of v3.10.0 has been released which includes the following changes.

• Fixed compatibility issue with the Player Administration plugin.
• When an item is removed from your inventory, gather mode will be paused for one frame. This fixes an issue where swapping two items between inventory containers could cause one of them to be moved into the backpack.
• When an item enters your inventory that matches another stack of items in your inventory, gather mode will no longer move the item into the backpack. This fixes an issue where splitting a stack in your inventory would cause the amount that you split off to be moved into the backpack.
• When the backpack attempts to gather an item, if there is a matching item stack that matches the item, but cannot accept the item due to stack limit, the new item will be added after the existing stack, as a QoL auto sorting mechanism, rather than adding the new item toward the beginning of the container.

A new revision of v3.10.0 has been released which includes the following changes.

• Fixed an issue where acquiring multiple items at once would only gather one of the items. This could happen with plugins that have a "loot all" button to take items in bulk.