EvLightning
EvLightning copied to clipboard
evaera
EvLightning is a Roblox Lua library. Its purpose is to generate realistic-looking lightning bolts. This could be used to easily add lightning strike effects to any game
EvLightning
EvLightning is a Roblox Lua library that aims to generate realistic-looking lightning bolts. This could be used to easily add lightning strike effects to your game.
Usage
local LightningBolt = require(path.to.EvLightning)
local myBolt = LightningBolt.new(Vector3.new(0, 400, 0), Vector3.new(0, 0, 0), {
color = BrickColor.new("Really red");
-- More options are available, see below...
})
myBolt:Draw(workspace)
A lightning bolt is split into lines, and where the lines meet is considered to be a "bend". At each bend, there is a chance to create a fork, which will create another bolt with its own bends, which in turn have chances to create their own forks, etc. You can control how many bends are in the bolt and the chance of creating a fork at each bend.
API
LightningBolt LightningBolt.new(Vector3 from, Vector3 to[, dictionary options])
Returns an instance of LightningBolt. Automatically generates in the constructor, but further methods must be called on the returned instance to render the bolt.
Options
There are a number of options that you can pass in a third argument to LightningBolt.new in the form of a table dictionary. All options are optional, and have default values.
| Option name | Description | Default value | Type |
|---|---|---|---|
| seed | A numerical seed which could be used to generate the same lightning bolt across a network. | Random | Number |
| bends | The number of bends the main bolt should have. | 6 | Integer |
| fork_bends | The number of bends to put into forks off of the main bolt. | 2 | Integer |
| fork_chance | The chance to create a new fork off of each bend. (0-100) | 50 | Number |
| transparency | The transparency of the main bolt. Transparency is reduced at every fork. | 0.4 | Number |
| thickness | The thickness of the main bolt. Thickness is reduced at every fork. | 1 | Number |
| max_depth | The maximum depth that forks can reach off the main bolt, which is depth 0. | 3 | Integer |
| color | The color of the bolt | White | BrickColor or Color3 |
| material | The material of the bolt | Enum.Material.Neon | Enum.Material |
| decay | The number of seconds for the bolt to exist after being drawn. | Infinite | Number |
Note that the fork_chance option is not an equal chance for every bend in the bolt. The chance is distributed in a gradient down the length of the bolt, meaning that if the fork_chance is 50, then at the very top it will be 0, at the middle it will be 25, and at the very bottom it will be 50. This is done so that less forks are generated towards the top, which makes the bolt look more realistic. If you need to create upwards-forking lightning, then simply reverse the to and from arguments.
void bolt:Draw([Instance parent = Workspace])
Draws the lightning bolt in the world with the given options. An optional argument, parent, can be passed, which will be the parent of the generated lightning bolt parts. If this argument is omitted, there will be a new model created in Workspace containing the bolt parts.
array bolt:GetLines()
Returns a table of tables, containing the line information. The member tables have the keys origin, goal, and depth. This is only necessary if you want to draw the lightning bolt manually (i.e. not calling Draw).
{
{
origin = Vector3 origin,
goal = Vector3 endpoint,
depth = Number depth
},
{
origin = Vector3 origin,
goal = Vector3 endpoint,
depth = Number depth
},
-- ...
}
void bolt:Destroy()
If the lightning bolt has been drawn, this method will destroy the model that was created.
dictionary bolt:GetOptions()
Returns a table of the options that were passed into the constructor. Default values are not applied here.
bool bolt:IsDestroyed()
Returns true if the lightning bolt has either been destroyed or has decayed.
bool bolt:IsDrawn()
Returns true of the Draw method has been called on this particular instance.
evaera