⚡TimedItemX⚡ 0.8-b8
Schedule expire time for items.
❏ 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:
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.
- /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.
- /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)
- /ti help <page>: Show paged help.
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 setitem <name>: Set new item for timed item in collection (must hold item in hand) ex:
/ti set 12/07/2025 (without specific o'clock)
/ti set 27/05/2023 13:17:29 (full format)
/ti set 27/05/2023 13:17:29 (full format)
- /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
- 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
