VScoreboard

A lightweight and configurable scoreboard plugin for modern Paper servers.

VScoreboard lets you create clean, dynamic scoreboards using PlaceholderAPI placeholders, MiniMessage styling, and conditional scoreboard selection.

Features

• Fully configurable scoreboard layout
• Multiple scoreboards in one config
• Conditional scoreboard selection
• PlaceholderAPI support
• MiniMessage color and gradient support
• /scoreboardtoggle command
• Persistent per-player scoreboard visibility
• /scoreboardreload command
• bStats integration
• Lightweight and simple setup

Commands

Command	Description	Permission
/scoreboardtoggle	Toggles your scoreboard visibility	vortex.scoreboard.toggle
/sbtoggle	Alias for /scoreboardtoggle	vortex.scoreboard.toggle
/togglescoreboard	Alias for /scoreboardtoggle	vortex.scoreboard.toggle
/scoreboardreload	Reloads the scoreboard configuration	vortex.scoreboard.reload

Multiple Scoreboards

You can define multiple scoreboards in the config. The plugin checks them from top to bottom and displays the first scoreboard whose condition matches.

Example:

scoreboards:
  staff:
    title: '<gradient:#6ee7ff:#8b5cf6><bold>Staff</bold></gradient>'
    display-condition: '%luckperms_in_group_admin%==yes || %luckperms_in_group_mod%==yes'
    lines:
      - '<dark_gray>----------------'
      - '<gray>Player <dark_gray>» <white>%player_name%'
      - '<gray>Staff Mode <dark_gray>» <green>Active'
      - '<dark_gray>----------------'

  default:
    title: '<gradient:#6ee7ff:#8b5cf6><bold>Vortex Studio</bold></gradient>'
    display-condition: 'true'
    lines:
      - '<gray>Player <dark_gray>» <white>%player_name%'
      - '<gray>Online <dark_gray>» <white>%server_online%'

Conditions

Supported comparison operators:

• ==
• !=
• >=
• <=
• >
• <

Supported logic:

• && for AND
• || for OR
• parentheses for grouping

Requirements

• Paper 1.21.x or compatible fork
• Java 21
• PlaceholderAPI

Purpur 1.21.x should also work because it is Paper-based.

Metrics

This plugin uses bStats to collect anonymous usage statistics. You can disable bStats globally in the bStats config folder.