=============================================== IDEAL VIEWMODEL - v1.0.1 Minecraft Fabric Mod for 1.21.1

🎮 DESCRIPTION

Ideal ViewModel is a powerful Minecraft Fabric mod that brings professional PvP animations to your game. Customize your hand and item positioning with smooth, cinematic hit animations. Take full control over your viewmodel with independent transform controls for each item and global adjustments.

✨ KEY FEATURES

• 7 Unique Hit Animations (Sword-Only):

• PULSE - Classic smooth S-curve swing with balanced motion
• EXHIBITION - Extremely wide horizontal sweep (120° rotation)
• SIGMA - Sharp forward thrust with minimal side movement
• OLD_1_7 - Blocky classic 1.7-1.8 PvP downswing
• RISE - Upward rising uppercut with reverse rotation
• MOON - Circular orbit motion with outward swing
• ASTOLFO - Extreme spin animation (115° Z-rotation)

• Smart Animation System:

• Animations activate ONLY when holding swords
• Vanilla behavior preserved for all other items
• Works with modded swords (via ItemTags.SWORDS)
• No performance impact when not using swords

• Advanced Transform Controls:

• Separate "Item Mesh" panel for per-item customization
• Independent "Global" panel affecting all items in that hand
• Each panel has its own Copy/Paste/Reset buttons
• 9-axis control: Position XYZ, Rotation XYZ, Scale XYZ
• Real-time preview while adjusting

• Professional GUI:

• Dual-panel layout (side-by-side or stacked)
• Item-specific and hand-wide transforms work together
• Independent clipboard for each transform type
• Freeze swing/equip animations
• Favorite items for quick access
• Searchable item list
• Undo/Redo support

• Profile System:

• Create unlimited custom profiles
• Switch between configurations instantly
• Import/Export settings
• Per-profile customization

🔧 INSTALLATION

1. Install Fabric Loader for Minecraft 1.21.1
2. Download and install Fabric API (required dependency)
3. Place idealviewmodel-1.0.1.jar into .minecraft/mods folder
4. Launch the game and enjoy!

⚙️ HOW TO USE

1. Press the configured hotkey (default: O) to open settings
2. Select an item from the list on the left
3. Adjust "Item Mesh" panel for this specific item
4. Adjust "Global" panel for all items in this hand
5. Each panel has Copy/Paste/Reset for independent control
6. For swords: select animation preset and adjust amplitude/speed
7. Changes apply in real-time!

📋 CHANGELOG v1.0.1

✨ NEW FEATURES: • Sword-only animation system - animations now exclusive to swords • Separate Copy/Paste/Reset buttons for Item Mesh panel • Separate Copy/Paste/Reset buttons for Global panel • Independent clipboard management for each transform type • New API methods: copyGlobal(), pasteGlobal(), resetGlobal()

🔧 IMPROVEMENTS: • All 7 animations refined with unique characteristics • Increased posY values across all animations • Better upward motion during attack • Smoother interpolation curves • Enhanced visual distinction between animation styles

🐛 FIXES: • Fixed hand dropping down during attack animation • Fixed animation applying to non-sword items • Improved panel button layout and spacing • Better UI responsiveness

💡 USAGE TIPS

For Beginners:

• Start with PULSE animation (amplitude: 1.0, speed: 1.0)
• Use Global panel to adjust hand position for all items at once
• Use Item Mesh panel for fine-tuning specific items
• Copy/Paste lets you transfer settings between items

For Advanced Users:

• OLD_1_7 animation perfect for classic PvP feel
• ASTOLFO/SIGMA great for content creation
• Combine Global + Item Mesh for precise control
• Each panel's clipboard is independent
• Freeze swing/equip for screenshot-perfect poses

Animation Selection Guide:

• PULSE: Balanced, smooth, great for everyday use
• EXHIBITION: Flashy wide swings, content creation
• SIGMA: Aggressive forward thrusts, competitive feel
• OLD_1_7: Nostalgia, classic 1.7-1.8 combat
• RISE: Upward slashes, unique visual style
• MOON: Circular arcs, smooth orbital motion
• ASTOLFO: Maximum spin, extremely flashy

🎯 PERFECT FOR

✓ PvP players wanting professional animations ✓ Content creators seeking cinematic footage ✓ Players missing classic 1.7 combat feel ✓ Anyone wanting deep viewmodel customization ✓ Streamers looking for unique visual style ✓ Texture pack creators needing item positioning ✓ Modpack developers adding visual polish

⚡ PERFORMANCE

• Zero performance impact when not using swords
• Optimized rendering pipeline
• No lag or frame drops
• Minimal memory footprint
• Compatible with performance mods (Sodium, Iris)

🔗 COMPATIBILITY

✅ Works With:

• Fabric API (required)
• Sodium, Iris, OptiFabric
• Most weapon/sword mods
• Resource packs
• Other viewmodel mods (may conflict)

❌ Known Issues:

• None reported yet!

🐛 BUG REPORTS & SUPPORT

Found a bug? Have a suggestion?

• Report issues with detailed descriptions
• Include Minecraft version and mod list
• Screenshots/videos help diagnose problems

📜 CREDITS

Developed for the Minecraft PvP community Built with Fabric Mod Loader Utilizes Minecraft's rendering pipeline

⚖️ LICENSE

All rights reserved. Provided for personal use. Do not redistribute without permission.

=============================================== 📦 TECHNICAL DETAILS

Minecraft Version: 1.21.1 Mod Loader: Fabric Dependencies: Fabric API (required) File Size: ~99 KB Version: 1.0.1 Release Date: August 3, 2026

===============================================

🌟 THANK YOU FOR USING IDEAL VIEWMODEL! 🌟

If you enjoy this mod, please leave a review! Your feedback helps improve future updates.

===============================================