-
Notifications
You must be signed in to change notification settings - Fork 13
Placeholders
As of LegacyFactions v1.2.0 all placeholders are handle through our own system. This means all placeholders are the same across every placeholder plugin! Also - we can easily add more placeholders as they are requested!
The following placeholder plugins are currently supported:
| Name | Relational? | Bracket Example |
|---|---|---|
| PlaceholderAPI | Yes | %factions_faction_name% |
| MVdWPlaceholderAPI | No | {factions_faction_name} |
The following plugins support LegacyFactions placeholders:
| Name | Relational? | Placeholder Plugin? |
|---|---|---|
| DeluxeChat | Yes | PlaceholderAPI |
| ChatControl Pro | Yes | PlaceholderAPI |
| VentureChat | No | PlaceholderAPI |
| HolographicDisplays | No (only location placeholders) | No |
| ChatEx | No (but requested) | No |
| HeroChat 5 | No | PlaceholderAPI |
| HeroChat 6 | No (requested it and was ignored) | PlaceholderAPI |
| Legendchat | No (but requested) | No |
The following plugins do not support LegacyFactions placeholders, although we have asked for it:
- Essentials Chat - they refuse to add support (just use our inbuilt public chat formatter, its more powerful)
Just because PlaceholderAPI supports relational placeholders, it doesn't mean the plugin you are using supports it.
The plugin developer needs to pass two players to the set method in PlaceholderAPI. This information is outlined in the 2.8 update post: https://www.spigotmc.org/resources/placeholderapi.6245/update?update=167267
If they don't use placeholder API they need to create an event or method available that allows for this.
Please link developers to here if their plugin does not support relational placeholders.
The plugin you're trying to use doesn't support PlaceholderAPI relational placeholders - ask the developer to fix this!
It has been reported that you need to prefix placeholderapi_ to placeholders in featherboard. E.g. placeholderapi_factions_faction_name
factions_faction_id
The id of the faction the player is in.
factions_faction_name
The name of the faction the player is in.
factions_faction_name_blankwild
The name of the faction the player is in. Unless the faction is wilderness, in which it will be blank.
factions_faction_description
The description of the faction the player is in.
factions_faction_description_blankwild
The description of the faction the player is in. Unless the faction is wilderness, in which it will be blank.
factions_faction_admin
The admin of the faction the player is in.
factions_faction_power
The power of the faction the player is in.
factions_faction_powermax
The max power of the faction the player is in.
factions_faction_powerboost
The powerboost of the faction the player is in.
factions_faction_founded
The founded date of the faction the player is in.
factions_faction_count_claims (since 1.4.5)
The amount of claims the faction has.
factions_faction_count_members (since 1.4.5)
The amount of members the faction has.
factions_faction_count_members_coleaders (since 1.4.5)
The amount of coleader members the faction has.
factions_faction_count_members_moderator (since 1.4.5)
The amount of moderator members the faction has.
factions_faction_count_members_normal (since 1.4.5)
The amount of normal members the faction has.
factions_player_name
The name of the player.
factions_player_role
The role of the player.
factions_player_role_prefix
The players role as a prefix.
factions_player_kills
The kills recorded by LegacyFactions that the player has.
factions_player_deaths
The deaths recorded by LegacyFactions that the player has.
factions_player_deaths
The deaths recorded by LegacyFactions that the player has.
factions_player_title
Get the players title.
factions_player_chattag
Get the players chat tag.
factions_player_power
Get the players power.
factions_location_relation
Get the relation of the faction at the current players location.
factions_location_relation_colour
Get the colour relation of the faction at the current players location.
factions_location_faction_name
Get the name of the faction at the current players location.
factions_location_faction_description
Get the description of the faction at the current players location.
factions_location_faction_founded
Get the founded date of the faction at the current players location.
Relational placeholders are only supported in Placeholder API 2.8.
rel_factions_relation
The relationship to the player (returns nice name).
rel_factions_relation_colour ('color' works too)
The colour relation of the above.
rel_factions_is_enemy
Returns "true" if the relationship is enemy.
rel_factions_is_ally
Returns "true" if the relationship is ally.
rel_factions_is_truce
Returns "true" if the relationship is truce.
rel_factions_is_neutral
Returns "true" if the relationship is neutral.
rel_factions_is_member
Returns "true" if the relationship is member.
rel_factions_player_chattag
Get the players chat tag with relation colour.
factions_count_factions
Count of all factions on the server.
factions_count_fplayers
Count of all fplayers on the server.
factions_count_claims
Global count of claims on the server.
📚 Looking for documentation? You're in the right place. Start with the items on the right of the page.
🐞 Found a bug? Please open a GitHub Issue.
🆘 Need help? Jump on our discord channel - we'll do our best to help 😄
⭐️ If you like LegacyFactions please leave a review and let others know!