FeatherTouch

---

Overview

Push mobs gently with feathers - no damage, just gentle nudges! This lightweight plugin enables players to hit any mob with a feather to push them without causing damage or triggering hostility.

Perfect for farm management, pet organization, and peaceful mob manipulation inspired by the Reddit community.

---

Features

Feature	Description
Feather Touch	Hit entities with feathers to push them without damage
Preserved Knockback	Maintains visual and physics effects of hits
Soft Whoosh Sound	Satisfying audio feedback (configurable)
Vanilla Timing	Respects Minecraft's natural 600ms attack cooldown
No Hostility	Neutral mobs won't become aggressive from feather touches
Hot Reload	Configuration changes without server restart

Why Choose FeatherTouch?

• No dependencies required
• Lightweight with minimal performance impact
• Event-driven architecture for efficiency
• Community inspired from Reddit suggestions
• Professional code built on Java 21 LTS
• Modern compatibility with Spigot, Paper, and Purpur

---

Configuration

FeatherTouch offers simple yet powerful configuration:

• Enable/disable plugin functionality
• Toggle soft whoosh sound effects
• Optional bStats metrics (Plugin ID: 27875)
• Hot-reload support for instant updates

Example config.yml:

metrics: true
settings:
  enabled: true
  sound: true

---

Commands & Permissions

Commands

• /feathertouch reload - Reload configuration (admin only)
• Alias: /ft

Permissions

• feathertouch.reload - Administrative commands (default: op)

---

How It Works

1. Get a Feather - Obtain from chickens or creative mode
2. Gentle Push - Left-click any mob with feather in main hand
3. No Damage - Mob gets pushed but takes zero damage
4. Stay Peaceful - Neutral mobs like iron golems and wolves stay friendly
5. Natural Timing - Follows vanilla attack cooldown for balanced gameplay

---

Technical Details

• Damage Prevention - Completely cancels damage events for feather hits
• Knockback Physics - Gentle knockback (0.35 horizontal, 0.15 vertical)
• Sound System - Custom whoosh sounds with configurable toggle
• Cooldown System - 600ms cooldown matching vanilla timing
• Event Priority - HIGHEST priority for reliable damage cancellation
• bStats Integration - Optional anonymous usage statistics

---

Use Cases

• 🐄 Farm Management - Move livestock without hurting them
• 🐕 Pet Organization - Reposition dogs and cats peacefully
• 🤖 Iron Golem Control - Move golems without triggering hostility
• 🎨 Creative Building - Position mobs for displays and scenes
• 🌾 Villager Management - Guide villagers to trading halls

---

Inspiration

Original Reddit Suggestion: r/minecraftsuggestions

"Suggestion to make so that if you punch a mob while holding a feather, it takes no damage and doesn't get hostile towards you (for iron golems, dogs etc.), that way you can push mobs wherever you like."

This plugin brings that brilliant community idea to life with a clean, lightweight implementation.

---

---