CoreTuff v1.0 — Official Release

After multiple Nightly builds, Insider testing, and the Release Candidate phase, CoreTuff 1.0 is now officially released.

CoreTuff is a comprehensive utility plugin for Paper and Folia servers, designed to provide server management, moderation, economy, teleportation, and utility features in a single plugin.

Included Systems

Teleportation

• /tpa, /tphere, /tpaccept, /tpdeny
• /tpignore, /tpunignore
• /back
• /rtp

Features include configurable cooldowns, movement cancellation, countdown titles, sound effects, and Folia-compatible teleport handling.

Economy

• /balance
• /pay
• /eco

Features:

• H2-backed persistent balances
• Transfer taxes
• Interest accumulation
• Transaction logging
• Balance leaderboard
• Vault integration
• Configurable currency formatting and limits

Vault registration automatically supports Vault-based plugins such as EconomyShopGUI and AuctionHouse.

Lands

Homes and Warps with:

• Persistent H2 storage
• Configurable delays
• Permission-based limits
• Economy integration for warps

Moderation

Includes:

• Ban
• Tempban
• IP Ban
• Kick
• Warn
• Pardon
• Punishment ID management

Additional features:

• Automatic warning decay
• Automatic punishment thresholds
• Online and offline mode support
• Vanilla ban synchronization
• Bedrock player detection
• Configurable moderation actions and sounds

Jail System

• Persistent jail locations
• Time-based jail tracking
• Configurable release behaviour

Kits

• YAML-defined kits
• Cooldowns
• Player targeting support

Utility Commands

• Gamemode shortcuts
• Fly
• Heal
• Feed
• Hat

Virtual Workbenches

• Crafting Table
• Anvil
• Stonecutter
• Smithing Table
• Loom
• Cartography Table
• Enchanting Table
• Grindstone

Security

• Plugin hiding system
• Command hiding via ProtocolLib
• Permission-aware command visibility
• Optional plugin visibility controls

Addon Platform

• Automatic addon discovery
• Lifecycle management
• Addon context access
• Plugin-style extension support

PlaceholderAPI

Built-in PlaceholderAPI integration including economy placeholders and additional CoreTuff expansion data.

Platform Support

• Paper 1.21.5
• Folia
• Java 25
• H2 Database
• Vault
• PlaceholderAPI
• ProtocolLib
• PacketEvents

Optional dependencies are automatically detected and integrated when available.

Stability & Reliability

CoreTuff 1.0 includes:

• Thread-safety fixes for economy interest processing
• Folia scheduler compatibility fixes
• OfflinePlayer handling improvements
• Database resource leak fixes
• Update notification improvements
• Vault integration stabilization
• Startup initialization ordering improvements

Notes

• CoreTuff 1.0 is the first stable release.
• Existing RC1 databases and configurations remain compatible.

Thank you to everyone who tested Nightly, Insider, and Release Candidate builds and helped shape the first stable release of CoreTuff.

You can report bugs in our Issue tracker: https://github.com/Voxelware-studios/CoreTuff/issues For support join our discord server: https://discord.gg/tuArC9pTbv Download: https://modrinth.com/plugin/coretuff

Welcome to CoreTuff 1.0.

CoreTuff v1.0-RC1 — Release Candidate Notes

CoreTuff has officially entered the Release Candidate phase.

No new features have been added in this build. RC1 focuses entirely on stability, correctness, and reliability as we prepare for the 1.0 release.

Unless critical issues are discovered, this build is expected to become the foundation of CoreTuff 1.0.

Planned Release Date: 16 June 2026

If no critical bugs are reported during the RC testing period, CoreTuff 1.0 is expected to be released on 16 June 2026.

Fixed

Interest Scheduler Thread Safety

Fixed: Interest payouts were executed asynchronously on non-Folia servers.

applyInterest() interacts with Bukkit APIs such as online player iteration and player messaging, which must run on the main server thread. The scheduler has been moved to a synchronous task to ensure thread safety and prevent potential concurrency issues.

Folia Countdown Titles

Fixed: Countdown title tasks would never execute on Folia.

The scheduler was using an incorrect overload, causing countdown tasks to be silently ignored. The countdown system now properly executes and reschedules itself on Folia servers.

Economy OfflinePlayer Handling

Fixed: Unsafe OfflinePlayer → Player casting in the economy service.

Replaced direct casting with a null-safe player lookup to prevent potential ClassCastExceptions when handling offline players.

Database Resource Leaks

Fixed: JDBC resources were not being properly released in several repository implementations.

Applied try-with-resources across the database layer, ensuring all PreparedStatement and ResultSet instances are correctly closed after use.

Affected repositories:

• EconomyRepository
• HomeRepository
• WarpRepository
• TransactionRepository

This improves long-term database stability and prevents cursor/resource leaks during extended server uptime.

Notes

• CoreTuff has officially entered the Release Candidate phase.
• Feature development is now frozen.
• Focus is now on bug fixes, stability improvements, and release readiness.
• If something breaks, please report it. If nothing breaks, we're getting suspicious.
• The EULA file may have disappeared, but by downloading CoreTuff you are still agreeing to its terms. The sign has been broken, but the chunk remains claimed.

You can report bugs in our Issue tracker: https://github.com/Voxelware-studios/CoreTuff/issues For support join our discord server: https://discord.gg/tuArC9pTbv Download: https://modrinth.com/plugin/coretuff

CoreTuff v1.0 Insider-2 - Previrew Build Changelog

In the spirit of the Insider phase, we removed one more file than strictly necessary. The EULA is no longer included in the plugin files, but downloading CoreTuff still means you agree to its terms. The sign has been broken, but the chunk remains claimed.

Changed

• Removed eula.txt, Now plugin will start like regular plugins on first drop

Notes

• Do you expect notes for this tiny change?

You can report bugs in our Issue tracker: https://github.com/Voxelware-studios/CoreTuff/issues For support join our discord server: https://discord.gg/tuArC9pTbv Download: https://modrinth.com/plugin/coretuff

CoreTuff v1.0 Insider-1 - Previrew Build Changelog

CoreTuff has officially escaped the Nightly phase and entered the Insider phase.

This means we've stopped throwing random features into the codebase at 3 AM and pretending it's a development strategy.

During the Insider phase, no new features will be added. Instead, we'll spend our time hunting bugs, fixing bugs, and discovering entirely new bugs created while fixing the previous bugs.

Welcome to stabilization. Pray for the testers.

Overview:

• first public preview insider build of CoreTuff.
• bStats Integration.
• bug fixes

bStats

• We integrated bStats to CoreTuff. Now on public can see plugin usage stats.

Changes

• Added coretuff.economy.lbignore, Which allows players to opt out of the balance leaderboard

Bug Fixes

• CT-01 - Economy plugins unable to hook with CoreTuff via Vault

Notes

• CoreTuff has officially entered the Insider phase.
• We have stopped adding shiny new features and started fixing the consequences of adding shiny new features.
• Expect stability improvements, bug fixes, performance optimizations, and the occasional bug that somehow survived six Nightly builds.
• If something breaks, please report it. If nothing breaks, we're just as surprised as you are.
• Back up your database anyway. We trust our code, but not that much.

CoreTuff v1.0 Nightly-6 - Development Build Changelog

Overview:

• Sixth public development build of CoreTuff.
• Complete package rebrand from net.voxfonix.coreTuff to org.voxelware.coretuff.
• Added full economy system with Vault integration, transaction history, and interest scheduler.
• Added Lands system with persistent homes and warps backed by H2 database.
• Added economy integration for warps (per-warp cost with bypass permission).
• Added Jail system for moderating players with configurable teleport delay and sounds.
• Added Kits system with YAML-based item definitions and per-player cooldowns.
• Added PlaceholderAPI expansion exposing economy, warps, and moderation data.
• Added custom plugin dependency resolver for bootstrapping H2, Configurate, and Lombok.
• Added Modrinth-based update checker.
• Added formatRaw() message method for prefix-free display messages.
• Added new config files: ecoconfig.yml, kitsconfig.yml, landconfig.yml.
• Expanded H2 database with 6 new tables for homes, warps, economy, transactions, jails, and jailed players.
• Improved security with plugin-hide defaulting to false and refined permission checks.
• Improved VersionedConfigLoader rename pattern to timestamped old<base>_<date>.yml.

---

Additions:

Economy System:

• Full virtual economy with H2 persistence:
  • /balance [player] -- Check your or another player's balance. Permission: coretuff.economy.balance (default: true), coretuff.economy.balance.others
  • /pay <player> <amount> -- Transfer funds to another player. Permission: coretuff.economy.pay (default: true)
  • /eco <give|take|set|reset> <player> <amount> -- Admin economy management. Permission: coretuff.economy.admin
• Economy configuration (ecoconfig.yml):
  • Currency name, name-plural, symbol, decimal places
  • Starting balance, max balance
  • Pay tax percentage with bypass permission
  • Interest system (rate %, interval hours, max balance, bypass permission)
  • Configurable sounds for pay-sent, pay-received, balance-check, eco actions, insufficient-funds
• Vault integration:
  • VaultHook.java registers a Vault economy provider on startup if Vault is detected
  • Allows other plugins (e.g. ShopGUI+, Essentials) to use CoreTuff's economy
• Transaction history:
  • TransactionRepository.java with H2 economy_transactions table
  • Tracks sender, target, amount, type, reason, timestamp
  • TransactionType enum (PAY, ADMIN_GIVE, ADMIN_TAKE, ADMIN_SET, ADMIN_RESET, INTEREST)
• Economy service (EconomyService.java):
  • Thread-safe balance operations with BigDecimal precision
  • Interest scheduler: runs at configurable interval via Folia/Paper scheduler
  • EconomyRepository.java for H2 CRUD operations

Lands System:

• Homes (H2 database-backed):
  • /home <name> -- Teleport to a home. Permission: coretuff.land.home
  • /sethome <name> -- Set a home at your location. Permission: coretuff.land.sethome
  • /delhome <name> -- Delete a home. Permission: coretuff.land.delhome
  • Configurable teleport delay, default home name, max homes per permission
  • Configurable sounds (set, teleport, delete, list)
• Warps (H2 database-backed):
  • /warp <name> [player] -- Teleport to a warp. Permission: coretuff.land.warps.warp, warp-others: coretuff.land.warps.warp.others
  • /setwarp <name> [description] -- Create or update a warp. Permission: coretuff.land.warps.setwarp
  • /delwarp <name> -- Delete a warp. Permission: coretuff.land.warps.delwarp
  • /warps [page] -- List all warps. Permission: coretuff.land.warps.list
• Economy integration: per-warp cost with coretuff.land.warps.bypass-cost bypass permission
  • Max warps per permission base, configurable descriptions, creation timestamps
  • Configurable sounds (set, teleport, delete, list, no-permission, insufficient-funds)
• Lands configuration (landconfig.yml):
  • Separate sections for homes and warps with their own messages, sounds, and limits
  • Versioned config with auto-migration

Jail System:

• Full moderation jail feature with H2 database:
  • /setjail <name> -- Create a jail at your location. Permission: coretuff.moderation.jail.setjail
  • /deljail <name> -- Delete a jail. Permission: coretuff.moderation.jail.deljail
  • /jail <name> [player] [reason] -- Jail a player. Permission: coretuff.moderation.jail.jail, others: coretuff.moderation.jail.jail.others
  • /jails -- List all configured jails. Permission: coretuff.moderation.jail.list
• H2 tables: jails (locations) and jailed_players (tracking)
• Configurable teleport delay (seconds), release-on-logout toggle
• Configurable messages and sounds in modconfig.yml under moderation.jail.*

Kits System:

• YAML-defined kits with cooldowns:
  • /kit <name> [player] -- Redeem a kit. Permission: coretuff.utility.kit.<name>, others: coretuff.utility.kit.others
  • /kits -- List available kits with availability status. Permission: coretuff.utility.kit.list (default: true)
• kitsconfig.yml with config-version, default cooldown, kit teleport delay
• Sample kit "starter" with diamond sword, cooked beef, iron tools
• Per-player cooldown tracking (in-memory Map, resets on restart)
• Items defined as YAML list of material + amount entries
• Items dropped at feet if inventory is full

PlaceholderAPI Expansion:

• CoreTuffExpansion.java auto-registers on startup if PlaceholderAPI is present
• %coretuff_economy_balance% / %coretuff_economy_balance_raw% -- Current player's balance
• %coretuff_economy_balance_<player>% -- Specific player's balance
• %coretuff_economy_balance_raw_<player>% -- Specific player's raw balance
• %coretuff_economy_currency_symbol% / %coretuff_economy_currency_name% / %coretuff_currency_name_plural%
• %coretuff_economy_has_funds_<amount>% -- Returns yes/no if player can afford the amount
• %coretuff_warps_count% / %coretuff_warps_list% -- Warp statistics
• %coretuff_warps_list_with_desc% -- Warp list with descriptions
• %coretuff_moderation_warnings% / %coretuff_moderation_warnings_<player>% -- Warning points
• %coretuff_moderation_is_banned% / %coretuff_moderation_is_banned_<player>% -- Ban status
• %coretuff_moderation_punishments% / %coretuff_moderation_punishments_<player>% -- Punishment count

Custom Plugin Dependency Resolver:

• dependencyresolver.java -- Paper plugin loader that bootstraps Maven-like dependencies
• Automatically downloads and loads com.h2database:h2:2.4.240, org.spongepowered:configurate-yaml:4.1.2, org.projectlombok:lombok:1.18.46 from Maven Central

Update Checker:

• UpdateChecker.java -- Checks Modrinth API on startup
• Compares latest version against current plugin version
• Logs update notification to console if newer version is available

Database Expansion:

• New H2 tables created in DatabaseManager.java:
  • homes -- player_uuid, home_name, world, x, y, z, yaw, pitch (composite PK)
  • warps -- name (PK), world, x, y, z, yaw, pitch, owner_uuid, description, created_at
  • economy -- player_uuid (PK), balance
  • economy_transactions -- id (IDENTITY), sender_uuid, target_uuid, amount, transaction_type, reason, created_at
  • jails -- name (PK), world, x, y, z, yaw, pitch
  • jailed_players -- player_uuid (PK), jail_name, jailed_by, reason, jailed_at, release_at

Changes:

Security:

• plugin-hide default changed from true to false in securityconfig.yml
• All PluginHideListener event handlers now guard with if (!config.pluginHideEnabled()) return; -- hiding only activates when explicitly enabled
• isVisibleTo() returns true for commands with null/blank permission (fixes tab-completion for vanilla commands)
• Removed custom coretuff.command.<name> fallback from ProtocolCommandHider
• SecurityConfig now provides typed API: pluginHideEnabled(), setPluginHide(), hiddenCommandMessage()
• PlayerCommandSendEvent handler simplified with removeIf pattern
• Brigadier children field resolved once in static block for performance

Config Version Migration:

• VersionedConfigLoader.renameCurrentAsOld() now creates old<base>_yyyyMMdd-HHmmss.yml instead of old<filename>
• Pre-existing old file is deleted before rename to avoid conflicts

Permission Tree Expansion:

• New top-level permission groups: coretuff.land, coretuff.economy, coretuff.moderation.jail, coretuff.utility.kit
• New player-facing Permissions: coretuff.land.home , coretuff.land.sethome , coretuff.land.delhome , coretuff.economy.balance (true), coretuff.economy.pay, coretuff.utility.kit.list
• coretuff.land.warps children: warp, setwarp, delwarp, list, warp.others, bypass-cost
• coretuff.economy children: balance, balance.others, pay, admin, bypass-tax, bypass-interest

Config File Additions:

• ecoconfig.yml -- Economy configuration (version 1.0)
• kitsconfig.yml -- Kit definitions (version 1.0)
• landconfig.yml -- Homes and warps configuration (version 1.0)
• modconfig.yml -- Bumped to version 1.1 with jail section

---

Bugs:

• Tab completion incorrectly hid commands that had no permission requirement (Fixed -- isVisibleTo() now returns true for null/blank permission)

---

Notes:

• This is a nightly development build, It might be unstable.
• Existing Nightly-5 config files are compatible but modconfig.yml will be auto-migrated to v1.1 on first run (old file preserved as oldmodconfig_<date>.yml).
• Plugin hide security feature is now opt-in (defaults to false). Enable with /ct pluginHide true.
• Economy data is stored in H2 database -- backup Core/database.mv.db regularly.
• Kit cooldowns are currently in-memory only and reset on server restart (persistence planned).
• We highly recommend you to review all new config files, especially ecoconfig.yml, landconfig.yml, and kitsconfig.yml.

CoreTuff v1.0 Nightly-5 - Development Build Changelog

Overview:

• Fifth public development build of CoreTuff.
• Added workbench UI menu commands.
• Added a full security layer for command hiding and plugin concealment.
• Added addon loading support.
• Added configurable sounds for utility, teleportation, and moderation flows.
• Added version number for config files.
• Split the old single core config into multiple config files.
• Changes in rtp.

Additions:

• Workbenches UI menu command:

  • /crafting permission: coretuff.utility.craftingtable
  • /anvil permission: coretuff.utility.anvil
  • /stonecutter permission: coretuff.utility.stonecutter
  • /smithing permission: coretuff.utility.smithingtable
  • /loom permission: coretuff.utility.loom
  • /cartography permission: coretuff.utility.cartographytable
  • /enchanting permission: coretuff.utility.enchantingtable
  • /grindstone permission: coretuff.utility.grindstone

• Utility (Misc)

  • /hat premission: coretuff.utility.hat

• Plugin hide security (Beta):

  • By enabling this feature you can disable usage of /pl, /plugin and /? by players by toggling this feature and also tab completion.
  • You can toggle this feature on by running /ct pluginHide true and /ct pluginHide false to toggle off (user needs coretuff.plhide to use this command) or can change value in securityconfig.yml
  • You must need ProtocolLib to disable tab completion fully.
  • Players with coretuff.pl can use /pl, /plugin and /? command.

• Addon Support:

  • Added addons framework into core plugin. By default Addons folder will generate in CoreTuff folder.

• UX:

  • Added sounds for certain feature which can be configured in their respective config folders.
  • Added /ct bug command and only op can access it.

• Configuration files:

  • spited config.yml into following:
    • teleportconfig.yml
    • securityconfig.yml
    • utilityconfig.yml
    • modconfig.yml
  • Each config comes with its own version number. It helps us to update config files easily if there is any addition or deletion. It works by checking the version number from config file against the number in code, If when change detected renames the file in folder as old and adds new config.

Changes:

• RTP:
  • Now RTP check for generated chunks and during teleport countdown plugin tries to load that and nearby chunk in ram to avoid sudden spike in load. This feature can be toggled in teleportconfig.yml and by default this feature is on rtpGeneratedChunksOnly: true

Bugs:

• Players were able to use teleport command without permission (Fixed)

Notes:

• This is a nightly development build, It might be unstable.
• It's highly recommend to delete already existing config files.
• Plugin hide security feature is in beta which means it has a lot of bugs.
• We highly recommend you to go through new config files.

You can report bugs in our Issue tracker: https://github.com/Voxelware-studios/CoreTuff/issues For support join our discord server: https://discord.gg/tuArC9pTbv

CoreTuff v1.0 Nightly-4 - Development Build Changelog

Overview

• Fourth public development build of CoreTuff
• Critical Bug fix and minor changes,

Changes

• Added /coretuff reload (/ct reload) to reload configs.
• Users cannot self warn / tempban / ban / kick / ban-ip and cannot punish server ops.
• CoreTuff now overrides plugin with similar commands.
• Ops can bypass cooldowns

• Moderation Durations:
  • s for seconds
  • m for minuets
  • h for hours
  • d for days
  • w for week
  • mo for month

Example /tempban player 1d for x raying

• added /pardon to unban player with their name

Bug fix:

• When player use rtp in neather they get teleport to nether roof.
• Permission keys are not shown in permission plugins.

Notes:

• This is a nightly development build, It might be unstable.

You can report bugs in our discord:https://discord.gg/tuArC9pTbv

CoreTuff v1.0 Nightly-3 - Development Build Changelog

Overview

• Third public development build of CoreTuff
• Major moderation and punishment system overhaul
• Improved Bedrock/Geyser compatibility
• Added highly customizable moderation configuration system

Major Features

• Added complete moderation framework:

  • /ban
  • /tempban
  • /ban-ip
  • /kick
  • /warn

• Added warning severity and escalation system:

  • low
  • medium
  • high

• Added punishment history, status and ID system

• Added punishment retention after pardons

• Added automatic tempban expiration handling

• Added collision-safe punishment ID generator

• Added /pid punishment management command:

  • /pid
  • /pid view <id>
  • /pid pardon <id> <reason>

• Added synchronization between:

  • banned-players.json
  • banned-ips.json
  • CoreTuff moderation database

• Added automatic import/export of vanilla bans

• Added Bedrock/Geyser-compatible punishment formatter

• Added contextual command suggestions for moderation commands

• Added command overriding support for:

  • /ban
  • /kick
  • /ban-ip

• Added world-specific RTP support:

  • /rtp world <world>

• Added world-based RTP permissions:

  • coretuff.teleportation.rtp.<world_name>

Moderation Permissions

• coretuff.moderation.ban
• coretuff.moderation.tempban
• coretuff.moderation.banip
• coretuff.moderation.kick
• coretuff.moderation.warn
• coretuff.moderation.pid

Configuration Changes

• Added new directory:

  • plugins/CoreTuff/Core/

• Added moderation configuration:

  • plugins/CoreTuff/Core/modconfig.yml

Customizable Features

• Moderation messages
• Permission-denied messages
• Player-not-found messages
• Usage messages
• Punishment success messages
• Kick messages
• Warning messages
• PID command messages
• Punishment view formatting
• Warning severity points
• Warning decay system
• Automatic punishment thresholds
• Automatic tempban durations
• Punishment retention duration
• Ban screen formatting
• Bedrock/Geyser punishment screen formatting
• Appeal messages
• Status messages

Warning System

• Added configurable warning points:

  • low = 1
  • medium = 2
  • high = 3

• Added configurable warning decay system

• Added configurable automatic punishments

• Added warning history persistence

• Added warning escalation handling

Punishment Features

• Added punishment states:

  • ACTIVE
  • PARDONED

• Added pardon metadata:

  • Reason
  • Pardoned by

• Added automatic "Duration End" handling for expired tempbans

• Added moderator/source preservation for imported bans

• Added punishment persistence system

• Added punishment viewing through /pid view <id>

Internal Improvements

• Added H2-based punishment database architecture
• Added punishment schema migration support
• Improved moderation synchronization systems
• Improved punishment formatting and history handling
• Improved online/offline moderation handling

Known Issues

• Bedrock disconnect UI still has rendering limitations due to Geyser/Minecraft Bedrock client restrictions
• Some moderation edge-cases may still require further testing

Notes

• Existing vanilla bans are automatically imported into CoreTuff database.

• Punishments remain stored after pardons depending on retention configuration.

• New moderation files are now stored inside:

  • plugins/CoreTuff/Core/

• DO NOT DELETE database files if you want to preserve punishment history.

• This is a nightly development build, It might be unstable.

• You can report bugs in our discord: https://discord.gg/tuArC9pTbv