Cyber Arsenal: Sci-Fi Weapon FX

LarkLab in Simulations & Effects


Documentation  /  v1.0.1

CYBER ARSENAL DOCS

How to install Cyber Arsenal, add a weapon to a gun, time the shot, attach modules and render it. The add-on lives in the Cyber Arsenal tab of the 3D Viewport sidebar (N). Blender 5.0+, EEVEE and Cycles.

Guide

INSTALL, UPDATE, REMOVE

  1. Download cyber_arsenal-1.0.1.zip from your Superhive downloads. Don't unzip it.
  2. In Blender open Edit › Preferences › Get Extensions, open the arrow menu at the top right, choose Install from Disk… and pick the zip.
  3. In the 3D Viewport press N and open the Cyber Arsenal tab.

Update: install the new zip the same way. Shots already in your files keep working.

Remove an effect: click it in the Effects in this scene list, then press Remove Effect at the bottom of the Shot panel. It deletes the effect, its ledger, its lights and its modules, including the heat modifier on the barrel. The Muzzle, the Target and any vent, port or emitter empties stay, so delete those by hand if you no longer need them.

Guide

ADD A WEAPON

Cyber Arsenal sidebar

1. Place the 3D cursor on the barrel tip, rotated so its +Y points where the gun fires (Shift+S › Cursor to Selected, or snap it while dragging). Add Weapon turns that +Y into the Muzzle's +Z, the axis every weapon fires along.

2. Pick a weapon in the picker and click Add Weapon. You get CA Muzzle at the cursor, CA Target 6 m ahead and the effect object, already baked. The Fire Time starts at the current frame, or at Charge Time + 0.5 s if that is later.

3. Parent the Muzzle to your gun (Ctrl+P) or to a hand bone. Move the Target to aim, or clear it in the Shot panel to fire along the Muzzle's +Z to the first surface.

With an effect selected, the picker's button turns into Attach to Active Effect for modules.

Guide

THE MUZZLE CONVENTION

Every weapon and module reads the same empty. If you place or rotate it by hand, keep these axes:

+Z Down the barrel, the direction the shot travels
+X Down (toward the grip)
+Y To the left of the gun
Heat-Sink port Made at (-0.012, -0.032, -0.55) in Muzzle space, pointing right and slightly up; move it to your ejection port
Laser emitter Made at (0.035, 0, -0.12) in Muzzle space, under the barrel
Overheat vents Made on the barrel mesh: its local +Z runs breech to tip

Guide

SHOT PANEL

Shot panel
Fire Time When the shot fires, in seconds. The charge plays before it.
Fire Here Sets Fire Time to the playhead.
Fire · Aim · Look The main inputs of the selected weapon (shots, rate, spread, scale, intensity, colour).
Movers A collection of moving objects. Hits on them ride along.
Re-bake Re-runs the aim and the hits now.
Auto Re-bakes on its own when the Muzzle, the Target, their parents or a setting changes. It waits while you drag, play or render. If you move a wall or another surface, press Re-bake.
Status How many shots are baked and how many reached a surface; a warning when something changed since the last bake.
Select Muzzle · Target Selects the empties of this shot, ready to move.
Remove Effect Deletes the effect, its ledger, its lights and its modules. The Muzzle and Target stay.

Guide

WEAPON CONTROLS

The sidebar shows the main inputs. Every input is in the modifier panel (Properties › Modifiers › Cyber Arsenal), grouped by beat:

Fire Fire Time, Shots, Rate (rpm), Charge Time, Speed (m/s), Seed
Aim Muzzle (+Z down the barrel), Target (optional), Spread (degrees)
Look Scale, Intensity, Color
Charge · Fire · Travel · Hit Per weapon, closed by default (see below)
Binding Ledger, Camera, Probe and FPS are set by the add-on. Set Movers for moving targets, and set Floor to your floor height if it is not at Z 0, so debris lands on it.
Plasma Rifle Pinch, Core Size, Motes · Flash Size, Puff · Bolt Length, Bolt Width, Streak, Wake · Splash Size, Droplets, Mark Size, Smoke
Railgun Coils, Coil Spacing, Barrel Radius, Arcs, Rail Gap · Flash Size, Debris, Sabot, Smoke · Core Life, Trail Life, Trail Width, Helix, Helix Pitch, Drift · Spall, Mark Size, Smoke
Pulse Blaster Lens Size · Burst, Burst Pause, Flash Size, Wisp · Bolt Length, Bolt Width, Streak, Ricochet · Pit Size, Droplets, Smoke
Scatter Cannon Ports, Face Radius · Flash Size, Smoke · Pellets, Choke, Pellet Size, Pellet Length, Streak · Crater Size, Smoke
Heat Ray Lens Size · Hold, Kick Size · Beam Width, Shimmer · Spot Size, Max Temperature, Heat Time, Cool Time, Ignite, Flames, Smoke, Shimmer
Flechette Launcher Spark Size, Hiss · Needle Length, Streak · Embed, Tilt, Cool Time, Scorch Size, Smoke, Charged, Pop Delay, Pop Step, Pop Size, Drops
Airburst Round Flash Size, Smoke · Range, Round Size, Trail · Burst Size, Fragments, Fragment Speed, Pock Size, Smoke

Guide

MODULES

Module inputs live in the Modifier tab of the object that carries them: CA Barrel Heat on your barrel, CA Vent Purge on CA Overheat Purge, CA Heat Sink on CA Heat-Sink Eject and CA Laser Sight on CA Laser Sight.

Select a weapon effect (click it in Effects in this scene), then press Attach next to a module in the Modules panel, or pick the module in the picker and press Attach to Active Effect. Remove it with the X.

Overheat Purge Needs the gun's barrel mesh (pick it under Barrel). The barrel's local +Z must run from the breech to the tip, with its origin at the breech. Heat builds per shot: with the default heat settings, a burst at 420 rpm reaches glow at about 6 shots and purges from 7, so raise Shots or Heat Per Shot. To see the glow, press Apply Heat Material in the Overheat Purge box. It replaces the barrel's own material until you press Restore Material or remove the module, and the glow starts at the muzzle end. The box says so when a burst is too short to purge. Purge Cooling sets how much heat the purge removes: lower it to keep the barrel glowing after the purge. For thin parts such as fins to glow first, give the barrel mesh a point attribute named ca_thin set to 1 on those parts; Thin Cool Time only acts on them. Inputs: Heat Per Shot, Cool Time, Thin Cool Time, Max Temperature, Purge Cooling, Length, Shimmer, Jet Time, Jet Speed, Steam, Puffs.
Heat-Sink Eject Ejects on the purge time, or a short delay after the last shot without a purge. Set Floor to your floor height if it is not at Z 0. Inputs: Speed, Lift, Spin, Start Temperature, Cool Time, Fin Cool Time, Length, Radius, Smoke, Floor.
Laser Sight Live every frame. Put the objects the beam can hit in a collection and pick it under Surfaces in the Laser Sight box. Inputs: Settle, Sway, Settled Sway, Haze, Color, Power, Dot Size, Beam Width, Motes, Range. The beam is meant to be seen in haze.

Guide

SURFACES

Hits read the surface they land on. By default a surface counts as painted: it blisters, chars and, under the Heat Ray, can catch fire. To make an object bare metal, select it and press Bare Metal in the Surface panel of the sidebar; every selected mesh changes and the shots re-bake. Bare metal shows heat tint and glows instead of burning. Press it again to go back to painted.

Guide

MOVING TARGETS

Put the objects that move in a collection and pick it as Default Movers in the sidebar (new weapons use it) or as Movers in the Shot panel. Hits, marks and hit lights are stored in the mover's own space and ride with it as the object moves and turns. They follow the whole object, so they do not stick to a deforming character.

Smoke and droplets that are already in the air when the target moves ride with it too. Keep fast movers away from long smoke, or lower Smoke.

Guide

DEMO SHOTS

The Demo Shots panel opens ten ready files, one shot each, with a camera: Plasma Rifle with Overheat Purge, Railgun, Pulse Blaster, Scatter Cannon, Heat Ray, Flechette Launcher, Airburst Round, Heat-Sink Eject, Laser Sight and a moving target. They use simple stand-in guns. Opening one doesn't re-bake anything.

Guide

RENDERING

EEVEE Fast. Flashes and hits light the set with keyed lamps. The Heat Ray's flames read as a soft glow.
Cycles Best for the Heat Ray flames, smoke and refraction. Use the same file.
Background renders The bake keys the lights, so command-line renders (-b) match the viewport.
Frame rate Timing is in seconds. Change the fps and press Re-bake (Auto does it for you).
Close cameras Hit lights are strong for one frame. On bare metal close to the camera, lower Intensity.

Guide

TROUBLESHOOTING

Nothing fires Check the playhead is after the Fire Time and the viewport is in Material Preview or Rendered.
The shot misses the wall The Target is set. Clear it in Aim to hit the first surface along the aim, then Re-bake.
Shot goes the wrong way With a Target set, shots fly at the Target, so move it. With no Target, the Muzzle's +Z must point down the barrel.
Changed since the last bake Press Re-bake, or turn Auto on.
Laser beam invisible Raise the Laser Sight's Haze input. It is an aiming beam, faint by default.
$13.90$9.73

Have questions about this product?
Login to message

Details
Blender Extension Compatible Yes
Published about 22 hours ago
Blender Version 5.0 - 5.2
Extension Type Add-on
Render Engine Used Cycles, Eevee
License GPL