Skip to content

Commands & Permissions

Robin edited this page May 31, 2023 · 4 revisions

Introduction

This page has all the information regarding Commands, Permissions and Placeholders for EternalTags.

How do I use this?

Permission Usage

To use these commands, You need to have the permission nodes associated with them. OP Players will automatically be assigned these permissions. For any player who isn't an operator, You will need to use a permissions plugin such as LuckPerms to set this up.

Command Usage

Aliases for EternalTags commands include /eternaltags, All commands and aliases can be modified in /plugins/EternalTags/commands/tags.yml. Anytime you see <brackets> in a command, you are required to include that argument in your command. If the command arguments contain a [brackets], This argument is optional and can be ignored.

Commands & Permissions

Command Description Permission Node
/tags Opens the main tags gui. This command permission is required for all other sub commands. eternaltags.use
/tags help Displays a list of plugin commands -
/tags reload Reloads the plugin's files and applies any changes eternaltags.reload
/tags categories Opens the categories GUI eternaltags.categories
/tags clear Clears your current active tag. eternaltags.clear
/tags clear [player] [silent] Clear's another player's current eternaltags.clear.other
/tags convert <plugin> Converts tags from other tag plugins to EternalTags eternaltags.convert
/tags create <name> <tag> Creates a new tag eternaltags.create
/tags delete <tag> Deletes a tag and removes the active users eternaltags.delete
/tags edit Base command for all tag editing. eternaltags.edit
/tags edit category <tag> <newCategory> Changes a tag's category
/tags edit description <tag> <order> <line> Changes a tag's description, setting line to "remove" will remove line.
/tags edit icon <tag> [remove] Changes tag icon to the item in the player's hand.
/tags edit name <tag> <name> Changes a tag's name.
/tags edit order <tag> <order> Changes a tag's order
/tags edit permission <tag> <permission> Changes a tag's permission
/tags edit tag <tag> <new-display-tag> Changes a tag's display text.
/tags favorite [tag] Can be used to option the Favorites GUI or add/remove a tag as a favorite eternaltags.favorite
/tags random Will equip the player with a random tag they own eternaltags.random
/tags search <keyword> Will search for a tag in the gui eternaltags.search
/tags set <tag> Changes your current active tag eternaltags.set
/tags set <tag> [player] [silent] CHanges another player's current active tag eternaltags.set.other
/tags setall <tag> [silent] Changes all online player's active tag eternaltags.setall

PlaceholderAPI Placeholders

All PlaceholderAPI placeholders will begin with eternaltags_ and require %percentage symbols% to work. A working example is %eternaltags_tag%

Placeholder Description
tag Displays the player's active tag with colours & placeholders, If empty will return ""
tag_formatted Displays the player's active tag with colours & placeholders, If empty will return default value (Defined in config.yml)
tag_stripped Display's the player's active tag without any changes (Except Oraxen)
tag_stripped_formatted Display's the player's active tag without changes (Except Oraxen), Shows default value when empty
tag_name The active tag display name
tag_id The active tag id
tag_permission The active tag permission
tag_description The active tag description
tag_order The active tag order
active If the player has a tag active (Returns true/false)
total Total tags available number
joined All player's tags joined in a string
unlocked Total tags unlocked
favourites Total tags set as a favourite
get_<tag> Shows the display tag for the tag with the given id
get-formatted_<tag> Shows the display tag for the given id, Shows default value when empty
has_<tag> Displays true/false on whether a user has the given tag
has-unlocked_<tag> Displays a formatted result on whether a user has the given tag
active_<tag> true/false on whether the given tag is active for the user