Documentation

First steps

Change the entry of motd.motds in /minecraftbukkit/plugins/SmartPing/config.yml to something that represents your server or add new entries to motd.motds to let SmartPing pick a random MOTD every time the description is accessed.

Apply changes by using command /smartping reload and test your personal MOTD with /smartping test, the default MOTD with /smartping test #default, the MOTD for banned players with /smartping test #banned and the MOTD for not whitelisted players with /smartping test #forbidden.

If you want SmartPing to pick a random server icon every time someone views your server list entry, put image files into the /minecraftbukkit/plugins/SmartPing/backgrounds folder. You probably want to keep your current icon, so copy /minecraftbukkit/server-icon.png into this folder too. (Images that do not have dimensions of 64x64 or are not .png will be backed up and converted once)

config.yml

max_priority
Enable this if SmartPing can't apply its MOTD even if motd.enabled is true. This allows SmartPing to use
the highest available priority to change the MOTD.
allow_multiple
This defines how pings from an IP with multiple players assigned to are handled.
If true, the last logged in player of the IP is returned at ping. If false, motd.personal.multiple is returned.

icon.show_heads
If true, there will be the heads of the online players rendered over the icon.
icon.stick_ops
If true, displaying heads of an OP has more priority than displaying other heads.
icon.shuffle_heads
If true, the heads sorting is randomized. If false, they get sorted by when they joined the game.
icon.colors
The border colors of heads in "Red, Green, Blue" format. Optional: "Red, Green, Blue, Alpha" format.
overlay
Contains boolean fields that let you decide in which cases overlay icons are displayed.
overlay.clear_heads
If true, player heads and overlay icons are never displayed together. (Overlay gets more priority)

motd.enabled
If false, SmartPing won't change your MOTD and only affects icon and max players.
motd.motds
A list of random MOTDs. One of them will be shown in the server list entry. You can use static and dynamic variables here.
motd.personal
The texts that replace {PERSONAL} in MOTDs. The names describe which one is displayed on which player state. You can use static and dynamic and player related variables here.
motd.random_colors
A list of Minecraft color chars. The default value excludes black, white and 2x gray.
motd.time_format
A Java SimpleDateFormat argument that changes the way the {TIME} variable is displayed.
motd.hide_0_mails
If true, {ESSENTIALS_MAILS} is ignored when the mails amount is zero.
motd.use_mail_icon
If true, {ESSENTIALS_MAILS} displays an envelope icon before the mails amount. If false, it displays the word "mails".

slots.count
If this value is not zero, it overwrites the max players value shown in server list entries.
It does not actually affect the amount of players who can play at the same time.

log.enabled
If true, recognized players write a log line when they view their server lists. (for spying and stuff)
log.anonymous
If true, unrecognized or new players write a log line with (anonymous) as name when they view their server lists.
log.multiple
If true and allow_multiple is false, players whose {PERSONAL} text got replaced by motd.personal.multiple write a log line with (multiple) as name.
log.ips
If true, the IP address of a pinging person is attached to each ping log line.
log.performance
If true, the time (ms) needed to render icon and to generate personal MOTD is attached to each ping log line.


Comments

Posts Quoted:
Reply
Clear All Quotes