![[1.8-1.19] Harmony Scoreboard | NMS Async | PlaceHolderAPI Support icon](data:image/png;base64,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)
[1.8-1.19] Harmony Scoreboard | NMS Async | PlaceHolderAPI Support -----
NMS Asnyc Lightweight Scoreboard PluginAdded support for PAPI placeholders in animations.
Added a fix for 1.12.2
If you are running an older version of minecraft try downgrading to 2.6.5 if this version doesn't work.
I am currently recoding the plugin, this is the hopefully the last version before 3.0.0
Added a fix for 1.12.2
If you are running an older version of minecraft try downgrading to 2.6.5 if this version doesn't work.
I am currently recoding the plugin, this is the hopefully the last version before 3.0.0
The plugin should now work just fine on 1.19
Didn't even notice it came out until now, sorry about that
Didn't even notice it came out until now, sorry about that
/hboard toggle works as intended
/hboard reload does enable events if they were previously disabled without restarting the server
/hboard reload does enable events if they were previously disabled without restarting the server
- Temporarily added color codes translation before proper hex implementation
- Potentially fixed the plugin not working on Java 8
- Potentially fixed the plugin not working on Java 8
- Added Traditional Chinese locale (Thanks xMikux)
- Fixed bug with locales erroring out on console messages
- Fixed bug with 1.13-1.16 scoreboard titles
- Fixed bug with locales erroring out on console messages
- Fixed bug with 1.13-1.16 scoreboard titles
Added locales for:
- German (Thanks Du_bist_kein_pro for doing the entire thing)
- Japanese (Thanks BaGuAr for adjustments)
- Romanian
Information about how to use them can be found here:
https://github.com/Oreoezi/HarmonyBoard/wiki/Languages
- Fixed a bug with condition matching (Thanks TiaTheFairy)
- Fixed a bug with scoreboards having broken colors (Thanks crston)
- Removed old code from Harmony 1.0 present in the command handler
- Added more preset scoreboards
- Fixed the old messy algorithm for choosing scoreboard templates.
- German (Thanks Du_bist_kein_pro for doing the entire thing)
- Japanese (Thanks BaGuAr for adjustments)
- Romanian
Information about how to use them can be found here:
https://github.com/Oreoezi/HarmonyBoard/wiki/Languages
- Fixed a bug with condition matching (Thanks TiaTheFairy)
- Fixed a bug with scoreboards having broken colors (Thanks crston)
- Removed old code from Harmony 1.0 present in the command handler
- Added more preset scoreboards
- Fixed the old messy algorithm for choosing scoreboard templates.
- Fixed a bug where changing worlds broke scoreboards (Thanks xMikux)
Turns out I changed the %player% placeholder to %name% but did not change the default scoreboards.
Added event system (
https://github.com/Oreoezi/HarmonyBoard/wiki/Scoreboards-and-Animations)
Changed player name placeholder from %player% to %name%
TODO:
Changed player name placeholder from %player% to %name%
TODO:
- HEX Support
- Tidy the 1.17 code
- Add more placeholders & event relevant ones
- Document the new API
- Native bungee support
Fixed bugs with the /hboard scoreboard command
Made plugin compatible with bungeecord (Thanks Xyness)
Minor optimizations and code tidying (Thanks iGabyTM)
Added metrics
Did not remove old API, will try to document the new one better and with examples beforehand
TODO:
Made plugin compatible with bungeecord (Thanks Xyness)
Minor optimizations and code tidying (Thanks iGabyTM)
Added metrics
Did not remove old API, will try to document the new one better and with examples beforehand
TODO:
- HEX Support
- Event system
- Add more placeholders
- Document the new API
- Native bungee support
Old API will show a deprecated warning until removal in the next version.
https://github.com/Oreoezi/HarmonyBoard/wiki/API-Usage
TODO:
TODO:
- HEX Support
- Bungee support
- Event system
- Add more placeholders
Added support for Oraxen glyphs.
Read the wiki for implementation example.
https://github.com/Oreoezi/HarmonyBoard/wiki/Scoreboards-and-Animations
Read the wiki for implementation example.
https://github.com/Oreoezi/HarmonyBoard/wiki/Scoreboards-and-Animations
Full recode.
Config layout and API changed.
Read https://github.com/Oreoezi/HarmonyBoard/wiki for more information on the changes.
Use the github releases in case the build is unstable. https://github.com/Oreoezi/HarmonyBoard/releases/
Config layout and API changed.
Read https://github.com/Oreoezi/HarmonyBoard/wiki for more information on the changes.
Use the github releases in case the build is unstable. https://github.com/Oreoezi/HarmonyBoard/releases/
If you run versions later than 1.12 this version is unchanged.
If your server is running 1.8 keep in mind the plugin was only tested on 1.8.8 so any previous version isn't guaranteed to work.
Fixed flickering caused by old scoreboard method being used on legacy verisons (Thanks ItzFlip)
If your server is running 1.8 keep in mind the plugin was only tested on 1.8.8 so any previous version isn't guaranteed to work.
Fixed flickering caused by old scoreboard method being used on legacy verisons (Thanks ItzFlip)
From my testing everything worked accordingly, make sure to report any bugs on 1.17.
- Fixed bug with /hboard scoreboard command
- Made all commands except /hboard toggle available to the console
- Updated plugin.yml to mention the plugin version (thanks Nonoritas)
- Updated plugin.yml to mention the API version (thanks KoxSosen)
- Made all commands except /hboard toggle available to the console
- Updated plugin.yml to mention the plugin version (thanks Nonoritas)
- Updated plugin.yml to mention the API version (thanks KoxSosen)
Thanks to hallowhead1 for helping me troubleshoot.
Thanks to Nononitas for reporting them to me too.
Thanks to Nononitas for reporting them to me too.
Added toggle command messages (thanks Hallowhead1)
Added the ability to save toggle preferences with SQLite or MySQL (thanks howtoNhut)
config.yml and language.yml are backwards compatible, so if you don't want any of the new features you can leave them the same as they are.
Added the ability to save toggle preferences with SQLite or MySQL (thanks howtoNhut)
config.yml and language.yml are backwards compatible, so if you don't want any of the new features you can leave them the same as they are.
Code (YAML):
enable_restricted_scoreboards
: false
restricted_scoreboards:
scoreboard2 : "permission.for.scoreboard2"
enable_perworld_scoreboards : false
world_scoreboards:
scoreboardworld : "world"
scoreboardend : "world_the_end"
scoreboard_update_rate : 1
save_scoreboard_preferences : false
mysql : false
host : "127.0.0.1"
port : 3306
username : "root"
password : "pass"
database : "harmonyboard"
restricted_scoreboards:
scoreboard2 : "permission.for.scoreboard2"
enable_perworld_scoreboards : false
world_scoreboards:
scoreboardworld : "world"
scoreboardend : "world_the_end"
scoreboard_update_rate : 1
save_scoreboard_preferences : false
mysql : false
host : "127.0.0.1"
port : 3306
username : "root"
password : "pass"
database : "harmonyboard"
Code (YAML):
prefix
:
"&f[&bHarmony&f]"
messages:
error:
nonplayer : "You must be a player to run this command."
no_permission : "You do not have the required permission to perform this command."
invalid_command : "The command you were trying to perform does not exist."
invalid_arguments : "Please provide the right arguments for the command."
invalid_player : "Player does not exist or is not online."
admin:
reloaded : "Config successfully reloaded."
toggle_on : "Toggled scoreboard on successfully."
toggle_off : "Toggled scoreboard off successfully."
messages:
error:
nonplayer : "You must be a player to run this command."
no_permission : "You do not have the required permission to perform this command."
invalid_command : "The command you were trying to perform does not exist."
invalid_arguments : "Please provide the right arguments for the command."
invalid_player : "Player does not exist or is not online."
admin:
reloaded : "Config successfully reloaded."
toggle_on : "Toggled scoreboard on successfully."
toggle_off : "Toggled scoreboard off successfully."
As the title suggests, you can now put placeholders in scoreboard titles. This can cause flicker on legacy versions(1.12 or below) so that is why this feature is toggled off by default.
config.yml:
config.yml:
Code (YAML):
allow_placeholders_in_title
: false
Added /hboard toggle (requires harmonyboard.toggle permission to work).
(Thanks Hallowhead1)
Fixed "bug" that made scoreboards not enable by default after reloading (Thanks Hallowhead1).
Added new placeholders for showing the overworld coordinates in the nether: %posxow% and %poszow%
Added decimals to %posx% %posy% %posz% placeholders
(Thanks Hallowhead1)
Fixed "bug" that made scoreboards not enable by default after reloading (Thanks Hallowhead1).
Added new placeholders for showing the overworld coordinates in the nether: %posxow% and %poszow%
Added decimals to %posx% %posy% %posz% placeholders
Added a new function for removing scoreboards from players in the API (thanks SkyyDaork).
Added new placeholders and symbols:
Code (Java):
try
{
HarmonyBoardAPI. setScoreboard (player, "examplescoreboard" ) ;
HarmonyBoardAPI. removeScoreboard (player ) ; // to remove it afterwards
} catch (HarmonyBoardException e ) {
e. printStackTrace ( ) ;
}
HarmonyBoardAPI. setScoreboard (player, "examplescoreboard" ) ;
HarmonyBoardAPI. removeScoreboard (player ) ; // to remove it afterwards
} catch (HarmonyBoardException e ) {
e. printStackTrace ( ) ;
}
%health% - shows health as 20.0
%health_hearts% - shows health as ❤❤❤❤❤❤❤❤❤❤
%ping% - shows player's latency
%posx% - shows the X coordinate of the player's position
%posy% - shows the Y coordinate of the player's position
%posz% - shows the Z coordinate of the player's position
%health_hearts% - shows health as ❤❤❤❤❤❤❤❤❤❤
%ping% - shows player's latency
%posx% - shows the X coordinate of the player's position
%posy% - shows the Y coordinate of the player's position
%posz% - shows the Z coordinate of the player's position
%heart% - ♥
%king% - ♔
%omega% - Ω
%queen% - ♕
%skull% - ☠
%star% - ★
%star_hollow% - ☆
%telephone% - ☏
%king% - ♔
%omega% - Ω
%queen% - ♕
%skull% - ☠
%star% - ★
%star_hollow% - ☆
%telephone% - ☏
Despite those versions not being currently in use I still wanted to make sure the versions work as intended. If you are not on any of the two versions, this update doesn't change anything.
This update switched to using scoreboard teams alongside not updating lines that didn't receive a change. By using the team prefix and suffix scoreboard lines can be 128 characters long.
This change was only applied from versions 1.13.2-1.16.5 due to the hard limit of characters that exists on older versions.
This change was only applied from versions 1.13.2-1.16.5 due to the hard limit of characters that exists on older versions.
Changes to scoreboards' and animations' configs were made. From now lines don't need to be labeled. (Thanks Andre_601 for the suggestion)
New configs look like this:
Added a new setting in config.yml for the scoreboard update rate. By default it is set to 1 (as in every tick, 2 being once every two ticks).
The delay in animations is still based on ticks and not affected by the update rate value. (Thanks Conclure for the suggestion)
New configs look like this:
Code (YAML):
title
:
"Your Server Network"
lines :
- "a%default%a" #Animations have the placeholder a%animation_name%a
- "Hello &b%player%&f,"
- " "
- "Online Players : %online%"
- " "
- "&byourserver.gg"
- "a%default%a "
lines :
- "a%default%a" #Animations have the placeholder a%animation_name%a
- "Hello &b%player%&f,"
- " "
- "Online Players : %online%"
- " "
- "&byourserver.gg"
- "a%default%a "
Code (YAML):
delay
: 5
#number of ticks until the next line
lines :
- "&a========================="
- "&b========================="
- "&c========================="
lines :
- "&a========================="
- "&b========================="
- "&c========================="
Added a new setting in config.yml for the scoreboard update rate. By default it is set to 1 (as in every tick, 2 being once every two ticks).
Code (YAML):
scoreboard_update_rate
: 1
API
Harmony Scoreboard has an easy-to-use API for registering placeholders and changing the player's scoreboard.
If you want to register placeholders when your plugin loads, make sure to have Harmony Scoreboard as a dependency.
depend: [HarmonyScoreboard]
Registering Placeholders
Every placeholder needs to be of type HarmonyPlaceholder. Here is an example of a placeholder that replaces %health% with the player's health.
Then we need to register the placeholder. That can be easily done with
HarmonyBoardAPI.registerPlaceholder(new HealthPlaceholder());
All HarmonyBoardAPI functions are static, there is no need to create an instance.
In order to remove the placeholder, you can either remove it based on its instance or on its name.
Setting Scoreboards
You can set a player's scoreboard with the setScoreboard function. It takes as parameters the player and the name of the scoreboard you want to set. It bypasses and permission / world check.
HarmonyBoardException is thrown if the player is null or if the name of the scoreboard is invalid.
Harmony Scoreboard has an easy-to-use API for registering placeholders and changing the player's scoreboard.
If you want to register placeholders when your plugin loads, make sure to have Harmony Scoreboard as a dependency.
depend: [HarmonyScoreboard]
Registering Placeholders
Every placeholder needs to be of type HarmonyPlaceholder. Here is an example of a placeholder that replaces %health% with the player's health.
Code (Java):
HarmonyBoardAPI.registerPlaceholder(new HealthPlaceholder());
All HarmonyBoardAPI functions are static, there is no need to create an instance.
In order to remove the placeholder, you can either remove it based on its instance or on its name.
Code (Java):
HarmonyBoardAPI.
unregisterPlaceholder
(healthplaceholder
)
;
HarmonyBoardAPI. unregisterPlaceholder ( "health" ) ;
HarmonyBoardAPI. unregisterPlaceholder ( "health" ) ;
You can set a player's scoreboard with the setScoreboard function. It takes as parameters the player and the name of the scoreboard you want to set. It bypasses and permission / world check.
Code (Java):
try
{
HarmonyBoardAPI. setScoreboard (player, "examplescoreboard" ) ;
} catch (HarmonyBoardException e ) {
e. printStackTrace ( ) ;
}
HarmonyBoardAPI. setScoreboard (player, "examplescoreboard" ) ;
} catch (HarmonyBoardException e ) {
e. printStackTrace ( ) ;
}
Resource Information
Author:
----------
Total Downloads:
5,317
First Release:
Jan 30, 2021
Last Update:
Jul 29, 2022
Category:
---------------
All-Time Rating:
13 ratings
Version
-----
Released:
--------------------
Downloads:
------
Version Rating:
----------------------
-- ratings