ActivityPromotion - Promote players based on their activitytime.

IMPORTANT: As I am not playing minecraft anymore, i stopped developing this plugin.
This will now be unactive. If you want to continue or start over fell free to take a look at the Code.

Version: v0.5.5

Notes on the last changes

v0.5.4 - v0.5.5

I fixed the spelling mistake, please change it in the config: "necessaryGroup" instead of "neccesaryGroup".
I implemented two new variables in the config: "promotionCheck" and "resetCheck".
They are used to determine in which periods the tasks should run. 10 means every 10 seconds.
Change that according to your needs.

I also implemented MYSQL, but i haven't fully tested it yet. Please report any bugs in the forum.


This plugin needs Vault as permission and economic interface!
You have to download Vault er ein order to get this plugin to work.

I am the owner of a german minecraftserver and on our server is a need for automatic promotion.
There is nothing out there, that provides the same functionality, so i created this plugin.
This plugins allows you to put player in multiple groups, based on the time they have spend playing on the Server.
This is my first plugin for bukkit, so please be patient with updates and bad code ;)


  • Multiworld support
  • Supports Flatfile and MYSQL
  • Vault integrated: supports Permissions 3, bPermissions, PEX, GroupManager, PermissionsBukkit, zPermission
  • limit the promotion to groups
  • add Users that should be ignored
  • define your own period of time the user should be promoted
  • multiple timeperiods possible
  • add Permissions to the user
  • define own ActivityPeriods like 7 days, 1 month, whatever
  • See also the last logout, the total playing time and inactive players


The plugin will count the onlinetime of each player.
when a player reaches a specific timelevel, he will be promoted to the group.
After a resetdate the player will keep the groups for one more timeperiode
if he is inactive in this period, he will be degraded in the next period.
The date will be stored in the list.yml
That is all.

See the video for more details.


shows all commands
/ap reload
reload the plugin and save actual status
/ap info <player>
shows information about the player
ap info
shows information about yourself


able to reload ActivityPromotion
Allows you to see Information about yourself.
Allows you to see Informations about other players.
With this node you will see inactive Player when you log in

All nodes can be used by OP by default.


    port: 3306
    enable: false
    adress: 'localhost'
    user: root
    database: minecraft
    pass: ''
promotionCheck: 10
resetCheck: 10
        resetActivity: true
        periodTime: 1
        nextReset: '2011-10-25 00:00:00'
        - Trial
        - Member
        resetActivity: false
        periodTime: 1
        - VIP
        nextReset: '2012-03-22 10:36:00'
        startTime: 1
        endTime: 40
        setForFirstUse: false
        - example.permission
        - Trial
        - Notch
        - world
        startTime: 30
        endTime: false
        setForFirstUse: false
        - Trial
        - another.example.permission
        - Member
        - Notch
        - world
        startTime: 100
        endTime: false
        setForFirstUse: false
        - Member
        - ^Trial
        - vip.permission
        - VIP
        - Notch
        - world

Explanation for the periods

Except for periodTime (which values are in minutes) all values have to be in seconds!

the name for the group doesn't really matter, put in what you like
If you want to reset the timecount every now and then, set this to true.
If you set this to false it wil count as a lifetime period.
Put here the time in MINUTES after a period should be resetted.
- Trial
- Member
Define the active groups here. They have to be listed in the groups section.
'2012-03-22 20:16:00'
You have to put a date in the past here for the first time you use the plugin.
After that the plugin will update this entry on its own.

Explanation for the groups

The time in seconds after a player will be promoted
The time in seconds after a player will get this group removed, if set to false it means this group has no endtime
If you want to give this group every player on the server on the first start, set this to true. it will reset after one period is over.
The groups the player has to be in to get promoted. Please be aware that he has to be in ALL Groups to get promoted.
'^' Means, that he must not be in this group to get promoted.
If you want to grant permission nodes instead of groups put your nodes here.
This are the groups the player will be promoted to
Add Users that shoud be ignored
Put the worlds here. Please be aware, that the nessecaryGroup will apply on all worlds.
So the player has to be in Member and not in Trial in ALL worlds to get promoted.


The "^" command will only work for nessecaryGroup.


    lastLogout: 1332443720
    totalTime: 130
      oneMonth: 6
      lifeTime: 0
      oneMonth: 4
      lifeTime: 62


Since version 0.5.5 AP supports MYSQL again.
Please note that this plugin will NOT create the table, instead you have to create it.
The code looks like this:

CREATE  TABLE `ap_player` (
  `period` VARCHAR(255) NOT NULL ,
  `name` VARCHAR(255) NOT NULL ,
  `lastLogout` INT NULL ,
  `totalTime` INT NULL ,
  `passivePeriod` INT NULL ,
  `timePlayed` INT NULL ,
  PRIMARY KEY (`name`, `period`) )

Known Bugs


Download & Source

All Files on GitHub
Source on GitHub


  • v0.5.5
    • implemented MYSQL
    • fixed spelling mistake
  • v0.5.4
    • implemented Vault to support more permissionplugins and to easier integrate economics in further steps
    • fixed exception when a player was not found after asking information about it
  • v0.5.3
    • fixed handling with console
  • v0.5.2
    • Compiled against CB1.2.4-R1.0
  • v0.5.1
    • Added GroupManager support
    • Added Ingame commands
  • v0.5DEV
    • Complete rewrite, thanks to the new code base provided by bukkit.
  • v0.4.1
    • updated version number
    • fixed a small bug
    • implemented some more features that doesn't work actually
  • v0.4
    • Compiled against CB 1317
    • Includes newest version of bPermission and PermissionsEx
  • v0.3.3
    • fixed an error that created nullpointerexceptions when using the flatfile
  • v0.3.2
    • removed Permission reload after each promotion and put it in the /ap reload command
    • added secure close for mysql
  • v0.3.1
    • removed debug output when a player joins
  • v0.3
    • Added MySQL support
    • improved performance
    • playerupdate now every two (2) seconds instead of every tick
  • v0.2
    • More Permissions to support
    • Added ignoreUser, endTime, default and permissions
    • Bugfixing
  • v0.1
    • First release


Even so i tested out this plugin there sure will be Bugs and Errors.
Please post them here so i can improve the Plugin and add more Features.
If you want to help me, improve the plugin or request features please do that also here.


  • timed Groups, e.g VIPs after you typed in "/ap promote <player> <group> <time>
  • MYSQL support
  • Regulary updates ;)


  • written periods like "1 month" or "6 weeks"
  • timed/VIP groups
  • IConomy support
  • Add MySQL support

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

  • Avatar of lDarkeen lDarkeen Apr 16, 2013 at 00:00 UTC - 0 likes


    How are you? I'll hope fine :)

    I have a little suggestion to "/ap info" command. If you could add to some line the last group that user's belongs, it will be nice. Thanks. For example: If user was promoted from "Guess" to "Member", so the plugin should be "Group: Member".

    Sorry for my bad english.

  • Avatar of WEB11 WEB11 Jul 25, 2012 at 05:18 UTC - 0 likes

    Does anyone know of a similar plugin since this won't be updated?

  • Avatar of FriedTaco FriedTaco Jun 28, 2012 at 19:50 UTC - 0 likes

    When using this plugin, every time I modify the config, it rewrites the entire thing back to the default.

    Running on the latest RB of craftbukkit, and using GroupManager with Vault installed. It constantly spams me that it's demoting me to default, then promoting me to Trial. I don't have a trial group, my config only has 1 setting, which is to promote my members to the group Member after 2 hours.

    Last edited Jun 28, 2012 by FriedTaco

    MadMinerMc Banner

  • Avatar of antoinne30 antoinne30 Jun 21, 2012 at 13:54 UTC - 0 likes

    o wait i see the todo list now u want to make an command for specific time like vip 100 ours but does the list reset too then for 1 specefic player? and not the whole group

    Last edited Jun 21, 2012 by antoinne30
  • Avatar of antoinne30 antoinne30 Jun 21, 2012 at 13:52 UTC - 0 likes

    i have a question does if i have been 1 sec online i get guest but if i have 2 sec on my name i cant get to guest anymore right ? becuase if thats so i cant make automated stuff so vips buy and they are automaticly time reseted then so i wont have to put in a specific date it will be reseted otherwise my vips will always have vip and thats not what i want.

  • Avatar of AdvantageServers AdvantageServers Jun 17, 2012 at 06:02 UTC - 0 likes

    The folder will not load and it says it is not in my plugins when i type /plugins..... please help!!!!

    Dylan Hansch

    Lavahub Network Owner

    IP Address:

  • Avatar of weja93 weja93 May 05, 2012 at 22:59 UTC - 0 likes

    @Chumpertm: Go With flatfile everything worked perfectly, never had problems.
    Only that stopping the server took 30 seconds, and it was stuck in "disabling activitypromotion" or something like that when it's unloading the plugins. And it was getting worse all the time.

  • Avatar of Chumpertm Chumpertm May 05, 2012 at 20:37 UTC - 0 likes
  • Avatar of HuntVenom HuntVenom May 05, 2012 at 16:36 UTC - 0 likes

    Hey. Can you make me a config? That promotes "Member" to "Elite" in 50 hours? I don't know how to make one. Thanks.

    Last edited May 05, 2012 by HuntVenom
  • Avatar of Chumpertm Chumpertm May 05, 2012 at 11:50 UTC - 0 likes

    @weja93: Go

    I will give you the possibility to set the save circle in the config but will set it to false by default.

    Did you have the same problem when you used the Flatfile?


Date created
Oct 09, 2011
Last update
Apr 30, 2012
Development stage
  • enUS
GNU General Public License version 3 (GPLv3)
Curse link
Recent files



Required dependency