# **Custom Hit Command: Unleash Dynamic Actions on Impact!**
\n   <\/p>\n
## **\u2753 What is CHC?**
\n**Custom Hit Command** let’s you trigger specific commands every time you **hit another player** with a **chosen item group** and\/or **single item(s)** you marked before with `\/chc sethititem`! This **lightweight** and **highly customizable** plugin is built for Paper 1.21, ensuring **fast performance** and **seamless integration**.<\/p>\n
## **\ud83c\udf1f Key Features:**<\/p>\n
\ud83d\udd27 **Configurable Hit Item**: Define which item group, single item, or external NBT tag triggers the action (e.g., all Iron Swords, marked Blaze Rods, or even plugins like DeluxeHub items via key=value)<\/p>\n
\ud83c\udfaf **Dynamic Command Execution**: Set any server command to run upon a successful hit. You can choose whether the command is executed by the attacking player or the console. Use the **`%hitted_player%`** placeholder to automatically insert the name of the player you hit (e.g., `\/duel %hitted_player%`)<\/p>\n
\u2728 **Visual Hit Particles**: Configure particle effects to appear at the location of the hitted player, adding a visually dynamic element to your commands<\/p>\n
\ud83d\udcac **Customizable Messages**: Tailor nearly all plugin messages to match your server’s style<\/p>\n
\ud83d\udd0e **Enhanced Logging**: An optional, enhanced logging system can be enabled to provide detailed debug information for troubleshooting<\/p>\n
\ud83d\udd14 **Update Notifications**: An automatic update checker can be configured to notify you in the console or directly in-game (or both) when a new version is available. It can be easily toggled on\/off in the configuration<\/p>\n
**So what are you waiting for? Get Custom Hit Command now and bring a new layer of excitement to your server!**<\/p>\n
## \ufe0f**\ud83d\udee1\ufe0f Commands & Permissions:**
\n`\/chc reload` | `customhitcommand.reload`<\/p>\n
`\/chc sethititem` | `customhitcommand.sethititem`<\/p>\n
`customhitcommand.update` (for in-game update notifications)<\/p>\n
`customhitcommand.use` (allows the use of the hit item (default true))<\/p>\n
`customhitcommand.admin` (parent permission for all permissions)<\/p>\n
## **\ud83d\udcc6 Planned features:**
\n– config updater
\n– minimessage support
\n– multiple commands
\n– multiple hit item groups
\n– set for every item group a different command executor and command
\n– sound option to play at a successful hit
\n– folia support<\/p>\n
## **\u2753 Q&A:**
\n**Why is the compiled plugin (JAR file) larger than the source code on GitHub?**<\/p>\n
Our plugin includes dependencies like **bStats** to gather anonymous usage statistics. When the plugin is compiled into a single JAR file, the bStats library (along with all its own dependencies) is packaged directly into the final plugin file. This process, called ‘shading’, makes the plugin self-contained which naturally increases the overall file size compared to just the raw source code.<\/p>\n
## **\ud83c\udd98 Need Help?**
\nIf you encounter any problems, bugs, or have questions about the plugin, please don’t hesitate to contact me directly. I’ll be happy to take a look and provide support! Your positive experience is our priority.<\/p>\n","protected":false},"excerpt":{"rendered":"
Executes a configurable command when hitting an other player with a configurable item group or a single item!<\/p>\n","protected":false},"featured_media":38993,"template":"","meta":{"_minecraft_slug":"chc","_minecraft_project_id":"eXM4AQg2","_minecraft_author":"Nicouschulas","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":323,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"chc.zip","_minecraft_size_bytes":9796164,"_minecraft_version_count":24,"_minecraft_updated_at":"2026-05-16T11:36:24.598546Z","_minecraft_date_created":"2025-07-26T05:40:14.175170Z","_minecraft_date_modified":"2026-04-05T20:42:17.228408Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/chc","_minecraft_icon_attachment_id":38993,"_minecraft_imported_at":"2026-06-01T20:23:29+00:00","_minecraft_import_hash":"d6d4a835ef4df34d749ae2633b342b3d","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[89,126,127,128,92],"mod_loader":[132,133],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-38992","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-utility","mod_loader-paper","mod_loader-purpur","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","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n