OkGlass
OkGlass
OkGlass is a highly configurable performance monitor that uses a scoreboards to display a system information: memory usage, ticks-per-second (TPS), ping result of pinging a host, etc.
Features
- Display a window that contains a system information
- Disable any unnecessary "gadget" (just edit gadgets.yml)
- Allows to use custom gadgets created by me or by anyone who want to create a OkGlass gadget.
Why do I want it?
If you need to see a system information without typing additional command you need OkGlass!
How to use it?
- Install plugin and gadgets
- Type /okglass and.... it's all!
Gadgets
You can find more information about OkGlass gadgets here: http://dev.bukkit.org/bukkit-mods/okglass/pages/gadgets/
Warning! One of included gadgets - gadget PlayerPing (GadgetPlayerPing.jar) requires a FakePlayersOnline plugin installed. If FakerPlayersOnline is not installed at your server this gadget will be disabled
Commands:
- /okglass show — show OkGlass dispaly
- /okglass hide — hide OkGlass display
- /okglass cfg — display configuration and list of available (enabled) gadgets
- /okglass reload — reload plugin configuration and restart gadgets
Permissions:
- okglass.showhide — allows to show and hide OkGlass display
- okglass.config — allows to use /okglass help, /okglass cfg and /okglass reload command and receive a version update notifications
Configuration
To configure plugin, you must edit config.yml and gadgets.yml and type /okg reload command (or restart server).
config.yml:
general: check-updates: true # Check plugin updates at dev.bukkit.org language: english # Language, Russian is included. language-save: false # Save the translation file OkGlass: display-refresh-delay: 10 # Delay between OkGlass display refreshes. title: '&6OK''GLASS' # Title of OkGlass window default-color: a # Default color of gadget's title debug: false # debug-mode
gadgets.yml
Chunks: # Gadget name enabled: true # Enable gadget, every gadget could be disabled Entities: enabled: true Memory: enabled: true gigabytes: false Ping: enabled: true delay-time: 30 number-of-repeats: 5 host: google.com show-host-name: true use-java-ping: false PlayerPing: enabled: true TPS: enabled: true tps-update-delay: 10
Metrics and update checker
OkGlass includes two features that use your server internet connection. First one is Metrics, using to collect information about plugin (versions of plugin, of Java.. etc.) and second is update checker (required to find newer version of OkGlass at dev.bukkit.org). If you don't like this features you can easy disable it. To disable update checker you need to set parameter "version-check" to "false" in config.yml. Obtain more information about Metrics and learn how to switch off it, you can read here.
Hello Fromgate,
Nice plugin (just like your other plugins). Although I don't use it very much at the moment I do want to point to an error I have had for a while.
Since spigot 1.11 I kept getting '[WARN] [Fatal Error] :1:1: Premature end of file.' at the end of loading the whole server but never found a way to remove it. Since I now updated everything to 1.12 I found that OkGlass is causing this.
To be sure I have tested it with a fresh server loading only the Spigot 1.12 and OkGlass. The error never seemed to do any harm, but [Fatal Error] does scar a bit. And I like my server to be error free of course ;-).
Like I said I have not been using it too much but the plugin itself still seems to be working.
Any idea what the solution could be, or does it need an update?
@owenftw
Thank you :)
Nice plugin
add support/variables to Autorank Please!
Update it to 1.7.2 !!! Its perfect.
This seems to be deleting existing scoreboards for admins.
I don't mean the sidebar, I mean we had health below player's names and some numbers in the TAB-key player list, both are gone to anyone with admin permissions...
@Justin330
It will work with 1.6.x and 1.7.2 too. But really need to update. Next verision of OkGlass is unfinished, yet. I think I will return to it soon.
Just realized the Date this was put out... This still working?
Ant
This is a really great plugin... but almost lost it when i quit my browser couldnt find it again, cause the name OKGlass.... well I just wouldnt think of! Good plugin tho! Ant
@peterroxible
Hello!
You need to check gadgets location: /plugins/OkGlass/Gadgets/ After placing gadgets at this folder you need to restart server and check config file. You must see something like this (gadgets shown at this example are not released yet):
And you can type /okg cfg (or /okglass cfg) command in game and see the loaded gadgets list.
@lo0p Hello, Java has not a built-in ping methods that returns a ping real time value. So I tried to implement two methods on is based at Java method "isReachable" - that just checks is server available (or not), second - is executing the "ping" command of operating system. Calculating of executing time of both method did not provide a real result time result :( For example ping localhost is return 20-40 ms for my home computer. If I find a solution I will release a fixed gadget....
It says my gadget list is empty.
I seem to be having a problem. When I type the command /okglass, it says Okglass is enabled, but nothing happens. Maybe I installed the gadgets wrong? Weren't they supposed to go in the plugins folder?
Any idea why the ping from internet client goes up (400-500) whem LAN client if far in the game and down (4-8) when near?
@fr333n3rgy
Thank you for information. But I'm not sure that it was a memory leak (of cause I will test it). Until version 0.2.0 there was only one instance of ScoreBoard. This scoreboard is was realy one for all players (and there was a problem to show personal information). So you can login ten times and instance of scoreboard will be only one and it will resent to player. If you have speed problem, I think it could be bounded to one of the gadget. Can you tell me which gadgets you used at your server? I will examine this gadgets to find a possible reason.
I'm running bukkit 1.5.2 on linux and this is what I noticed while testing v0.2 ...
There is a severe (yet slow to manifest) memory leak with this plugin on bukkit 1.5.2 R0. If you turn okglass on, exit the mc client and then login again okglass will be on (which would be ok as a general feature but..) If you then execute /okglass again, it will ADD a new instance to the existing one. Executing /okglass will remove the last instance but the original instance that was in there when you logged in remains. Also (problem 2) if you logon 5 times, it will take 5 times the amount of memory (per user that uses okglass) in the bukkit server memory space - although small, it will add up ... I had to disable this plugin today after about 4 days of running it as it cause huge lag. As soon as I removed it, the lag was gone, now everything runs as speedy as before ...
I know this is a long write-up but I'm trying to give you as much info as I can ... I love this plugin and the concept, but I can't risk for this issue to happen again - players were unhappy when the server froze :( ...
p.s. once i ctrl-d/a out of the screen session, i could see that the cpu was not overloaded at all so the problem is isolated within the main bukkit java instance taking 140% of cpu time and up to 210% using 'top'.
Hope this helps...
@Hdom v0.2.1
@Hdom There's no "autoshow" feature yet. But I will add to next version. I think it will be ready at weekend.
@fromgate
Edit: Woops, it works, im just having trouble getting everyone to see it by default. Is this a built in feature? Or does every have to do /okglass show to see it. I would like for people to see it automatically when they log in.
Yes! Thank you thank you! Freaking amazing update.