NidToolbox: Player Manager module

[plugin logo small header]Player Manager module for NIDTOOLBOX Light

[kofi button blue]

Compatible with ECO 13+

NEW - if you would like to have YOUR SERVER LOGO appear in the notifications area in messages that come from NidToolbox. Please join my DISCORD and post them in #server-logos channel.

Useful in day to day administration of your citizens.

SUPPORT IS PROVIDED as well as SUGGESTIONS ARE ACCEPTED on my DISCORD [DISCORD TINY] HERE

FUNCTIONALITY

---

• Easy PLAYER RESETS to the starting state, including reimbursement of any DELETED ALPHA BACKER ITEMS, (see below for screenshots) each time you reset a player, a CONFIRMATION WINDOW will be displayed - providing the DETAILS OF THE RESET, as well as targeted player and their information. This allows you to ABORT THE PROCEDURE AT ANY TIME.
• VEHICLE MANAGEMENT COMMANDS, self rescue vehicle command with cooldown and CONFIGURABLE LIMITATIONS caloric cost, maximum distance and load level.
• Fixes some of the errors present in the vanilla game reset commands: non updating skill tree and ghosting issue.
• Setting of required PROFESSION LEVELS, including up levels and de-levels;
• Checking and changing the ​TASTINESS OF FOOD ITEMS​​ as well as setting/changing ​FAVORITE AND WORST FOOD FOR PERSON.
• Ability to alter and sync PLAYER LEVELS.
• Module takes into account TRANSLATED AND LOCALISED NAMES, should your server be running in language other than English. For example: You can use ГОТОВКА for Cooking or HOLZFÄLLEN for Logging.
• Module ACCEPTS PARTIAL NAMES for easier lookup.
• GRANTING and DEDUCTING of SPECIALTY POINTS, with respect and checks against locked and already invested points.
• ADDITIONAL USER TOOLTIP INFORMATION - IP, STEAMID and SLGID, with customisation of which user groups can see these.
• RESETTING INDIVIDUAL PROFESSIONS to the unlearnt state;
• As it is impossible to target talents by their localised (translated and displayed names), this module provides a HELPFUL WAY TO REMOVE TALENTS either ONE BY ONE or enmasse. Popup window WILL LIST ALL OF THE PLAYER'S TALENTS, including their links, so administrator may ensure they remove a desired talent.
• Ability to obtain GEO-LOCATION info on the player, THEIR IP ADDRESS and details about it. Allows TO DETECT PLAYERS USING SAME IP ADDRESS, for administrators who use this feature.
• Custom ANNOUNCEMENTS, WARNINGS, OFFLINE MESSAGES.

SETTINGS

---

Settings for the module are located in CONFIGS/NIDTOOLBOX/PLAYERMANAGER.JSON and deal mainly with visibility of the additional user tooltip information.

Code

{   "Info1": "NidToolbox Light: Player Manager settings.",   "ShowIPinTooltip": true,   "ShowSteamIdinTooltip": true,   "ShowSlgIdInTooltip": true,   "ShowShopsInTooltip": true,   "EnableUserVehicleRescueCommand": true,   "UserVehicleCommandCooldownMinutes": 120.0,   "BlackListed": false }

SHOWIPINTOOLTIP - sets IP Address visibility in the user's tooltip. Can be also changed in game via /tooltip-conf

SHOWSTEAMIDINTOOLTIP - sets Steam Id visibility in the user's tooltip. Can be also changed in game via /tooltip-conf

SHOWSLGIDINTOOLTIP - sets Slg Id visibility in the user's tooltip. Can be also changed in game via /tooltip-conf

ENABLEUSERVEHICLERESCUECOMMAND - Enables /car-rez command. Used on the issuing user, allows for rescue of stuck or otherwise inaccessible vehicle. Teleports vehicle to player.

USERVEHICLECOMMANDCOOLDOWNMINUTES - Cooldown for /car-rez in minutes.

REQUIREMENTS

---

As any module of NidToolbox set, it requires NID-CORE VERSION 1.10+ module, available in the MAIN FORUM THREAD: here

INSTALLATION

---

• Unpack .zip archive
• COPY Eco.Nid.PlayerManager.dll to MODS\NIDTOOLBOX\MODULES
• Configuration files will be created after first run and are located in \Configs\Mods\NidToolbox

USAGE NOTES

Module accepts partial names for skills, if serveral same partial names exist, you will have to be more specific.

Module accepts skill names in the language set on server. For example: You can use ГОТОВКА for Cooking or HOLZFÄLLEN for Logging.

COMMAND GROUPS

---

/HELP MANAGEPLAYER

Displays information about all commands contained within this module.

/NIDFOOD

Displays food related commands.

/CARS

Displays vehicles related commands.

GENERAL

---

/PLAYER-RL

Reloads and validates module configuration from file.

Code

/player-rl

/ANN

Sends server wide announcements. Has several advantages over the default announce: possibility to ADD THE MESSAGE TO NOTIFICATIONS, possibility to LEAVE THE MESSAGE FOR OFFLINE USERS, to check when they come online, ability to SHOW THE POPUP MESSAGE as either OKBOX - requiring user to confirm before it disappears (all actions blocked until OK is clicked), or standard INFOWINDOW - resizable but prone to disappearance at any click. Both popups accept all formatting options. Sending the message WITH DIFFERENT TAG, for example GENERAL instead of NOTIFICATIONS - this was requested by users that have Notifications cleared in chat filters.

/ANN string text (required), int size, bool showAsPopUp, bool showAsOKBox, bool leaveIfOffline, bool showInNotifications, string windowHeader, string tag

showAsPopUp - (Default: false) - sets message to be displayed as InfoBox - resizable and scrollable ;

showAsOKBox - (Default: true) - sets message to be displayed as OKBOx - requires click on OK from the user to go away, all actions are blocked;

leaveIfOffline - (Default: true) - stores message if the user is offline at the moment of sending, this message can be found and read through notification interface when user logs back in.

showInNotifications - (Default: true) - adds message to the notifications panel. If leaveIfOffline is set to on and user is offline, this setting is always true.

windowHeader - (Default: "Server Announcement") - se