Repository navigation
1.0.0
⏳ TimedItem v1.0.0 — Initial Release
Welcome to the official release of TimedItem v1.0.0! A modern, high-performance, and lag-free expiration item plugin built from the ground up for Minecraft 1.21 / 1.21.1+.
🌟 Key Highlights & Features
-
🛡️ Dual-State Item System (Inactive vs Active):
- Inactive State (
Hiệu lực: <thời gian>/Duration: <time>): When items are created with/ti addor/ti set, the timer does not start ticking down. Safe to store in Crates, Shops, Kits, or Chests. - Creative-Safe: Admins in Creative mode can move, duplicate, or inspect items without triggering the countdown.
- Smart Survival Activation (
Hết hạn vào: <ngày giờ>/Expires at: <date>): The moment an item enters a player's inventory in Survival mode, it automatically transforms into the active expiration date, plays a sound, and begins ticking down!
- Inactive State (
-
💤 Standalone Pure-Java NBT Offline Player Scanner:
- Scans
world/playerdata/*.datfiles 100% asynchronously (Zero TPS drops / No main-thread lag). - Automatically removes expired items from both Player Inventories and Ender Chests even when players are offline.
- Welcomes returning players with a summary message of expired items.
- Scans
-
⚡ 100% Asynchronous & Thread-Safe Engine:
- Background interval checks run on async threads.
- World Check: Automatically clears expired dropped items on the ground.
- Real-Time Event Catchers: Instantly validates items on click, interact, or pickup to prevent using expired items between scheduled scans.
-
🎨 Native PersistentDataContainer (PDC) & Safe Lore Engine:
- Stores timestamps directly in PDC for maximum reliability across server restarts.
- Non-destructive: will never wipe or corrupt existing lore, enchants, MMO attributes, or custom tags from other plugins.
- Supports standard color codes (
&a,&c, etc.) and Hex RGB colors (&#RRGGBB).
-
🌐 Fully Configurable & Translatable:
- 100% of messages, prefixes, and
/ti helpdescriptions are editable inlang.yml. - Flexible time formats (
1d2h,30m,1w,2mo,1y) and calendar date formats (dd/MM/yyyy HH:mm:ss,dd/MM/yyyy). - Full tab-completion support for subcommands and duration parameters.
- 100% of messages, prefixes, and
📥 Installation
- Download
TimedItem-1.0.0.jarbelow. - Place it into your server's
plugins/directory. - Start or restart your server (Requires Java 21+ and Minecraft 1.21+).
- Customize
plugins/TimedItem/config.ymlandlang.ymlto your liking!