The Custom Assets Library Plugin is the successor to EAL and EAR which converts packs to use the TaleWeave Interface.
This package is designed specifically for R2ModMan and Talespire. You can install them via clicking on "Install with Mod Manager" or using the r2modman directly.
This plugin used for players allows TaleSpire to search for TaleWeaver content in the R2Modman Directory. This will allow direct download of TaleWeaver packs via R2Modman.
CALP has a bunch of keyboard shortcuts for triggering additional functionality. The default keys can be reconfigured to other keys by editing the R2ModMan configuration for the CALP plugin. Keyboard shortcuts are divided into two sub-sections: functionality triggers and asset spawn modifeirs.
Press these keys while a mini is selected to trigger the corresponding effect if supported.
+-----------------+------------------------------------------------------------------+
| Modifier Keys | Results |
+-----------------+------------------------------------------------------------------+
+-----------------+------------------------------------------------------------------+
| LControl + 1 | Trigger Animation "Anim01" |
+-----------------+------------------------------------------------------------------+
| LControl + 2 | Trigger Animation "Anim02" |
+-----------------+------------------------------------------------------------------+
| LControl + 3 | Trigger Animation "Anim03" |
+-----------------+------------------------------------------------------------------+
| LControl + 4 | Trigger Animation "Anim04" |
+-----------------+------------------------------------------------------------------+
| LControl + 5 | Trigger Animation "Anim05" |
+-----------------+------------------------------------------------------------------+
| LControl + 6 | Trigger Animation "Anim06" |
+-----------------+------------------------------------------------------------------+
| LControl + 7 | Trigger Animation "Anim07" |
+-----------------+------------------------------------------------------------------+
| LControl + 8 | Prompt for animation name and play it |
+-----------------+------------------------------------------------------------------+
| LControl + 9 | Start playing associated audio |
+-----------------+------------------------------------------------------------------+
| LControl + 0 | Stop playing animation and audio |
+-----------------+------------------------------------------------------------------+
When selecting an asset from the Talespire Library the asset will be loaded based on the kind specified in the asset bundle or as a creature if the asset does not specify the kind in its info.txt file. However, it is possible to override the kind indicated in the asset bundle with a different kind by holding down the corresponding modifier key while selecting it from the library and when placing it down (if applicable). The following tables show what modifier keys select what kind:
+-----------------+------------------------------------------------------------------+
| Modifier Keys | Resulting Kind |
+-----------------+------------------------------------------------------------------+
+-----------------+------------------------------------------------------------------+
| None | Uses kind specified in asset bundle or creature if not specified |
+-----------------+------------------------------------------------------------------+
| Left Shift | Processes spawn as if the kind was creature |
+-----------------+------------------------------------------------------------------+
| Right Shift | Processes spawn as if the kind was transform |
+-----------------+------------------------------------------------------------------+
| Left Control | Processes spawn as if the kind was effect |
+-----------------+------------------------------------------------------------------+
| Right Control | Processes spawn as if the kind was aura |
+-----------------+------------------------------------------------------------------+
| Left Alt | Processes spawn as if the kind was audio |
+-----------------+------------------------------------------------------------------+
| Right Alt | Processes spawn as if the kind was filter |
+-----------------+------------------------------------------------------------------+
+-----------------+-------------------+--------------------+--------------------+----------------------------------------------------+
| Kind | Shader | Transparency | Hide | Comments |
+-----------------+-------------------+--------------------+--------------------+----------------------------------------------------+
+-----------------+-------------------+--------------------+--------------------+----------------------------------------------------+
| Creature | TS/Creature | Not Supported | Supported | This is the default for minis |
+-----------------+-------------------+--------------------+--------------------+----------------------------------------------------+
| Audio | TS/Creature | Not Supported | Supported | Mini starts playing audio when place on board |
+-----------------+-------------------+--------------------+--------------------+----------------------------------------------------+
| Auras | From Asset Bundle | Supported | Supported | Not yet implemented in CAPL |
+-----------------+-------------------+--------------------+--------------------+----------------------------------------------------+
| Effect | From Asset Bundle | Supported | Supported | Used to create minis with non-TS shaders |
+-----------------+-------------------+--------------------+--------------------+----------------------------------------------------+
| Transform | TS/Creature | Not Supported | Supported | Not yet implemented in CAPL |
+-----------------+-------------------+--------------------+--------------------+----------------------------------------------------+
| Prop | TS/Placeable | Not Supported | Supported | Not yet implemented in CAPL |
+-----------------+-------------------+--------------------+--------------------+----------------------------------------------------+
| Tile | TS/Placable | Not Supported | Not Supported | Not yet implemented in CAPL |
+-----------------+-------------------+--------------------+--------------------+----------------------------------------------------+
| (Multi) Slab | TS/Placable | Not Supported | Not Supported | Partially supported. Hight bar does not work. |
+-----------------+-------------------+--------------------+--------------------+----------------------------------------------------+
| Encounter | Based On Asset | Based On Asset | Supported | Not yet implemented in CAPL |
+-----------------+-------------------+--------------------+--------------------+----------------------------------------------------+
Inbuilt into this package is a Binary Index writer which will generate a TaleWeaver compliant index file mimicing the interface of TaleWeaver. This is incredibly experimental and is being worked on. With CALP, EAR compliant files can be converted to TW compliance. This allows asset creators to keep their current workflow.
After CALP runs, an index.json and index files will be generated with some re-organizing. In the root of index.json file will contain an assetPackId variable which can be used to copy over into TaleWeaver's Steamapps folder.
If you update an asset (e.g. custom mini) you may or may not need to re-register it. If the asset's info.txt file and portrait.png file remained the same, you can just copy your new asset over the old one and the next time TS runs, it will use the updated version. If you did modify the info.txt or portrait.png file or added new assets to the pack then you will need to re-register the pack. To make this process easier, the Unregister batch file is provdied. Double click on this batch file to return the pack to its unregistered condition and it will get re-registered when TS is started again.
For testing purpose it is not possible to tweak the pack's index.json file (which is basically core TS version of most info.txt properties). To do this the pack needs to have been registered (or pre-registered). If the setting to delete the index.json is not turned on, the index.json file will remain after registration. To tweak it, follow these steps:
1. Ensure that in the CALP R2ModMan config you have Build Index Mode set to rebuildIndexIfMissing.
2. Rename the Assets folder back to CustomData
3. Delete the index (but not the index.json) file. Do not delete the Portraits folder.
4. Edit the index.json file
5. Restart TS to re-register the pack. This process will recognize the fact that you have a index.json file present and use it instead.
To help content developers use their custom assets even on Vanilla Talespire (non-modded Talespire), CALP generates a RegisterForVanilla.Bat file in the root of each pack. Using this batch file creates a directory link to be created in the Taleweaver directory that points to the pack location. Talespire will be convinced that the content is in the Taleweaver folder even though it is actually elsewhere. In order to use this batch file, you will need to do the following:
1. Open up a Command Prompt using the Run As Administrator. A normal Command Prompt does not have permissions to make links.
2. Execute the batch file with the location of your Taleweaver directory. For example: RegisterForVanilla E:\Steam\steamapps\common\TaleSpire\Taleweaver
To remove the link, just go to the Talwweaver folder and delete the corresponding sub-folder (not the d71427a1-5535-4fa7-82d7-4ca1e75edbfd folder since that is the core TS folder).
Below is a list of the currently supported proeprties in the info.txt file. Any of the old EAR properties (which are not yet listed here) are accepted but will be ignored.
{
"name": "Assasin",
"prefab": "",
"kind": "Effect",
"category": "Creature",
"groupName": "Human",
"description": "Assasin",
"tags": "Human,Rogue,Assasin",
"author": "Lord Ashes",
"version": "1.0",
"comment": "Maximo source",
"size": 1.0,
"code": "",
"meshAdjustments":
{
"size": "1.0,1.0,1.0",
"rotationOffset": "0.0,0.0,0.0",
"positionOffset": "0.0,0.0,0.0"
}
}
All properties are optional and will take the default if not provided. The "prefab" property allow using a different prefab name than the asset bundle name. If empty the prefab will default to the asset bundle name.
the index writer as a supplied interface and method to write the pack. PackContent data structure does not use blob references or ECS upon initial construction.
CustomAssetsLibrary.CustomAssetLib.generate(folder);
After completion, the WritePack method will convert it into the ECS Blob structure and write the index file into the modpack directory.
1.6.0: Added Effect hide functionality.
1.6.0: Added checks for improper asset bundles with visual warning and list in the logs.
1.5.0: Added scripts for unregistering and registering for vanilla.
1.5.0: Added option to tweak index.json files.
1.4.1: Updated documentation. No plugin change.
1.4.0: Added animation functionality
1.4.0: Added sound functionality
1.4.0: Added spawn modification keys
1.3.1: Improved logs
1.3.1: Bug Fix: Null Reference on ghosts
1.3.0: Bug Fix: Endless bases on load
1.3.0: Bug Fix: Spawn size for non-medium creatures
1.2.1: Corrected Thunderstore posting
1.2.0: Effects support trasparency.
1.2.0: Effects are restored on board load.
1.2.0: Bug Fix: AssetBundle Shader is not applied to Creature.
1.1.0: Fixed Effects support.
1.1.0: Fixed Index Out Of Bounds issue.
1.1.0: Added pre and post callbacks to implement additional features.
1.1.0: Temporarily removed dependency on Asset Data plugin.
1.0.1: Added missing Default Portrait into pack. No plugin change.
1.0.0: Official Release, CAL & CAP integrated and working.
Shoutout to Hollofoxes Patreons recognising their mighty contribution to his caffeine addiction:
Also checkout LordAshes donation page