Boo mcMMo Reward
You want to give some money for users who reach the mcMMO level 250 ?
Or you want this user to be granted to a new group ?
Or just give them some items or greetings message ?
Giving some items enchanted or not ?
Giving some items with damage value or not ?
Give their 1 chance to 10 to win a bonus items or 1 chance sur 100 ?
...
...Yes it's possible...
Perhaps just adding one permission to this users is enough ?
Or there isn't enough and you want to launch some admin console commands after that ?
...Yes it would be possible..
What is it?
English:
BoomcMMoReward is an addon for mcMMO.
It gives you abilities to distribute rewards for all mcMMO's player level up with or without conditions.
Available Conditions
- money ( > or < amount ) - Vault required
- perm ( has or has not specific permission ) - Vault required
- group ( is on a specific group or not ) - Vault required
- POWER level ( > or < specific POWER level )
- SKILL level ( > or < for multiple SKILL level )
- world ( if in specific World )
Available Rewards
- money ( give specific amount with an optional sender ) - Vault required
- lotteryMoney ( % of chances to win amount ) - Vault required
- perm ( give/remove permissions or permissions for specific world ) - Vault required
- group ( add/remove from specific groups ) - Vault required
- item ( give items, you can set quantity/damage/enchantments )
- luckyItem ( an item randomly choose from a list of items )
- lotteryItem ( % of chances to win item )
- luckyKit ( a kit of items randomly choose from a list of kits )
- message ( you can send mp/broadcast/log with color )
- command ( for advanced user you can launch console command )
French:
BoomcMMoReward est un addon pour mcMMO.
Il vous permet de distribuer des récompenses à chaque level up mcMMO de vos joueurs sous conditions ou non.
Conditions disponibles
- money ( > ou < montant ) - Vault required
- perm ( doit avoir ou pas des permissions spécifiques ) - Vault required
- group ( doit être ou pas dans des groupes ) - Vault required
- POWER level ( > ou < à tel niveau de POWER )
- SKILL level ( > ou < à tel niveau pour des SKILLS spécifiques )
- world ( si il est dans tel Monde )
Rewards disponibles
- money ( verser un montant en précisant en option qui paye ) - Vault required
- lotteryMoney ( % de chances de gagner un montant ) - Vault required
- perm ( donner/retirer des permissions spécifiques à un Monde ou pas ) - Vault required
- group ( ajouter/retirer de groupes ) - Vault required
- item ( donner des items (quantité/damage/enchantements incluts) )
- luckyItem ( un item tiré au hasard dans une liste d'items définie )
- lotteryItem ( % de chances de gagner un item )
- luckyKit ( un kit d'items choisis au hasard dans une liste de kits )
- message ( envoyer des mp/broadcast/log avec coloration classique )
- command ( pour les utilisateurs avancés vous pouvez envoyer des commandes consoles )
How it works?
English:
When a player level up a skill he level up his global level.
The plugin do:
- a search on POWER/ONE folder if there is a reward file for the reached global level
- a search on POWER/EVERY folder if there is a reward file multiple of the reached global level
- a search on SKILLS/skill/ONE folder if there is a reward file for this skill level itself
- a search on SKILLS/skill/EVERY folder if there is a reward file multiple of this skill level itself
If the plugin find a reward file it deals with it.
French:
Quand un joueur gagne un niveau en compétence son POWER global augmente de même.
Ce plugin fait:
- une recherche de fichier reward dans POWER/ONE pour voir si il en trouve un pour le niveau POWER atteint
- une recherche de fichier reward dans POWER/EVERY pour voir si il en trouve un multiple du niveau POWER atteint
- une recherche de fichier reward dans SKILLS/skill/ONE pour voir si il en trouve un pour le niveau de la compétence en question atteint
- une recherche de fichier reward dans SKILLS/skill/EVERY pour voir si il en trouve un multiple du niveau atteint pour la compétence en question
Si il trouve un fichier reward il l'exécute.
Depends
English:
Of course it depends on mcMMO and Vault for permissions/money.
French:
Bien entendu il dépend de mcMMO et de Vault pour les permissions/money.
Documentation
Version | Docs | |
---|---|---|
Introduction | ||
BoomcMMoReward-1.1.x | English | |
BoomcMMoReward-2.0.x | English / French | |
Conditions section | ||
BoomcMMoReward-1.1.x | English | |
BoomcMMoReward-2.0.x | English / French | |
Rewards section | ||
BoomcMMoReward-1.1.x | English | |
BoomcMMoReward-2.0.x | English / French | |
Examples | ||
BoomcMMoReward-1.1.x | English | |
BoomcMMoReward-2.0.x | English / French |
Commands
English:
A console only command to toggle debug mode when server is started :
boomcmmoreward debug
A console command to On/Off database storing of player's rewards:
boomcmmoreward db
A console only command to retrieve history per player :
boomcmmoreward db get playerName
French:
Une commande en console pour activer/désactiver le debug :
boomcmmoreward debug
Une commande en console pour activer/désactiver le stockage en base de données:
boomcmmoreward db
Une commande en console pour consulter historique d'un joueur :
boomcmmoreward db get playerName
Last Release
v2.0.5b
Current Beta release.
Fixes lottery message's part and ormlite log output's path.
v2.0.4b
Bugged version on Loterry message's part and path of ormlite output log.
v2.0.3b
Prerequisites:
Vault and mcMMO of course.
Installation
- put the .jar on your plugins folder
- start your server it will create the folder structure
- no need to restart your server, create some yml rewards file and put them where they must be
Upgrade Instructions
This release has an integrated system to backup your reward files but PLEASE MAKE A BACKUP BY YOUR OWN TOO because it is a beta.
- put the .jar on your plugins folder
- on start it backup your reward files and adapt them to a new concept for multiple scenario if you upgrade from v1.x
- start your server it will create the folder structure
Your config.yml will be updated.
New 'ABILITIES' folder to reward on ability's launch and skill and power level based.
Need help to setup your reward ?
Feel free to join me at #boo on esper.net and hl me.
You can join this channel with this link if you don't have an IRC client: http://chat.mibbit.com/?channel=%23boo&server=irc.esper.net
Source
https://github.com/boozaa/BoomcMMoReward
Servers known running BoomcMMoReward
If you use this plugin and want to add your banner here please pm me...
Cool.
Latest release has been rejected for updater....
I want to say that the updater only send log that a new release is out not auto update.
I will try to clarify this situation
@MCBuncey
I am glad to visit your server :D
I see your signature so i thank that i must say you hello :)
i'm proud to see this plugin running and add some fun so i thank you for that and for the 3 bottles of xp earned for all basics level up :D
@boozaa
Im glad to see you checked my server :D specially the one who made the plugin that is 1 feature of on my server :D
A new Update !
For some reasons mcMMO package structure has changed, this version of BoomcMMoReward is just an adaptation of the 1.1.0 to take this changes.
Tested on latests dev Craftbukkit (1.4.7-R1.1-20130201.060225-2), mcMMo (1426) and latest Vault plugin (1.2.22).
You will see a new parameter on your config.yml so yes i work on a new version with MySQL support as requested, have fun and thank you.
You want to be inform about all new changes quickly ?
Use the 'subscriptions' menu link on top of this page
@kcaps it's for you !! :D
Thank you for your message
I would be thrilled if this were updated!
Looks like mcMMO is close to a new release :)
@boozaa
it worked thanks
Hi itemId/Damage:quantity:enchantId:multiplier so i suppose:
373/8201:5 for 5xpotion
how do you reward with potions i tried it like this '373:8201:5' but what happen was they recieved a ton of water bottles
This plugin has been working perfectly for awhile now and my server is now on beta really thank you for making this plugin i hope this plugin will stay as it is
[Work In Progress]
I made changes on the way system works.
The reward treatment populate a Queue to deal with it on another thread. I make the messages sending part as a standalone process which keep all messages part to deal with them at the end of all process. Benefits are to group messages sending and permits cancellation and also will permit to add a messages part for all kind of rewards things.
Think of :
It's not obviously the answer of your request artlune but it adds flexibility.
@artlune
Thanks a lot for your clarification.
I think i understand more what you need. Let me some days to think about it and i will be back to you with a new release which include requested MySQL backend too.
I don't want this plugin to be too specific (eg: for Pex Ladder system) so i must find a way perhaps with prefix/suffix, i don't know yet.
I know the limitation of my system especially on the EVERY because you can't do conditional scenario, i think about it too.
Thank you,
@boozaa
I assumed it would first promote the player and then display the message to the player. So if you were part of a group named "1" and reach a power level of 50, you are then promoted on a rank ladder and now in a group named "2" and it would display a 2.
...\POWER\EVERY\50.yml
^Should display "Your level has increased. You are now level 2" once they reach 50 power level. At 100 power level they are then in group 3 and it would say "You are now level 3". A %group% variable would only work in this situation if the command is executed first and then the message is displayed to the player. That's how I assumed it worked but I don't know.
I know you already understood this but I just wanted to be clear. What you suggest would work but not if I wanted to demote players and take away some levels. Say somebody has 500 power level therefore they would be in group "11" if they were promoted every 50 power levels under this system. If they were to reach power level 550 it should say they were now level 12.
...\POWER\ONE\550.yml
...\POWER\ONE\550.yml
I've tried other plugins like this one that had a %group% variable but this plugin offers much more customization and is just plain awesome :)
Is it difficult to add this group variable?
@artlune
It would be difficult to do want you want with the EVERY mecanism because how can you populate this %group% variable depending on player's power when the reward is done for every 50 level on the same reward yml file ?.
What do you think about that :
you know which level give specific group so why not create more than one reward file based on each level to reach for ranking ladder.
Exemple:
power level 50 : rank group "1" -> file POWER/ONE/50.yml
power level 100 : rank group "2" -> file POWER/ONE/100.yml
power level 150 : rank group "3" -> file POWER/ONE/150.yml
power level 200 : rank group "4" -> file POWER/ONE/200.yml
50.yml exemple:
Could you add a %group% variable? I'm trying a system where users get promoted on a ranking ladder every 50 power levels. I'd like it to say to the player; "Congratulations, %player%! You are now level %group%!" (just promoted from a group named "4" to group "5")
I noticed how strict on format this is XD That i have learned it from the hard way
A complete example:
So if player who level up is on the group "Red" the rewards part is launch so:
- he win a 35/14 (red wool) and 278:1:35:3 (enchanted pickaxe)
- he received a private message "Congrats" and "You win a &3red wool &fand an &benchanted pickaxe"'
If player is not on group "Red" the rewards part is not launch so nothing happen.
If you want to add on the reward part a "lotteryItems", "luckyItems" or a "luckyKit" you can add a dédicated message part on them :
If the player is on group "Red" :
- he win a 35/14 (red wool) and 278:1:35:3 (enchanted pickaxe)
- he received a private message "Congrats" and "You win a &3red wool &fand an &benchanted pickaxe"
- he must win one item from the luckyitem items list and received a private message "&3A lucky item for you : %item%" where %player% and %item% are replaced with his nickname and the name of the item won.
On the dedicated message part from the 'luckyitem' part i added a 'broadcast' and a 'log' message so :
- a broadcast message is sent for all players in the server "&5A lucky item started for %player%, he win %item%"
- a log message is sent to console "Lottery for %player% -> %item%"
If player is not on group "Red" the rewards part is not launch so nothing happen.
Check this dedicated pages to see all you can do:
conditions rewards
@artlune
Hello, conditions part are on same level than rewards part on the same yml file.
conditions rewards
You forgot to complete an example with a condition. I see it written at the bottom of the Examples page but there aren't any examples listed under it. Say I wanted to give the player 1 Red Wool but only if they are in the "Red" group. Would this work?
rewards:
items:
- '35/14'
conditions:
group:
- +Red
Or do I start with "conditions:" instead of "rewards:"? Should "items:" be under "conditions:" and not above it?