This is an addon created for Rust:IO. In order to use this plugin, you need to install Rust:IO first!
There is a config file located at config/Clans.json which contains all translatable strings. Simply edit the right hand side of the translations, but always keep the %PLACEHOLDERS% intact and untranslated.
Also in config/Clans.json there are a few variables to configure the plugin.:
- Create your own clan and invite your friends
- Promote members to moderators to manage the clan
- Automatically updates members to share their location on Rust:IO
- Chat internally with all clan members through /c Message...
- Shows the clan tag in front of all clan members' names
- Broadcasts members going online or offline to all clan members
- Turns off friendly fire for clan members when used with Rust:IO FriendlyFire
Chat Commands
Clan Member
- /clan -- Display relevant information about your current clan
- /c <message> -- Send a message to all online clan members
- /clan create "<tag>" "<description>" -- Create a new clan
- /clan join "<tag>" -- Join a clan you have been invited to
- /clan leave -- Leave your current clan
Clan Moderator
- /clan invite "<player>" -- Invite a player to your clan
- /clan kick "<player>" -- Kick a member from your clan
Clan Owner
- /clan promote "<player>" -- Promote a member to moderator
- /clan demote "<player>" -- Demote a moderator to member
- /clan disband forever -- Disbands your clan (no undo)
Configuration
The settings and options can be configured in the RustIOClans file under the config directory. The use of an editor and validator is recommended to avoid formatting issues and syntax errors.There is a config file located at config/Clans.json which contains all translatable strings. Simply edit the right hand side of the translations, but always keep the %PLACEHOLDERS% intact and untranslated.
Also in config/Clans.json there are a few variables to configure the plugin.:
- addClanMatesAsFriends specifies whether clan mates are automatically added to each others Rust:IO friendslist (default: true).
- limit specifies the maximum number of clan members respectively moderators (default: -1 = no limit)
For Developers
This plugins provides a simple to use API for other plugins to utilize:- GetClan(tag:string):JObject
Returns a JObject (reference Newtonsoft.Json.dll) representing the clan using the specified tag or null if there is no such clan.
The JObject contains the following properties: tag:string, description:string, owner:string, moderators:JArray, members:JArray, invited:JArray.
All members are represented by their SteamID as a string. - GetClanOf(player:ulong|string|BasePlayer):string
Returns the clan tag of a player's clan or null if the player is not a member of a clan. - GetAllClans():JArray
Returns an array of all clan tags.
- OnClanCreate(tag:string)
Called when a new clan has been created - OnClanUpdate(tag:string)
Called when clan members or invites change. Note: Make sure not to do any clan updates within your hook method, as this would most likely result in an infinite loop. - OnClanDestroy(tag:string)
Called when a clan is disbanded or deleted
TODO
- Move messages from configuration to language file
- Remove unnecessary ResourceId
- Remove unnecessary[HookMethod(...)] attributes