# ### **Thanks for 2k downloads!!!** ### Version 5 for Folia is coming!
NotzScoreboardV3

# NotzScoreboard is a complete and fully customizable scoreboard plugin that features: support for multiple simultaneous scoreboards; multiline and animation support; ViaVersion support for legacy players in 1.20/1.21 servers; its own placeholders and PlaceholderAPI; database via MySQL or SQLite and dynamic updating for greater efficiency.
## Information ### Scoreboards The plugin has dynamic scoreboards that only update the placeholders inserted in each line, without having to reload the scoreboard completely! It also contains multiple customization commands so that they can be created and modified directly from the server without having to mess with the files. ### Groups The scoreboards are separated by groups and pre-programmed so that it is possible to view players from other groups (and even from the same group) on your scoreboard or from the group itself on other scoreboards. ### Templates It also has a system of templates that can be created in the plugin's configuration file and set through the game using them as Header, Footer or the main template, thus allowing greater customization and standardization of each scoreboard. ### Placeholders You can choose to use dynamic placeholders from other plugins via the PlaceholderAPI or your own static placeholders that can be created via the plugin's configuration file. ### Color codes The plugin allows you to use the old color code system and short color codes instead of creating long strings in every scoreboard line or in messages sent to players. (v4 only) ### Tip For questions or issues: [Discord @Gago32](https://discord.com/users/258701013198831617)
## Scoreboard Demo
### Player example with staff on and off

### Helper and Trial example

Show

### Mod and Admin example

Show

### Manager and Owner example

Show

## Scoreboard system (v4 only) ### Multiline separator: `--` Use `--` or more hyphens to distinguish lines. ### Prefix and Suffix line separators: `Placeholder` (the suffix), `:` (separate and keeps the ":"), `::` (only separates). ### Placeholder system It doesn't matter if you put a placeholder with `{}` or `%%`!\ The `:` in placeholders defines a default message if the placeholder doesn't exist. ### Note: Player clients in versions <1.20.3 have short lines, so the max lenght for an area in a scoreboard line (prefix, entry and suffix) is 16 chars each, making the prefix area (before a 'placeholder' or ':') only 32 chars long (counting the color codes §/&).

Example

```yml templates: - player: - '' - '⧽ {player_displayname}' - '' - '⎧ {rank}' - '⎩ {status_rankup}' - '' - '⎧ Money: {money:0.0}' - '--⎩ Cash&f: {cash:0c}' # same line, but it will - '--⎩ Tokens&f: {tokens:0t}' # alternate every X seconds - '' - '⎧ Clan: {simpleclans_clan:No clan}' - '⎩ KDR: {simpleclans_kdr:0.0}' ```

## Custom color code system (v4 only) ### Legacy color codes Use `&` along with any legacy color code.\ Example: `&b` (Old color AQUA). ### Gradient with old color codes Use `&g` along with any legacy color code.\ Example: `&g2b` (Gradient from GREEN to AQUA). ### Gradient with hexadecimal colors Use `&g[_color1_:_color..._]` along with the hexadecimal color, whether short (#f0f) or long (#ff00ff).\ Example: `&g[#fff:#000]` (Gradient from WHITE to BLACK). ### Pride colors Use `&p` alone or `&p[_flag_]` together with any [pride flag name](https://docs.papermc.io/adventure/minimessage/format/#pride).\ Example: `&p[bi]` (Bi flag gradient). ### Rainbow Use `&!` alone or together with [! or phase](https://docs.papermc.io/adventure/minimessage/format/#rainbow).\ Example: `&!` (Normal rainbow).\ Example: `&!!` (Inverted rainbow).\ Example: `&!2` (Rainbow phase 2).\ Example: `&!!2` (Inverted rainbow and phase 2). ### Chat event Use `&&_action_[_value_](_message_)` with any supported action: [copy, url, run, sug|suggest](https://docs.papermc.io/adventure/minimessage/format/#click)\ [hover](https://docs.papermc.io/adventure/minimessage/format/#hover)\ Example: `&&hover[Boooo!](Hover over this message to see something.)` (Display a message on hover).\ Example: `&©[You copied me!](Click here to copy something.)` (Copies a message).\ Example: `&&run[/tutorial](Click here to run the tutorial!)` (Executes a command).\ Example: `&&sug[/bc yipeee](Click here to be happy!)` (Suggests a command). ### End color code Use `&.` to terminate a color code (the '&.' will be removed from the message). It will also be terminated when another color code begins (auto detects another `&`).
## Dependencies - PlaceholderAPI (Optional) - ViaVersion (Optional) (v4 only)
## Placeholders | Placeholder | Description | |:-----------:|-------------| |`{money}` | Player money straight from Vault and formmated by NotzAPI. [PlaceholderAPI-Vault]| |`{staff}` | Get the nick of one of the online players in the visible groups for that group.| |`{supstaff}` | Same thing as {staff}, but returns an alternative message if there is no online player in the visible groups for that group.| |`{staff_list}` | Number of online players in the visible groups for that group.| |`{staff_'group'}` | Get one of the players in that group.| |`{'group'_list}` | Gets the number of online players in that group.|
## Permissions | Permission | Description | | :---: | --- | | `notzscoreboard.admin` | Enables the player to use the /notzsb admin command |
## Commands ### `/notzsb` - `create` \ \ (header) (template) (footer) - Creates the scoreboard with the option of already setting the templates. - `delete` \ - Deletes a scoreboard. - `list` - Lists all the scoreboards created. - `players` - Lists all registered players and their respective scoreboards. - `reload` - Reloads the entire plugin. - `reset` \ - Resets the player's scoreboard to the default scoreboard. - `set` \ - Sets the scoreboard itself. - `update` - Updates all scoreboards. - `` - `addplayer` - Adds a player to the scoreboard. - `addgroup` - Adds a group to the scoreboard's VisibleGroups. - `clearheader` - Clears the scoreboard header. - `clearfooter` - Clears the footer of the scoreboard. - `cleartemplate` - Clears the scoreboard template. - `pause` (minutes) - Pause the scoreboard update for X minutes (by default it is paused for 1 minute). - `players` - View the players registered on the scoreboard. - `remplayer` \ - Remove a player from the scoreboard. - `remgroup` \ - Remove a VisibleGroups group from the scoreboard - `setcolor` \ - Sets a new color for the scoreboard. - `setdisplay` \ - Sets a new display on the scoreboard. - `setheader` \

KaaDev