ScriptedEssentials
Discord Download

Documentation

Nicknames & Skins

Nicknames and skins let you change how a player appears for a recording. Set a name on its own, copy a skin, or use /nick skin <user> to apply both together.

Nick data is kept in the nicks/ folder, and skins are cached in nicks/cache/.

The profile menu

Run /nick or /skin on its own to open your profile. It has your nickname, a colour, and a skin, which you can pick from the list or type as any username or image link. There are also buttons to reset your nickname or skin, and Premium adds a Random Nick button.

Saving a nickname here doesn't change your skin. The skin box decides that.

Nicknames (/nick)

commands
/nick                     # the profile menu
/nick <name>              # yours
/nick off                 # remove yours
/nick <target> <name>     # someone else's
/nick <target> off
/nick info [player]       # history
/nick clearhistory
/nick help

& colour codes work if nickname.allow-colors is on.

Skins (/skin)

commands
/skin                # the profile menu
/skin help
/skin <player>       # that player's skin
/skin off            # back to your own
/nick skin <user>    # nickname and skin in one

Skin lookups can take a moment and successful results are cached. Apply the skin before recording and check it from another player's view.

In this section

Page Covers
Random nicknames (Premium) The username pool, profiles, auto-nick on join, similar names
Blacklist & filter Blocking names from the pool and from NPCs

Keeping nicknames through death (/nick keepnicks)

commands
/nick keepnicks <on|off>
yaml
nickname:
  keep-on-death: false

With this off, death can clear the nickname. In Premium, if a previous nickname is offered when the player rejoins, they can accept or decline it:

commands
/nick reequip accept
/nick reequip decline

Decline and they won't be asked about that name again.

Admin (/nicklist, /nick resetall)

commands
/nicklist        # every nickname in use
/nick resetall   # wipe every nickname and skin, after a confirm

Admins also get a Reset Everyone button in the profile menu, which asks first too.

Config

Full settings on Feature settings.

yaml
nickname:
  enabled: true
  max-length: 16
  allow-colors: true
  allow-formatting: true
  require-permission-for-colors: false

The plugin won't start with NickAPI installed, both change how names and skins get sent out. See Integrations.