FS-Blackout
Toggle synchronized world-light blackouts while leaving vehicle lights unaffected.
Start Here
- Start FS-Lib, then FS-Blackout.
- Decide who may use the blackout command.
- Run
/worldblackout, then run it again to restore normal lighting.
Expected result: artificial world lights flicker and switch off for connected players; vehicle lights remain unaffected. Players joining during a blackout receive its current state.
Installation
Copy the built FS-Blackout release into your resources directory. The server code calls FS-Lib for its startup version check, so start FS-Lib first even though the current manifest does not declare it as a dependency.
ensure FS-Lib
ensure FS-BlackoutNo framework or database is used by the current source. FS-Weather is an optional consumer of the blackout exports.
Configuration
Edit the installed config.lua, then restart the resource.
| Setting | Default | Meaning and when to change it |
|---|---|---|
Config.Command | worldblackout | Toggle command without a slash. Rename to avoid a command collision. |
Config.AcePerms.Enabled | false | Everyone can toggle by default. Enable for staff-only control. |
Config.AcePerms.PermissionRequired | worldblackout | ACE checked when restrictions are enabled. Change only to match your permission scheme. |
For staff-only use, change the existing setting and grant the permission to your intended group:
Config.AcePerms.Enabled = trueadd_ace group.admin worldblackout allowFlicker timing is internal server behavior, not an exposed config.lua setting. Blackout state starts false when the resource starts; there is no persistent database state.
Usage
- Run
/worldblackoutas a permitted player, orworldblackoutfrom the server console. - Allow the transition flicker to finish. While active, periodic flicker bursts are expected.
- Run the command again to restore normal lighting. A new toggle cancels an older in-progress transition.
Troubleshooting
The command is denied
Check AcePerms.Enabled, the permission string and group membership. Server-console calls are allowed by the current implementation.
Lights change back unexpectedly
Check for another script controlling artificial lights or calling the blackout exports, including storm-blackout integration. Vehicle lights staying on is intentional.
Startup reports a missing FS-Lib export
Install/start a compatible FS-Lib before FS-Blackout. Its documentation may be temporarily unavailable, but the dependency remains required by the startup code.
Advanced reference
See server exports for explicit state control.