Author: 7erra
Author Website:

Requirements: No addons required

Version: 1.0

Short description: The attachTo command can be unnecessarily time consuming since you have to basically guess the position of the attached object. Therefore I've made a dialog with which you can attach any object to another and return the offset. And there's more....

Support the author:

100% of your donation goes directly to the author of this content!
Date: 2017-04-26 07:51

Comments: (0)


AttachTo Finder


The attachTo command can be unnecessarily time consuming since you have to basically guess the position of the attached object. Therefore I've made a dialog with which you can attach any object to another and return the offset. And there's more.

Of course the main function is to find the offset, therefore you only need point (1) to (3) of the main display. Everything else is just nice to have and I thought why not? The documentation inside of the scripts is pretty bad because I was focussing on scripting, not explaining. Feel free to ask me anything. Bugs can ofcourse be reported in this thread ;)

Thats all for now and have fun editing.

Installation / Usage:
Main Interface:
1. Camera control:
Move - WASD
Up - Q
Down - Y
Faster - SHIFT
Slower - ALT
Detach pointer - SPACE (see 5.2.)
2. Source object, object of which the offset is taken
2.1. Select object from list of existing objects
2.2. Confirm selection
3. Offset, shows the current values
// Until here is the basic stuff. The following points are not necessary but maybe interesting
3.1. Step selector: Change the steps of which changes are applied ranging from 0.001 to 1. Positions can only be edited while pointer is not attached. Edits can be edited with the scroll wheel.
4. Memory points (Selections)
4.1. Select memory point, opens new dialog "Memory Points" (see below)
4.2. Enter the name of your own memory point. If memory point is not found, default offset [0,0,0] is used
5. Pointer
5.1. Show pointer yes/no
5.2. Detach/Attach pointer. Leave pointer whereever it currently is. Values are still evaluated.
5.3. Attaches the nearest object to the pointer and automatically disables simulation
5.4. ~Currently not used. If you want to create a new object then do so in the editor or Zeus. Object list is updated on dialog load~
5.5. Delete object: Select an existing object in the COMBO and press the BUTTON to delete it. You can't delete yourself, the current source object or the current pointer object (that would cause many many script errors)
6. Directions of pointer object
6.1. Vector Dir: Shows the vectorDir (difficult behaviour, use (6.2) instead)
6.2. Degrees: Shows the orientation in degrees
6.3. Vector Up: Shows the vectorUp (difficult behaviour, use (6.4) instead)
6.4. getPitchBank: Uses BIS_fnc_getPitchBank
6.5. Enter and Reset: Enter apllies settings, Reset sets everything to normal
7. Other
7.1. Opens new dialog "Settings" (see below)
7.2. Copy the commands to the clipboard. 7.3.2. shows the resulting message
7.3. Credits: Shows contributors.

Memory points:
1. Available memory points, Shows some default selections (link to topic follows (maybe))
2. Search for specific memory point. Enter text. Results are shown in tree below
3. Find Memorypoints: Most useful control of them all. Automatically finds existing (!= [0,0,0]) selections
4. Resets the dialog
5. Passes selected memory point to Main Interface
6. Leave without changes

1. Pointer color (Default: GREEN)
1.1. Predefined colors and custom ones
1.2. Define own color. Remember to set "Alpha" to something greater than 0 or else nothing happens
1.3. Preview of custom color
2. Pointer size (Default: 10cm)
2.1. Select size
3. Pointer object (Default: sign_sphere_10cm)
3.1. Choose an existing object to become the pointer. (3.2.) has to be checked.
3.3. Create new object from config name as pointer. (3.4.) has to be checked.
4. Memory points (Default: Unchecked, Unchecked)
4.1. If checked the memory points will be shown next time you are executing point (3.) from Memory points dialog (see above)
4.2. Delete the pointers when dialog is closed. If unchecked, pointers will stay.
5. Simulation (Default: checked > enabled)
5.1. Enable or disable simulation of source object
6. Collsion (Default: checked > enabled)
6.1. Enable or disable collision of the pointer object with all other scenario objects
7. Exclude/Include objects (Default: Excuded objects: player, pointer, (camera))
7.1. Select objects that won't be shown in the dialogs
7.2. Reverse actions of (7.1.)
8. Dialog
8.1. Apply the settings
8.2. Return all settings to default
8.3. Cancel: Leave without changes

Bugs, Quirks, Errors More Features:
Hide contents
- Camera control works with modelToWorld, therefore it is a bit... different
- SINGLEPLAYER ONLY (why would you want to play this in MP?)
- the offset may be incorrect after changing orientation of pointer object, I guess I'd need some calculations to get it working. I recommend not changing those until you've found the offset.
- Some vehicles don't seem to have m

v1.0 (25.04.2017)
- Release

Forum topic:
- BI forums

Enable javascript to be able to download from Armaholic please!

Tags: Attachto,   Dialog,   Function,   Offset,   Script