Grab Drop Plugin

This unofficial TaleSpire plugin is for adding allowing minis to grab and drop each other. While a mini is grabbed it will move along with the mini that grabbed it. When a mini is dropped it will no longer move along with the mini that grabbed it. Typically this is used with mini and prop mini to have minis pick up (and drop) props.

Change Log

1.0.0: Initial release

Install

Install using R2ModMan.

Usage

The configuration for the plugin has two mode "Select Prop" and "Select Prop". You can set the desired mode using R2ModMan configuration editor for this plugin.

To use the plugin you need to select the prop mini and the grabbing mini. The mode determines which of those two items is actually selected and on which the radial menu is opened.

Select Prop Mode

In this mode, the prop mini is selected and then the right mouse button is used on the grabbing mini to select the Grab option. This will cause the grabbing mini to move the prop mini along whenever it moves. To drop the prop, always right click the grabbing mini and select drop.

Select Mini Mode

In this mode, the grabbing mini is selected and then the right mouse button is used on the prop mini to select the Grab option. This will cause the grabbing mini to move the prop mini along whenever it moves. To drop the prop, always right click the grabbing mini and select drop.

Grabbed Item Location

A prop mini can be grabbed at any distance. Once grabbed it will keep the same position offset to the grabbing mini as when it was grabbed. This means that this effect can be used not only to represent physical grabs but also things like telekinetic powers (i.e. activate the grab when the item is not adjacent).

While an item is grabbed it can still be moved independently thus adjusting the offset between itself and the grabbing mini. This can be used to adjust the position of the grabbed item with respect to the grabber without having to drop and re-grab the item. To do this just select the prop mini as usual and use the usual methods to move it.

Known Limitations

1. The current implementation allows only one object to be grabbed. However, as a work around, it is possible to chain multiple objects together. For example, Prop1 can be grabbed by Prop2, which can be grabbed by Prop3, which can be grabbed by a mini. Each of the minis is grabbed by only one mini but the end mini would be able to "carry" all three props.

2. Current grabbing is a simple parenting so it is more of a "drag" than actual "pick up". Future version may implement a more specific grab (such as right and left hand) for minis which have a bone structure.

3. Odd effect may occur when moving a grabbed object near walls. It has not been fully tested what happens when a item is grabbed and then dragged in such a way that it would end up in a wall.