Join the Game4Freak Discord Get exclusive plugin sneak peeks, talk directly with VisEntities, never miss important updates, and unlock special discount codes!
Custom Hack Duration

Custom Hack Duration 1.0.1

Control crate hack times with permission tiers, teammate bonuses, and milestone alerts
Documentation License Changelog (1) Reviews (1) Version History Discussion
Works With
Clans
This plugin controls how long it takes to hack locked crates on your server. Different hack times can be assigned to different players through permissions, allowing VIP players to hack faster than regular players. When teammates stand nearby during a hack, the timer automatically decreases to reward coordinated play. Players also receive progress notifications throughout the hack so they always know how much time is left.


Permissions

  • customhackduration.vip -- Applies the VIP hack duration tier (default: 300-450 seconds)
  • customhackduration.elite -- Applies the Elite hack duration tier (default: 60-120 seconds)
Additional tiers can be added freely in the config. All permissions defined in Permission Based Hack Durations are registered automatically on plugin load. When a player holds multiple tier permissions, the one with the lowest Priority number wins.

Configuration

JSON: 
{
  "Version": "1.0.0",
  "Default Hack Duration For Players Without Permissions": {
    "Minimum Hack Duration In Seconds": 900,
    "Maximum Hack Duration In Seconds": 900
  },
  "Teammate Proximity Bonus": {
    "Enabled": true,
    "Use Clans Plugin For Teammate Detection": false,
    "Teammate Detection Radius": 10,
    "Seconds Reduced Per Nearby Teammate": 30,
    "Maximum Total Seconds That Can Be Reduced": 120
  },
  "Hack Progress Notifications": {
    "Enabled": true,
    "Display As Game Tip Toast Instead Of Chat Message": true,
    "Notify At These Percent Remaining Intervals": [75, 50, 25, 10]
  },
  "Permission Based Hack Durations": [
    {
      "Permission": "customhackduration.vip",
      "Priority (Lower Number = Higher Priority)": 1,
      "Minimum Hack Duration In Seconds": 300,
      "Maximum Hack Duration In Seconds": 450
    },
    {
      "Permission": "customhackduration.elite",
      "Priority (Lower Number = Higher Priority)": 2,
      "Minimum Hack Duration In Seconds": 60,
      "Maximum Hack Duration In Seconds": 120
    }
  ]
}

Default Hack Duration For Players Without Permissions

Applied to any player who does not match a permission tier.
  • Minimum Hack Duration In Seconds -- Shortest possible hack time. Set equal to Maximum Hack Duration In Seconds for a fixed, non-random duration
  • Maximum Hack Duration In Seconds -- Longest possible hack time. When different from the minimum, each hack rolls a random value within the range

Teammate Proximity Bonus

Reduces the effective hack duration based on how many teammates are standing near the hacking player at the moment hacking begins.
  • Enabled -- Toggles the entire proximity bonus system
  • Use Clans Plugin For Teammate Detection -- When true, players in the same clan (via Clans) count as teammates in addition to native Rust team members. Requires the Clans plugin to be loaded
  • Teammate Detection Radius -- Radius in meters to scan for nearby teammates
  • Seconds Reduced Per Nearby Teammate -- Flat seconds subtracted from the hack duration for each qualifying nearby teammate
  • Maximum Total Seconds That Can Be Reduced -- Cap on the total time reduction regardless of how many teammates are nearby
The final duration after applying the bonus is floored at 1 second and will never go below that.

Hack Progress Notifications

Sends the hacking player a notification at configurable milestones during the hack.
  • Enabled -- Toggles progress notifications entirely
  • Display As Game Tip Toast Instead Of Chat Message -- When true, notifications appear as the in-game HUD toast; when false, they are sent as chat messages
  • Notify At These Percent Remaining Intervals -- List of thresholds (as percent of hack time remaining) that trigger a notification. For example, 25 fires when 25% of the duration is left

Permission Based Hack Durations

An array of permission tiers. Each tier defines its own duration range and priority.
  • Permission -- The Oxide permission string. Registered automatically on plugin load
  • Priority -- When a player matches multiple tiers, the one with the lowest priority number is applied
  • Minimum Hack Duration In Seconds -- Shortest possible hack time for this tier
  • Maximum Hack Duration In Seconds -- Longest possible hack time for this tier. Set equal to the minimum for a fixed duration

Localization

JSON: 
{
  "Hack.Started": "Hacking started! Estimated time: {0}",
  "Hack.Progress": "Hacking... {0}/100 complete - {1} left",
  "Hack.Complete": "Hack complete!",
  "Hack.TeamBonus": "Team bonus: -{0}s ({1} teammates nearby)"
}
Author
VisEntities
License duration
Unlimited
Price
7.99 USD
First release
Last update

Ratings

5.00 star(s) 1 reviews

Also by VisEntities

  • Loot Inject
    Loot Inject
    Inject items into existing loot tables without replacing them
  • Catapult Aim Assist
    Catapult Aim Assist
    Gives players a visual guide to predict where their catapult shots will land
  • Server Password
    Server Password
    Requires players to enter a password via keypad UI before they can play

Latest updates

  1. 1.0.1

    Fixed plugin affecting hackable crates spawned by other plugins.
Read more…

Latest reviews

Wild Shadow
Nice plugin, for reducing hack time based on player permissions, with a display of the hack's progress, easily integrated into other third-party plugins like SkillTree for example
Upvote 0 Downvote
Read more…
Back
Top
Chat commands start with a /, while console commands can be entered directly in the F1 console or server console. Use find <keyword> in console to search for available commands related to the plugin. Parameters in < > are required, while [ ] are optional.
This plugin uses Oxide's permission system. Grant or revoke permissions using oxide.grant and oxide.revoke. You can assign them to individual players or groups using their Steam id or group name.
Settings are stored in the config file found under the config/ directory. You can edit this file manually, then reload the plugin to apply your changes.
Persistent data is saved in the data/ directory. This includes things like saved settings, usage stats, or player progress depending on the plugin. Deleting a data file will reset stored progress or customizations.
Language files are located in the lang/ folder. To translate messages, copy the en.json file into your target language folder (e.g. fr, de) and edit the values. Reload the plugin after changes to apply new messages.
This section lists public methods exposed by the plugin for use in other plugins. You can call these via the CallHook method. Ensure the plugin is loaded before calling its API to avoid null reference errors.
These are custom hooks that other plugins can listen for. Simply define a method with the same name and expected parameters in your plugin to handle the event. Hooks are triggered at key moments and are useful for extending or reacting to plugin behavior.
These hooks are injected into the game's code using Harmony. They let the plugin run code at key points in the game's internal logic. You can return values to block or modify behavior. Use with caution — these are powerful and can affect core mechanics.
Cart

Cart

Total -