NidToolbox: Player Manager module 1.0.10

Due to human (non-bot) spam the first contribution of a user has to be reviewed and activated manually, all further contributions do not require this.
As long as a user does not have at least one reviewed and activated contribution, the user is unable to edit his profile, set a avatar, title picture or a signature.

Contains commands useful in day-to-day player management, ability to Reset Skills, Talents and progression, set Job Level and refund specialisation points of any player on the server, geo-location and more.

Player Manager module

for NidToolbox Light

requries nid-core module available here



1586-default-violet-2-png



Useful in day to day administration of your citizens.


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.
  • 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.

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:

  1. Unpack .zip archive
  2. 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.


/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
/ip targetPlayer, true/false


/ip-list

Displays pop-up windows with a list of currently connected players with their IP Addresses.

/ip-list

Code
/ip-list


/ip-same

Returns list of players who are connected from the same IP Address.

/ip-same

Code
/ip-same



Screenshots:




  • Version 1.0.10

    Version 1.0.10:

    • Fixes job-reset command when used against modded skill that either has no talents or no selectable active talents. Huge thanks for @MNK for reporting on Discord.
  • Version 1.0.9

    Version 1.0.9:

    • Adds new command /on which displays list of players who are currently online as well as grand totals of all players, and offline ones. Command has two optional parameters format - accepting v for vertical user list alignment or h for the horizontal one, as well as optional parameter maxPerLine which limits users per one line in horizontal view. Issuing command with no parameters assumes the defaults - vertical view.
      Example use: /on or /on h, 6. Thx @Dennis for suggestion.
    • Position and size of the window can be saved for future uses, by closing it via the X button, available in the upper right corner.
    • Fixes display error on online user checking. Thx @Dennis and @Kye for reporting.

    forum.play.eco/core/attachment/1644/ forum.play.eco/core/attachment/1645/

    Images

  • Version 1.0.8

    Version 1.0.8:

    • Updates plugin to game version Eco 9.3
    • Fixes missing confirmation message to the target of the talents reset command.
  • Version 1.0.7

    Version 1.0.7

    • Module yet again accepts localised names. For example: You can use Готовка for Cooking or Holzfällen for Logging. Given your server runs the specific language version.
    • Feedback message will now clearly state which skill was trying to be removed (with skill link in the UI), as well as why it was not possible, i.e. player does not know it etc.
    • Most of the error logging removed from console and file log, unless the error is important. Removed things like skills not found, and simple command errors.
  • Version 1.0.6

    Version 1.0.5 & 1.0.6

    • Added new command:
      • 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.
      • spec-reportLists free and invested speciality points of the target player.[/tt]
    • Added online checks requirement for player reset commands. This is to avoid problem reported by users of the vanilla reset commands on offline players aka "ghosting" issue.
    • Removed backer items reimbursement as they are now available in the void storage.
    • Fixed display text in the talent reset error message.
    • 1.0.6: Fixed error messages on grant-spec command, to be clearer.
  • Version 1.0.5

    Version 1.0.5

    • Added new command:
      • 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.
      • spec-reportLists free and invested speciality points of the target player.[/tt]
    • Added online checks requirement for player reset commands. This is to avoid problem reported by users of the vanilla reset commands on offline players aka "ghosting" issue.
    • Removed backer items reimbursement as they are now available in the void storage.
    • Fixed display text in the talent reset error message.
  • Version 1.0.4

    Version 1.0.4:

    • Fixed confirmation window being sent to target player instead of the command issuer in case of /player-reset command. Thanks for the report to JessicaSky on Discord.
  • Version 1.0.3

    Version 1.0.3

    • Added new command: ip-same . It will display players sharing same IP Address if any are present.
    • Upgraded to full-fledged NidModule instead of a command snap-in.
    • Added new command ip-list. Lists all online users with their IP Addresses in the pop-up window.
    • Added requirement for nid-core module enforcement. If the module is not found or in wrong version, it will be reported to the server owner, instead of showing default net cryptic error message;
    • Migrated project to NetStandard 2.1;
  • Version 1.0.2

    Version 1.0.2 release notes:

    • added new command /player-refundspec; which refunds specialisation points and reset skills but does not clear character progress;
    • fixed problem with target user in skill individuals and talents commands; Thank you @KindKindle reporting on Discord;
    • fixed /player-reset not removing experience and spec points; thank you @AlexALX reporting on Discord;
    • fixed various typos in descriptions and window text; thank you @Ragnar for reporting.
  • Version 1.0.0