Difference between revisions of "LimitedNametags"

From SupaHam
Jump to: navigation, search
(Added version 1.1 documentation.)
(Added config.yml example.)
Line 39: Line 39:
 
|  
 
|  
 
|}
 
|}
 +
 +
{{example|title=Generic config.yml|text=
 +
<syntaxhighlight lang="yaml">
 +
worlds:
 +
  # Tell LimitedNametags to operate in a world named ''world''.
 +
  world:
 +
    # Whether to enable this world, this is provided as a convenient option instead of having to remove the whole world configuration.
 +
    enabled: true
 +
    # Permission based groups to check for each player, with the default always given to the player.
 +
    radius-groups:
 +
      # default group to give all players, with a nametag visibility radius of 10 meters/blocks. This is required and always needs to be defined.
 +
      default: 10.0
 +
      # vip group to give to players by giving them the permission 'limitednametags.radius.vip', with a nametag visibility radius of 20 meters/blocks.
 +
      vip: 20.0
 +
    # client team name, don't worry about this unless told to.
 +
    team-name: ltd-nt
 +
</syntaxhighlight>
 +
}}

Revision as of 06:54, 12 March 2015

LimitedNametags

LimitedNametags is a Bukkit plugin created by SupaHam, that adds the possibility to limit nametag view distance. It requires almost no setup, other than installing it and ProtocolLib in your server's plugins directory. Credit goes to gsand AKA Clippy in the Spigot community for bringing this concept of a plugin to me.

Commands

Tip: Confused with command syntax or want to make the most out of them? Head over here for help.
Parent Command Permission Aliases Description
limitednametags limitednametags.cmd.reload lt Reloads the LimitedNametags configuration file and refreshes all online players.

Configuration

Tip: Before starting to mess around with a configuration file, please head over here and familiarise yourself.

LimitedNametags provides configurable options for the user to tweak the plugin just the way they like. The configuration is currently per world to allow the user to change the functionality to their liking.

config.yml

Configuration Value Description
worlds Section This section contains a list of world names that LimitedNametags should operate in.
worlds.<world> Section This section is named after a specific existing world that LimitedNametags should operate in. Use '*' (asterisk) to refer to all worlds.
worlds.<world>.enabled Boolean This boolean specifies whether LimitedNametags should use this world. This is simply a convenient method of telling the plugin to not use <world> without the user actually deleting the data.
(OUTDATED) worlds.<world>.nametag-radius Double This double specifies the view distance (in block units) that players should be able to see each other's nametags.
Since v1.1 worlds.<world>.radius-groups Section This section specifies the radius groups used to default what radius a player gets based on their permission. If they don't have permission to any of the groups, LimitedNametags will fallback to the group called default, thus the default group must always be defined!
Since v1.1 worlds.<world>.radius-groups.<groupName> Double This double specifies the radius of nametag visibility for players in this group. A radius group is applied to a player by giving them the permission node 'limitednametags.radius.<groupName>', where <groupName> is the same as this configuration key, except lowercased; meaning ABC would be abc. Please do not confuse this with group implementations provided by permission plugins.
worlds.<world>.team-name String This string specifies the team name that manages the nametag visibility function. This is a technical feature that you as a user do not need to worry about unless told so.
Example: Generic config.yml
worlds:
  # Tell LimitedNametags to operate in a world named ''world''.
  world:
    # Whether to enable this world, this is provided as a convenient option instead of having to remove the whole world configuration.
    enabled: true
    # Permission based groups to check for each player, with the default always given to the player.
    radius-groups:
      # default group to give all players, with a nametag visibility radius of 10 meters/blocks. This is required and always needs to be defined.
      default: 10.0
      # vip group to give to players by giving them the permission 'limitednametags.radius.vip', with a nametag visibility radius of 20 meters/blocks.
      vip: 20.0
    # client team name, don't worry about this unless told to.
    team-name: ltd-nt