WiFlow's Scoreboard | Animations & Conditions

Dynamic scoreboards that react to everything. Deeply integrates with WiFlowPlaceholderAPI - any plugin with an expansion can drive your scoreboard. 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 marketplace download orbisguard
/wpapi marketplace download luckperms
/wpapi marketplace download hyfaction

Now your scoreboard reacts to everything:

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

{
  "profiles": [
    {
      "condition": "orbisguard_region",
      "equals": "spawn",
      "title": { "text": "[#55ff55]SPAWN" },
      "lines": { "content": ["Welcome to Spawn!", "You are safe here!"] }
    },
    {
      "condition": "luckperms_primary_group",
      "equals": "vip",
      "lines": { "content": ["[#ffaa00]VIP Member", "Exclusive perks active!"] }
    },
    {
      "condition": "hyfaction_name",
      "notEquals": "",
      "lines": { "content": ["Faction: {hyfaction_name}", "Power: {hyfaction_power}"] }
    },
    {
      "isDefault": true,
      "lines": { "content": ["Default scoreboard"] }
    }
  ]
}

The entire expansion ecosystem works as conditions:

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

More Features

• World-Specific Scoreboards - Different scoreboards for each world
• Permission-Based Variants - Fallback to permission checks when no placeholder matches
• Conditional Lines - Show/hide individual lines based on placeholder values
• Animated Text - Rainbow, gradient, pulse, and custom color animations
• 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)

Conditional Lines

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

{
  "lines": [
    {
      "condition": "{orbisguard_flag_pvp}",
      "equals": "allow",
      "then": "[#ff5555]PVP ENABLED",
      "else": "[#55ff55]Safe Zone"
    },
    {
      "condition": "{combatlog_active}",
      "equals": "true",
      "then": "[#ff0000]IN COMBAT!"
    }
  ]
}

Tip: Omit else to completely hide the line when false (no empty space).

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

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
3. Download expansions: /wpapi ecloud download <name>
4. Edit files in mods/WiFlowScoreboard/scoreboards/
5. Use /sb reload to apply changes

mods/WiFlowScoreboard/
├── config.json              # Global settings
├── playtime.json            # Persistent playtime data
├── scoreboards/
│   └── default.json         # Scoreboard profiles
├── logos/
│   └── spawn.png            # Custom logos (auto-loaded)
└── 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