ECO: NidToolbox: Player Manager module v Script Mod für ECO

Downloads today

Downloads total

Comments

Player Manager module

for NidToolbox Light

Useful in day to day administration of your citizens.

Support is provided as well as suggestions are accepted on my Discord here

Player Manager module allows:

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.
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;
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 file:

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,
  "ShowTooltipInfoToGroups": [
    "Admin"
  ]
}

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

ShowTooltipInfoToGroups - EM Groups included in this list can view additional tooltip info, mentioned above. Can be set in game via /tooltip-grpAdd

and /tooltip-grpdel

Requirements:

As any module of NidToolbox set, it requires nid-core version 1.0.3+ module, available in the main forum thread: here

How to install:

Unpack .zip archive
Copy nid-playermanager.dll to Mods\NidToolbox\Modules

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.

Available commands:

/help ManagePlayer

Displays information about all commands contained within this module.

/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") - sets title of the announcement as well as title of the window, if any of the popups are selected.

tag - (Default: Notifications) - sets the tag of the message. Requested by people who have everything but General filtered off. Accepts either Notifications or General.

Code

/Ann We are wiping the server in two days!

/Ann Free items available at the general stockpile, 32, false, true

/AnnTest

Sends warning to the target user. Requires only two arguments, rest is assumed automatically. Advantages over the vanilla warning are the same like in case of the announcement: ability to leave this message if user is offline, different popup options, sizing etc.

Code

/AnnTest Here is my test announcement.

/Warn

/Warn User targetUser (required), string text(required), int size, bool showAsPopUp, bool showAsOKBox, bool leaveIfOffline, string windowHeader

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") - sets title of the announcement as well as title of the window, if any of the popups are selected.

Code

/Warn Boop, Clean up your rubble!

/Warn Boop, Clean up your rubble!, 28, false, true, true, Warning

/on

Shows online players. Has two optional parameters - format and maxPerLine. Format accepts two values: v for vertical list and h for horizontal; maxPerLine is an integer limiting max number of usernames per line.

Command can be triggered with just its name and then it will launch with default values - vertical list.

/on string format, int maxPerLine.

Code

/on
/on h, 6

/grant-spec

Grants or deducts exact amount of specialty points. Use negative numbers to deduct. It has checks against already invested points and those that are otherwise locked.

/grant-spec User targetPlayer, int amount

Code

/grant-spec targetPlayer, amount

/spec-report

Lists free and invested speciality points of the target player.

/spec-report User targetPlayer,

Code

/spec-report targetPlayer

/talent-unlearn

Unlearns specified talent. IMPORTANT: As talents follow own naming format, it is recommended to use /talent-list to obtain ID names for this command. If the requested talent is not found, information window will appear by default.

/talent-unlearn User targetPlayer, string talentName

Code

/talent-unlearn targetPlayer, talentName

/talents-list

Lists talents currently known by the target player. Provides naming IDs for the command /talent-unlearn. Provided talents are linked and available for mouse over to ensure proper talent is removed.

/talents-list User targetPlayer

Code

/talents-list targetPlayer

/talents-reset

Resets ALL talents of the target player.

/talent-reset User targetPlayer

Code

/talent-reset targetPlayer

/player-reset

Resets skills, talents, inventory, stats of the target player to the starting state. Effectively making them born anew. Contrary to the game method, this one will also reimburse the player any alpha backer items, they have entitlement for. Targets keep all of their plots and other owned property. Before the reset occurs, confirmation window is provided with all details of the reset. See below for screenshots.

/player-reset User targetPlayer

Code

/player-reset targetPlayer

/player-refundspec

Refunds specialisation points and resets skills, but preserves character's progress: levels and experience points.

After the refund player can pick their skills anew.

/player-refundspec User targetPlayer

Code

/player-refundspec targetPlayer

/job-reset

Resets specified profession to the starting, unlearnt state. Contrary to the game method, it uses own way of searching through skills, making sure the correct skill is targeted.

/job-reset User targetPlayer, string skillName

Code

/job-reset targetPlayer, skillName

/job-set

Set specified skill to the desired level. This command sets the job level to the one indicated by the issuer. It ensures that server stats are updated properly as well as the user info available in real time. Information on the command effect is sent both to the issuer and to the receiver but not to the whole server.

/job-set User targetPlayer, string skillName, int level

Code

/job-set targetPlayer, skillName, level

/ip

Gets current IP address of the player. Allow for detailed (default) or simple check. Detailed check offers approximate location (country and city of the Internet Service Provider), simple check returns only IP address.

/ip User targetPlayer, bool simple

Code