- voting rewards (any servers in general)
- PVP rewards (PvP, Faction, KitPvP servers)
- mining rewards (Prison Servers), etc.
The time-based permission/rank will automatically expire after the duration specified at the time of issuing the permission/rank. You can use any existing permission nodes /ranks with this plugin to make them time-based. You can also specify whether the time is counted only while a player is online or even when they are offline.
Doesn't permission plugin like PermissionsEx have timer feature?
Yes, and if it's working for you, you would not need this plugin. However, if it's not working as you wanted or if your permission plugin does not have timer-based permission/rank feature, this plugin is for you.
With this plugin, even if the server shuts down/restart/crash, timer information is still kept safe and when the server resumes the timer will resume counting down. Also, the timer will be monitored for offline players too. And expired permissions/ranks are re-checked at the time of player login to make sure they are indeed expired.
Test Server:
- Please contact me to get test server information.
Commands:
- /ptimer help : displays a help menu
- /ptimer reload : reloads the config.yml
- /ptimer info [name] : Display your (or [name]'s) time-based permissions.
- /ptimer give <name> <common-perm-name|rank> [perm[img=18x18]styles/default/xenforo/clear.png[/img]ermission-node] [time:duration] [world:worldname] [online:{true|false}]: Gives <name> a permission <common-perm-name> or a rank <rank>. If [node] and [duration] are not specified, the <common-perm-name|rank> specified in the config.yml will be used. If a player already has a specified timed-permission, the specified time will be added to the existing time.
- /ptimer remove <name> <common-perm-name | rank> : Removes the permission <common-perm-name> or the rank <rank> from <name>.
- /ptimer giveaway <name> <common-perm-name | rank> : Stop the timer for this particular permission|rank and give it to the player.
Aliases:
- permissiontimer, ptimer
Permissions:
- permissiontimer.reload : allows you to use /ptimer reload
- permissiontimer.info: allows you to use /ptimer info command
- permissiontimer.admin: allows you to use /ptimer give and remove command
Configuration:
You can customise
- common name of a permission node, for instance "fly" for "essentials.fly",
- limit the number of times a player can use a permission,
- duration/expiration of a permission,
- messages for each permission given/removed.
config.yml
config.yml
HelpMessages:
banner:
msg: "=== &e[&aPermissionTimer Commands List (%version%)&e] &r==="
help:
msg: "/ptimer or /ptimer help : display this help menu."
reload:
msg: "/ptimer reload : Reload config.yml file."
permission: "permissiontimer.reload"
info:
msg: "/ptimer info [name] : Display your (or [name]'s) time-based permissions."
permission: "permissiontimer.info"
give:
msg: "/ptimer give <name> <perm|rank> [perm:perm_node] [time:duration] [world:worldname] [cost:$$$] [online:{true|false}] : Gives <name> a permisison <perm> or a rank <rank>."
permission: "permissiontimer.admin"
remove:
msg: "/ptimer remove <name> <perm> : Removes the permission <perm> from <name>."
permission: "permissiontimer.admin"
giveaway:
msg: "/ptimer giveaway <name> <perm|rank> : Gives <name> a permisison <perm> or a rank <rank>, that <name> currently has (this will cancel expiry without removing the permission/rank)."
permission: "permissiontimer.admin"
# define your parameter and its value like:
Messages:
error_msg : "&c [PermTimer] : Some error occured."
NoPermissionMsg : "&2[&aPermTimer&2]&r You do not have permission for this command."
NotEnoughArgsMsg : "&2[&aPermTimer&2]&r Not enough arguments supplied."
YouDontHaveMsg : "&2[&aPermTimer&2]&r You currently do not have any time-based permissions."
PlayerDoesNotHaveMsg : "&2[&aPermTimer&2]&r The player (&6%player%&r) currently does not have any time-based permissions."
YouHaveFollowingMsg : "&2[&aPermTimer&2]&r You currently have the following time-based permissions:"
PlayerHasFollowingMsg : "&2[&aPermTimer&2]&r The player (&6%player%&r) currently has the following time-based permissions:"
PermExpirationDateMsg : "&2[&aPermTimer&2]&r %type% %commonname% expires in %expires%."
YourPermExpiredMsg : "&2[&aPermTimer&2]&r %commonname% for %player% has expired."
IllegalDataFormatMsg : "&cIllegal Data Format."
UserLimitReachedMsg : "&2[&aPermTimer&2]&r You have reached the maximum number of time you can use this permission!"
GivenToMsg : "&2[&aPermTimer&2]&r The permission &6%commonname%&r has been added to the player (&6%player%&r), and it will expire in &d%expires%&r."
PermissionRemovedFromMsg : "&2[&aPermTimer&2]&r The permission (&6%commonname%&r) has been removed from the player (&6%player%&r)."
PermissionGivenToMsg : "&2[&aPermTimer&2]&r The permission (&6%commonname%&r) has been given to the player (&6%player%&r)."
#
#
# if the following is true, expired permission will also be listed
# with /ptimer info command
DisplayExpired: false
#
#
#
Permissions:
fly:
expire: 24h
limit: 5
permission: essentials.fly
given_msg: "&2[&aPTimer&2]&r You've been given a permission to use &6%commonname%&r, and it will expire in &d%expires%&r."
expire_msg: "&2[&aPTimer&2]&r Your permission &6%commonname%&r has just expired."
limit_msg: "&2[&aPTimer&2]&r You've exceeded the limit."
pre_cmd:
- "fly %player% on"
post_cmd:
- "fly %player% off"
test2:
expire: 12h
limit: 2
permission: what.ever.permission2
online: true
Ranks:
Dev:
expire: 3m
limit: 1
given_msg: "&2[&aPTimer&2]&r You've been given a rank &6%commonname%&r in &\
6%world%&r, and it will expire in &d%expires%&r."
expire_msg: "&2[&aPTimer&2]&r Your rank &6%commonname%&r has just expired."
limit_msg: "&2[&aPTimer&2]&r You've exceeded the limit."
world:
# - "prison"
Tester:
expire: 3h
limit: 1
given_msg: "&2[&aPTimer&2]&r You've been given a rank &6%commonname%&r in &\
6%world%&r, and it will expire in &d%expires%&r."
expire_msg: "&2[&aPTimer&2]&r Your rank &6%commonname%&r has just expired."
limit_msg: "&2[&aPTimer&2]&r You've exceeded the limit."
world:
# - "testworld"
online: trueInstallation:
Put PermissionTimer.jar in the plugins folder.
Dependency:
Vault (you need this to interface PermissionTimer and your permission plugin)
Example Usage:
- /ptimer give TestUser fly perm:essentials.fly time:10m
will give the user "TestUser" the Essential permission "essentials.fly" for 10 minutes. - /ptimer give TestUser VIP time:1d
will give the user "TestUser" the "VIP" rank for 1 day.
