Skip to content

1.0.0

Choose a tag to compare

@skygamer1233 skygamer1233 released this 10 Oct 16:04
· 42 commits to main since this release
9cb440a

⏳ 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 add or /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!
  • 💤 Standalone Pure-Java NBT Offline Player Scanner:

    • Scans world/playerdata/*.dat files 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.
  • ⚡ 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 help descriptions are editable in lang.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.

📥 Installation

  1. Download TimedItem-1.0.0.jar below.
  2. Place it into your server's plugins/ directory.
  3. Start or restart your server (Requires Java 21+ and Minecraft 1.21+).
  4. Customize plugins/TimedItem/config.yml and lang.yml to your liking!