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...
@m1cr0man
If i understand you want multiple scenario like :
for the same reward file ?
If i'm not wrong it is the limitation of the system for now so it can't be possible for the moment.
You can at least thinking in that direction :
Found a limit or a multiplier useful. For example the 100 multiplier.
Your players when they obtain the 100 level this is all the reward files that can be processed :
You can use some of them to make different scenarii using the conditions part.
Thanks for pointing me to that i'll working on it.
Is it possible to have multiple rewards on the same multiplier? eg.
Im running a modded server, rewarding Forstry Stamps and IC2 coins to long-term players, ie players who are rank > 100 mining. I want to reward players < 100 only a Stamp, is this possible?
Also, would you be able to add support for blocks who have damage values like wool? A lot of mod items, including higher value stamps, have ids like 31157:1.
No it isn't possible in that sort.
You can trick the thing perhaps :
That did :
On global level 150 the 15.yml is proceed, the player has the power 150 so rewards done.
If player has global level 300 the 15.yml is proceed too, the player not have power at 150 so rewards cancelled.
It seems a little weird and tricky at first approch but should work.
To illustrate what i said the 15.yml can be done like this :
If you look at the conditions page you will see that a lot of combinations are possible.
For the moment the limitation is for multiple scenarii on the same reward file.
Otherwise this division logic is not implemented like the multiple is on the tree folders.
I thought about division.
Something like that for example:
Power = 159
So reward should be 15.9 ( power/10 )
Is it possible ?
@matix931
For a globalpower multiple of 10 you can create your rewardfiles under the folder POWER/EVERY :
When your reward file is created, inside you set :
Is it posibble to set reward every level equal to globalpower/10 ?
The v0.8 comes with some fun reward like lotteryItems and luckyItem !!
Bug regarding the 'messages' part of your yml is fixed.
Now you can colorized every text on this 'messages' part using the in-chat syntax (ex:&3...)
The rewards page has been updated.
There's a bug on the 'messages' section.
Description :
whenever you choose mp/broadcast/log it sends mp
It is fixed for the next release who add some others rewards possibilities...
Thank you kindly for the update sir (: I am very excited to start adding punishing rewards! Although I sort of meant on death. They die in the mcmmo hardcore mode (which potentially strips them of their levels, depending on the percentage in the config) and then they lose their perms, or in broad terms, get punished :P
The v0.7 comes with the EVERY process enable.
A little word for that using use case.
The v0.6 comes with process in differents threads.
The initiation of treatment should be more fluid and should be add better performance on concurrent accesses.
Reward files are handled as YamlConfiguration object on independent threads.
I would be very happy to have feedback on this version especially on heavy use.
Thanks for the update!
@boozaa
Yes, perfect. I just wanted to get my point across for the losses <3.
@sheepwool7
No too much specific i think but if you can find a logic like this for your needs perhaps :
-> if all conditions succeed do reward/loss
levelUp
-> conditions
-> if one condition not succeed do nothing
@boozaa
Alright. Hardcore mode is on. Let's say I have it set to lose %100 of my levels gained. Will your plugin understand how to take any permissions earned away?
@Krallnyx
You can ommit the sender part on yml so for money node like that :
If you want a complete example it can looks like this :
Is that possible to reward with money without using a player's account ? (using infinite server account)
@sheepwool7
Simply create your reward yaml file on folder SKILLS/WOODCUTTING/ONE and name it 57.yml
In this SKILLS/WOODCUTTING/ONE/57.yml file you can optionally set some conditions on :
-money
-group appartenance
-if player has some permissions or if not
-the world where he is when he level up
And you set some rewards ...For you example it looks like this :
If the player pass conditions he got the rewards.
For the moment the plugin looks for the event levelUp of mcMMO. Can you explain me more what you think ? Perhaps a concrete example.
I am slightly confused as to how to create a reward. For example what would I do if I wanted a player to get the permission node essentials.help when they reach 57 in Woodcutting?
Also, what if we are using hardcore mode? I'd love if they lost their levels, they lose their reward as long as it's a permission node or group (if they got an item then there's no way guarantee it'll be in their inventory.)
@Thomas2536
What are you using for permissions and for economy ?