Lorenzo
Supported Games
Permissions
excavatorlock.use
when Use Permission is true. default name but can be modified in configexcavatorlock.admin
to bypass excavator loot protection by admins
Commands
excavator
view giant excavator status
-excavatorclear
clear the excavator lock status.
Configuration
{
"Use permission": false,
"Permission": "excavatorlock.use",
"Multiplier permission": false,
"Permission For Multiplier": "excavatorlock.multiplier",
"CoolDown before releasing excavator": 5.0,
"Send Excavator available Message to All": true,
"Enable engine loot after it is started to add diesel": true,
"Use Teams": true,
"Use Clans plugin": false,
"Use clan table": false,
"CoolDown before a player or team can restart the excavator (0 is disabled)": 30.0,
"Apply cooldown to all excavators": true,
"Enable fuel modifier": true,
"Maximum stack size for diesel engine (-1 to disable function)": -1,
"Enable signal Computer lock": true,
"Enable signal Computer message": true,
"Running time per fuel units (time in seconds)": 120.0,
"Sulfur production multiplier ": 1.0,
"HQM production multiplier": 1.0,
"Metal production multiplier": 1.0,
"Stone production multiplier": 1.0,
"Excavator chat command": "excavator",
"Excavator clear status": "excavatorclear",
"Empty the output piles when excavator start": false,
"Charge needed for supply drop (0 to use default of 600sec)": 0,
"Clear excavator lock after all player from team/clan disconnect ": false,
"Clear excavator lock after player owner disconnect": false,
"Time after all player disconnect before excavator clear (minutes)": 10,
"Use Discord hook": false,
"Use Discord timestamp": true,
"Discord hook url": "",
"Use Notify plugin": false,
"Debug": false,
"Log to file": false
}
Use permission: falseset to true if you want to use permission system for giant excavator
Permission : "excavatorLock.use"Name of the permission when Use permission is set to true
Multiplier permission: falseset to true if you want to use permission system for giant excavator
Permission for Multiplier : "excavatorlock.multiplier"Name of the permission when Use permission is set to true
CoolDown before releasing excavator: 5.0
The player using the excavator receive a message when the excavator turn off.this is number of minutes after the engine turn off and before it unlock the loot piles to all players.Time is in minutes
Send Excavator available Message to All: true
After the cooldown, control if a broadcast is send to all players
Enable engine loot after it is started to add diesel: true
allow looting of the fuel tank after the engine is started.If false, it stop player adding fuel to extend usage.
Use Teams: true
team members will share excavator operation (rust team)
Use Clans plugin: true
use the clan plugin to share excavator operation
Use clan table
use the clan table to share excavator operation.
CoolDown before a player or team can restart the excavator (0 is disabled): 30.0
Set a cooldown after the excavator turn off, before a player/team/clan can use it againTime is in minutes. if a Player/Team has used the excavator, then finish, they have to wait that long before they can use it again.
"Apply cooldown to all excavators": true,
When there are multiple excavators,if true, a cooldown apply to all excavators when player use one of excavator.and when false, a player can use all excavators at the same time.
Enable fuel modifier: truewhen true, use the Running time per fuel units paramater. this parameter should be set to false if an other plugin is managing the excavator fuel.
Maximum stack size for diesel engine (-1 to disable function) : -1Option to modify the stack size of the diesel for the excavator only.set to -1 to disable the function.set to 0 to use the default stack sizethis implementation only modify the "inventory.maxStackSize" for the diesel engine. may not work well with other plugin. if this is the case, just disable this option it with -1.also this parameter can only be used with a value lower then the global stack size.
Enable signal Computer lock: truewhen true, the ability to call an airdrop is locked to the player/team/clan operating the excavator.note: The airdrop is not locked.
Enable signal Computer message: truesend a message in chat that the airdrop is called from the signal computer.
Running time per fuel units (time in seconds): 120.0change the default run time for each barrel of diesel. default is 120sec.Time is in seconds.
Sulfur production multiplier: 1HQM production multiplier: 1Metal production multiplier: 1Stone production multiplier: 1
Override production quantity of each minerals per period. should not be used when using a gather modifier plugin because of conflicts.
Excavator chat command": "excavator"
command to view excavator status
Excavator clear status: "excavatorclear"
admin command to clear the lock status of all giant excavatorscommand can be issued in RCON, chat or console
Empty the output piles when excavator start : true
When starting the excavator, The content of the output piles will be flushed.
Charge needed for supply drop (0 to use default of 600sec) : 0
Set the number of seconds to recharge the signal computer.0: to disable the function and use default value.600 is the default value of Rust
Clear excavator lock after all player from team/clan disconnect : falseClear excavator lock after player owner disconnect : false
These modes will unlock the excavator if the players or team/clan disconnect for a certain time. Only one mode can be used at a time
Time after all player disconnect before excavator clear (minutes): 10
when one of the Unlock on disconnect mode is active, this is the time to wait in minutes befor the excavator clear and become available to all. Player cooldown will still be active before they can reuse the excavator.
Debug: true
Display some basic debug info to console
Log to file: true
Send basic debug info to log file in
Use Discord hook: falseDiscord hook url: "a discord url"
Configure a discord hook and send some information to discord
Use Discord timestamp
Discord timestamp allow to display time/date relative to viewer time zone.
Use Notify plugin
display the notification using the Notify/UI Notify plugin
Note: When the cooldown parameter of the configuration in changed, it is preferable to delete the datafile of ExcavalorLock.
Localization
{
["ExcavatorOff"] = "<color=#FF1500>- Giant excavator just turn off !</color>",
["ExcavatorCoolDown"] = "<color=#FF1500>- You have {0} min. to get the ore, before it unlock to all</color>",
["ExcavatorInUse"] = "<color=#FFA500>Giant Excavator currently in use by {0}</color>",
["ExcavatorStartEngine"] = "Giant Excavator started for {0,2:F0} minutes",
["ExcavatorStartEngineHM"] = "Giant Excavator started for {0,2:F0} hour, {1,2:F0} minutes",
["ExcavatorStarted_"] = "Giant Excavator {0}, started by {1}. loot is protected",
["ExcavatorStoped_"] = "Giant Excavator {0}, stopped and is available to all",
["ExcavatorFuel"] = "<color=#FFA500>Giant Excavator currently running with {0} fuel in storage</color>",
["ExcavatorPlCooldown"] = "Excavator Player cooldown will expire in {0} min.",
["ExcavatorAvailableIn"] = "Giant Excavator {0} will be available in {1,2:F0} min.",
["ExcavatorClearStatus"] = "Clearing the giant excavator status",
["ExcavatorPermission"] = "Player does not have permission to use giant excavator",
["ExcavatorSupplySignal"] = "Airdrop was activated at excavator {0} by player {1}, please do not steal",
["ExcavatorClearOffline"] = "Giant Excavator {0}, cleared because team/clan player are offline",
}
About limiting the amout of diesel
Without limits, players can fill the diesel engine and hold the excavator for a very long time. I have added a simple function to limit the amount of diesel a player can put in the engine, but other plugin to modify stack size can do this better.
for example, stack-item-storage can set the amount of fuel put in the diesel enginehttps://umod.org/plugins/stack-item-storage
plugin ChestStackMultiplier does a similar function https://umod.org/plugins/chest-stack-multiplierand there a probably others.
the container used for configuration is : "assets/content/structures/excavator/prefabs/engine.prefab"
About airdrops
this plugin does not protect airdrops. It only allow the activation of the signal compute by the current user of the excavator. Plugin LootDefender can lock the airdrop to the player that activated the signal computer.https://umod.org/plugins/loot-defender
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.