ProjectilePlugin

Projectile Plugin

This unofficial TaleSpire plugin for adding custom projectiles and projectile path builders. This is an initial release

of the plugin with the base feature implemented by very little bells and whistles. Improvements and additional features

will be coming soon.

This plugin, like all others, is free but if you want to donate, use:

Install

Use R2ModMan or similar installer to install this plugin.

Using R2ModMan to edit the configuration for this plugin, one can set the duration (in frames) of the projectile

animations. Currently the duration of the animation is always the same regardless of the distance. This is to more

easily accomodate other plugins, such as rule set plugins, which need to determine when the animations has completed.

The dependency only setting indicates if a Projectiles menu is added to the redial menu. When this setting is true,

no menu will be added (used for cases when Projectile plugin will be used by other plugins like D20 Plugin).

When This setting is false, the Projectile menu will be added to the Radial menu.

Usage

• Right click on the attacking (source) mini to open the Radial menu.
• Select Projectile icon (3 firebolts) from the menu.
• Select the desired projectile from the sub-menu.
• Select targets using the below options.
• Once the require targets are selected or the user ends target selection, the projetile(s) are launched.

Mini Selection

• Click on the mini to select it.

Location Selection

• Click on the ground at the desired location.

Selecting Less Targets

• Middle click to end target selection

Target Count Indication

On the right hand side of the screen, arranged vertically, is an indication of the number of targets that need to be

selected and how many have already been selected.

For projectiles that need 9 or less targets a box will appear for each target that is needed. As the user selects targets

the boxes light up allow the user to see how many more selections are needed.

For projectiles that have an unlimited selection a plus box appears. This means that target selection wil continue endlessly

until the user uses the middle mouse button to end it.

Plugin Details

This plugin requires two types of assets: projectiles and path builders. The plugin comes with three projectile asstes

(arrow, boulder and chaos bolt) and two path builders (direct and arc).

Projectiles define the various setting of the corresponding projectile like the name, mesh, icon, number of targets,

path builder, path builder parameters, etc. Each projectile has its own file thus allowing content creators to easily

make additional projectile options.

Path builders determine how the projectile gets from the source (attacker) to the destination(s) (victim(s)).

In order to try the sample projectiles, open the plugin folder and under CustomData or Assets folder you will find

a folder called "Move_Me_To_A_LocalContent_Folder". Move this folder to a separate custom folder (e.g. [LocalContent])

and place it within the CustomData folder. Lastly remove the ".assetBundle" extension from the 3 files within.

Creating Projectiles

• Before you can create a projectile for this plugin, the asset must already exist. Make a projectile asset bundle

just like you make any other asset. Projectiles always use Effect mode (even if the asset bundle info.txt file say

otherwise), so it is suggested to use the Kind Effect in your info.txt file so that when the asset is spawned as

an Effect it will look the same as when it is used as a projectile.

• You will also need a 64x64 PNG file to represent the projectile icon. The PNG can use transparency.

• Now you can create the projectile file. It should be a text file with the extension "projectile". The file actually

contains JSON content but needs the projectile extension for this plugin to recognize it as a projectile configruation.

The contents of the file look similar to this:

{

"name": "Chaos Bolt",