MineAcademy Docs

Appearance

Special Chests ​

Winter adds several types of special chests that can be used for events, gifts, and timed rewards. These chests are perfect for seasonal events, daily rewards, or special occasions on your server.

Chest Sign Creation

To place a sign on a chest, place the chest first, then place a sign directly on it by holding SHIFT while right-clicking with the sign.

Gift Chests ​

Gift chests allow players to create lootable chests for other players. They're great for leaving gifts or running community events.

Public Gift Chest ​

[Gift]
Usage: Creates a public gift chest that can be looted by anyone with the winter.chest.gift permission.
Note: Only the first line is required - [Gift]. Leave the other lines empty.

Private Gift Chest ​

[Gift]
playername1
playername2
playername3
Usage: Creates a private gift chest that can only be looted by the specified players.
Lines 2-4: Usernames of players who should have access (up to 3 players).
Permission: Players still need the winter.chest.gift permission.

Dated Chests ​

Dated chests are only available during specific time periods. They are "infinite" - they don't lose items when looted, but each player can only loot them once.

Preview Mode

Enable Dated_Chest.Preview in settings.yml to let players see chest contents before the unlock date. The chest will show items but won't allow taking them until the date is reached.

Default Year

Set Dated_Chest.Default_Year to the current year in settings.yml so your dated chests trigger correctly. The plugin warns you in console if the configured year doesn't match the current year.

Daily Chest ​

[Dated]
24.12
Usage: Creates a chest that is only accessible on December 24th.
Second line: The date in DD.MM format.
Permission: Players need the winter.chest.dated permission.

Time-Restricted Daily Chest ​

[Dated]
24.12
17:00-20:00
Usage: Creates a chest that is only accessible on December 24th between 5PM and 8PM.
Second line: The date in DD.MM format.
Third line: Time range in HH:MM-HH:MM format.

Date Range Chest ​

[Dated]
25.12-26.12
Usage: Creates a chest that is accessible between December 25th and 26th (inclusive).
Second line: Date range in DD.MM-DD.MM format.

Time-Restricted Date Range Chest ​

[Dated]
25.12-26.12
18:00-19:00
Usage: Creates a chest that is accessible on December 25th and 26th, but only between 6PM and 7PM each day.
Second line: Date range in DD.MM-DD.MM format.
Third line: Time range in HH:MM-HH:MM format.

Timed Chests ​

Timed chests can be looted repeatedly, but players must wait a specified duration between each open. They can be set to unlimited uses or a set number of uses per player.

Cooldown Chest ​

[Timed]
60m
Usage: Creates a chest that can be looted repeatedly, with a 60-minute cooldown between loots.
Second line: Cooldown duration. Examples: 60m (60 minutes), 24h (24 hours), 20s (20 seconds).
Permission: Players need the winter.chest.timed permission.

Limited Uses Chest ​

[Timed]
24h
3
Usage: Creates a chest that can be looted 3 times by each player, with a 24-hour cooldown between loots.
Second line: Cooldown duration.
Third line: Maximum number of uses per player.

Admin Features ​

Players with the winter.chest.admin permission can:

  • Break chests created by other players
  • Bypass cooldown restrictions on timed chests
  • Access any chest regardless of date/time restrictions
  • Access private gift chests even if not listed on the sign