Achievements Reloaded
Achievements - made by Lolmewn
What does this plugin do?
This plugin allows you to add additional achievements to the game. This plugin requries my other plugin, Stats, to work.
Using this plugin, you can add achievements to the game, and add rewards to them. Whenever a player gets an achievement, you can let commands run, give them money and/or items, and much more using the API this plugin will have.
How do I install this?
Download the latest file from the files page and put it in your plugins folder.
Configuring the plugin
config.yml
There's nothing much to configure here yet. You can toggle whether or not it auto-updates, but that's about it.
achievements.yml
This is where you will store all your achievements. An achievement must have the following layout:
<id> name: YourAchievementName goals: - Stat <amount> <TOTAL or the variables belonging to this Stat> - another one?
The rest of the things is pretty self-explanatory. Once I have time, I will write down a good how-to-write achievements page.
Stats
These are the available Stats:
Stat | Description | Variables |
---|---|---|
Block_break | All broken blocks with their Datavalues | itemId itemData breaking |
Block_place | All placed blocks with their Datavalues | itemId itemData breaking |
Death | All deaths with their causes | cause entity(boolean, true is safest) |
Kill | All kills with their causes | type |
Move | Walking, sailing, riding a train, on the back of a pig or by horse. | type (0=walk, 1=boat, 2=train, 3=pig, 4=pig in train, 5=horse) |
Playtime | Time played in seconds | |
Arrows | Arrows shot | |
Xp_gained | Total XP gained | |
Joins | Total times joined | |
Fish_catched | Total fish Caught | |
Damage_taken | Total damage taken | |
Times_kicked | Total times kicked | |
Tools_broken | Total Tools broken | |
Eggs_thrown | Total eggs thrown | |
Items_crafted | Total items crafted | |
Omnomnom | Total times had a snack | |
On_fire | Total times being on fire | |
Words_said | Total words said | |
Commandsdone | Total commands done | |
Votes | Total times voted for the server (uses Votifier) | |
Worldchange | Total times worlds changed | |
Bucketfill | Total buckets filled | |
Bucketempty | Total buckets emptied | |
Bedenter | Total times bed entered | |
Itemdrops | Total times items dropped | |
Itempickups | Total times items picked up | |
Teleports | Total times teleported | |
Shear | Total times sheared | |
Lastjoin | The time the player joined the server last | |
Lastleave | The time the player left the server last |
Want to use a Stat that uses variables? You have to specify either the variables or use 'TOTAL'.
Variables with StatTypes
Some Stats have variables. A good example is Block_break, it has the variables <blockId> <blockData> and <breaking>.
If you want to have a goal where a player must break 5 blue wool blocks, the goal would be
- Block_break 5 35 3 true
If the block has no special blockData (e.g. there's only one type of it), use 0 as blockData. Example:
- Block_break 20 1 0 true
This means break 20 stone blocks.
Examples for the other special Stats:
- Block_place 5 TOTAL - Move 1000 1 #move 1000 blocks with transport type 1 (boat) - Kill 10 Zombie - Death 3 Creeper
The format always is - Stat Amount Total|Variables|<empty>
Item Rewards
The way Item Rewards are written down is somewhat difficult. Basically, you should write it down as
items: <itemId>.<itemData>,<amount>;<itemId>.<itemData>,amount;... etc. items: 35.3,10;1,10 items: 1,20
Note that the itemData doesn't have to be specified
The itemID obvioulsy is the ID the item has (which you can find a full list of here), the itemData is also on that list, and the amount.. well, duhh.
The first example gives you 10 colored wool, and 10 stone. The second example gives you 20 stone.
Example achievements.yml
You can find an example right here. When writing new achievements, I suggest you grab this page and see what all the options do.
Commands and permissions
Command | Permission | Description |
---|---|---|
/ach | achievements.view.self | Check out your progress |
/ach player <player> | achievements.view.others | Check out someone elses progress |
/ach reload | achievements.reload | Saves all players and reloads all achievements |
/ach page <page> | achievements.view.self | Check out page <page> of your progress |
/ach <achievement> | Check out what the achievement is all about |
Development builds
Development builds of this project can be acquired at the provided continuous integration server.
These builds have not been approved by the BukkitDev staff. Use them at your own risk, they may or may not work at all.
Development builds for Stats can be found at my CI, over at http://ci.lolmewn.nl/job/Achievements/.
Source
Want to help develop, or simply view what makes this plugin run?
Visit my bitbucket!
Metrics
This plugin utilises Hidendra's plugin metrics system, which means that the following information is collected and sent to mcstats.org:
- A unique identifier
- The server's version of Java
- Whether the server is in offline or online mode
- The plugin's version
- The server's version
- The OS version/name and architecture
- The core count for the CPU
- The number of players online
- The Metrics version
If you wish to disable this feature (/me cries), you can do so by opt-ing out, which you can do in the config file under /plugins/PluginMetrics/
Auto-updater
This plugin has a built-in auto-updater, which connects to BukkitDev to check for updates. If you, for some reason, wish to disable this process, you can do so by setting 'update' to false in the plugins' settings file.
IRC Support
You can find me (and possibly, when I'm around, support) in my IRC channel #Lolmewn on irc.esper.net - See you there!
@mmuziek
Yep :) Exactly.
@Shooty_
i think you can alraidy to this. by adding the command - say hey everyone %player% reached the achievement test
@Lolmewn
Just mean that certain achievment could be broadcasted in the tchat for all people and other achievments only broadcasted to the player who get the achievement. So "hard" achievement could be see by everyone :)
@Shooty_
Could you explain this in greater detail?
Hi, can you add a way for us to add a special "tag" for certain achivements and if a player complete these achievement with this "tag" it will broadcast a message on the server ?
@ha11oga11o
Yeah, that was because my computer was off probably :P Try now (or somewhere in the coming... six or so hours)
@Lolmewn
Hmm,
Service Temporarily Unavailable
The server is temporarily unable to service your request due to maintenance downtime or capacity problems. Please try again later.
Ill try later :)
@ha11oga11o
Or, I don't have a link to my CI on here. Will add that now.
@Lolmewn
Oke, nice to hear, but, as far i see version are:
R: Stats v1.29 for 1.6.4 Jun 20, 2013
R: Achievements v0.6 for 1.6.4 Jun 20, 2013
So where are those new versions? DEV builds? If so can you provide link :)
Otherwise, seems all works fine, except some events/blocks are not counting anymore. Dont have details but im sure you know what it is then.
many thnx for awesome plugin, and many thnx for web-end too :)
@ha11oga11o
Yeah.. Will be fixed in the next version (I think it already is, actually)
@aneantisseur
I was just about to comment at same issue. I have this every time when shutting down server. And i have this:
http://pastebin.com/VsLSS8xJ
From time to time, as far i seen when someone leaves server.
Cheers :)
@Lolmewn
Ok. I've one question now.
When we reach an achivement, messages and commands when it's complete should be execute immediatly ?
I just see I have antoher problem. When I reload, I get this message:
What is this and how to fix it ? Thanks (and sorry for my bad english )
@aneantisseur
It automatically regenerates the files if they do not exist (or maybe it only does that when the config doesn't exist, but I'm pretty sure it does it for every file)
Hi, your plugin doesn't work fine. I've installed and tested it, but players does'nt receive the message when the achivements was reached. So, I've delete the plugin and reinstalled, but this time, no files .yml were created.
Can you send a file with 10 achievements arround, with config.yml, for tests ?
The plugin stats run under version 1.29, and the latest version of achievement. I use spigot 1112.
Thanks
@ruggerbuns
Which version of Stats are you running? Looks to me like you're running two incompatible versions.
Getting a bunch of these:
http://pastebin.com/ikR3aD6h
I installed all of your Stat plugins and I'm not sure which one the error is occurring in.
@ha11oga11o
Oh right, that error makes total sense. I'll fix that too.
Hello,
i just add this to my server but i got this error from time to time:
http://pastebin.com/REVLiynR
What is the problem??
@mmuziek
It does. Currently Achievements actually uses the database connectivity of Stats to store it's data, going to the same database but a different table. Future support for Achievements on the website are planned, but I'm not sure what the development of webstatsx is at at the moment...
mabe its a nice idea to put achievements in the same DB as stats. then show all the achievements and stats about the achievements and such in the webstatsx
that will be awesome