FeatherTouch

What's New in v1.0

Reddit Community Inspired

• Original Suggestion - Based on popular r/minecraftsuggestions post
• No Hostility - Neutral mobs like iron golems and wolves stay friendly
• Safe Manipulation - Move mobs without harm or aggression
• Community-Driven - Built from player feedback and requests

Core Mechanics

• Feather Touch System - Hit entities with feathers to push without damage
• Preserved Knockback Physics - Maintains visual and physics effects (0.35h, 0.15v)
• Soft Whoosh Sounds - Satisfying ENTITY_PLAYER_ATTACK_SWEEP audio feedback
• Vanilla Attack Cooldown - Natural 600ms timing that feels right

Professional Architecture

• Java 21 LTS - Modern codebase built on latest LTS version
• Event-Driven Design - HIGHEST priority for reliable damage cancellation
• Clean Implementation - Production-ready code with no unnecessary bloat
• Embedded bStats - Optional metrics (ID: 27875) without dependency conflicts

Configuration & Control

• Simple Config - Enable/disable functionality and sounds
• Hot Reload - /feathertouch reload command for instant updates
• Optional Metrics - bStats integration that can be disabled anytime
• Lightweight Setup - No dependencies, just drop and play

---

Core 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)

---

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

---

Technical Implementation

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

---