Common Customs Menu Plugin

This unofficial TaleSpire pluigin provides a core Talepsire like asset llibrary menu into which custom content plugins can easily add assets. This menu is independent of the BR menu so plugins registering their content with this standalone menu are less likely to break when BR makes updates.

Special thanks to Equanimity for latest compatibility fix.

Install

Use R2ModMan or similar installer to install this asset pack.

Configuration

Plugin Configuration

Menu Toggle Trigger: Indicates the key or key combination used to toggle the menu open/closed.

Diagnostic Level: Indicates the amount of information that is put into the logs while running. Keep on Info except when getting logs for support.

Number Of Asset Badges Per Row: Indicates how many asset badges are shown in each row of asset. Larger numbers produce smaller badges.

Plugin Registration Complete: Indicates the time in seconds before the plugin asks all provider plugins to list their assets.

Rewrite Scope Value: Indicates which fields are used in rewrite (reorganize) checks. Add the values of all sources:

Off = 0 Name = 1 Description = 2 Tags = 4 Pack = 8 Prefab = 16

For example, to use only Name, Description and Tags for rewrite checks, the Rewrite Scope Value would be 1+2+4=7.

Rewrite

Assets can be reorganize using the rewriter. Ensure that the Rewrite Scope is not set to "off" (see above).

Create a file called org.lordashes.plugins.commoncustomsmenu.rewriter.json and inside it create a structure similar to:

{
  "Item": { "kind": "Effect", "category": "Prop" },
  "Object": { "kind": "Effect", "category": "Prop" },
  "Armor": { "kind": "Effect", "category": "Prop" },
  "Weapon": { "kind": "Effect", "category": "Prop" },
  "Crate": { "kind": "Effect", "category": "Prop" },
  "Treasure": { "kind": "Effect", "category": "Prop" },

  "Cart": { "kind": "Effect", "category": "Vehicle" },
  "Wagon": { "kind": "Effect", "category": "Vehicle" },
  "Boat": { "kind": "Effect", "category": "Vehicle" },
  "Ship": { "kind": "Effect", "category": "Vehicle" }
}

The key in the dictionary structure (the string on the left side) is the keywords for which the rewrites searches. If found then it changes the "kind" and/or the "category" based on the dictionary striucture to the right. The kind property is how the provider treats the asset. The category property is what Type category it will show up in the menu. For example, { "kind": "Effect", "category": "Prop" } means that the asset will be treated as a "Effect" by the provider (the plugin actually responsible for the asset) but the asset which show up under the "Prop" icon.

The rewriter is applied to all assets at runtime. The registration file is left unmodified with the reweiter applies all changes in memory only. As such turning off the rewriter functionality will restore all assets to their developer intended locations.

Registration file

The master list of registered assets, used by the Common Customs Menu plugin, is store in a .cache folder in the plugins install folder under a folder matching the plugin guid (org.lordashes.plugins.commoncustomsmenu). This file contains the info.txt information of each asset that is registered. This is also the file from which the plugin generates its menus. As such, the information for any particular asset can be tweaked by editing this file.

Usage

1. Use the Open Menu shortcut to open the Common Custom Menu. Default: ``{Home}``
2. Select the desired Kind (Type) using the icons on the left.
3. Select the desired Group using the buttons right of the Kind (Type) icons.
4. Select the desired Asset using the badges right of the groups.