AuthMe/AuthMeReloaded

View on GitHub
src/main/java/fr/xephi/authme/settings/commandconfig/CommandSettingsHolder.java

Summary

Maintainability
A
0 mins
Test Coverage
package fr.xephi.authme.settings.commandconfig;

import ch.jalu.configme.SettingsHolder;
import ch.jalu.configme.configurationdata.CommentsConfiguration;
import ch.jalu.configme.properties.BeanProperty;
import ch.jalu.configme.properties.Property;

/**
 * Settings holder class for the commands.yml settings.
 */
public final class CommandSettingsHolder implements SettingsHolder {

    public static final Property<CommandConfig> COMMANDS =
        new BeanProperty<>(CommandConfig.class, "", new CommandConfig());

    private CommandSettingsHolder() {
    }

    @Override
    public void registerComments(CommentsConfiguration conf) {
        String[] rootComments = {
            "This configuration file allows you to execute commands on various events.",
            "Supported placeholders in commands:",
            "  %p is replaced with the player name.",
            "  %nick is replaced with the player's nick name",
            "  %ip is replaced with the player's IP address",
            "  %country is replaced with the player's country",
            "",
            "For example, if you want to send a welcome message to a player who just registered:",
            "onRegister:",
            "  welcome:",
            "    command: 'msg %p Welcome to the server!'",
            "    executor: CONSOLE",
            "",
            "This will make the console execute the msg command to the player.",
            "Each command under an event has a name you can choose freely (e.g. 'welcome' as above),",
            "after which a mandatory 'command' field defines the command to run,",
            "and 'executor' defines who will run the command (either PLAYER or CONSOLE). Longer example:",
            "onLogin:",
            "  welcome:",
            "    command: 'msg %p Welcome back!'",
            "    executor: PLAYER",
            "  broadcast:",
            "    command: 'broadcast %p has joined, welcome back!'",
            "    executor: CONSOLE",
            "",
            "You can also add delay to command. It will run after the specified ticks. Example:",
            "onLogin:",
            "  rules:",
            "    command: 'rules'",
            "    executor: PLAYER",
            "    delay: 200",
            "",
            "Supported command events: onLogin, onSessionLogin, onFirstLogin, onJoin, onLogout, onRegister, "
                + "onUnregister",
            "",
            "For onLogin and onFirstLogin, you can use 'ifNumberOfAccountsLessThan' and 'ifNumberOfAccountsAtLeast'",
            "to specify limits to how many accounts a player can have (matched by IP) for a command to be run:",
            "onLogin:",
            "  warnOnManyAccounts:",
            "    command: 'say Uh oh! %p has many alt accounts!'",
            "    executor: CONSOLE",
            "    ifNumberOfAccountsAtLeast: 5"
        };

        conf.setComment("", rootComments);
        conf.setComment("onFirstLogin",
            "Commands to run for players logging in whose 'last login date' was empty");
        conf.setComment("onUnregister",
            "Commands to run whenever a player is unregistered (by himself, or by an admin)");
        conf.setComment("onLogout",
            "These commands are called whenever a logged in player uses /logout or quits.",
            "The commands are not run if a player that was not logged in quits the server.",
            "Note: if your server crashes, these commands won't be run, so don't rely on them to undo",
            "'onLogin' commands that would be dangerous for non-logged in players to have!");
    }
}