ChronoSteal

ChronoSteal completely revolutionizes server survival mechanics by replacing traditional health with a ticking clock. Every player has a "Life Clock" that counts down every second they are online. If their time reaches zero, they are instantly banished to Spectator mode!

To survive, players must hunt each other down. When you kill another player, you steal a configurable percentage of their remaining time. Want to trade time for gear? Players can extract their own time into physical, unforgeable Chrono Gems to trade with others or hoard safely in their enderchests.

Built entirely from scratch for modern 1.21+ servers, ChronoSteal uses 100% asynchronous database processing and Folia-compatible schedulers to ensure zero TPS drops, even with 100+ concurrent players.

Key Features:

⏱️ Tick-Perfect Asynchronous Logic: No main-thread lag. All time ticking and database saving runs on asynchronous Folia/Paper schedulers.

💎 Chrono Gems: Extract time into physical items using modern, unforgeable PersistentDataContainers (PDC).

🎨 Full MiniMessage Support: Say goodbye to legacy & colors. Use RGB, gradients, and hex codes for all messages.

💾 Dual-Database Support: Out-of-the-box support for both local SQLite and cross-server MySQL using HikariCP pooling.

💻 Commands /timecheck - Check your own remaining time.

/timecheck <player> - Check another online player's time.

/timepay <player> <seconds> - Transfer your time to another player.

/timeextract <seconds> - Safely extract your time into a physical Chrono Gem.

/chrono <add|remove|set> <player> <seconds> - Admin command to artificially modify a player's remaining time.

🔑 Permissions chronosteal.command.timecheck - Allows checking time. (Default: true)

chronosteal.command.timepay - Allows transferring time. (Default: true)

chronosteal.command.timeextract - Allows creating Chrono Gems. (Default: true)

chronosteal.admin - Grants access to the /chrono admin modification tools. (Default: OP)

⚙️ Setup & Configuration Download the ChronoSteal.jar and drop it into your plugins folder.

Ensure you have the required dependencies installed (see below).

Start your server to generate the default configuration files.

Open plugins/ChronoSteal/config.yml to customize:

Default Starting Time: How much time new players get (Default is 86400 seconds / 24 hours).

Kill Steal Percentage: The fraction of a victim's time stolen upon death (Default is 1.0, meaning 100% of their time).

Database Settings: Switch between sqlite and mysql.

All Text & UI: Customize Action Bars, Chat Messages, and Item Lore using the modern <gradient> and <color> formats.

Placeholders: You can use %chronosteal_time_left% in any PlaceholderAPI-supported plugin (like TAB, Scoreboards, or Chat formatting) to display a player's formatted remaining time (e.g., "1d 4h 30m").

📦 Requirements Please note that because ChronoSteal is highly optimized, it relies on modern APIs.

Java Version: Java 21 is strictly required.

Server Software: PaperMC, Purpur, or Folia (1.21+) is required. This plugin will NOT work on standard Spigot/CraftBukkit due to the usage of modern Paper-exclusive Component and Scheduler APIs.

Hard Dependency: PlaceholderAPI - Must be installed for the plugin to enable.