Subscribe to download
Precise Rotation Script [Obsolete, use MoveIT script instead]

Note:script is obsolete now

This script is pretty much obsolete now and has been superseded by my MoveIT script that can do everything that this one can, and much more. See http://steamcommunity.com/sharedfiles/filedetails/?id=461120531&searchtext=

Of you course you can still continue to use this one if you really want, its not going away or something.







Using this script, you can accurately rotate a rotor by exactly 90 degrees - or 45° or 30° or whatever you desire.
For example, you can use it for 90° turns. If the rotor is initially at 0°, you can go to 90° with one button click. Second button click will bring it to 180°, third to 270° and fourth will bring it back to 0°.

I used a simpler version of this to build the Gatling Grav Gun on my Vendetta Battleship, which required precise 90° turns to fire safely. I'm sure you will find many other potential uses for this script.

The script used in the Vendetta Battleship can do only thing - rotate one specific rotor by 90° degrees whenever run. This version is much more flexible, you can do 90°, 45°, 10°, whatever you desire. You can also do -90°,-45°, -10° to reverse the direction. Also, it is not limited to one specific rotor: you can rotate any rotor with only one programmable block, provided you know the name of the rotor and the programmable block has access to the rotor (must be on the same ship & ownership must be correct)

Setup

1. Build the rotor if you haven't already. Lets call it "MyRotor" for now.
2. Set the rotors upper limit and lower limit to exactly 0°. Remember, if you hold CTRL and click inside a slider, you can enter exact values.
3. Download the script from Steam Workshop and copy it into a programmable block. Lets call that programmable block "TurnIt" for now, although the name doesn't really matter.
4. Place a button panel somewhere.
5. Configure the first button to "Run" the "TurnIt" progammable block. In the argument, enter "90 MyRotor". The first part "90" means we want 90° turns. The second

part "MyRotor" means we want to turn the rotor named "MyRotor".
6. Press the button.
7. Thats it, the rotor should turn by 90° now. See the "arguments" chapter for further usage examples.

Also, check out the video for further examples.

Demoworld

If you want, you can try out the script in my crappy demo world first before you add it to your own world, see here

Arguments

Since Space Engineers latest 1.082 update, one can specify command arguments to Programmable Blocks. This is basically just a line of text you can enter when you put the "Run" command of a programmable block in you button panel or a cockpits command bar. In this script, the command argument controls how much the rotor is turned and which rotor is turned.


Argument Examples:

"45 MyRotor" Turns the Rotor named "MyRotor" by +45°
"-45 MyRotor" Turns the Rotor named "MyRotor" by -45° (same as above, just to the other direction)
"90 My awesome rotor" Turns the Rotor named "My awesome rotor" by 90°.
"22.5 MyRotor" Turns the Rotor named "MyRotor" by 22.5 degrees.
"90 RotorGroup" Assuming "RotorGroup" is a group with some rotors in it: turns those Rotor by +90°


So the first parameter is the desired rotation, the second is the name of the rotor (or the name of a group that has rotors in it).

Use point as decimal separator for the rotation, so "22.5" as usual in english. NOT "22,5" like it is used in many other languages.
Also, using arguments doesn't seem to work in timer blocks right now (see "Known Bugs" chapter)

Troubleshooting - typical problems with this script

If you have followed the Setup Steps above, and the rotor doesn't turn please check the following things:


- Does the programmable block print out any exception in the menu? If so, this might help you to find the problem. To get a programmable block working again after a exception you also need to hit "edit" and "remember & exit".

- Check the name of the rotor in the programmable block arguments. If its spelled wrong, stuff won't work and a expection is printed in the programmable blocks menu

- Ownership issues. The rotor and the programmable block must have the same owner (or maybe access via share options). Otherwise the programmable block can't do anything with the rotor.

- Are ingame scripts enabled? In Single Player, please check the "In-Game Scripts" checkbox in Edit Settings -> Advanced of your savegame. In multiplayer: some servers have ingame scripts disabled. Unless you are the admin, you are out of luck.

- did you use the script in a timer block? See "Known Bugs" section

Known Bugs

Using this script in timer blocks doesn't work right now.
The problem isn't my script, the problem is Space Engineers - you can setup arguments in timer blocks, but they never get passed to the programmable block. Therefor my script fails.
There is nothing I can do about it, other than reporting it on the Bug forum (which I already did).

"License"

Use this in any SE creation you want. If you include the script in anything you publish on the Steam Workshop, please link back to this Page in your description.
Thats all!

Mod compatibility

This script works fine without any mods whatsoever, but it can also work together with any mod that functionally counts as rotor.
Here are the ones I have tested:

Conveyor Hinge by Digi. Technically, this is a rotor that refuses to go below -90° or above +90°.