# BellCommand – Command Item Plugin<\/p>\n
## Version Info
\nCurrent Version: 1.4.0-beta.1<\/p>\n
This is a major Beta release with the following features:
\n– \u2705 **Config System Overhaul**: Modular multi-folder architecture with real-time hot-reloading (WatchService) and smart auto-migration.
\n– \u2705 **Consumable Item System**: Support for fixed count, probability-based, and random range consumption modes.
\n– \u2705 **Enhanced Thread Safety**: Full implementation of ReentrantReadWriteLock for configuration stability under high concurrency.
\n– \u2705 **Automated Release Pipeline**: Deep integration with GitHub Actions and Modrinth API for automatic publishing.
\n– \u2705 Complete command item system
\n– \u2705 Language support
\n– \u2705 Bedrock player support (requires Floodgate)
\n– \u2705 Action-specific cooldown system
\n– \u2705 Custom update source support (GitHub, Gitee, Custom API)<\/p>\n
## Introduction
\nBellCommand is a powerful Minecraft plugin that allows server administrators to create custom items that can execute commands. Players can trigger preset commands by left-clicking or right-clicking these items.<\/p>\n
## Features
\n– **Modular Config Management**: Support for multiple folders (e.g., `Default_config\/`) to store item configurations, decoupling item definitions from the main config.
\n– **Real-time Hot-Reloading**: Powered by `WatchService` to monitor file changes; modifications take effect instantly without manual reloading.
\n– **Consumable Item System**: Support for item consumption based on fixed counts, probabilities, or random ranges to flexibly control item lifespan.
\n– **Enhanced Thread Safety**: Implementation of `ReentrantReadWriteLock` for core configuration access, ensuring absolute stability under high concurrency.
\n– **Multi-Dimensional Interaction**: Independent command triggers for Left-Click, Right-Click, and Shift+Left\/Right-Click.
\n– **Deep Bedrock Adaptation**: Dedicated interaction logic and command configurations for Floodgate (Bedrock) players.
\n– **Granular Permission Control**: Comprehensive permission system supporting global and item-specific permissions.
\n– **Independent Cooldowns**: Different action types (e.g., Left\/Right click) can have their own independent cooldown timers.
\n– **Internationalization (i18n)**: Robust `LanguageManager` system for real-time switching of system logs and messages.
\n– **Automatic Update Alerts**: Integrated update detection for GitHub, Gitee, and custom APIs.<\/p>\n
## Commands ## Permissions ## Installation BellCommand is a powerful Minecraft plugin that allows server administrators to create custom items that can execute commands. The player can trigger preset commands by left-clicking or right-clicking on these items.<\/p>\n","protected":false},"featured_media":27323,"template":"","meta":{"_minecraft_slug":"bellcommand","_minecraft_project_id":"n18snJd9","_minecraft_author":"ning-g-mo","_minecraft_license":"MIT","_minecraft_downloads":715,"_minecraft_follows":4,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"bellcommand.zip","_minecraft_size_bytes":4207354,"_minecraft_version_count":16,"_minecraft_updated_at":"2026-05-16T09:31:23.992392Z","_minecraft_date_created":"2025-01-04T22:03:28.824658Z","_minecraft_date_modified":"2026-01-02T16:18:37.421575Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/bellcommand","_minecraft_icon_attachment_id":27323,"_minecraft_imported_at":"2026-06-01T10:25:37+00:00","_minecraft_import_hash":"8567e530fe6527cc7f5436f8cc7cd9ec","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,126,127,128,129,92],"mod_loader":[130,132,133,134],"minecraft_version":[438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-27322","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n– `\/bc give
\n– `\/bc list` – View available command items
\n– `\/bc reload` – Reload plugin configuration<\/p>\n
\n– `bellcommand.command` – Allow using basic commands
\n– `bellcommand.reload` – Allow configuration reload
\n– `bellcommand.give` – Allow giving items
\n– `bellcommand.list` – Allow viewing item list
\n– `bellcommand.use` – Allow using command items
\n– `bellcommand.item.
\n1. Download the latest BellCommand.jar
\n2. Place the file in your server’s plugins folder
\n3. Restart server or reload plugin
\n4. Edit configuration file
\n5. Use `\/bc reload` to reload configuration<\/p>\n","protected":false},"excerpt":{"rendered":"