Skip to content

Getting started ​

FeatherBoard turns the vanilla sidebar into a fully animated scoreboard. Boards are plain YAML files, so you can build everything from a one-line counter to a rotating news ticker with images, custom fonts and PlaceholderAPI data.

This guide takes you from an empty server to a working board in a few minutes.

Requirements ​

RequirementVersionNotes
ServerSpigot 26.3Paper usually works, but Spigot is the tested target. Other server software is not supported.
Java25Required by the 26.3 server line.
ProtocolLib5.5.0+Use the Spigot build when the GitHub release lags behind.
PlaceholderAPI2.12.3+Required at runtime; download the release jar, not the bare Maven artifact.
VaultOptionalOnly needed for GROUP scoreboard assignment.

Use matching versions

FeatherBoard 7 targets Spigot/Paper 26.3. If you run an older server line, use the FeatherBoard release that matches that server version instead of mixing jars.

Install ​

  1. Stop the server.
  2. Put FeatherBoard.jar, ProtocolLib.jar and PlaceholderAPI.jar in the plugins/ folder.
  3. Start the server. FeatherBoard creates its data folder on first start.
  4. Run /fb about in-game or from the console to confirm the plugin loaded.

On first start the plugin creates its data folder and the files it needs. A full setup looks like this:

text
plugins/
├── FeatherBoard.jar
├── ProtocolLib.jar
├── PlaceholderAPI.jar
└── FeatherBoard/
    ├── config.yml
    ├── scoreboards/
    │   ├── default.yml
    │   ├── default-images.yml
    │   └── benchmark.yml
    ├── effects/              # custom effects (created as needed)
    ├── lang/                 # optional message overrides
    └── resource-pack/        # generated when images or fonts are used

default.yml is enabled for every player through featherboard.group.default. Keep it as a working example, or replace its contents with your own design.

Dependencies

FeatherBoard declares ProtocolLib and PlaceholderAPI as hard dependencies. If either jar is missing, the plugin disables itself and the folder is not generated.

Create your first scoreboard ​

Create plugins/FeatherBoard/scoreboards/myboard.yml:

yaml
# Optional: settings and scripts live at the root of the file.
settings:
  # Higher priority wins when several boards are assigned to a player.
  priority: 10
  # This board is assigned with the permission featherboard.group.myboard.
  assigning: 'PERMISSION'

# A dedicated title section. The first line under "lines" is also used as the title
# when this section is omitted.
title:
  frames:
    - '&c&lMy&e&lServer'
  interval: 20

lines:
  header:
    frames:
      - '&8&m--------------------'
    interval: 100
  player:
    frames:
      - '&7Player: &f%player_name%'
    interval: 20
  online:
    frames:
      - '&7Online: &a%server_online%'
    interval: 40
  world:
    frames:
      - '&7World: &b%player_world%'
    interval: 40
  footer:
    frames:
      - '&8&m--------------------'
    interval: 100

The file name is the board name, so this board is called myboard. Grant the matching permission to the players who should see it:

text
/lp group default permission set featherboard.group.myboard true

Now load the new file and show it:

text
/fb reload -all
/fb show myboard

/fb reload -all is needed when you add a new file. /fb reload myboard only reloads an existing board, and is the faster option while you are tweaking a design.

Verify that everything works ​

CommandWhat it checks
/fb aboutPlugin and framework version.
/fb permissionsWhich FeatherBoard permissions you currently have.
/fb parse &aHello %player_name%Parses text, effects and placeholders and prints the result.
/fb show myboardForces a board for yourself, bypassing assignment.
/fb debugCreates a debug dump and uploads it to Ubuntu Paste. Include the link when asking for support.

Common first-run problems ​

The board does not appear

Check, in this order:

  1. Is the board assigned? See assigning scoreboards.
  2. Does the player have featherboard.group.myboard?
  3. Is the world listed in disabled-worlds?
  4. Is the YAML valid? Run /fb reload myboard and read the console.
  5. Is tweaks.default-hidden enabled in config.yml? Players then need /fb on.
Images or custom fonts do not show

Images and fonts need a resource pack. Check that resource-pack.enabled is true and that players accepted the resource pack prompt. A board with images can define a fallback board for players who reject it. See images and fonts.

The plugin disables on startup

This is almost always a dependency problem. Confirm that ProtocolLib and PlaceholderAPI are present, enabled, and built for the same server version. Check the first lines of the server log for the exact missing dependency.

Updating ​

  1. Back up plugins/FeatherBoard/.
  2. Stop the server.
  3. Replace FeatherBoard.jar with the new release.
  4. Start the server and check console for config migration messages.

Do not change the config: number in config.yml; it is used by the plugin to migrate the file. If a release adds new keys, the plugin fills them in automatically.

Next steps ​

Released under a proprietary license. FeatherBoard is not affiliated with Mojang or Microsoft.