From fee959eaa075c1cd6cd3cbc542510be0dd82d017 Mon Sep 17 00:00:00 2001 From: mckaygerhard Date: Tue, 28 May 2024 12:44:37 -0400 Subject: [PATCH 1/3] Improve information for README, the mod doe snot provide enought info for * this mod seems usefully but does not promote very well their usage * added myselft to mod contributor cos i have plans to fix some non fully working functions --- README.md | 59 +++++++++++++++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 57 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 80f48cd..21db65d 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,57 @@ -# essentials -Essentials — Minetest mod with many-many useful console commands! +minetest-mod-essentials +========================= + +mod with many-many useful console commands and api functions! + +Information +----------- + +This mod attempts to be an improvement usefully essentials commands +as a light version of some other tools like names-per-ip, global messages, hacks, +biome/stuffs management, player management etc etc etc + +This mod has some UI menues but almost all the tasks are done using +commands. + +## Technical info +----------------- + +This mod must be named `essentials` and provides administrarion tools and +procedures to manage server using a bunch of commands some already provided +by other mods some already new but similar to other mods. + +#### Configurations + +| config param | type | value | req | default/min/mx | example or description | +| --------------------- | ------ | ---------- | --- | --------------- | -------------------------------- | +| essentials_additional_privileges | bool | true | no | true | Enables extra refined privilegies for the commands, see privilegie tables | +| essentials_changed_by | bool | true | no | true | Allows to see if a player property whas altered (by) when was made by some admin | +| essentials_killed_by | bool | true | no | true | Allows to see who a player was killed (by) when was killed by some admin | +| essentials_biome | bool | true | no | true | Allows to see for anyone request biome infos, otherwise only admins allows | +| essentials_seed | bool | false | no | false | Allows to see for anyone the seed of the world, otherwise only admins allows | +| essentials_ip_verified | bool | true | yes | true/singleplayer | On every join, if administrator verified ip user to only allows from those ip/name combination | +| essentials_check_for_updates | bool | false | no | false | check raw data of git repo by check of version file content | + +#### Commands and privilegies + +| command & format | mint/privs | Esse/privs | description function | observations | +| ---------------------- | ---------- | ---------- | ----------------------- | ----------------------- | +| `/ip ` | server | server | Show the IP of a player | | +| `/broadcast ` | bring | broadcast | Send GLOBAL message in chat | | +| `/speed ` | rollback | speed | Sets a speed for an any player. | | +| `/biome []` | | biome | "Shows the current(or provided name) biome info | If no assentials privs, any player wil be able, `biome` priivilegie works if confg params are set, otherwise admin only | +| `/seed` | rollback | seed | "Shows the seed number of the server world | If no assentials privs, any player wil be able, `biome` priivilegie works if confg params are set, otherwise admin only | +| `/god []` | noclip | god_mode | Enable the god mode for current or given player | `enable_damage` enabled only of course | +| `/ban_menu` | ban | ban | Open the ban menu | Requires GUI sfind/ui | +| `/kick_menu` | kick | kick | Open the kick menu | Requires GUI sfind/ui | +| `/mute_menu` | mute | mute | Open the mute menu | Requires GUI sfind/ui | +| `/getpos ` | teleport | get_pos | Allows the player to find out the position of another player | | +| `/kill ` | kill | protection_bypass | Kill anyone with command. | Check `essentials_killed_by` | +| `/heal []` | rollback | heal | Heals full health for a player. | Check `essentials_changed_by` | + + +## LICENSE + +* Copyright (C) 2024 SkyBuilder1717 MIT + +see [LICENSE](LICENSE) file. From 6d62fd236e3bfe644f7aa4ccf85a9fd6963afbb5 Mon Sep 17 00:00:00 2001 From: mckaygerhard Date: Tue, 28 May 2024 12:55:09 -0400 Subject: [PATCH 2/3] add myselft as mantainer cos i not iinly provide information also will fix update function --- README.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/README.md b/README.md index 21db65d..ef7b3b6 100644 --- a/README.md +++ b/README.md @@ -52,6 +52,19 @@ by other mods some already new but similar to other mods. ## LICENSE +* MIT + +Author and creator of the mod: + * Copyright (C) 2024 SkyBuilder1717 MIT +Contributors: + +* Copyright (C) 2024 mckaygerhard + see [LICENSE](LICENSE) file. + +Media: + +* textures/*.png - Copyright (C) 2024 SkyBuilder1717 +* sounds/*.png - Copyright (C) 2024 SkyBuilder1717 From 4ea052cbe3125de36d2a05be4bdc15e56d28ebd4 Mon Sep 17 00:00:00 2001 From: mckaygerhard Date: Tue, 28 May 2024 13:12:55 -0400 Subject: [PATCH 3/3] address workaround of error on mod loading for http api * we get some errors on load of nul value in http api, this becouse the mod must be in trusted mod and also in http api mods * this is related to issue https://github.com/SkyBuilder1717/essentials/issues/3 --- README.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index ef7b3b6..1817820 100644 --- a/README.md +++ b/README.md @@ -22,8 +22,10 @@ by other mods some already new but similar to other mods. #### Configurations -| config param | type | value | req | default/min/mx | example or description | -| --------------------- | ------ | ---------- | --- | --------------- | -------------------------------- | +| config param | type | value | req | default/min/mx | observations and examples | +| ---------------------------- | ------ | ---------- | --- | --------------- | -------------------------------- | +| secure.http_mods | string | essentials | yes | none set | geoip,governing,essentials | +| secure.trusted_mods | string | essentials | yes | none set | auth_rx,governingg,essentials | | essentials_additional_privileges | bool | true | no | true | Enables extra refined privilegies for the commands, see privilegie tables | | essentials_changed_by | bool | true | no | true | Allows to see if a player property whas altered (by) when was made by some admin | | essentials_killed_by | bool | true | no | true | Allows to see who a player was killed (by) when was killed by some admin |