WiFlow's Scoreboard | Animations & Conditions

Dynamic scoreboards that react to everything. Page rotation, per-profile logos, auto-sizing, conditional rendering, animated text, and deep WiFlowPlaceholderAPI integration. Region-based, rank-based, faction-based, or anything else you can imagine.

The Killer Feature: WiFlow's PlaceholderAPI Integration

Any plugin with a WiFlowPlaceholderAPI expansion can control which scoreboard players see.

Install an expansion. Use it as a condition. Done.

/wpapi ecloud download orbisguard
/wpapi ecloud download luckperms
/wpapi ecloud download hyfaction

Now your scoreboard reacts to everything:

• Player enters spawn → Spawn scoreboard with welcome message & spawn logo
• Player joins a faction → Faction scoreboard with power/members
• Player ranks up to VIP → VIP scoreboard with exclusive logo & perks
• Player enters combat → Combat scoreboard with timer
• Player enters a mine → Mining scoreboard with reset timer

{
  "profiles": [
    {
      "condition": "orbisguard_region",
      "equals": "spawn",
      "logo": { "image": "spawn_logo.png" },
      "title": { "text": "[#55ff55]SPAWN" },
      "lines": { "content": ["Welcome to Spawn!", "You are safe here!"] }
    },
    {
      "condition": "luckperms_primary_group",
      "equals": "vip",
      "logo": { "image": "vip_logo.png" },
      "lines": { "content": ["[#ffaa00]VIP Member", "Exclusive perks active!"] }
    },
    {
      "condition": "hyfaction_name",
      "notEquals": "",
      "lines": { "content": ["Faction: {hyfaction_name}", "Power: {hyfaction_power}"] }
    },
    {
      "isDefault": true,
      "pages": [
        { "duration": 5.0, "lines": { "content": ["Player: {player}", "Online: {online}"] } },
        { "duration": 4.0, "title": { "text": "Stats" }, "lines": { "content": ["Playtime: {playtime}", "TPS: {tps}"] } }
      ]
    }
  ]
}

The entire expansion ecosystem works as conditions:

If a placeholder exists, you can switch scoreboards with it.

Features

• Page Rotation - Multiple pages per profile, auto-cycling with configurable duration and per-page titles
• Per-Profile Logos - Different logos for each profile, placed in mods/WiFlowScoreboard/images/
• Auto-Sizing - Width and height auto-adjust based on visible content
• In-Game Editor - Edit worlds, profiles, pages, and lines with /sb edit
• Conditional Profiles - Switch scoreboards based on any placeholder value
• Conditional Lines - Show/hide individual lines with 9 comparison operators
• Animated Text - Rainbow, gradient, pulse, shimmer, breathe, glow, strobe, and custom animations
• Position Presets - 9 positions: center-right, top-left, bottom-center, etc.
• World-Specific Scoreboards - Different scoreboards for each world
• Permission Variants - Fallback to permission checks when no placeholder matches
• Built-in Placeholders - Player info, server stats, playtime, TPS
• Playtime Tracking - Session and total playtime (persisted across restarts)
• Hot Reload - Change configs without restarting (/sb reload)

Page Rotation

Add multiple pages to any profile. Each page has its own content and optional title override:

"pages": [
  {
    "duration": 5.0,
    "lines": { "content": ["Player: {player}", "World: {world}"] }
  },
  {
    "duration": 4.0,
    "title": { "show": true, "text": "Stats" },
    "lines": { "content": ["Playtime: {playtime}", "TPS: {tps}"] }
  }
]

Pages auto-rotate. When pages is present, it replaces the profile's lines.

Custom Logos

Place images in mods/WiFlowScoreboard/images/ and reference them by filename:

"logo": {
  "show": true,
  "image": "my_logo.png",
  "width": 240,
  "height": 137
}

Each profile can override the logo with its own "logo": { "image": "vip_logo.png" }. Per-profile fields merge with the top-level — only set what you want to change.

Conditional Lines

Show different content based on placeholder values within a single scoreboard:

{
  "condition": "{orbisguard_flag_pvp}",
  "equals": "allow",
  "then": "[#ff5555]PVP ENABLED",
  "else": "[#55ff55]Safe Zone"
}

Tip: Omit else to completely hide the line when false. Pairs great with auto-height sizing.

Supported comparisons: equals, notEquals, contains, startsWith, endsWith, greaterThan, lessThan, greaterThanOrEquals, lessThanOrEquals

Auto-Sizing

The scoreboard automatically adjusts its width and height based on visible content:

"size": {
  "autoHeight": true,
  "autoWidth": true,
  "minWidth": 200,
  "maxWidth": 500
}

When conditional lines hide, the panel shrinks. When long placeholders expand, the width grows. Fully configurable with min/max bounds.

Built-in Placeholders

These work out of the box without WiFlowPlaceholderAPI:

Animations

Add animations to any line:

[anim:rainbow]Welcome to the server!
[anim:gradient:#ff0000:#0000ff]Red to Blue
[anim:pulse:#ffffff:#ffaa00]Pulsing gold

Quick Start

1. Drop the JAR in your mods/ folder
2. Install WiFlowPlaceholderAPI (optional, for expansion placeholders)
3. Download expansions: /wpapi ecloud download <name>
4. Edit files in mods/WiFlowScoreboard/scoreboards/
5. Place logos in mods/WiFlowScoreboard/images/
6. Use /sb reload to apply changes

mods/WiFlowScoreboard/
├── config.json              # Global settings
├── playtime.json            # Persistent playtime data
├── scoreboards/
│   └── default.json         # Scoreboard profiles
├── images/                  # Custom logos (PNG, JPG)
└── animations/
    └── custom.json          # Custom animations

Commands

Aliases: /scoreboard, /wsb

Need Help?

Join the Discord server for:

• Setup help and questions
• Config examples
• Feature requests
• Bug reports

Contact: w1fl0w on Discord