Actionbars

Module info
Configuration	actionbars.yml
Manager	ActionbarManager
Support	Bukkit: 1.8+ Sponge: v6.0+ (MC 1.11+)
Free version	✔
Proxy-configurable	❌

Actionbars are one line strings displayed above the player's hotbar. This module prints them in configurable time intervals. They can be used to show useful information like a player's balance or as advertisements:

Default configuration (actionbars.yml in 1.8+)

actionbars:
  settings:
    enabled: true
    random-order: false
    prefix:
      enabled: false
      format: '&8[&5&lAds&8] &f'
    sending-timeout-ms: 10000
    placeholder-types:
    - JUST_NAME
    - SERVER
  discord:
    texts:
      english: '&9Join Discord to chat with friends!'
      italian: '&9Entra su Discord per chattare con amici!'
  store:
    texts:
      english: '&6Visit the Store if you want to donate!'
      italian: '&6Visita lo Store se vuoi fare una donazione!'
  vote:
    texts:
      english: '&aRemember to vote us everyday!'
      italian: '&aRicorda di votarci ogni giorno!'
  welcome:
    texts:
      english: '&bWelcome to the server, &f{player}&b!'
      italian: '&bBenvenuti nel server, &f{player}&b!'
  date:
    texts:
      english: '&dDate: &f{date_full}&d.'
      italian: '&dData: &f{date_full}&d.'
  last:
    texts:
      english: '&cNext one will not be shown.'
      italian: '&cLa prossima non verrà mostrata.'
  hidden:
    texts:
      english: '&fThis text will not be shown.'
      italian: '&fQuesto testo non verrà mostrato.'
    hidden: true

Setup

The following snippet of code represents and explains the actionbars' configuration.

actionbars: 
  settings:
    enabled: true # whether to enable or disable this module
    random-order: false # whether to use a random order when sending the actionbars
    prefix:
      enabled: true # whether to add a prefix at the beginning of every actionbar
      format: '&8[&5&lAds&8] &f' # the prefix to add, if enabled
    sending-timeout-ms: 10000 # timeout between sendings, in milliseconds
    placeholder-types: # read below
    - JUST_NAME
    - SERVER
  # ...default actionbars...

Just like for the other modules, you have to specify which placeholder types you wish to use. Refer to the Modules/Placeholders page for more info.

Adding actionbars

To add a new actionbar, you just need to specify its ID and its texts. The ID has to respect the following pattern: ^[a-zA-Z0-9-_]{2,36}$.

    # ...actionbars' settings...
    placeholder-types: 
    - JUST_NAME
    - SERVER
    - INTEGRATIONS # this is required to use the {balance} placeholder
  # ...default actionbars...
  new-actionbar: # ID - required
    texts:
      english: '&2&lBalance: &f${balance}' # main language's translation - required
      italian: '&2&lConto: &f${balance}' # other language's translation - optional
    hidden: false # actionbar's visibility - optional; false if not specified

...which, after a /chatplugin reload, will result in:

---

ChatPlugin - Un plugin completo ma leggero che gestisce semplicemente troppe funzionalità!
© 2024  Remigio07

Questa wiki è attualmente aggiornata alla versione 1.9.10.
Si prega di segnalare imprecisioni ed errori di ortografia come descritto a Home/Reporting issues.