Skip to content

A skinchanger minecraft mods can insert your skin up to 2048x!

License

Notifications You must be signed in to change notification settings

ThelabDevelopment/FelixSkins-ReFork

 
 

Repository files navigation

FelixSkin

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

📋 Requirements

  • Minecraft 1.20.1+
  • Fabric Loader 0.16.12+ Or Forge in 1.20.1-1.20.4 Or even Neoforge newer i guess 46+
  • Fabric API 0.92.6+ & Forgified Fabric API
  • 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

🛠️ Building from Source

Prerequisites

  • Java 17 or higher
  • Gradle (included in the project)

Build Commands

# Build the mod
./gradlew build

# Build without running tests
./gradlew build -x test

# Clean build
./gradlew clean build

# Generate sources JAR
./gradlew sourcesJar

Build Output

The built mod will be available in:

  • build/libs/felixskin-1.2.3.jar - Main mod JAR
  • build/libs/felixskin-1.2.3-sources.jar - Source code JAR

🏗️ Project Structure

(Undergoing Restructure)

🔧 Technical Details

Undergoing Too

⚠️ 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

About

A skinchanger minecraft mods can insert your skin up to 2048x!

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Java 91.4%
  • PowerShell 5.5%
  • Batchfile 3.1%