RustEssentials 1.6.1

Rust Essentials is the all around (all you need) mod for Rust. This mod utilizes LeatherLoader. In the future we plan on working with other developers to make Rust Essentials more intuitive.

Commands: * All syntax (<>, [], "", and {}) can be viewed in allCommands.ini after first launch.

/access {on} (Gives the sender access to all doors)
/access {off} (Revokes access to all doors from the sender)
/airdrop (Spawns an airdrop with a random drop location)
/airdrop <player name> (Spawns an airdrop with a drop location at the specified player)
/ban <player name> (Bans player with reason: "Banned by a(n) <Your Rank>")
/ban <player name> *reason* (Bans player with the specified reason)
/ban [player UID] (Bans player by UID with reason: "Banned by a(n) <Your Rank>")
/ban [player UID] *reason* (Bans player by UID with the specified reason)
/bane "player name" (Bans player by their exact name with reason: "Banned by a(n) <Your Rank>")
/bane "player name" *reason* (Bans player by their exact name with the specified reason)
/chan {g} (Joins the global chat)
/chan {global} (Joins the global chat)
/chan {d} (Joins the direct chat)
/chan {direct} (Joins the direct chat)
/clearinv *name* (Clears the inventory of the specified player)
/clearinv "name" (Clears the inventory of the specified player by their exact name)
/craft {on} (Turns on super craft mode. Item, crafting, research, and blueprint restrictions nullify for the sender)
/craft {off} (Turns off super craft mode. Item, crafting, research, and blueprint restrictions re-activate for the sender)
/fall {on} (Turns on server-wide fall damage)
/fall {off} (Turns off server-wide fall damage)
/f {admin} *player name* (Gives faction admin to the specified faction member)
/f {ally} *faction name* (Allies the specified faction)
/f {build} {on} (Grants the sender build mode and allows them to build in zones)
/f {build} {off} (Revokes build mode from the sender)
/f {create} *name* (Creates and joins a faction with specified name)
/f {deadmin} *player name* (Revokes faction admin from the specified faction member)
/f {disband} (Disbands the current faction if user is the owner of said faction)
/f {info} (Shows the sender's faction information)
/f {info} *faction name* (Shows the faction information of a user or a faction)
/f {invite} *name* (Invites the player with the specified name to your faction)
/f {join} (Joins the faction of the last invitation received)
/f {join} *name* (Joins the specified faction if invited)
/f {kick} *name* (Kicks user with said name from faction)
/f {leave} (Leaves current faction)
/f {list} (Lists all factions on page 1)
/f {list} [#] (Lists all factions on page #)
/f {online} (Displays the statistics of members of the current faction)
/f {players} (Lists the players of the current faction)
/f {ownership} *player name* (Transfers ownership of faction to specified faction member)
/f {safezone} {1} (Sets the first safe zone point)
/f {safezone} {2} (Sets the second safe zone point)
/f {safezone} {3} (Sets the third safe zone point)
/f {safezone} {4} (Sets the forth safe zone point)
/f {safezone} {set} (Establishes the safezone)
/f {safezone} {clear} (Deletes the current safezone)
/f {safezone} {clearall} (Deletes all safezones)
/f {unally} *faction name* (Unallies the specified allied faction)
/f {warzone} {1} (Sets the first safe zone point)
/f {warzone} {2} (Sets the second safe zone point)
/f {warzone} {3} (Sets the third safe zone point)
/f {warzone} {4} (Sets the forth safe zone point)
/f {warzone} {set} (Establishes the safezone)
/f {warzone} {clear} (Deletes the current safezone)
/f {warzone} {clearall} (Deletes all safezones)
/feed (Feeds the sender)
/feed *player name* (Feeds the designated player)
/feed "player name" (Feeds the designated player by the exact name)
/give <player name> <item name> (Gives the item to that player)
/give <player name> <item name> [amount] (Gives the amount of the item to that player)
/give <player name> [item id] (Gives 1 of the item with the corresponding id to that player)
/give <player name> [item id] [amount] (Gives the amount of the item with the corresponding id to that player)
/giveall <item name> (Gives the item to all players)
/giveall <item name> [amount] (Gives the item to all players)
/giveall [item id] (Gives the item to all players)
/giveall [item id] [amount] (Gives the item to all players)
/god (Gives god mode to the sender)
/god *player name* (Gives the specified player god mode)
/god "player name" (Gives the specified player with the exact name god mode)
/heal (Heals the sender)
/heal *player name* (Heals the designated player)
/heal "player name" (Heals the designated player by the exact name)
/help (Returns available commands for your current rank)
/help [command without /] (Returns the documentation and syntax for the specified command)
/hide {on} (Hides the sender from AI)
/hide {off} (Reveals the sender to AI)
/history {1-50} (Returns the the last # lines of the chat history)
/i <item name> (Gives the item to you)
/i <item name> [amount] (Gives the amount of the item to you)
/i [item id] (Gives 1 of the item with the corresponding id to you)
/i [item id] [amount] (Gives the amount of the item with the corresponding id to you)
/join (Emulates the joining of yourself)
/join <player name> (Emulates the joining of a fake player)
/kick <player name> (Kick player with reason: "Kicked by a(n) <Your Rank>")
/kick <player name> *reason* (Kick player with the specified reason)
/kicke "player name" (Kick player by their exact name with reason: "Kicked by a(n) <Your Rank>")
/kicke "player name" *reason* (Kick player by their exact name with the specified reason)
/kickall (Kicks all users, except for the command executor, out of the server)
/kill *player name* (Kills the specified player)
/kill "player name" (Kills the specified player with that exact name)
/kit [kit name] (Gives the user the specified kit if the user has the correct authority level)
/kits (Lists the kits available to you)
/leave (Emulates the joining of yourself)
/leave *player name* (Emulates the leaving of a fake player)
/mute *player name* (Mutes the player on global chat)
/mute *player name* <time[s/m/h]>(Mutes the player on global chat for a period of time (time example: 15s or 30m))
/online (Returns the amount of players currently connected)
/owner {on} (Gives access to display the owner of a structure upon hit)
/owner {off} (Revokes access to display the owner of a structure upon hit)
/players (Lists the names of all connected players)
/pm <player name> *message* (Sends a private message to that player)
/pos (Returns the player's position)
/r (Replies to the last sent or received PM)
/random <item name> (Gives 1 of the specified item to 1 random player)
/random <item name> [amount] (Gives an amount of the specified item to 1 random player)
/random <item name> [amount] [amount of winners] (Gives an amount of the specified item to random players)
/random [item id] (Gives 1 of the specified item to 1 random player)
/random [item id] [amount] (Gives an amount of the specified item to 1 random player)
/random [item id] [amount] [amount of winners] (Gives an amount of the specified item to random players)
/reload {config/whitelist/ranks/commands/kits/motd/bans/prefix/warps/controller/tables/all} (Reloads the specified file)
/remove {on} (Gives access to delete entities (structures and AI entities) upon hit)
/remove {off} (Revokes access to delete entities (structures and AI entities) upon hit)
/rules (Lists the server rules)
/save (Saves all world data)
/say *message* (Says a message through the plugin)
/saypop *message* (Says a (!) dropdown message to all clients if the first word is more than 2 characters)
/saypop [icon] *message* (Says a dropdown message to all clients with designated icon)
/saypop [icon] *message* [#s] (Says a dropdown message to all clients with designated icon with a duration of # seconds (1-7 range))
/share *player name* (Shares ownership of your doors with the designated user)
/stop (Saves, deactivates, and effectively stops the server)
/time (Returns current time of day)
/time {0-24} (Sets time to a number between 0 and 24)
/time {day} (Sets time to day)
/time {freeze} (Freezes time)
/time {night} (Sets time to night)
/time {unfreeze} (Unfreezes time)
/timescale (Returns the speed at which time passes)
/timescale [#] (Sets the speed at which time passes. Recommended between 0 and 1. WARNING: THIS AFFECTS AIRDROPS)
/tp *player name* (Teleports the operator/sender to the designated user)
/tp <player name 1> <player name 2> (Teleports player 1 to player 2)
/tpa *player name* (Sends a teleport request to that user)
/tpaccept (Accepts the last teleport request recieved)
/tpaccept *player name* (Accepts the teleport request from that user)
/tpdeny *player name* (Denies the teleport request from that user)
/tpdeny {all} (Denies all current teleport requests)
/tphere *player name (Teleports the specified player to you)
/tppos [x] [y] [z] (Teleports your character to the designated vector)
/uid (Returns your steam UID)
/uid *player name* (Returns that user's steam UID)
/uid "player name" (Returns the steam UID of the user with that exact name)
/unban *player name* (Unbans the specified player)
/ungod (Revokes god mode from the sender)
/ungod *player name* (Revokes god mode from the specified player)
/ungod "player name" (Revokes god mode from the specified player with that exact name)
/unmute *player name* (Unmutes the player on global chat)
/unshare {all} (Revokes ownership of your doors from everyone)
/unshare *player name*(Revokes ownership of your doors from the designated user)
/vanish {on} (Makes the sender vanish. If the sender reconnects, the name becomes invisible)
/vanish {off} (Makes the sender appear. If the sender reconnects, the name becomes visible)
/version (Returns the current running version of Rust Essentials)
/warp *warp name* (Teleports you to the specified warp)
/warps (Lists the warps available to you)
/whitelist {add} [UID] (Adds the specified Steam UID to the whitelist)
/whitelist {check} (Checks if you're currently on the whitelist)
/whitelist {kick} (Kicks all players that are not whitelisted. This only work if whitelist is enabled)
/whitelist {off} (Turns whitelist off)
/whitelist {on} (Turns whitelist on)
/whitelist {rem} [UID] (Removes the specified Steam UID to the whitelist)

MOTD Commands:

- /save
- /saypop
- /stop
- /kickall
- /reload
- /timescale
- /time
- /join
- /leave
- /giveall
- /random
- /airdrop

Features:
- Advanced, yet user-friendly permissions & ranks system
- Extended MOTD settings
- Cycled messages
- Whitelisting (change on/off in realtime)
- In game config reloading (see /reload above)
- A variety of commands
- Environment overriding upon start up
- Global and Direct chat (using /chan)
- Chat history (command - up to 50 lines (ONLY GLOBAL CHAT FOR NOW))
- Teleport requesting
- Door sharing (saves)
- Per user prefix system
- Automatic version checking
- Kit inheritance
- Command inheritance
- Fully customizable death messages
- Customizable server rules
- Custom banning system
- Factions & Alliances
- Friendly fire
- Safezones and Warzones
- Vanish and Name invisibility
- Hide from AI
- Random item giveaway
- Forced nudity toggle
- Repair toggle
- Ownership checking tool
- Crafting, Research, Item, and Blueprint Restrictions
- Options for infinite research kits and paper requirement
- and much, much more!

Future:
- Post anything down below of what else you want to see in the mod.
- The following commands:

/pvp
/vote
/votekick

Upon updates, back up and delete the RustEssentials folder in order to get the latest config files. Then you can later adapt them back to your previous settings.

Installation:
1. You must have LeatherLoader installed and completely setup before attempting to install this mod. (Follow the "Install Leather" section.)
2. Download RustEssentials from the link above.
3. Extract RustEssentials.zip into the "rust_server_Data" folder. (If it asks to overwrite make sure to click yes.)
4. Launch the server! *
5. After the server starts up completely for the first time after installing the mod, it is recommended that you close it and change the configuration files to your liking. (You can find this in "rust_server_Data/mods/RustEssentials/")

* With the first launch of the server, all needed configuration files are created in the /mod/RustEssentials folder.

Bugs/Issues/Feedback:
You are able to post any of these things here: https://github.com/Team-Cerionn/RustEssentials/issues

Changelog:

1.6.1
- Completely fixed teleport positioning making you go under or through objects.
- Fixed warps not inheriting.
- Fixed loot tables going haywire.
1.6.0:
- Fixed kits and tpa cooldowns sometimes going negative.
- Fixed players with illegal characters or name lengths staying in /players and /online (again... sigh)
- Fixed duplicate bans causing major mod malfunction (security measure implemented to prevent any such occurances).
- Fixed typos and missing commands in allCommands.txt
- Added controller.ini for crafting, researching, and blueprint restrictions.
- Added the Tables folder. It will auto generate files on first start or when any files are missing. Used for custom loot tables. (A lot easier on the eyes). Note that minimumAmount/maximumAmount, if set under torches, research kits, or guns, refer to the amount of uses/bullets.
- Added /craft to allow the sender to bypass previously mentioned restrictions.
- Added the option to disable door stops after the door has been destoryed (in the config).
- Added the option to have research kits never run out (infinite).
- Added the option to have researching require paper.
- Fixed the crashing of the plugin when config.ini is out of date or missing variables. If it errors, it will just use all default values of Essentials.
- Removed the old broken MySQL variables from the config, they were obsolete.
- Fixed /f admin and /f deadmin to only work for the faction owner.
- Fixed /f admin to prevent owners from giving admin to themselves or current admins.
- Fixed /f deadmin to prevent owners from revoking admin from non-faction admins or from themselves.
- Fixed the NavMesh "Stop" error that semi-spammed when a hidden user walked by some hostile AI.
- Added more secure checks to further prevent AI from noticing hidden players (sometimes it broke).
- Added a check to prevent users from joining with the same name as the plugin bot.
- Added the UID to the console/main log join message.
- Fixed a typo in warps.ini
- Fixed kit_cooldowns not loading properly sometimes.
- Fully prevented kit cooldowns from going negative.
- Slightly rewrote the bans system to prevent duplicate bans.
- Added /reload controller and /reload tables.
- Fixed vanished players winning the giveaway.
- Fixed typing /i or /give displaying "by {name}" when the sender is vanished or the receiver is the sender.
- Updated everything to work with the latest Rust update.
- Fixed /mute sending the message with the wrong name when muted with a timer.
- Added item restrictions to the controller.ini (removes illegal items)
- Fixed kicking a faction member still allowing them to rejoin.
- Users with /craft on will not have illegal items removed.
- Fixed mismatch with method names for the ban system.
1.5.5:
- Fixed a bug that caused the console to be spammed when some players came within "scent" range of hostile AI.
- Fixed UID warps not working if both UID assigned and non-UID assigned warps exist.
- Fixed boots disappearing after unvanishing.
- Possibly fixed more of the NullReferenceExceptions?
1.5.4:
- Fixed players duplicating in player list and commands breaking due to it.
- Fixed warzones not notifying users that they have entered the warzone.
1.5.3:
- Fixed /clearinv not working.
- Fixed warps not loading properly. You can now assign them to specific ranks and UIDs.
- Added a check for /random - previous winners will not win again.
- Fixed joining, leaving, kicking, and invitation issues with factions.
- Fixed messages being sent to the wrong person upon /f invite.
- Added a "no invitations" message for users that type /f join without any invites.
- Typing /f list when there are no factions will say "There are no factions!"
- Objects in safezones and warzones can no longer be damaged by anything other people in build mode (melee and guns only).
- Fixed /kickall.
- Fixed /saypop not limiting itself to 7 seconds max when a duration over 7 is specified.
- Added messages for when you feed, heal, or god someone else other than yourself.
- Fixed /fall off and /fall on. I accidentally made /fall on turn it off and vice versa...
1.5.2:
- Fixed a major bug with players with illegal characters.
- Fixed the NullReferenceException bug.
1.5.1:
- Fixed a typo (or whatever it's called :]) in /f help for safezones and warzones.
- Fixed the sleeper bug. It was urgent.
1.5.0:
- Added duration to /saypop.
- Made the first word/argument used in /saypop the icon if less than 3 chars. (EX: /saypop test. -> [ Test ])
- Added /vanish to go invisible and REMOVE THE PLAYER'S NAME! WOOT!
- Added /hide to hide from AI.
- Added /owner. If on, hit a structure to see who owns it (like /prod). It even says their name if they have never been on or are offline.
- Added /warp for coordinate based warp locations. Warps can be assigned per rank prefix or UID.
- Added /warps to list warps avaiable to the sender.
- Updated /heal to set your radiation to 0 aswell.
- Added /feed to completely feed a player.
- /god, /ungod, /heal, and /feed no longer require a username to apply it to yourself.
- Added /tphere to teleport players to yourself easily.
- Added /bane and /kicke for punishing players by their exact name (use quotes).
- Added /giveall to give all connected players an item of specified amount.
- Added /random to start an item giveaway.
- Updated the /help for all new commands.
- Added the user of some commands in MOTDs. (See allCommands.ini or somewhere on the post)
- Added the ability to enable and disable repairing structures.
- Added the ability to force nudity.
- Added limiting names by a maximum and minimum character count.
- Added the ability to whitelist certain characters for names.
- Added duplicate name handling. If Bob connects and someone named Bob is already connected, the new Bob will be renamed to Bob (1) if kickDuplicate is false. If true, he get's kicked.
- Added the ability to censor words in names and chat.
- Added a murder message for death by an unknown weapon.
- Messages (join, leave, kill, etc.) no longer require the tags.
- Addded warp inheritance.
- Added allies to factions. Reduces damage by 1/3.
- Added the option to toggle friendly fire and allied fire negation in the config.
- Added safezones and warzones! WOOT!
- Added options for changing damage of users in warzones.
- Added cooldowns for tpa (or teleport requesting). 3 types: none, per person, all people. See config for more details.
- Added the option to disallow teleport requests in warzones.
- Kit cooldowns will save over restarts now.
- TPA cooldowns save too.
- Updated removePrefix to account for join and leave messages too.
- Added faction chat.
- Ending a kit cooldown will no longer clear ALL acting cooldowns.
- Most commands that require user names can now use quotes for exact name specification.
- Using /f players, /players, or /f online will not show you if you are vanished.
- Added a huge load of commands to factions. See /f help.
- Fixed bans and prefixes not loading upon restart.
- Added /clearinv to clear a player's inventory.
- And more that I couldn't remember.
1.4.0:
- Fixed chat not working if Assembly-CSharp.dll is out of date
- Added factions. Still a work in progress. Much more to be fixed and added to it.
- Shooting teammates within the same faction will bring up a "friendly fire" notice and not deal damage
- Factions have a limit of 15 people (for now)
- Added /r for quick replies to last PM sent/received
- Added /fall {on/off} (server-wide fall damage)
- Re-enabled plugin-side door sharing and /tpa
- Added /tpa cancellation if either players are hit
- Added /remove on/off (will delete any AI or structure entity upon hit)
- Added customizeable voice chat distance in Config
- Fall damage can now be set in config file and through /fall
- Fixed ALL formatting issues with logs in Notepad++
- Fixed logs not deleting properly
- Fixed /reload kits not reloading correctly for kits with cooldowns
- Fixed /heal not actually updating the target's UI
- Fixed steam group whitelist not working properly
- Fixed syntax in allCommands.
- Changed allCommands.ini to allCommands.txt
- Added help info for the new commands
- Added "factions.dat"
1.3.3:
- Changed "door_data" to "door_data.dat"
- Implemented configurable suicide, murder, and death by mob (accident) messages. All of which are toggleable
- Added timed mutes with /mute *name* *time[s/m/h]*
- Added a death message and reason for being /killed
- God Mode will now prevent fall damage and bleeding from occurring
- Fixed bugs with latest rust update
- Updated Assembly-CSharp.dll
- Fixed unsharing not saving
- Added /reload prefix
- Added /players to show the names of connected players
- Added /rules, configurable in MOTD.ini
- Fixed a typo in /help kits
- Fixed /kits not showing kits for users with some ranks
1.3.2:
- Fixed most problems with /stop, /save, /give, /i, and /kit
- Added /kits to list your available kits
- Fixed most, if not all, freezing/lag when executing commands upon first time
- Fixed banned and nonwhitelisted users not getting the kick message
1.3.1:
- Fixed most of (if not all) the whitelist bugs
- Fixed /tpa not working properly
1.3.0:
- Added Steam Group whitelist availability
- Added the ability to grab another player's uid with /uid *name*
- Banning a player now saves the reason and redisplays to them upon their reconnect
- Added banning and unbanning offline players by UID
- Added per player prefixes. Overrides rank prefixes.
- Added /saypop (notice pop up version of /say)
- Steam Group whitelist auto reloads every 10 seconds.
- Added toggleable kit and command inheritance (for more advanced, yet less friendly usage)
- Added /access (gives sender access to all doors)
- Added /unshare all (unshares all doors with anyone shared with in the past)
- Added /whitelist check (with changeable responses in the config)
- Fixed logging issue with bot <broadcast to>
- Fixed /heal
- Using /god on someone will heal them too now.
- Added /save for server data saving.
1.2.5:
- Fixed chat channels bugging out.
- Fixed leave messages not displaying.
1.2.4:
- Fixed automatic version checking.
1.2.3:
- Leather 1.1 support.
1.2.2:
- Fixed items not spawning with /i, /give, or /kit.
1.2.1:
- Changed default config location to "/save/RustEssentials". (Thank you HFB)
1.2.0:
- Fixed defaultChat not working.
- Fixed unassigned kits having a broken cooldown.
- Added /tpa, tpaccept, and /tpdeny with a 10 second timer. (You can enable/disable in config)
- Added the ability to enable and disable join and leave messages.
- botName now accepts spaces and non-alphanumerical characters.
- Fixed config file not reloading properly.
- Added /tppos [x] [y] [z]
- Fixed the logs not deleting once cap was reached.
- Kits are no longer case sensitive.
- Fixed PM's not working half the time.
- Fixed giving items giving an amount error.
- Fixed spaces not working in arguments for most commands such as /tp.
- Added /ban [UID] and /unban [UID]
- Added /say *message*
1.1.0:
- allCommands.ini is in alphabetical order now.
- Fixed the bug with kits not inheriting.
- Got rid of the "quote" bug in strings and system messages.
- Fixed the timeScale in the config to default to 0.01, not 1.
- Overhauled the default ini files. They now have examples, presets, and more comments.
- Added the ability to change join and leave messages.
- Added global and direct chat (Yes, proximity chat - distance is configurable. Default 150m)
- Added the following commands: /chan, /say, /stop, /mute, /unmute, /history (up to 50 lines), and /tp.
- Added more tag restrictions and security with usernames.
- Added the ability to enable or disable the "Unknown Command" return.
- Added the changing of the plugin's chat name (From Essentials to what ever you would like).
- Mod now creates log files for both chat and general mod info (For those who can't see the console).
- Commands.ini now comes with preset permissions for reference or usage.
- /help now shows the full list of items and is more useful. (Try it out!)
- Changed the version style from 4 digits to 3 digits.
1.0.0.0:
- Initial Release

Servers:
- net.connect 23.81.82.2:28055 (Essentials/Sleepers/PvP/InstaCraft/Super Starter Kit)
- net.connect 192.99.14.192:28115 (Hollowmen Gaming | Wipe 2/12 | Factions | 1/2 Craft | 24/7Admins)

Download:

RustEssentials.zip

Credits:
- Team Cerionn (MistaD & Pwnoz0r)