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:

StatDescriptionVariables
Block_breakAll broken blocks with their DatavaluesitemId itemData breaking
Block_placeAll placed blocks with their DatavaluesitemId itemData breaking
DeathAll deaths with their causescause entity(boolean, true is safest)
KillAll kills with their causestype
MoveWalking, 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)
PlaytimeTime played in seconds
ArrowsArrows shot
Xp_gainedTotal XP gained
JoinsTotal times joined
Fish_catchedTotal fish Caught
Damage_takenTotal damage taken
Times_kickedTotal times kicked
Tools_brokenTotal Tools broken
Eggs_thrownTotal eggs thrown
Items_craftedTotal items crafted
OmnomnomTotal times had a snack
On_fireTotal times being on fire
Words_saidTotal words said
CommandsdoneTotal commands done
VotesTotal times voted for the server (uses Votifier)
WorldchangeTotal times worlds changed
BucketfillTotal buckets filled
BucketemptyTotal buckets emptied
BedenterTotal times bed entered
ItemdropsTotal times items dropped
ItempickupsTotal times items picked up
TeleportsTotal times teleported
ShearTotal times sheared
LastjoinThe time the player joined the server last
LastleaveThe 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

CommandPermissionDescription
/achachievements.view.selfCheck out your progress
/ach player <player>achievements.view.othersCheck out someone elses progress
/ach reloadachievements.reloadSaves all players and reloads all achievements
/ach page <page>achievements.view.selfCheck 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!

You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of Lolmewn Lolmewn Feb 28, 2015 at 15:10 UTC - 0 likes

    @Liger_XT5: Go

    Spigot moved dependencies, so fanciful can't find GSON anymore. It has been fixed but the build its been fixed in contains a new config layout which isn't documented yet. You can try it of course, since you only have one achievement anyway it's not going to be extreme.

    Waiting to see what's going to become of BukkitDev. May or may not switch to a replacement if it completely dies off (which is what I presume to happen really).

  • Avatar of Liger_XT5 Liger_XT5 Feb 27, 2015 at 22:54 UTC - 0 likes

    Just tried it again. Got something different. Not sure what's going on.

    [16:49:29] [Craft Scheduler Thread - 210/ERROR]: Could not pass event StatUpdateEvent to Achievements v2.0.0-50
    org.bukkit.event.EventException
    	at org.bukkit.plugin.java.JavaPluginLoader$1.execute(JavaPluginLoader.java:305) ~[Spigot.jar:git-Spigot-8c3dd1f-ee6d0fa]
    	at org.bukkit.plugin.RegisteredListener.callEvent(RegisteredListener.java:62) ~[Spigot.jar:git-Spigot-8c3dd1f-ee6d0fa]
    	at org.bukkit.plugin.SimplePluginManager.fireEvent(SimplePluginManager.java:502) [Spigot.jar:git-Spigot-8c3dd1f-ee6d0fa]
    	at org.bukkit.plugin.SimplePluginManager.callEvent(SimplePluginManager.java:484) [Spigot.jar:git-Spigot-8c3dd1f-ee6d0fa]
    	at nl.lolmewn.stats.player.StatData$1.run(StatData.java:84) [Stats.jar:?]
    	at org.bukkit.craftbukkit.v1_8_R1.scheduler.CraftTask.run(CraftTask.java:71) [Spigot.jar:git-Spigot-8c3dd1f-ee6d0fa]
    	at org.bukkit.craftbukkit.v1_8_R1.scheduler.CraftAsyncTask.run(CraftAsyncTask.java:53) [Spigot.jar:git-Spigot-8c3dd1f-ee6d0fa]
    	at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1142) [?:1.8.0_31]
    	at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:617) [?:1.8.0_31]
    	at java.lang.Thread.run(Thread.java:745) [?:1.8.0_31]
    Caused by: java.lang.NoClassDefFoundError: net/minecraft/util/com/google/gson/Gson
    	at nl.lolmewn.libs.mkremins.fanciful.FancyMessage.createChatPacket(FancyMessage.java:527) ~[?:?]
    	at nl.lolmewn.libs.mkremins.fanciful.FancyMessage.send(FancyMessage.java:514) ~[?:?]
    	at nl.lolmewn.libs.mkremins.fanciful.FancyMessage.send(FancyMessage.java:552) ~[?:?]
    	at nl.lolmewn.libs.mkremins.fanciful.FancyMessage.send(FancyMessage.java:565) ~[?:?]
    	at nl.lolmewn.achievements.EventListener.handleAchievementGet(EventListener.java:227) ~[?:?]
    	at nl.lolmewn.achievements.EventListener.onStatUpdate(EventListener.java:73) ~[?:?]
    	at sun.reflect.GeneratedMethodAccessor482.invoke(Unknown Source) ~[?:?]
    	at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43) ~[?:1.8.0_31]
    	at java.lang.reflect.Method.invoke(Method.java:483) ~[?:1.8.0_31]
    	at org.bukkit.plugin.java.JavaPluginLoader$1.execute(JavaPluginLoader.java:301) ~[Spigot.jar:git-Spigot-8c3dd1f-ee6d0fa]
    	... 9 more
    

    This repeats every second.

    The only achievements I have, are for autoranking when a person meets X number of seconds.
    Example:

    1: 
      name: "Active for 1 hour!"
      goals:
      - "Playtime 3600 total"
      rewards:
        money: 0
        items: ""
        commands:
        - "manuadd %player% member2"
      onComplete:
        broadcast: "&4%player% completed the &a&a%achievement%&4&4 achievement!"
    
    Last edited Feb 27, 2015 by Liger_XT5

    MCDen @ mc.mine-craft-den.com
    http://dv95vg8j0dclt.cloudfront.net/images/servers/banners/normal/39051_1423940226.jpg
    Details at FairMCList.com!

  • Avatar of Lolmewn Lolmewn Feb 15, 2015 at 15:17 UTC - 0 likes

    @Prodkid: Go

    Oh yeah, looks like pastebin fucked up a bit there. Oh well. Probably gonna overhaul the plugin soon anyway for Stats 3.0 ;)

    @Liger_XT5: Go

    No idea what that error message is, please post logs?

  • Avatar of Liger_XT5 Liger_XT5 Feb 14, 2015 at 03:31 UTC - 0 likes

    Just tried to install the plugin, I get the error stating that MCStats.Stats_achievements does not exist. A bit strange, lol

  • Avatar of Prodkid Prodkid Feb 13, 2015 at 17:29 UTC - 0 likes

    @Lolmewn: Go

    I ran through two parsers and got no errors.

  • Avatar of Lolmewn Lolmewn Feb 13, 2015 at 16:03 UTC - 0 likes

    @Prodkid: Go

    Latest build on my CI uses a new config system which is not yet explained. BTW: You have formatting issues in there, try parsing your YML in a YML parser.

  • Avatar of Prodkid Prodkid Feb 13, 2015 at 14:37 UTC - 0 likes

    @Lolmewn: Go

    Okay, thanks. I ran into an issue while updating the latest build #76.

    I was trying to check my achievement status for ID 17 by running /achievements 17 but was given by the response "Do /achievements to view your achievements!" That goes the same for doing /achievements or any other command with the plugin. Heres my config. I don't think I did something wrong. http://pastebin.com/8Qg866Jf

  • Avatar of Lolmewn Lolmewn Feb 13, 2015 at 13:17 UTC - 0 likes

    @Prodkid: Go

    Yes, type is Player as far as I know. As for PVP, Yes. The description from Stats can be copied to here pretty much, all stats from Stats are supported automatically by Achievements.

  • Avatar of Prodkid Prodkid Feb 13, 2015 at 09:55 UTC - 0 likes

    For kill stats, is there a type for just players? is it player? Also looking at stats plugin theres a stat called pvp, does this plugin have that?

  • Avatar of Lolmewn Lolmewn Feb 09, 2015 at 23:41 UTC - 0 likes

    @Daconway: Go

    Something like that is planned, yes. Currently does not exist.

Facts

Date created
Apr 16, 2013
Categories
Last update
Jul 01, 2014
Development stage
Release
License
GNU General Public License version 3 (GPLv3)
Curse link
Achievements Reloaded
Downloads
8,958
Recent files

Authors

Relationships

Required dependency
Stats
Optional dependency
SpoutPlugin
Vault