LoginPerks
What is LoginPerks?
LoginPerks is a plugin for the popular Minecraft server Bukkit. The plugin credits users every day that they log in with items and/or money. LoginPerks aims to be:
- Lightweight – Java takes up enough memory as is!
- Easy to use – intuitive commands for on-the-fly configuration in your client.
- Powerful – Allow for customization at the global, group, or player level.
Latest release: 0.1e [Download]
1.0 Compatible Release: 0.1c [Download]
Latest Dev build: http://jenkins.brianturchyn.net/job/LoginPerks/
What Makes LoginPerks different (aka. Features)?
Every other plugin seems to be just too basic for what I’ve always wanted this kind of plugin to do. Therefore, I wrote my own. Here are a few specific features of LoginPerks:
- Fine-grained control at every permissions level; global, group, and player
- Flat file data storage
- Supports all permissions and economy plugins supported by Vault
- Message Customization- with colour support — NEW in 0.1e!
- Data value support (for colours of wool, etc) — NEW in 0.1e!
- Ability to give experience as a perk — NEW in 0.1e! — suggested by xXReVurbXx
Planned Features
- MySQL and PostgreSQL support
- Integration with Hawkeye anti-griefing mod for better auditing
- Colour support for messaging
- Multiple items being given as a single reward
- Random quantity support (eg. 1-10 of the item) — suggested by quickclay
Requirements
Hard Requirements
You need these:
- Java 1.6 or above (or OpenJRE equivalent)
- The minimum-supported CraftBukkit build:
- 0.1e or above: Bukkit 1.1 R4 (minimum tested build: CraftBukkit #1938)
- 0.1c or below: Bukkit 1.0.0 R1 (minimum tested build: Bukkit 1073)
- Vault
- Along with this, a supported economy and permissions plugin
Soft Requirements
Coming soon!
Installation
- Download the latest version (or the development version, if you feel like living on the wild side):
- Latest release*: See Link Above
- Latest Dev build*: http://jenkins.brianturchyn.net/job/LoginPerks/
- Place the plugin in the
plugins/
directory - Restart your server
- Configuration information can be found here or in the Pages link above.
Links
Permissions
** IMPLEMENTED ** - loginperks.getsMoney -- Determines if a node will get money from the Economy plugin -- default: false - loginperks.getsItem -- Determines if a node will get items in their inventory -- default: false
** COMING SOON ** - loginperks.admin.global -- Can a node edit the global defaults? -- default: op - loginperks.admin.group -- Can a node edit all groups? -- default: op - loginperks.admin.group.<groupname> -- Can a node edit a specific group? -- default: false - loginperks.admin.player -- Can a node edit all players? -- default: op - loginperks.admin.player.<playername> -- Can a node edit a specific players? -- default: false
As always, you should reserve loginperks.admin.*
for your admins and mods.
Commands
Coming soon
Author and About
LoginPerks is coded and designed by Brian Turchyn (Minecraft handle: Th3Bra1n). Brian runs the NOS Gamers group, which runs a Teamspeak (teamspeak.nosgamers.com
) and Minecraft(minecraft.nosgamers.com
) server. The servers are Pay-To-Play access to ensure everybody has a vested interest in keeping the server a great place for players to play.
Donate
If you’ve used this plugin and like it, please consider making a contribution to its support and development. All proceeds collected go straight towards the running of NOS Gamers and maintaining the plugins. The money doesn’t go into my own pocket.
License
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see <http://www.gnu.org/licenses/>.
Do I need any special gamemode/version? It's not working for me, although I just started my server and am not very good at plugins.
Does it require an update? Please at least update it for 1.6 then, I have the configs set as they should be with the correct settings, but its only reading from the default when giving out perks, its not reading from any of my custom groups, any reason why? I have vault updated to the newest version, and using iconomy.
EIther that or I need a similar plugin that I can grant money once per day to players for logging into the server, its been a perk and now its not working D:
Update please.
You should make it so this plugin can support color codes I would like it so I could change the color of the text
does this still work on bukkit?
Any luck yet. I would really like to use this plugin on my server...
@Spartan_V23
I will look into it. If you could PM me the versions of EconXp and Vault, that would be much appreciated.
Finally this man update his plugins!
There seems to be a issue when trying to use this plugin with the EconXp economy plugin. The plugin notifies the user they have recieved xp but does not actually reward them anything. Ive tried multiple configurations and still does not work. Heres 2 of the combos i tried in the data.yml
and
Both do not work. Help please :D
@generilisk
I believe you are reading the description wrong :)
On a global, group, or user level, you can set loginperks.getsItem (and getsExp and getsMoney) to either true or false. With that, you can, for example, have everybody get money, additionally give VIPs an item, and give players in the "banned" group nothing.
In LoginPerks/data.yml, you can specifically set what each perk gives on, again, a global, group, or user level. For example, you can set the default amount of money for all users to get to 50 (loginperks.defaults.money_amt: 50), give VIPs 100 (loginperks.groups.vip.money_amt: 100), and give user Th3Bra1n 200 (loginperks.users.Th3Bra1n.money_amt: 200). The plugin always takes the finest configuration option first, then works out to wider options (ie. user -> group -> global).
The next major release will support multiple rewards of the same type, so you will be able to add several types of items to a single perk.
I believe the above covers the functionality suggestion you have. If it doesn't and I'm totally off-mark though, let me know! :)
If I may make a suggestion? instead of loginperks.getsMoney and loginperks.getsItem, use loginperks.<group1>, and then have a config file where you specify what groups get what. But maybe I'm reading the description wrong.
Sorry for the lack of updates, everybody. I just finished my university degree, so my life has been really busy recently.
I'm working on updates right now, and I will have an updated version out shortly, ensuring that the plugin is working as expected with the latest versions.
This plugins does not updated?
@rajinhear
You haven't really provided me with any information here. Please PM me with the following info:
i added the "- loginperks.getsMoney" perm to my permissions file but still players can not claim any money when they login. What can be the problem ?
@quickclay
Thanks for the heads up. I will take a look at it shortly.
Added a ticket, fyi. :)
I'll be updating the plugin live here at http://www.justin.tv/b_turchyn Feel free to tune in and watch for the next couple hours!
@Crayder
@rajinhear
Hi,
Yes, I will absolutely be preparing for R5 the 1.2 release. Glad to see people are using this!
I have a few extra features that I haven't had the time to test yet that I'm hoping will make it into the release for 1.1 R4 update. I should have time to update some time this week.
Friendly reminder that people still care about this plugin and to see if you're ready for R5 and an eventual 1.2 release!