staffprofiles
Please see the project on GitHub for the most up-to-date documentation.
staffprofiles is a Minecraft plugin that assigns staff members a different game profile if they are joining using a specific hostname. It's an evolution of my proof-of-concept plugin hostprofiles into a more practical, specialized solution for staff management.
Non-technical example
The plugin essentially does the following when a player is logging in:
- It checks if the address that the player is using to connect matches a configured staff address
- If the address matches, it verifies that the player has a configured permission
- If both are true, the player UUID and username are changed, causing the server to treat the player as if they were on a separate Minecraft account.
An example:
If your server address is example.org, you could configure staff.example.org (the host) as a staff host
so that all players connecting using that host, if they have the permission staffprofile, are
connected using what is treated by the server like a separate account.
Configuration
The plugin is configured using a JSON file as opposed to a YAML file to reduce plugin jar size. Unfortunately, this means that the plugin configuration file cannot contain any comments.
Please see the reference below to learn about available configuration options:
hostRegex: A regular expression pattern that determines if a hostname should be treated as a staff hostname by matching
against the entire address
permission: The permission the player must have to be allowed to join using a staff hostname
uuidTransformer: Specifies the transformation of player UUIDs into staff profile UUIDs using a regex pattern. The format
is "pattern/replacement" where a pattern matches parts of the original UUID and replacement defines how to construct the
new UUID.
usernameTransformer: Specifies the transformation of player username into staff profile username using a regex pattern.
The format is "pattern/replacement" where a pattern matches parts of the original username and replacement defines
how to construct the new username.
