Inventory
From OpenSimulator
m (Layout Only) |
(Section for those redirected to this page from viewer popup) |
||
(31 intermediate revisions by 4 users not shown) | |||
Line 1: | Line 1: | ||
− | + | {{Quicklinks}} | |
− | + | <div style="background-color:#FFA500; padding:10px; padding-bottom:5px; border: 1px #FF544F solid"> | |
+ | <b>If you landed here from a viewer popup then it is likely that the inventory structure associated with your avatar is damaged in some way.</b><br> | ||
+ | <b>The information on this page can be used to resolve inventory issues, if you are the operator of a grid, otherwise forward this page to the administrator of the grid you connect to.</b><br> | ||
+ | In most cases issues are the result of old data, in rare cases viewers, especially if not designed for OpenSim, can create faulty inventory data. Make sure to only use recommended viewers with OpenSim. | ||
+ | </div> | ||
− | + | From 2022 some viewers have code designed to validate whether the inventory structure is properly set up and may have facilities to warn users if there are problems with their inventory structure. | |
− | + | There are a variety of potential causes for these issues, old bad data retained from previous changes or bugs to IARs creating a mess. Full validation would require some of these issues to result in a fatal error, which either prevents login or makes inventory unavailable. Most viewers thankfully attempt to handle these issues as gracefully as possible, it is still a good idea to resolve them if possible. | |
− | + | Inventory is handled almost exclusively via the database, some caching excluded, so resolving issues has to happen there. If you run a grid or standalone you will likely have to change the [[Inventoryfolders]] table to comply with the proper inventory structure. If you are just a user on a grid then you will have to contact the operator of the grid to fix the issues for you. The most common problems and steps to resolve them are listed on this page, but each inventory is different so there are no blanket ways to resolve issues, it requires examination on an individual basis. | |
− | + | ||
− | + | ||
− | == | + | == OpenSim Inventory Folder Types == |
+ | |||
+ | OpenSim has been permissive about inventory folder duplication. However, OpenSim until 2015 used folder types that where different from the ones expected by viewers, so Region and Grid owners should pay attention to some cases where viewer side restrictions are being validated: | ||
+ | |||
+ | * My Inventory or Inventory: should be type 8 and each user must have only one. (type 9 was used on older versions) | ||
+ | * My Suitcase or Suitcase: is optional. If present, should be type 100 and each user must have only one. (type 8 or 9 was used on older versions) | ||
+ | * Trash: should be type 14 | ||
+ | * Lost and Found: should be type 16 | ||
+ | * Current Outfit: must be type 46 | ||
+ | |||
+ | {{Warning|IAR load DOES create duplicate folders unless the --merge option is used}} | ||
+ | |||
+ | Viewers will look for specific folders, mostly only on creating a new item, So if they are duplicated, it just may not be clear the folder they choose. Users should be advised to only have duplications while doing merge of inventories, etc. Folder types in OpenSim have still no other use than show type specific icons and to allow use of inventory filters. | ||
+ | |||
+ | Also see the informative Wiki page on [[Inventoryfolders]] for complete documentation. | ||
+ | |||
+ | == Check and Correct Inventory Script (User Contribution) == | ||
+ | |||
+ | See also [[Check_inventory_script]] for advice and a PHP script which can help fix some inventory type issues. Grid operators can run this script to check user inventories for problems and the article describes the steps to resolve the most common errors. | ||
+ | |||
+ | == External Discussions on Inventory Issues == | ||
* http://opensimulator.org/mantis/view.php?id=8997 - OpenSimulator Mantis 8997 - Inventory Validation Checks in Recent Viewers Causes Issues for Inventory Folders with wrong type numbers. | * http://opensimulator.org/mantis/view.php?id=8997 - OpenSimulator Mantis 8997 - Inventory Validation Checks in Recent Viewers Causes Issues for Inventory Folders with wrong type numbers. | ||
* https://jira.firestormviewer.org/browse/FIRE-31634 - Firestorm JIRA FIRE-31634 Opensim - Inventory doesn't load on some grids. | * https://jira.firestormviewer.org/browse/FIRE-31634 - Firestorm JIRA FIRE-31634 Opensim - Inventory doesn't load on some grids. | ||
− | + | As this does not constitute a bug on the side of OpenSim please direct questions at [[IRC]] or the [[Mailing_Lists]] instead of filing a mantis ticket. | |
− | + | ||
− | + |
Latest revision as of 06:46, 15 February 2023
If you landed here from a viewer popup then it is likely that the inventory structure associated with your avatar is damaged in some way.
The information on this page can be used to resolve inventory issues, if you are the operator of a grid, otherwise forward this page to the administrator of the grid you connect to.
In most cases issues are the result of old data, in rare cases viewers, especially if not designed for OpenSim, can create faulty inventory data. Make sure to only use recommended viewers with OpenSim.
From 2022 some viewers have code designed to validate whether the inventory structure is properly set up and may have facilities to warn users if there are problems with their inventory structure.
There are a variety of potential causes for these issues, old bad data retained from previous changes or bugs to IARs creating a mess. Full validation would require some of these issues to result in a fatal error, which either prevents login or makes inventory unavailable. Most viewers thankfully attempt to handle these issues as gracefully as possible, it is still a good idea to resolve them if possible.
Inventory is handled almost exclusively via the database, some caching excluded, so resolving issues has to happen there. If you run a grid or standalone you will likely have to change the Inventoryfolders table to comply with the proper inventory structure. If you are just a user on a grid then you will have to contact the operator of the grid to fix the issues for you. The most common problems and steps to resolve them are listed on this page, but each inventory is different so there are no blanket ways to resolve issues, it requires examination on an individual basis.
[edit] OpenSim Inventory Folder Types
OpenSim has been permissive about inventory folder duplication. However, OpenSim until 2015 used folder types that where different from the ones expected by viewers, so Region and Grid owners should pay attention to some cases where viewer side restrictions are being validated:
- My Inventory or Inventory: should be type 8 and each user must have only one. (type 9 was used on older versions)
- My Suitcase or Suitcase: is optional. If present, should be type 100 and each user must have only one. (type 8 or 9 was used on older versions)
- Trash: should be type 14
- Lost and Found: should be type 16
- Current Outfit: must be type 46
IAR load DOES create duplicate folders unless the --merge option is used |
Viewers will look for specific folders, mostly only on creating a new item, So if they are duplicated, it just may not be clear the folder they choose. Users should be advised to only have duplications while doing merge of inventories, etc. Folder types in OpenSim have still no other use than show type specific icons and to allow use of inventory filters.
Also see the informative Wiki page on Inventoryfolders for complete documentation.
[edit] Check and Correct Inventory Script (User Contribution)
See also Check_inventory_script for advice and a PHP script which can help fix some inventory type issues. Grid operators can run this script to check user inventories for problems and the article describes the steps to resolve the most common errors.
[edit] External Discussions on Inventory Issues
- http://opensimulator.org/mantis/view.php?id=8997 - OpenSimulator Mantis 8997 - Inventory Validation Checks in Recent Viewers Causes Issues for Inventory Folders with wrong type numbers.
- https://jira.firestormviewer.org/browse/FIRE-31634 - Firestorm JIRA FIRE-31634 Opensim - Inventory doesn't load on some grids.
As this does not constitute a bug on the side of OpenSim please direct questions at IRC or the Mailing_Lists instead of filing a mantis ticket.