OnSign
This companion plugin to OnTime provides a sign based solution to share an individual player's and the server's top player's OnTime data. It also supports OnTime "shop" Rewards, which give players control over the OnTime Rewards they receive. A MySQL database is required to use OnSign.
Important Notes on V2.0.x
In order to use this latest version of OnSign, the OnTime plugin must also be upgraded to V4.1.2 or later.
Player Signs
For a specified player, the player's name and any combination of up to three of the following can be shown on a sign:
- status (online, offline, or AFK)
- date/time of last login or logout (changes when players come and go)
- date/time of last login (only changes on each login)
- total play time (OnTime) on the server
- total play time for the current day
- total playtime for the current week
- total playtime for the current month
- total votes cast for the server
- total votes cast for the current day
- total votes cast for the current week
- total votes cast for the current month
- total referrals made to the server
- total referrals made for the current day
- total referrals made for the current week
- total referrals made for the current month
- current 'loyalty' point total
Top "Ten"
For a specified piece of data, the plugin will show the position on the list, the name of the player, and their current score. These signs are updated every day, or at an interval specified by the administrator. The following data can be shown on the "top" signs:
- total play time (OnTime) on the server
- total play time for the current day
- total playtime for the current week
- total playtime for the current month
- total votes cast for the server
- total votes cast for the current day
- total votes cast for the current week
- total votes cast for the current month
- total referrals made to the server
- total referrals made for the current day
- total referrals made for the current week
- total referrals made for the current month
- current 'loyalty' point total
Shop Rewards
These signs are linked directly to an OnTime Reward defined by an admin. When a player clicks on this type of OnSign, and they have the required balance of Points or in-game money, they will receive that reward and have deducted from their points or econ balance, the configured cost. Please [click here] to learn more about OnTime Shop Rewards.
Sign Setup
For information and setting up signs, and other plugin information please see the plugin pages tab, or click here.
Other Plugin Integration
- Vault: OnSign uses the Vault plugin to provide support to various permission plugins. The Vault.jar MUST be installed in your plugins directory in order to use OnSign.
- OnTime: OnSign sources most of the data displayed from the OnTime plugin. This OnTime.jar MUST be installed in your plugins directory in order to use OnSign.
OnSign and OnTime version compatibility
- OnSign v1.0.0 will work with OnTime v3.8.1 or earlier
- OnSign v1.1.0 will ONLY work with OnTime v3.8.2 - v3.9.0
- OnSign v1.2.0 or later will ONLY work with OnTime v3.9.1 - v3.10.3
- OnSign v1.3.0 or later will ONLY work with OnTime v3.11.0 - v3.13.2
- OnSign v2.0.0 or later will ONLY work with OnTime v4.1.2 or later
Commands
- onsign refresh
This command will refresh all signs.
- onsign reload
This command will reload the config.yml, reload from the database the sign data, and refresh all signs.
Installation
- Place OnSign.jar in your plugin folder
- Place OnTime.jar in your plugin folder Make sure you are running the correct version of OnTime!
- Place vault.jar in your plugin folder
- Restart your server / Reload Plugins
- Edit plugins/OnSign/config.yml to setup your MySQL (required) database access
- See insructions for config settings in the generated file or here
6. Restart your server / Reload Plugins if config.yml is modifed
That's it!
Change Log
For the complete change log, please click here.
V2.0.2
Compiled/Tested with Spigot/Bukkit V1.8.1; Java7; Vault 1.5.2
Fixes
- The fix added in V2.0.1 did not address all possible scenarios. This second update provides a complete fix for Ticket #21
V2.0.1
Compiled/Tested with Spigot/Bukkit V1.8.1; Java7; Vault 1.5.2
Fixes
- Fixed issue with OnSign not auto-updating the MySQL database 'uuid' column for some servers. (Ticket #21)
V2.0.0
Compiled/Tested with Spigot/Bukkit V1.8.1; Java7; Vault 1.5.2
Enhancements
- Made plugin compatible with MC v1.8, adding support for UUIDs for player identification
- Added support for 'vanishNoPacket' plugin, leaving players marked as 'offline' on signs when 'vanished' (Ticket #15)
Fixes
- Fixed 'login/logout' display on signs to properly update each successful player login and logout (No Ticket)
- Added a delay to OnSign startup, so OnTime is sure to complete its initiation first (No Ticket)
- Addressed issue where 'rank up' purchases from a sign shop could result in multiple charges for one rank. (Ticket #17)
New Commands
- onsign refresh
This command will refresh/update all signs.
@Nightreaber
The permission info is at the very top of the creation instructions.
http://dev.bukkit.org/bukkit-plugins/onsign/pages/creating-signs/
i just told a user to create sign like
%%username %status %totalplay
(sure he replaced the username with his name with correct typo)
but as he places the sign, i stay like so, nothing is replaced with values %status stay %status and so on.
-actually i can create signs, my users dont... why?
i think he doesn't have permission to place sign on his own, thats why i'm asking for permissions they may need, as i didn't find anything about this in the documentation
@Nightreaber
There are no OnSign permissions for users, only permissions for admins wanting to create an sign. Can't help more unless you describe a little what you are trying to do and what you are seeing on the sign etc.
Used with the latest version of OnTime but seem not to work. Do I miss permissions for my users?
@killermanaa2
Sorry for the long time in responding, but yes this is possible. You need to use OnTime's reward feature to create a "command" reward, make that reward an "shop" type, and then link it with your OnSign.
See here: http://dev.bukkit.org/bukkit-plugins/ontime/pages/rewards/#w-command-rewards-notes
And here: http://dev.bukkit.org/bukkit-plugins/ontime/pages/tutorials/6-reward-shops/
Is there anyway that you can make reward shop signs to take points and run a command? That would be useful. Thanks
@secretbryan15
Right now it does not support data from any other plugins, but I recently had another user ask for something similar. I think it is very possible to add a 'generic' specification where data could be pulled from a mysql table and populated on the signs.
It would take a little bit more work to have it also do a sorted ranking, but this too is very doable I think.
I currently am not releasing this as open source, but would willing to add this to the implementation if you will open an enhancement request.
Anyway to create my own top list? I want to make a top bounty list for the Decapitation plugin (http://dev.bukkit.org/bukkit-plugins/decapitation/). Also is this project open source?
@Edge209
vanish no packet saves metadata onto the player "vanished" or "vanish" not sure atm
@CrowMCLP
Hi. Sorry for long time for a response. But it does not currently support vanish no packet, but I can see how there is a conflict here. I looked into the other plugin and it has an API support so there is an opportunity to connect the two, but it will take some additional investigation on my part to figure out exactly how.
If you would, please open up an enhancement ticket so that I don't forget the request.
@MinecraftAdmin
Hi, some of the data does not come straight out of the OnTime database, but is modified based on current play time and AFK status, etc. It also uses OnTime's permission settings to keep players off of the top lists etc.
But, what you recommend is something interesting. I could add option to allow specification of other database columns associated with OnSign's keywords to allow use with other plugins.
I had designed OnSign as an add on to OnTime, not really intended as a standalone, but as you say there could be other applications I had not considered.
If this is something you would really like to see, then I suggest opening up an enhancement ticket and providing as much specification of your idea as you can and I will consider for the next big update.
I am curious as to why OnSign requires OnTime if it sources data from OnTime's database instead of directly from OnTime. Making OnSign independent of OnTime would make it a lightweight plugin to just display stats from another database (for example, %MONTHVOTE from the hub/lobby server).
Question.. Does this hook into VanishNoPacket? I would like to use this plugin for online status signs for my staff but if they go in vanish I don't want it to say they are still online. If this doesn't hook with VNP can you add a hook for it? I have also noticed that you have incorporated the color codes into the config, can you also add support for formatting, bold, italic ect?..Thanks and awesome work!
@talariuss
I cannot 'officially' update to 1.7.4 until there is a bukkit version compatible with 1.7.4. I have tried the plugin with both v1.7.2 and v1.7.4 and it seems to work. If you are seeing errors,please open up a ticket with details of your issue.
Please update to 1.7.4!
that worked thank you very much and that should help me setup the rest of my perms! ty again
@Edge209
ahh perfect never though of adding it that way thank you i will try that
@hypno82
You need to negate the "ontime.top.exclude" permission:
(I left out all of the other stuff, so just add the " - -ontime.top.exclude" to what you have.
@Edge209
Does not seem to work but i am horrible with permissions how do i toggle it from true to false? i downloaded and setup permissionsEX and set the permissions but there seems to be something overriding them or something because i even tried taking away access to the /ontime command and that even still works
Admins: prefix: '&0(&4Admins&0)&7 ' permissions: - ontime.afk.collect - ontime.afk.notify - ontime.logfile.admin - ontime.message.admin - ontime.moduser - ontime.online - ontime.other - ontime.purge.exclude - ontime.referred.admin - ontime.referredby.enable - ontime.report - ontime.remove - ontime.rewards.admin - ontime.rewards.receive - ontime.save - ontime.suspend - ontime.test - ontime.top - ontime.top.extra - ontime.track - ontime.welcome_msg - ontime.me: false options: rank: '1' inheritance: - Moderator users: Hypno82: group: - Admins
with the permissions setup like that i am still excluded and still can use the /ontime command if your wondering about the lower ranks i have nothing setup so they should not be interfearing
@hypno82
In OnTime there is a permission string that will exclude players from showing up on the top lists and hence the top signs. See this FAQ for more info
http://dev.bukkit.org/bukkit-plugins/ontime/pages/faq/#w-q2-why-dont-all-players-like-ops-and-admins-appear