minenux/minetest-engine-multicraft2
1
0
Fork 0
Code Releases Activity

Improve documentation around banning (#9088)

Browse Source 
* Fix ban chatcommand description
* Correct ban API documentation
This commit is contained in:
sfan5 2019-11-05 19:24:51 +01:00 committed by GitHub
parent 2907c0f3a2
commit 15a030ec9f
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 13 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
builtin/game/chat.lua
View File

@ -909,8 +909,8 @@ core.register_chatcommand("shutdown", {
}) })
core.register_chatcommand("ban", { core.register_chatcommand("ban", {
params = "[<name> | <IP_address>]", params = "[<name>]",
description = "Ban player or show ban list", description = "Ban the IP of a player or show the ban list",
privs = {ban=true}, privs = {ban=true},
func = function(name, param) func = function(name, param)
if param == "" then if param == "" then
@ -922,7 +922,7 @@ core.register_chatcommand("ban", {
end end
end end
if not core.get_player_by_name(param) then if not core.get_player_by_name(param) then
return false, "No such player." return false, "Player is not online."
end end
if not core.ban_player(param) then if not core.ban_player(param) then
return false, "Failed to ban player." return false, "Failed to ban player."
@ -935,7 +935,7 @@ core.register_chatcommand("ban", {
core.register_chatcommand("unban", { core.register_chatcommand("unban", {
params = "<name> | <IP_address>", params = "<name> | <IP_address>",
description = "Remove player ban", description = "Remove IP ban belonging to a player/IP",
privs = {ban=true}, privs = {ban=true},
func = function(name, param) func = function(name, param)
if not core.unban_player_or_ip(param) then if not core.unban_player_or_ip(param) then

15
doc/lua_api.txt
View File

@ -4896,13 +4896,16 @@ Server
Bans Bans
---- ----
* `minetest.get_ban_list()`: returns the ban list * `minetest.get_ban_list()`: returns a list of all bans formatted as string
(same as `minetest.get_ban_description("")`). * `minetest.get_ban_description(ip_or_name)`: returns list of bans matching
* `minetest.get_ban_description(ip_or_name)`: returns ban description (string) IP address or name formatted as string
* `minetest.ban_player(name)`: ban a player * `minetest.ban_player(name)`: ban the IP of a currently connected player
* `minetest.unban_player_or_ip(name)`: unban player or IP address * Returns boolean indicating success
* `minetest.kick_player(name, [reason])`: disconnect a player with a optional * `minetest.unban_player_or_ip(ip_or_name)`: remove ban record matching
IP address or name
* `minetest.kick_player(name, [reason])`: disconnect a player with an optional
reason. reason.
* Returns boolean indicating success (false if player nonexistant)
Particles Particles
--------- ---------