RolePlayCalendar will start downloading in 5 seconds...
Description
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/