[thetwistedpanda]

Updating:

• ExtendedComm currently uses a rather nifty setup where it can automatically update your database installation without requiring any action from you. It's still recommended that you back up the database prior to updating the plugin, however, due to issues that like to ninja their way in. This feature is only available provided you're using the latest version 2.2.4 (pre-3.x update) or 3.x.x. If you're using a version other than these, you're out of luck.
• v2.2.4 --> v3.0.x:
  • All previous files have been made obsolete, please delete the following files:
    • sm_extendedcomm.smx, located in /sourcemod/plugins/
    • sm_extendedcomm.phrases.txt located in /sourcemod/translations/
    • sm_extendedcomm.cfg, located in <game>/cfg/sourcemod/
    • sm_extendedcomm.txt, located in /sourcemod/configs
  • After the files have been removed, please shut down your server and follow the installation instructions above.

ConVars:

• extendedcomm_database - Default: "" - The database configuration for ExtendedComm. Use "" to connect to a local sqlite database.
• extendedcomm_temporary - Default: "0" - If enabled, temporary punishments issued by ExtendedComm will remain until the map changes (as opposed to disappearing on reconnecting). (0 = Disabled, 1 = Enabled)
• extendedcomm_delay_queries - Default: "1" - If enabled, save queries will be delayed until the client disconnects, otherwise the save queries are executed upon issuing the punishment. (0 = Disabled, 1 = Enabled)
• extendedcomm_obey_immunity - Default: "0" - If enabled, an admin's immunity is used when assigning a punishment and admins with lower immunity are inable to modify the existing punishment. (0 = Disabled, 1 = Enabled)
• extendedcomm_action_log - Default: "/logs/ExtendedComm.txt" - The path for logging punishments related to ExtendedComm. Example: "/logs/extendedcomm_actions.txt"
• extendedcomm_notice_log - Default: "/logs/ExtendedComm.txt" - The path for logging errors related to ExtendedComm. Example: Example: "/logs/extendedcomm_notices.txt"
• extendedcomm_time_format - Default "" - Determines the formatting for time and date display. Using \"\" will default to sm_datetime_format (/cfg/sourcemod.cfg)
• extendedcomm_prune_interval - Default "604800" - The number of seconds between each automatic pruning, a feature that removes expired punishments from the database. (0 = Disabled)

Commands:

• Parameters: The time parameter controls how long the player is punished. (< 0 == Temporary, 0 == Permanent, # == Minutes). The reason parameter must be inclosed in quotations and must be less than 128 characters.
  • sm_mute <player> <optional:time> <optional:reason>
    • Removes a player's ability to use in-game voice.
  • sm_unmute <player> <optional:time> <optional:reason>
    • Removes a player's ability to use in-game chat.
  • sm_gag <player><optional:time> <optional:reason>
    • Removes a player's ability to use in-game chat and voice.

• Parameters: To provide compatibility with other plugins and stupidity, extended/permanent punishments are not removed unless the optional remove parameter is specified.
  • sm_ungag <player> <optional:remove>
    • Restores a player's ability to use chat.
  • sm_silence <player> <optional:time (in minutes)>
    • Removes a player's ability to use voice and chat.
  • sm_unsilence <player> <optional:time (in minutes)>
    • Restores a player's ability to use voice and chat.

• sm_commlist
  • Provides information on punishments for all clients in-game, displaying information such as: reason, admin, duration, issued date/time, expiration date/time.

• sm_commprune
  • Allows administrators with the ROOT flag to manually prune the punishment database; ideal for very large databases where constant automatic pruning would put strain on the servers.

Natives:

• ExtendedComm releases several natives to provide compatibility with other plugins and for additional functionality.
  • ExtendedComm_GetMuteType
  • ExtendedComm_GetMuteLength
  • ExtendedComm_GetMuteStart
  • ExtendedComm_GetMuteExpire
  • ExtendedComm_GetGagType
  • ExtendedComm_GetGagLength
  • ExtendedComm_GetGagStart
  • ExtendedComm_GetGagExpire
• These natives will return a value of -2 if the database for ExtendedComm is currently experiencing issues (for whatever reason). A value of -1 will be returned if there is no valid data to return (i.e. attempting to get the expiration on a temporary punishment.