Releases: Flohhhhh/ultimate-lighting-controller
v1.8.0
What's New
True Stages from #32
This version of ULC adds a new feature named "stages" which finally adds support for proper cyclical stages. You can now define which buttons will be handled as "stages" which will change their behavior to behave properly. If you're wondering what "behave properly" means, see below.
What's the difference between a normal button and a stage?
The only real difference is that when a button is defined as a stage, it will check the state of the other buttons defined as stage to know what should happen when it's pressed.
Read more and see examples in the documentation
ulc.lua addition
stages = {
useStages = true,
stageKeys = {1,2,3},
},Adding this to your ulc.lua is not mandatory. You do not need to update your existing configs unless you want to use this feature.
Disable extras with horn from #12
Added ability to disable extras while horn is active instead of just enable them.
Disable extras with reverse from #13
Added ability to disable extras while horn is active instead of just enable them.
Smart timer for reverse feature from #24
Added a smart timer to the reverse feature to disable extras after a random amount of time. This is to simulate more realistic behavior where the driver would shift out of reverse after some time.
Settings for this were also added to the config.lua so you can disable the effect or change the duration.
Config Addition
-- Reverse Extras/Patterns Config;
ReverseSettings = {
-- these options control the expiration of the reverse extras
-- if enabled, reverse extras will turn off after a random time between min and max
-- this is to simulate more realistic behavior where the vehicle would shifted out of reverse
-- after being stopped for some time
useRandomExpiration = true,
-- minimum time in seconds extras will stay on after stopping
minExpiration = 3,
-- maximum time in seconds extras will stay on after stopping
maxExpiration = 8,
},This is not mandatory, if you don't add this section to your config.lua it will just use default values.
What's Changed
- Fixed an issue where players could control the lights from outside the car, or in another car. From #22 and #23
- Removed misleading instructions in config
- Variable name fix by @LucasStriker in #29
- Improved warnings for button text
New Contributors
- @LucasStriker made their first contribution in #29
Links:
Full Changelog: v1.7.1...v1.8.0
Contributors
Assets 3
v1.7.1
This is a bug fix release. See the latest full release for more details about the latest changes.
Bug Fix
- Fixed a missing variable causing an error
Links:
Full Changelog: v1.7.0...v1.7.1
v1.7.0
What's New
- Added ability to disable extras with brakes (rather than only enable)
- Added
/blackoutcommand - Moved to
onesyncfor load state management (more reliable)
Disable extras on brake
ulc.lua configs can now accept extras to disable in the brake section along with enabling extras!
Config Change
disableExtras field has been added to brakeConfig
brakeConfig = {
useBrakes = false,
speedThreshold = 3,
brakeExtras = {},
disableExtras = {}
},This is not mandatory. You do not need to update your existing configs unless you want to use this feature.
Bug Fixes
- Fixed a bug causing
GetVehicleCurrentGear: No such entityto spam in the console.
Links:
Full Changelog: v1.6.2...v1.7.0
v1.6.3
This is a bug fix release. See the latest full release for more details about the latest changes.
Bug Fix
- Fixed a bug that allowed control of lights while not in the vehicle
Links:
Full Changelog: v1.6.2...v1.6.3
v1.6.2
Bug Fixes
- Fixed door extras not working after driver exited vehicle
- Fixed an issue causing default stages to not trigger repairs for stages that need it
- Fixed an issue causing buttons to not properly apply repair to linked extras, opposite extras, etc.
- Fixed a bug causing default stages to trigger when entering vehicle (even if light state didnt change)
- Fixed a bug causing brake extra event to always fire (just a tiny performance improvement)
- Hid some errors that actually don't matter
Links:
Full Changelog: v1.6.1...v1.6.2
v1.6.1
What's New
- Added door extras!
- Fixed an issue where HUD would always be disabled the first time a client loads the resource
- Added a 2 second delay to park patterns
- Fixed an issue where park pattern sync would enable sirens on cars which did not already have them on
- Added a prompt to use
/ulcon the first load of the resource.
Door extras
ulc.lua configs can now accept door extras!
Door extras can enable or disable an extra while doors or the trunk are open.
Config Change
doorConfig = {
useDoors = false
driverSide = {enable = {}, disable = {}},
passSide = {enable = {}, disable = {}},
trunk = {enable ={}, disable = {}}
},This is not mandatory. You do not need to update your existing configs unless you want to use this feature.
Links:
Full Changelog: v1.6.0...v1.6.1
v1.6.0
What's New
- Fully redone UI and HUD
- Client settings, including positioning the HUD, and disabling the HUD.
- Colored buttons
- Repair workaround option on stage buttons for extras with collisions
- ULC now properly activates if you change from another seat to the driver seat.
UI OVERHAUL
ULC now features a more realistic HUD, as well as a interactive settings menu! Enjoy!
Colored Buttons
Buttons can now have a color field!
Currently available colors:
- Green
- Blue
- Amber
- Red
Config Change
Stage buttons will now accept a color field.
{label = 'STAGE 2', key = 5, extra = 8, color = 'green', linkedExtras = {}, oppositeExtras = {}, offExtras = {9}, repair = false},This is not mandatory. You do not need to update your existing configs unless you want to use this feature.
Repair Force for Stages
Stage buttons can now be set to repair the vehicle when toggled. This is important for any extras that are high-poly or have collisions. The ideal way to deal with this is to not include collisions in your lighting extras, but in the case that you have them, setting repair to true will resolve this.
These stages cannot be changed while the vehicle is damaged or while a door is open.
Config Change
Stage buttons will now accept a repair field.
{label = 'STAGE 2', key = 5, extra = 8, color = 'green', linkedExtras = {}, oppositeExtras = {}, offExtras = {9}, repair = false},This is not mandatory. You do not need to update your existing configs unless you want to use this feature.
Links:
Full Changelog: v1.5.0...v1.6.0
v1.5.0
What's New
- Added a Default Stages feature to handle stages when lighting is activated
- Added "Opposite Extras" to stage buttons that toggle to opposite state of the button
Default Stages
Default stages allows you to specify stages created as Stage Buttons that will either be enabled or disabled when the lighting is activated on the vehicle.
For example, you can set it so that the Stage Button associated with the numpad key 1 always enables when the vehicle lighting is activated.. This includes any linked extras etc.
Config Change
ulc.lua configurations will now accept the "defaultExtras" object.
defaultStages = {
useDefaults = false,
enableKeys = {},
disableKeys = {}
}Opposite Extras
Opposite extras are a feature of stage buttons. Extras in this field will toggle to always match the OPPOSITE of the state of the button. If the button is switched on, these extras will switch off. Opposite extras are very similar to offExtras with the exception that offExtras will not be toggled back on when the state is turned off.
Config Change
Stage buttons will now accept opposite extras field.
{label = 'STAGE 2', key = 5, extra = 8, linkedExtras = {}, oppositeExtras = {}, offExtras = {9}},This is not mandatory. You do not need to update your existing configs unless you want to use this feature.
Links:
Full Changelog: v1.4.0...v1.5.0
v1.4.0
What's New
- ULC config file generator
- Re-factored most features
- New method for handling auto repair (now works perfectly for all features!)
- Fixed various bugs with brake extras
- Vehicles now automatically sync park patterns with others of the same model (when sync is enabled)
- Fixed an issue preventing cruise lights from properly disabling when lights are on
- Buttons will now properly always sort themselves on the UI by key
- Added various helpful errors and warnings
Notes on auto-repair
I added a new method to disable vehicles automatically repairing when an extra changes.
- Vehicles do not repair when an extra is changed with ULC
- Syncs across network (no one else will see your vehicle repair when ULC changes an extra)
- Manually adding extras with menus still repairs vehicles (this syncs to all clients as well)
I'm very happy with the new system, and it seems to work flawlessly so far!
ulc.lua Config Generator
The new ulc.lua generator allows you to quickly and easily generate ulc.lua files without the risk of syntax errors!
Visit https://ulc.dwnstr.com/ to check it out!
Links:
Full Changelog: v1.3.5...v1.4.0
v1.3.5
Fix for park patterns repairing vehicle when it's damaged.
This is a bug fix release. See the latest full release for more details about the latest changes.
Alternatively, you can see an up to date list of all changes since the the previous full release here
Full Changelog: v1.2.2...v1.3.5