SideBar
~ This plugin aims to give you complete control of the scoreboard/sidebar.
- More than 100 variables
- Color and UTF-8 symbol support: ❤
(see here to convert UTF-8 to ascii for yml)
- Dynamically updating sidebar
- Set a sidebar to appear in certain worlds
- Have per group sidebars
- Optionally allow users to choose what sidebar to use
- Use commands to manage a player's sidebar
- Use in-built scripting to change user's sidebar or add new variables
- Group Specific Sidebar Permissions. Add & remove permissions for certain sidebars at your command
- No database required
Click here for a list of {variables}
The installation process is easy. Simply put this plugin, as well as Vault into your plugin directory and restart your server.
Dependencies
This plugin requires Vault - Click here to download it if you don't already have it.
Several files/folders are created upon installation.
config.yml
Setting | Description | Default Value |
---|---|---|
version | The plugin version (do not change) | version dependent |
scripting.directory | The location to use for custom scripts | scripts |
scripting.sidebar-directory | The location of the sidebar files | scoreboards |
multiworld.<world>.sidebar | The sidebar to use for that world (set to false for no scoreboard) | default |
sidebar.autoupdate.whitelist | A list of placeholders which should update (add your own here) | some big list |
sidebar.auto-update.enabled | Whether the scoreboards should update, or simply be static | true |
sidebar.interval-ticks | How often to update a scoreboard (20ticks=1s) | 20 |
sidebar.async | Do not mess with this unless you know what you are doing | false |
language | What yml file to use for the language messages | english |
compatability-mode | Whether other scoreboard plugins should be allowed to disable this scoreboard | true |
english.yml
- Not implemented yet :(
scripts folder
You will find two scripts already here.
To use the script "example.yml" simply put "{example}" in your scoreboard file
To use the script "test.js" simply put "{js:test.js}" in your scoreboard file
To add your own script, create a new .yml or .js file in the scripts directory
For outdated information on scripting, click here.
Click here for a list of {variables}
scoreboards folder
Setting | Description | Examples |
---|---|---|
title | The title (appearance) of the scoreboard | e.g. "Ranks" |
permission | The permission node required to use this scoreboard | e.g. sidebar.use.ranks |
description | A short description of the scoreboard | e.g. "Cost of different game ranks" |
keys | Keys are the values on the left of the scoreboard They can be anything less than 16 characters You can have placeholders in a key | e.g. Money: ${money} or just "Money:" |
values | This is the right side of the scoreboard Scoreboard elements are automatically sorted in descending order If you want something on top, it needs a large value You can only put numbers here or something that resolves to a number | e.g. 5 {money} |
Adding your first scoreboard:
1. Navigate to the scoreboards folder
When the plugin loads for the first time, it will create a folder (in your plugins directory) called SideBar
- Within here you will find the scoreboards folder (as well as the config.yml)
2. Create a new yml file
An example scoreboard (example.yml) should also be present.
It is recommended that you copy this file and base your new scoreboard off this.
Here is the example scoreboard file opened in NP++:
3. Changing the title
Set the title key to whatever you want the label to be for the scoreboard.
- e.g. title: "Stats:"
4. Add a permission node
Set the permission key to the permission node required for a user to use that scoreboard.
- e.g. permission: sidebar.use.myfirstscoreboard
5. Add a description
Set the description key to a brief explanation of the purpose of the scoreboard so that players will know what each scoreboard does.
(Useful if you want to allow users to set their own scoreboard using commands)
6. Add scores
The scores which will be visible on the scoreboard are under keys and values
Some things to note about scoreboard behavior:
- Each score is comprised of a String (some text) and an Integer (a whole number)
- Currently the length of the String cannot resolve to be longer than 15 characters.
- Scores are automatically sorted in descending order (client side)
(The score with the highest Integer value will always be on top)
Things you can use for "keys":
- Plain text e.g. Hello
- Color codes e.g. &6Hello
- Variables e.g. Hello {player}
- Unicode symbols e.g. \u2764 (ASCII equivilent of ❤)
See here for a list of variables
See here to convert UNICODE symbols to ASCII
Things you can use for "values":
- Whole numbers e.g. 6
- Variables e.g. {age}
- Expressions e.g. 15*6+4
(You may have variables within an expression)
(The result must evaluate to a whole number however)
6. Add the scoreboard to the config
Open the config.yml
For each map there will be a sidebar option.
- Set the sidebar/scoreboard for each world using this option.
- Set sidebar to the name (not including .yml) of the scoreboard file.
- e.g. If your scoreboard file is called custom.yml you may have sidebar: custom
7. Add your own dynamic variables
See here for help on creating your own variables
Command | Description | Permission |
---|---|---|
/sidebar help | Shows a list of commands | none |
/sidebar set <sidebar> | Set your sidebar | sidebar.set +node for specific scoreboard |
/sidebar set <sidebar> <player> | Set someone's sidebar | sidebar.set.other |
/sidebar list | Shows a list of scoreboards | sidebar.list |
/sidebar reload | Reloads the configuration | sidebar.reload |
[TODO]
Tell me if you want a feature added
- Sidebar setting for groups/permissions (Vault Required for Group Permissions, if vault is not found it will revert to bukkit based permissions)
- World grouping
- Command to hide sidebar
- Empty sidebar will not display
- Priority option for group/permission/world sidebars.
- Command to preview a sidebar (in chat)
- Command to browse placeholders
- Command to set variables
- Command to view a player's current sidebar
- Command to view a world's default sidebar
Latest build can be found here:
Repository | Status | Extra Info |
---|---|---|
Subproject | (Click image for repository: Sub) | Not Stable (Mostly alpha/beta builds) |
Masterproject | (Click image for repository: Master) | Stable (Stable Beta/Release builds) |
This sidebar is only showing up for ops even though everyone has the proper permission.
Is there anyway I can make this sidebar look like this? http://gyazo.com/456b930c78c07fd77567c384d45cff4b
@Empire92
Thank you for responding so quickly, but its not working, the line just comes out blank as if it doesnt read what you put. I copied and pasted the exact thing to make sure I didnt mess up.
@OTF_Catastrophe
{online} - for a list of online players
{length:LIST} - for the length of a list
putting them together:
{length:{online}}
Great plugin I love it! BUT is there even a variable to set the number of players in the server? Im going through the variables and cant seem to find out which one it is or even if there is a variable for it, if there isnt please implement it. Great plugin :)
@Empire92
The blinking is because of the use of an old version of craftbukkit. The constant updating shouldn't be happening unless it is another plugin that is constantly reloading and just so happens to reload most of the other plugins. Also if you happen to reload the server that would break the sidebar plugin, Currently there is no fix for that problem though we are looking in to it.
@WinterTactic Yes, the scoreboard is definitely blinking because of "automatic updates"
Anywho, we'll get the blinking thing fixed at some point, it was working in the past, so it should be fairly simple to fix again. If it is just an entry blinking when it updates, that is normal however.
@Chocolatebunns
The project is in violation of the Bukkit terms of service if they do not have an option in the plugin configuration to disable automatic updates.
@F9Alejandro
The scoreboard is blinking. Could you add a feature to only update when needed? :-)
First off great plugin! I was just wondering if there is a way to disable the scoreboard changing what it shows, and forcing it to show all the lines and update them only when needed? It would be really helpful to be able to do this. Thanks!
@DjSmeXhy
That is to be expected as it is a beta build. If you have craftbukkit version 1.7.9 R0.2 then you should be fine as the plugin was built using that version of bukkit. As of right now the plugin will allow you to set your sidebar to else what... just that it will not replace everything and will just add to the scoreboard instead. The replace feature should be added relatively soon.
Just be active on bukkit dev and it will be sure to show up soon. just give me some time to get back in the swing of things.
very buggy
@juwxx
Specific Group permissions are now working in the latest version 0.1.3 it is a beta build so be weary that it my be unstable.
@ISToxik
By chance do you have vault and some sort of economy plugin that is supported by vault?
Would love to see the Sidebar automatically displaying based on a users permission. So admin scoreboard scoreboards.admin, etc.
HI ! How is that my sidebar is visible by a specific group? Because to sidebar.use.mysidebar does not work ! Thanks from France to your job :)
@ShadowedDreamer
I am likely to get back to helping out again and make a step by step tutorial video on how to do the most basic of functions to better understand the plugin and it's configuration
I'm having issues with this plugin. Whenever I try to use something like {player}, {money}, or the like, they always display "null" rather than the actual value. So, say I do "&7Hello, &b{player}" it returns "Hello, null" instead of the player's name. I don't see anything wrong with what I'm doing, so, I'm a bit confused.
great plugin but! Pls add a Hide function :) oh and i don´t see the Server tps rate and Memory :(( btw: /sidebar set works not for me this spam my console xD... i tried it without the other plugins and only with vault and iconomy... when i Switch the world is my sidebar off.... :\
@ShadowedDreamer
I added step by step guides under the configuration, I hope this helps. If not, feel free to ask any questions about the parts which confuse you.