Skip to content

Display

ickerio edited this page Nov 21, 2022 · 4 revisions

Factions mod already comes with a customized chat and customized tab list by default. For the majority of small to moderate size servers this would be a perfectly acceptable solution. This simply prepends the players faction, styled in their faction color, to the players name in the chat and in the tab menu player list. In the Config file, leaving changeChat and tabMenu as true will enable this default behaviour.

"display": {
    "changeChat": true, // Whether or not to modify chat
    "tabMenu": true, // Whether or not the tab menu should be modified
},

Placeholder API

For any server moderators wanting to take server customization further, Factions mod fully supports the Placeholder API by Patbox. This small mod allows moderators to place dynamic variables in any strings they display, giving the ability to dynamically customize any displayed strings including the chat, sidebar, and tab list. The Placeholder Documentation outlines how to use preprovided Placeholders as well as our custom Factions placeholders. Our placeholders include

  • %factions:name%
  • %factions:rank%
  • %factions:color%
  • %factions:description%
  • %factions:state% if a faction is open
  • %factions:power%
  • %factions:power_formatted%
  • %factions:max_power%
  • %factions:player_power%
  • %factions:required_power%
  • %factions:required_power_formatted%
  • %factions:chat% players chat mode Global Chat or Faction Chat

This means this mod is fully compatible with Styled Player List, Styled Chat, Holograms and any other mod that supports or uses the Placeholder API. You can use any of the above placeholders in any of the aforementioned mods.

More

Of course, you can always write your own Placeholders in Java or even hook into Factions mod yourself by having a look into our Javadoc (more specifically theapi package)

Clone this wiki locally