These docs describe 1.3, which is in testing. The version on Fab is 1.1: read its docs.

1.3 is the shake and lock-on update, and everything else since 1.1. There was never a 1.2 on its own: it grew into this. Most of the move happens by itself as your project loads, and the rest is one menu item and a save.

• 1

  Back up the project.

  1.3 saves assets in a newer format that 1.1 can't read, so the backup is your only way back.

• 2

  Install 1.3.

  Update Blendable in the Epic Games Launcher, or, if it's in your project's own Plugins folder, close the editor and replace the Blendable folder there.

• 3

  Open the project.

  Everything loads as it was. 1.1's assets find their new names by themselves, Camera Effects loads as Blendable Shake and Camera Directors as Points Of Interest.

• 4

  Convert your pawns.

  Choose Tools → Blendable → Convert Camera Effects. It turns every Blueprint's 1.1 effects settings into shakes saved beside it, sets its Blendable Shake up to play them, and lists anything that didn't carry over exactly.

• 5

  Read the list.

  Most entries are information rather than problems. The one to act on is below.

• 6

  Save everything.

  File → Save All. Assets update as they load, every time, until they're saved in the new format.

• 7

  Fix paths written as text.

  A redirect can't reach a path typed into code or a Load Asset node. Renamed assets, below, has every old name and its new one.

Coming from 1.0? The same steps work. 1.1's own changes migrate on load too, and its notes are in the changelog.

What you'll notice#

Shakes#

• Everything reaches the screen by itself. Output Via Camera Modifier is gone; the camera owns the output, and there's no box to tick.
• A shake is a stack of layers. Shakes explains them. Your 1.1 shakes were converted to the size they actually showed at 60 fps, so nothing on screen changed size.
• The handheld lives on the Rig. Every Rig has a Handheld slot that blends with the shot. 1.1's ambient shake is Also Running, beside it. See handheld and body motion.
• Camera profiles are Body shakes. Everything a profile held, bob, sway, lean, landings, is a Body shake on the pawn now. The 1.1 profiles are in the plugin's Legacy folder.
• Each shipped style brings its own shakes. So the shipped Rigs' Handheld Ambient Scale is back to 1.0, where 1.1 had turned your pawn's handheld up to 2 or more. Under the shipped Rigs, your Body shakes now play at the size you made them.
• Two nodes have new names. Set Shake Intensity is Set Shake Scale, and it eases instead of stepping. Play World Shake is Play Shake At. The old names still work and are marked deprecated.
• Footstep and foley audio have left Blendable. The classes still load, marked deprecated. On Footstep still fires with the foot, speed, surface and location, so play your own audio from there.
• Peek and the crouch correction moved to Blendable Shake, unchanged.

The camera#

• Other characters no longer push the camera in. In a fight, the camera used to duck in front of whoever crossed behind you. Characters are now left out of every check the camera makes. Tick Characters Block The Camera for the camera as it was.
• Panels read broad to fine. Every Blendable asset opens on what matters most, one line per feature with its switch. Only the panels moved: saved assets and Blueprints are untouched. See the panels.
• Two Subject Framing moved off the Rig, onto whatever asks the camera to frame a second subject. A Rig whose values you changed passes them on as it loads.
• The same setting reads the same everywhere. A point of interest's aim uses the lock-on's words, like Turns To Look and The Character Faces. Only the names changed.

Lock-on#

• Nothing changes until you choose a Lock-On Preset. The lock-on component's own Rig and point of interest preset are under Without A Preset now, and they frame the lock exactly as before for as long as no preset is set. See lock-on presets.
• Targeting has its own module, BlendableLockOn. Pawns keep their settings, Blueprints their nodes and events, and C++ that includes BlendableLockOnComponent.h compiles as before.

Names#

• Camera Directors are Points Of Interest. The component, the actor, the preset and the nodes all say so. Saved levels, presets and Blueprints load as they were, and C++ keeps the Director class names.
• Shipped content has readable names in a folder per style. PCP_ is Preset_, PCR_ is Rig_, PCD_ is PointOfInterest_ and SHK_ is Shake_, so PCR_SH_Aim is Rig_SurvivalHorror_Aim. Each style's folder under Presets holds its preset, its Rigs, its shakes and its Lock-On Preset.

Renamed assets#

Every asset 1.1 shipped, and where it lives now in the plugin's content. References saved in your assets follow these by themselves; only a path written out as text needs the new one.

Known issues#

• A pawn placed in a level with its own 1.1 values isn't converted by the menu. The menu converts Blueprints. An instance that overrides the old settings converts itself each time it plays, which works but isn't saved. Reset those overrides on the instance and it uses its Blueprint's converted settings.
• Shakes played through Unreal's own shake system can't see the Blendable camera. Drivers that need it, such as camera speed, effort or the stride, read as standing still there. See shakes in the world.

The changelog has everything else, from the new presets to every fix.