## Description Multishot is a mod primarily meant for making timelapses or otherwise taking screenshots automatically, with a pre-set interval between the screenshots. It also has some other features that might be useful when making timelapses or other videos, such as a few different motion modes (linear, circle, path) and a basic zoom functionality. Starting from version `3.2.0`, Multishot now also has a free moving camera mode, which means that you can easily timelapse yourself building stuff even in single player. This version of Multishot (v3.x.x) is completely rewritten from scratch for Forge/FML. This means that it should now be compatible with most other mods that are written for Forge. In other words, now you can finally start making those timelapses in FTB or other modpacks! (provided that Forge is installed)

Quick Howto

To start making timelapses, you should first configure Multishot the way you want to make your timelapse. The most important settings are the Interval, which is the time between screenshots, the target directory where the screenshots will be saved, the image format/compression, and whether you want to use the automatic motion options. Good starting values are about 1.0 seconds for the interval, and if you have plenty of disk space available, leave the image format as PNG. (PNG is a lossless format, so it offers the best quality of the available options. The JPG format with the different compression values can save you some disk space and are a fair bit faster to save/compress, but they usually look a lot worse, especially with lower quality options.) I wouldn't go below 0.5 seconds for the interval, especially if you are using PNG as the format, because unless you have a fast computer, it might not be able to save the previous screenshot before the next one is due. Also, you'll just end up with a huge amount of screenshots and a lot of disk space used. Also make sure to set `Multishot Enabled` to ON, and also `Motion Enabled` to ON to be able to use the hotkeys. Those just enable the hotkeys, they do not mean that the multishot or motion modes are always on. It is also probably a good idea to turn `Lock Controls` to ON, so that you don't accidentally change the camera angle or position while recording. When all that is done, you can start taking multishots using the `Multishot Start/Stop` hotkey (default: `M`), or if you also want to use the motion feature, just start the motion (default key: `N`), and the multishot mode mode will also start, if the Interval has been set. You can hide the Multishot GUI/HUD either on its own with the Multishot Hide GUI hotkey (default: `H`), or by hiding the Minecraft HUD with `F1`. Multishot also includes a few slightly different, simple options to automatically stop the recording and/or motion after some criteria is met. The four options are: `OFF`, `Video`, `Real` and `Shots`. - `OFF`: Don't stop automatically, stop the recording and/or motion manually. - `Video`: Stops after the required number of screenshots have been taken for the requested length of final timelapse video time (**NOTE:** assumes 24 fps/24 screenshots per second of video. If you use for example 30 fps, you need to calculate the required number of screenshots yourself and use for example the `Shots` option instead.) - `Real`: Stops after the set amount of "real time" has passed, so the time you have been recording, regardless of how many screenshots have been taken in that time. - `Shots`: Stops after the requested number of screenshots have been taken. Note that the `Video` and `Real` time options have their own separate time settings! ### Tip for single player recording: If you use two instances of Minecraft on the same computer (often the case for recording timelapses in singleplayer worlds with a separate camera and the main player), be sure to toggle ON the feature where the game does not pause when losing focus, by pressing `F3 + P`. When it is ON, you should be able to Alt + Tab out without the game going into the pause/main menu screen. Starting from Multishot version `3.2.0`, there is no need to use two clients anymore. See the free camera mode.

## Free camera mode Starting from version `3.2.0`, Multishot now has a free moving camera mode, so you can easily record yourself from another viewpoint. Note that this is limited to what your client has currently loaded, so you can't record in unloaded chunks. The way this works, is that in the path mode the camera moves along the path as you would expect. In the Linear and Circle modes the camera starts from where your player is when you start the motion. You can enable/disable the free camera mode and set the recording resolution in the Multishot menu, on the Camera tab.

Here is an example of reasonable basic settings

![Example Settings](http://i.imgur.com/4WYer5t.png "Example Settings")

Some examples of paths

![Path Example 1](http://i.imgur.com/OiWBPTz.png "Path Example 1") ![Path Example 2](http://i.imgur.com/orDoElb.png "Path Example 2") ![Path Example 3](http://i.imgur.com/2dOETVD.png "Path Example 3")

## Multishot hotkeys Here are all the multishot hotkeys and their default values. They can be changed via the regular Minecraft Options => Controls menu. - Multishot options menu (default: `K`) - Start/stop recording (default: `M`) - Start/stop motion (default: `N`) - Pause/unpause the recording, preserving the image counter and save directory (default: `P`) - Lock/unlock controls (default: `L`) - Hide/show the Multishot GUI (icons and messages and path markers) (default: `H`)

Additional hotkey combinations for controlling the motion settings

### Circle and ellipse modes: - `HOME + Pause key` (pause default: `P`): Set the center point, around which the motion happens - `END + Pause key` (pause default: `P`): Set the target point, where the camera is pointed at the whole time when moving - `HOME + DEL + Pause key` (pause default: `P`): Remove the center point - `END + DEL + Pause key` (pause default: `P`): Remove the target point ### Path modes: - `Ctrl + Motion key` (motion default: `N`): Move to the path start point - `Shift + Motion key` (motion default: `N`): Move to the closest (= hilighted) point - `HOME + END + Pause key` (pause default: `P`): Reverse the travelling direction of the currently selected path - `END + Pause key` (pause default: `P`): Set the target point, where the camera is pointed at the whole time when moving - `END + DEL + Pause key` (pause default: `P`): Remove the target point - `Pause key` (pause default: `P`): Add a new path point to the player's current location, including the camera angle - `INSERT + Pause key` (pause default: `P`): Insert a new path point AFTER the hilighted point - `INSERT + HOME + Pause key` (pause default: `P`): Insert a new path point BEFORE the hilighted point - `Ctrl + Multishot Menu Key` (default: `K`): "Cut" (= store) the nearest path point (or more precisely, the index/id of it) - `Ctrl + Pause key` (pause default: `P`): Move (or more precisely, re-create) the previously stored path point to the player's current location - `DEL + Pause key` (pause default: `P`): Remove the closest (= hilighted) path point - `Ctrl + DEL + Pause key` (pause default: P): Remove all path points from the current path - `UP + Pause key` (pause default: `P`): Change to the next path (`+1`) - `DOWN + Pause key` (pause default: `P`): Change to the previous path (`-1`) - `UP + DOWN + Pause key` (pause default: `P`): Reload the current path from file

Multishot options menu keys and tips

To change the multishot options through the options menu, here are the useful buttons and modifiers. The amounts are relative to the smallest unit of change: - `Mouse Left` or `scroll up`: `+1` - `Mouse Right` or `scroll down`: `-1` - `Ctrl + Mouse Left` (or scroll up): `+10` - `Ctrl + Mouse Right` (or scroll down): `-10` - `Shift + Mouse Left` (or scroll up): `+100` - `Shift + Mouse Right` (or scroll down): `-100` - `Ctrl + Shift + Mouse Left` (or scroll up): `+1000` - `Ctrl + Shift + Mouse Right` (or scroll down): `-1000` - `Mouse Middle`: Reset the value to default - `Ctrl + Mouse Middle`: invert the value (`+/-`) - Setting the target directory is currently done as follows: - Copy the full path to the target directory to your clipboard - Right click on the "Paste Path" button - The path should then be displayed above the Back To Game button in a small font - (Middle clicking the "Paste path" button resets the path to the default value) - Copying the path to clipboard in Windows 7: - Go to the target directory in Explorer - Copy the full path to clipboard by right clicking the directory in the top location bar and selecting "Copy address (as text)" - Alternatively just write the path on any text editor, select it and copy it

About the motion modes

First select the motion mode you want to use from the Multishot `Motion` menu. The `Speed` setting in the menu is shared between the `Circle`, `Ellipse` and `Path` modes. `Linear` mode uses the separate per-axis settings. - `Linear` mode - Simple constant, linear change along the x-, z- and y-axes and constant rotation left/right (yaw) and up/down (pitch), according to the settings. - `Circle` mode - For travelling around a center point, for example when timelapsing the construction of a building. - Set the center point by moving the player to that spot, and press `HOME + Multishot pause key` (default: `P`). You will get a blue marker. - Set the point you want the camera looking at when moving, again by moving the player to that spot and pressing `END + Multishot Pause key`. You will get a red marker. - You can also use the circle mode without the target point set, then the camera rotation is not changed while moving. - The movement speed is the `Speed` setting in the Motion menu. - The radius is defined by the distance from the player to the center point when you start the motion. In other words, you are on the circle when you start the motion. - `Ellipse` mode - TODO - `Path` modes - Note: `Path (smooth)` mode motion calculation and movement is TODO/WIP. - 'Path (linear)' mode moves in a straight line between two points. 'Path (smooth)' mode is meant to calculate a smooth curve along the defined points. - You can add path points by moving the player to the spot you want, including the camera angle, and pressing the `Multishot Pause key` (default: `P`). - After adding a point you will get a marker and a line indicating the camera looking angle. - The point/marker that you are closest to is highlighted by rendering it as yellow. Useful when deleting, moving or inserting points/markers. - You can insert new points in the middle of a path with `INSERT + Multishot Pause` key (default: `P`) or `INSERT + HOME + Multishot Pause key` (default: `P`). - You can reverse the path traveling direction of the selected path with `HOME + END + Multishot Pause key` (default: `P`). - You can optionally add a "global" target point by moving the player to that spot and pressing `END + Multishot Pause key` (default: `P`). - If a target point has been defined, all the camera angle indicator lines will go to that target point. - You can remove the target point by pressing `END + DEL + Multishot Pause key`. - If no global target point is defined, the camera will turn smoothly from the per-point angle to the next point's angle on the way between the points. - When you start the motion in path mode, you will first be moved to the path start point, and then the motion (and recording, if interval is not OFF) will start.