Works with
Optional integrations and compatible files.
About JackhammerFlashlight
Add a fully functional flashlight to jackhammers in Rust.
Mining in dark caves or at night should not mean constantly switching between your jackhammer and a separate light source.
JackhammerFlashlight adds a toggleable flashlight to jackhammers, allowing players to mine while illuminating the area in front of them. Players can turn the flashlight on or off using the normal Rust flashlight key or simple chat commands, while server owners can configure battery duration, support for normal jackhammers, custom item skins, loot container drops, and optional battery status displays.
Perfect for PvE, PvP, Vanilla+, modded, survival, mining, and custom progression Rust servers.
Features
- Adds a fully functional flashlight to supported jackhammers.
-
Players can toggle the flashlight using the normal Rust flashlight key (
F). - Chat commands to toggle the flashlight, turn it on or off, and check battery charge.
- Flashlight follows the player's aim direction while holding the jackhammer.
- Special Jackhammer Flashlight item with a configurable display name and skin ID.
- Optional support for enabling flashlights on normal Rust jackhammers.
- Configurable battery duration with support for unlimited battery life.
- Battery charge decreases automatically while the flashlight is enabled.
- Battery consumption pauses when the flashlight is turned off.
- Remaining battery charge is preserved when the player switches items or puts the jackhammer away.
- Flashlight automatically turns off when its battery runs out.
- Players can check their remaining battery charge using a chat command.
- Optional SimpleStatus integration to display battery information while holding the jackhammer.
- Optional AdvancedStatus integration with battery countdown support.
- Battery display supports remaining time, paused charge, unlimited battery, and empty battery states.
- Configurable command aliases for player flashlight controls.
- Admin command to give special Jackhammer Flashlight items to online players.
- Supports giving multiple jackhammers with a single command.
- Admins can specify a custom battery duration when giving jackhammers.
- Optional automatic Jackhammer Flashlight drops from configured loot containers.
- Configurable loot container prefabs, drop chances, and minimum/maximum item amounts.
- Separate battery duration overrides for individual loot drop configurations.
- Automatically restores active flashlight functionality when players equip supported jackhammers.
- English and Russian plugin messages included.
Flashlight Controls
Players can control their jackhammer flashlight using the regular Rust flashlight key or chat commands.
| Control | Description |
|---|---|
| F Key | Toggles the flashlight on or off while holding a supported jackhammer. |
| /jf | Toggles the flashlight on or off. |
| /jf on | Turns the flashlight on. |
| /jf off | Turns the flashlight off. |
| /jf battery | Shows the remaining battery charge. |
Tip
Example: Hold a Jackhammer Flashlight and press F to turn on the light. Press F again to turn it off.
The flashlight follows your aim direction, allowing you to see where you are mining without switching tools.
Battery System
JackhammerFlashlight includes an optional battery system that allows server owners to control how long flashlights can remain active.
| Battery Setting | Description |
|---|---|
| Unlimited Battery | Flashlight can remain enabled without running out of charge. |
| Limited Battery | Flashlight operates for the configured number of seconds. |
| Battery Pause | Battery consumption stops when the flashlight is turned off. |
| Battery Depletion | Flashlight automatically turns off when its remaining charge reaches zero. |
| Battery Status |
Players can check their remaining charge using /jf battery.
|
Tip
Example: Set Battery Duration (seconds, 0 = unlimited) to 600 to give newly created Jackhammer Flashlight items 10 minutes of battery usage.
Set the duration to 0 for unlimited battery life.
Battery Status Integration
JackhammerFlashlight supports optional integration with SimpleStatus and AdvancedStatus to display battery information while players hold supported jackhammers.
SimpleStatus
- Displays battery information while holding a supported jackhammer.
- Shows a countdown when the flashlight is running on limited battery.
- Displays the remaining charge when the flashlight is turned off.
- Supports unlimited and depleted battery states.
AdvancedStatus
- Displays battery information using an AdvancedStatus bar.
- Supports a countdown for remaining battery duration.
- Updates the battery display depending on whether the flashlight is enabled or disabled.
- Automatically removes the status when the player stops holding the supported jackhammer.
Note
Integration Notes
- SimpleStatus and AdvancedStatus are optional integrations.
- Both integrations can be enabled or disabled in the configuration.
- When both are enabled and available, SimpleStatus takes priority.
-
Players can still use
/jf batterywithout either status plugin installed.
Loot Container Drops
Server owners can optionally configure special Jackhammer Flashlight items to appear inside Rust loot containers.
| Setting | Description |
|---|---|
| Enabled | Enables or disables the configured loot drop entry. |
| Prefab | Specifies the loot container prefab. |
| Chance | Sets the chance of adding Jackhammer Flashlight items to the container. |
| Min Amount | Minimum number of jackhammers added when the drop succeeds. |
| Max Amount | Maximum number of jackhammers added when the drop succeeds. |
| Battery Duration | Sets a custom battery duration for jackhammers generated by this entry. |
Multiple loot drop entries can be configured for different loot container types.
Tip
Example: Enable a loot drop entry for assets/bundled/prefabs/radtown/crate_normal.prefab and set its chance to 10 to give matching crates a 10% chance of receiving the configured Jackhammer Flashlight items when their loot spawns.
Note
Loot Battery Settings
-
-1- Uses the default battery duration from the main configuration. -
0- Gives generated jackhammers unlimited battery life. - Any positive value - Sets a custom battery duration in seconds for that loot entry.
Loot container drops are disabled by default.
Commands
/jf - Toggles the flashlight on or off while holding a supported jackhammer.
/jf on - Turns the flashlight on.
/jf off - Turns the flashlight off.
/jf battery - Shows the remaining battery charge.
Player flashlight command aliases are fully configurable.
Admin Commands
/jfgive <player name or Steam ID> - Gives one Jackhammer Flashlight to the selected online player.
/jfgive <player name or Steam ID> <amount> - Gives the specified number of Jackhammer Flashlights.
/jfgive <player name or Steam ID> <amount> <battery seconds> - Gives Jackhammer Flashlights with a custom battery duration.
Command Examples
/jfgive PlayerName /jfgive PlayerName 5 /jfgive "Player Name" 3 /jfgive PlayerName 1 600 /jfgive PlayerName 2 0
Note
Admin Command Notes
- Player names containing spaces must be placed inside quotation marks.
- The target player must be online and alive.
-
The default amount is
1. - Battery duration uses the main configuration unless explicitly specified.
-
Use
0as the battery duration for unlimited charge. - If the target player's inventory is full, additional jackhammers are dropped at their feet.
-
The
/jfgivecommand is available to Rust admins and players with the required permission.
Permissions
jackhammerflashlight.give - Allows non-admin players to use /jfgive to give Jackhammer Flashlight items to online players.
No permission is required to use the flashlight controls on supported jackhammers.
Rust admins can use /jfgive without being granted the permission separately.
Example Configuration
{ "Commands": [ "jf" ], "Enable Flashlight on Normal Jackhammers": false, "Item Name": "Jackhammer Flashlight", "Skin ID": 0, "Battery Duration (seconds, 0 = unlimited)": 0.0, "[SimpleStatus] Show Battery While Holding": false, "[AdvancedStatus] Show Battery While Holding": false, "Drop Settings": [ { "Enabled": false, "Prefab": "assets/bundled/prefabs/radtown/crate_normal.prefab", "Chance": 10, "Min Amount": 1, "Max Amount": 1, "Battery Duration (seconds, -1 = use default, 0 = unlimited)": -1.0 } ], "Config Version": { "Major": 1, "Minor": 0, "Patch": 0 } }
Note
Configuration Notes
- Commands: Configurable aliases for flashlight controls.
- Normal Jackhammers: Enables flashlight functionality for regular Rust jackhammers instead of only specially created Jackhammer Flashlight items.
- Item Name: Custom display name for generated Jackhammer Flashlight items.
- Skin ID: Custom skin ID applied to generated Jackhammer Flashlight items.
-
Battery Duration: Sets the default battery duration in seconds. Use
0for unlimited charge. - SimpleStatus: Enables battery display integration with SimpleStatus.
- AdvancedStatus: Enables battery display integration with AdvancedStatus.
- Drop Settings: Configures optional loot container drops, item amounts, chances, and battery overrides.
Warning
Important: When normal jackhammer support is disabled, flashlight functionality is limited to special Jackhammer Flashlight items created by the plugin.
Enable Flashlight on Normal Jackhammers in the configuration if you want regular Rust jackhammers to support the flashlight feature as well.
Why Choose JackhammerFlashlight?
Mining at night or inside dark caves should not require constantly switching between your tools and a separate light source.
JackhammerFlashlight combines a practical, aim-following flashlight, simple controls, configurable battery duration, optional battery status integration, customizable jackhammer items, and loot container drops in one focused plugin.
Whether you want unlimited flashlights for everyday mining or limited-battery jackhammers with custom loot drops and progression, JackhammerFlashlight gives server owners control over how players use light while mining
