❏ GENERAL

TimedItemX is plugin that allow player to create timed item.
Support inventory check and world check

❏ FEATURES

Add/remove/set expire time for item.
Clear expire time from item.
Manage player's expired items.
Announce for player whenever their items is expired.
Plugin also check for player inventory even they're offline and remove expired item, announce amount of expired items to player when they're online.
Check for dropped item of all worlds in your server and remove if it's expired.
Store expired item of player.
Async check and thread-safe.
Add/remove timed item to collection.
Give timed item to player by name from collection.
Access to timed item's information.
Access to other player's expired items.
Auto-saving users/items data every X minutes (configurable)

MUST READ: If an item is already have lore , the expire format will be inserted into the top line of item's lore.
Before:

After:

Check online player's inventory

Check offline player's inventory

❏ UPCOMING FEATURES

Player can view their expired items and spend money to buy more expire time for item (removed)
- Reason: just my dumb idea, realize it unnecessary now
Access to expired items of player, and you can clone it to your inventory. ✓
Schedule to clear expired items of player after amount of time. (on going)
Expire time will now apply to item that dropped from player's inventory, it will be disappear after amount of time. (removed)
- Reason: other plugin did it instead
More inventory check like Chest, Furnace, Dispenser, ....etc (removed)
- Reason: this function will make your server spend more resources to work so remove for optimization
Command to check deeper information of timed item. ✓
Add support MySQL, SQLite, MongoDB, .. database (on going)
Add notification sound when item is expired (on going)

❏ COMMANDS

- /ti add [time]: Add expire time for item.

ex: /ti add 1d2h

- /ti additem [name]: Add timed item to collection.

ex: /ti add mySword

- /ti autosave: Open auto-saving options.
- /ti clear: Clear expire time from item.
- /ti expired [player]: View expired items of player.
- /ti giveitem [player] [name] [amount]: Give timed item to player.
- /ti infinity: Toggle infinity mode for timed item and it never expire.
- /ti info: Shows timed item information.
- /ti items: Shows timed item collection.
- /ti reload: Reload plugin.
- /ti remove [time]: Remove expire time from timed item.

ex: /ti remove 3d5h

- /ti removeitem [name]: Remove timed item from collection.
- /ti rename [name] [new-name]: Rename timed item from collection.
- /ti set <format>: Set expire time for item. (format can be edited in config.ym)

default format: dd/MM/yyyy HH:mm:ss
ex:

/ti set 12/07/2025 (without specific o'clock)
/ti set 27/05/2023 13:17:29 (full format)

- /ti setitem <name>: Set new item for timed item in collection (must hold item in hand)
- /ti help <page>: Show paged help.

❏ PERMISSIONS

- timeditem.command.add
- timeditem.command.remove
- timeditem.command.clear
- timeditem.command.help
- timeditem.command.set
- timeditem.command.reload
- timeditem.command.additem
- timeditem.command.removeitem
- timeditem.command.getitem
- timeditem.command.giveitem
- timeditem.command.setitem
- timeditem.command.autosave
- timeditem.command.expired
- timeditem.command.items
- timeditem.command.rename
- timeditem.command.infinity
- timeditem.command.info

❏ CONFIGURATION

config

# Set your custom language in lang folder
# If plugin can't find language , it will return default "en-US.yml"
# Even if you delete "en-US.yml", plugin have added default message
# to prevent null exception while the operation is happening
locale : en-US

# Tell player know that amount of items in their inventory is expired
announcePlayerWhenItemExpire : true

# Plugin will tell player know that amount of items
# in their inventory is expired while they offline
notifyPlayerWhenLogin : true

defaultBuyCost : 1000

# Auto saving
autoSaving:
  item : 5 #minutes
  user : 5 #minutes

# Sets format for expire time
timeFormat :
  # This will make time separate space when format
  # Ex: 3d 43m 10s
  spacing : " "
  # Expire time format
  # Also applied for set commands
  # Ex: 15/09/2023 22:31:18
  date : "dd/MM/yyyy HH:mm:ss"
  # Represents second value
  second : "s"
  # Represents minute value
  minute : "m"
  # Represents hour value
  hour : "h"
  # Represents day value
  day : "d"
  # Represents week value
  week : "w"
  # Represents month value
  month : "M"
  # Represents year value
  year : "y"

Language

en-US

# What's 'is-default-language' ?
# it will return 'en-US' if plugin can't find valid language
# you set in 'locale: <language-format>' (config.yml)'
is-default-language : true

prefix : "&7[&bTimedItemX&7]"

emptyTime : "&cPlease type a specific time"
notHoldItem : "&cYou must hold item in your hand!"
invalidTime : "&cNew time must greater than old time!"
invalidItem : "&cThis item don't have expire time!"
addTime : "&aAdded &6%duration%&a, &anew date is &6%new-date%"
removeTime : "&aRemoved &6%duration%&a, new date is &6%new-date%"
setTime : "&aSet expire time to &6%new-date%"
clearTime : "&aCleared expire time from item!"
clearExpiredItem:
  inventory : "%prefix% &cTotal &6%amount% &citems in your inventory is expired!"
  offline : "%prefix% &cTotal &6%amount% &citems in your inventory is expired while you're offline!"
expireFormat : "&7[&cExpired&7] &b%date-format%"
reloadPlugin : "&aReloaded language & configuration!"
addItem : "&aAdded timed item with name &6%name%"
removeItem : "&aRemoved timed item with name &6%name%"
giveItem : "&aGiving &6%amount%x &atimed item by name &6%name% &ato player &6%player-name%"
setItem : "&aTimed item &6%name% &ais updated with a new item!"
setInfinity:
  active : "&aThis timed item is now in infinity mode and cannot be expired!"
  deactive : "&cThis timed item is no longer infinity mode and will expire in &6%expire-date%"
itemInformation:
  - "&e- Name : %name%"
  - "&e- Expire at : &b%expire-time%"
  - "&e- Duration : &b%duration%"
  - "&e- Infinity : %infinity%"
  - "&e- Date created : &b%date-created%"
  - "&e- Creator : &d%player%"
renameItem :
 - "&6Rename item successfully!"
  - "&6Old name : &c%old-name%"
  - "&6New name : &a%new-name%"

vi-VN

prefix : "&7[&bTimedItemX&7]"

emptyTime : "&cHãy nhập thời hạn cụ thể"
notHoldItem : "&cBạn phải cầm vật phẩm trên tay!"
invalidTime : "&cThời hạn mới phải nhiều hơn so với thời hạn cũ!"
invalidItem : "&cVật phẩm này không có thời gian hết hạn!"
addTime : "&aĐã thêm &6%duration%&a, &athời hạn mới là &6%new-date%"
removeTime : "&aĐã trừ &6%duration%&a, thời hạn mới là &6%new-date%"
setTime : "&aThiết lập thời hạn đến &6%new-date%"
clearTime : "&aĐã xóa thời hạn của vật phẩm!"
help : "&6/%command-name%: &7%command-description%"
clearExpiredItem:
  inventory : "%prefix% &cTổng cộng &6%amount% &cvật phẩm trong túi đồ đã hết hạn!"
  offline : "%prefix% &cTổng cộng &6%amount% &cvật phẩm trong túi đồ đã hết hạn trong lúc bạn ngoại tuyến!"
expireFormat : "&7[&cThời hạn&7] &b%date-format%"
reloadPlugin : "&aĐã tải lại ngôn ngữ và thiết lập!"
addItem : "&aĐã thêm vật phẩm mới với tên &6%name%"
removeItem : "&aĐã xóa vật phẩm với tên &6%name%"
giveItem : "&aĐang trao &6%amount%x &avật phẩm với tên &6%name% &acho người chơi &6%player-name%"
setItem : "&aVật phẩm với tên &6%name% &ađã được cập nhật!"
setInfinity:
  active : "&aVật phẩm này đang trong chế độ vô hạn và sẽ không bao giờ hết hạn!"
  deactive : "&cVật phẩm này đã hết trong chế độ vô hạn và sẽ hết hạn trong &6%expire-date%"
itemInformation:
  - "&eTên : %name%"
  - "&eNgày hết hạn : &b%expire-time%"
  - "&eThời hạn : &b%duration%"
  - "&eMất khi hết hạn : %infinity%"
  - "&eNgày tạo : &b%date-created%"
  - "&eNgười tạo : &d%player%"
renameItem :
 - "&6Đổi tên thành công!"
  - "&6Tên cũ : &c%old-name%"
  - "&6Tên mới : &a%new-name%"

❏ ACCESS API

Access API from GitBook

❏ CONTACT

Please do not report to PayPal if my plugin cause error, contact my discord and i will fix it asap
Any bugs or ideas please contact my discord Tuan#1177

❏ MY OTHER PLUGINS

ItemDismantle - help player save their resources by convert items.
FishingBonus - get extra exp , items and even mythic mobs when fishing.
ColorGradient - make your nickname/chat with gradient color

⚡TimedItemX⚡

Schedule expire time for items.