RolePlayCalendar
This plugin will keep track of the current Minecraft in-game date. You can post the date on signs and see the current date with a command. The weekday names, month names, and number of days in each month are completely customizable. By default, it uses real-life month names and weekday names, however, it is intended to be changed to fit in your world.
Usage
In general, this plugin just works. At the beginning of each day, the new day is announced (this can be configured). It's also possible to use the /today command to see the same announcement at any time. Using the command requires the rpcal.today permission, which everyone should have by default.
It is also possible to place signs that will update whenever the day changes. The rpcal.createsign is required to create signs. To do this, simply put the text [cal] anywhere in the sign text, then use the formatting codes below to specify how the sign should appear. For example, the sign lines might look like this:
[cal]
%w
%m %d
%y
Keep in mind there is a 15 character limit on each line, so be sure everything will fit properly.
There are two other commands available:
- /rpcal reload - Reloads the plugin from the config file
- /rpcal advance - Manually advance the calendar by one day
Both of these commands require the rpcal.admin permission node.
Configuration
When the plugin first runs it will create a config.yml file in its plugin folder. These are the options that can be modified.
Option | Description |
---|---|
datestr | The string used to format the date announcement (see formatting info below) |
dayannounce | Whether to announce the date at the beginning of the day |
monthnames | The names of the months, separated by commas |
monthdays | The number of days in each month, corresponding to the name list |
weekdays | The names of the days of the week, separated by commas |
yearoffset | The year to begin with |
yeartag | The text to put after the year (the epoch name) |
world | The world to watch the day cycle |
daychangeoffset | When the day should change, offset by hours from morning (hour 0 is roughly 8am) |
timecheckinterval | How often the plugin checks the current time to see if it is a new day, in server ticks |
ignorebigchanges | Whether the plugin should ignore big jumps in time, such as those caused by other plugins' time changes |
Formatting
The following codes can be used in both the announcement string and in sign text:
- %d = Day of month
- %m = Name of month
- %w = Weekday name
- %y = Year
Permissions
Permission | Description | Default |
---|---|---|
rpcal.today | Allows the player to use the /today command. | everyone |
rpcal.createsign | Allows the player to create a calendar sign. | op only |
rpcal.admin | Allows the player to use the /rpcal command. | op only |
Change Log
Version 1.0
- First BukkitDev release
See this thread on the Bukkit forums for the previous version of this plugin: http://forums.bukkit.org/threads/rpg-info-minecal-an-in-game-calendar-system.14164/
Can someone fix the day watcher ?
This plugin needs a 1.9 update, it generates an internal error when advancing and seems to break on restart unless you advance 1 day.
1.7.10 would really be cool!
Please update this to 1.7.10!!!
It stopped working when moving to 1.7, is this a known issue?
@MissIju
As far as I know it still works fine.
Is this still an active plugin and will it ever be updated?
It would be possible to create some type of "back-end" to display the server date, in a website?.
@RoosSkywalker
As far as I'm aware the current version should still work fine.
This would be awesome! Can you please update it to 1.5.1 and/or 1.5.2?
Works in bukkit server 1.5.2
create a toggle for perms so people with out a perm manager can use it
Maybe add a config option for when it becomes a new year offset, and what to change it to!
Simple and highly configurable, leave it to nisivon to do it again. One thing I would love to see, is an option (or alternate bit like %ds) to the day of the month display, to have it say '1st', '2nd', '3rd', etc.