promotional bannermobile promotional banner
premium banner

FelixSkins

A client-only Fabric mod for Minecraft 1.20.1 that allows players to drag and drop PNG skin files directly into the game and apply them immediately without restarting.

Description

FelixSkin v1.2.3 - Minecraft Fabric Mod

A client-only Fabric mod for Minecraft 1.20.1 that allows players to drag and drop PNG skin files directly into the game and apply them immediately without restarting.

✨ Features

  • 🎯 Drag & Drop Interface: Open GUI with K key, drag PNG files from your OS into the drop zone
  • ⚡ Immediate Application: Skins are applied instantly to your player model
  • 🎨 HD Support: Supports skins of any resolution (128x128, 256x256, 512x512, etc.)
  • 🤖 Auto-Detection: Automatically detects slim (Alex) vs classic (Steve) models based on filename
    • Files containing _slim or _alex → Alex model
    • All other files → Steve model
  • 🌐 Client-Only: No server-side changes required
  • 💾 Memory Efficient: Proper cleanup of old textures to prevent memory leaks

📋 Requirements

  • Minecraft 1.20.1
  • Fabric Loader 0.16.12+
  • Fabric API 0.92.6+
  • Java 17+

🚀 Installation

For Players

  1. Download the latest .jar file from releases
  2. Place it in your %minecraft%/mods folder
  3. Launch Minecraft with Fabric Loader
  4. Press K in-game to open the skin manager

For Developers

  1. Clone this repository
  2. Run ./gradlew build (or gradlew.bat build on Windows)
  3. Find the built JAR in build/libs/

🎮 Usage

  1. Open the GUI: Press K in-game
  2. Drag & Drop: Drag a PNG file from your file explorer into the drop zone
  3. Alternative: Click "Pick File" to browse for PNG files
  4. Apply: Click "Apply Skin" to apply the skin
  5. Clear: Use "Clear Skin" to remove the custom skin
  6. Close: Click "Close" or press ESC

GLFW Integration

  • Uses GLFW drop callback to receive file drops from the OS
  • Safely handles file path encoding and validation
  • Only accepts PNG files with reasonable size limits

⚠️ Troubleshooting

Common Issues

  1. Mod not loading: Ensure you have the correct Fabric Loader version
  2. K key not working: Check if the key binding conflicts with other mods
  3. Skin not applying: Verify the PNG file is valid and not corrupted
  4. Performance issues: Large HD skins (>2048x2048) may impact performance

Logs

Check the Minecraft logs for any error messages. The mod logs important events with the prefix [FelixSkin].

📞 Support

🤝 Contributing

Contributions are welcome! Please feel free to submit issues, feature requests, or pull requests.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

Made with ❤️ by Frame121