aboutsummaryrefslogtreecommitdiff
path: root/doc/API.md
diff options
context:
space:
mode:
Diffstat (limited to 'doc/API.md')
-rw-r--r--doc/API.md37
1 files changed, 35 insertions, 2 deletions
diff --git a/doc/API.md b/doc/API.md
index bee7c42..2353cb4 100644
--- a/doc/API.md
+++ b/doc/API.md
@@ -16,14 +16,47 @@ Ban a player and all of his/her alternative names and IPs.
### unban_player
-`xban.unban_player(player_or_ip, source)`
+`xban.unban_player(player_or_ip, source, reason)`
+
+Unban a player and all of his/her alternative names and IPs. A reason
+may be given for this unbanning, so other moderators can follow your
+thoughts.
-Unban a player and all of his/her alternative names and IPs.
#### Arguments:
* `player_or_ip` - Player to search for and unban.
* `source` - Source of the ban. See note 2 below.
+* `reason` - Reason for unbanning.
+
+### add_record:
+
+`xban.add_record(player, record)`
+
+Adds a record to the player's criminal record.
+
+#### Arguments:
+
+* `player` - Name of a player
+* `record` - a xban record (see below)
+
+### Player record format:
+
+
+ local record = {
+ source = "admin",
+ time = os.time(),
+ expires = nil,
+ reason = "bad behaviour",
+ type = "ban",
+ }
+
+* `source` - who issued the record
+* `time` - time at which the record was issued
+* `expires` - time at which the record expires, `nil` for never
+* `reason` - reason for record
+* `type` - type of record.
+
### Notes