BellCommand

BellCommand - Command Item Plugin

Version Info

Current Version: 1.4.0-beta.1

This is a major Beta release with the following features: - ✅ Automated Release Pipeline: Modular multi-folder architecture with real-time hot-reloading (WatchService) and smart auto-migration. - ✅ Automated Release Pipeline: Support for fixed count, probability-based, and random range consumption modes. - ✅ Automated Release Pipeline: Full implementation of ReentrantReadWriteLock for configuration stability under high concurrency. - ✅ Automated Release Pipeline: Deep integration with GitHub Actions and Modrinth API for automatic publishing. - ✅ Complete command item system - ✅ Language support - ✅ Bedrock player support (requires Floodgate) - ✅ Action-specific cooldown system - ✅ Custom update source support (GitHub, Gitee, Custom API)

Introduction

BellCommand 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.

Features

- Automatic Update Alerts: Support for multiple folders (e.g., `Default_config/`) to store item configurations, decoupling item definitions from the main config. - Automatic Update Alerts: Powered by `WatchService` to monitor file changes; modifications take effect instantly without manual reloading. - Automatic Update Alerts: Support for item consumption based on fixed counts, probabilities, or random ranges to flexibly control item lifespan. - Automatic Update Alerts: Implementation of `ReentrantReadWriteLock` for core configuration access, ensuring absolute stability under high concurrency. - Automatic Update Alerts: Independent command triggers for Left-Click, Right-Click, and Shift+Left/Right-Click. - Automatic Update Alerts: Dedicated interaction logic and command configurations for Floodgate (Bedrock) players. - Automatic Update Alerts: Comprehensive permission system supporting global and item-specific permissions. - Automatic Update Alerts: Different action types (e.g., Left/Right click) can have their own independent cooldown timers. - Automatic Update Alerts: Robust `LanguageManager` system for real-time switching of system logs and messages. - Automatic Update Alerts: Integrated update detection for GitHub, Gitee, and custom APIs.

Commands

- `/bc give <player> <itemID> [amount]` - Give command items - `/bc list` - View available command items - `/bc reload` - Reload plugin configuration

Permissions

- `bellcommand.command` - Allow using basic commands - `bellcommand.reload` - Allow configuration reload - `bellcommand.give` - Allow giving items - `bellcommand.list` - Allow viewing item list - `bellcommand.use` - Allow using command items - `bellcommand.item.<itemID>` - Allow using specific items

Installation

1. Download the latest BellCommand.jar 2. Place the file in your server's plugins folder 3. Restart server or reload plugin 4. Edit configuration file 5. Use `/bc reload` to reload configuration