Purposeful Storage

I've made adding compatibility an extremely easy process - it's just a JSON patch, that even ChatGPT can write if you give it an example.

There are 2 "folders" of interest if you want to add compatibility for your mod: purposefulstorage/config/restrictions and purposefulstorage/config/transformations.

Whitelisting

Whitelisting is allowing your item (presumably, spears or some type of clothing) to be placeable in my containers. You'll need a JSON patch to add your itemcodes to the appropriate JSON file.

The restrictions file has 4 "options" - most of the time only 2 are visible: "CollectibleTypes", "CollectibleCodes", and "GroupingCodes" (the last one is ONLY for the Resource Bin) as well as the "BlacklistedCodes" - this one is for ease of use.

• CollectibleTypes: These are the Block Class Names that the item has. (e.g., "game:BlockBarrel" will whitelist all vanilla and modded barrels). This option is generally discouraged.
• CollectibleCodes: These are the itemcodes of the items themselves. This is usually what you'll be patching.
• GroupingCodes: Itemcodes grouped into separate segments, used only by the Resource Bin for positioning and "choosing" the rendering method it's used. DO NOTE that if you notice a whitelist for a block uses these GroupingCodes, the patch MUST be on both server and client. So if you have "side": "server" in your patch, delete it!
• BlacklistedCodes: If you have a lot of items - enough to use a wildcard ( * ) in your patch, but only certain items shouldn't go inside, use this. For example, if a specific clothing like shoes-* catch everything you need, but you want to restrict shoes-flipflops from the whitelist, put it in the Blacklist. This way you don't need to write 99 shoes itemcodes, just so you could avoid the flipflops from being allowed inside. Example in purposefulstorage/config/restrictions/clothes/shoulderware.json.

Example patch:

[
  {
    "file": "purposefulstorage:config/restrictions/clothes/footware.json", // target this file
    "op": "addmerge", "path": "/CollectibleCodes", "side": "server", // append value server-side
    "value": [ // values that will be added
      "game:clothes-someshirt-shoulder-*"
    ],
    "dependsOn": [ { "modid": "your-mod-id-here" } ] // mod that activates the patch
  }
]

This example adds "some shirt" from "Your Mod ID Here" mod to the footware whitelist (which for example Shoe Rack uses). You can find more examples in the purposefulstorage/patches folder.

Modifying the position of the items

Your item might be misaligned, too small or too big. In the purposefulstorage/config/transformations folder, there are files that add specific transformations for placed items.

For example, to rotate all Cheese blocks by 45 degrees without affecting other items:

{
  "*cheese-*": { "origin": { "x": 0.5, "y": 0, "z": 0.5 }, "rotation": { "x": 0, "y": 45, "z": 0 } }
}

Hopefully this helped! Feel free to reach out for further assistance.

You can directly edit the whitelist files inside the mod to add your own items. Keep in mind that these changes will be overwritten whenever the mod updates.

Open the zipped file: purposefulstorage/config/restrictions
Note: Editing files inside a ZIP is sometimes not possible. Extract the file first, edit it, then put it back in the ZIP.

Each JSON file represents a container. Find the container you want to modify and add your itemcodes to the "CollectibleCodes" section.

Example:

[
  {
    "CollectibleCodes": [
      "yourmod:exampleitem",
      "yourmod:anotheritem"
    ]
  }
]

Save the file and restart the game.

Finding Itemcodes: Go to Settings > Interface > Enable Dev Mode. Click the new "Dev" tab > enable Extended Item Debug Info. In your world, hover over the item to see its code.