OfflineSkins

🧍‍♂️ Offline Skins
🎨 Use Custom Skins — Even Without Internet!

Offline Skins is a lightweight Fabric mod that lets you use local PNG skin files as your player skin — completely offline.
No Mojang API, no authentication — just your own skins loaded straight from your game directory.

💡 Features

✅ Offline Support: Apply custom skins without an internet connection.

🖼️ Local Skin Folder: Place PNG files inside

.minecraft/config/offlineskins/

(the same directory where your mods folder is).
Each file should be named after your username or any name you select with a command.

🧩 Command Controls:

/offlineskins list — Shows all available skin files.

/offlineskins change — Instantly switch to a chosen skin.

/offlineskins default — Reset to the default model.

⚙️ Auto Loading: Automatically loads your selected skin when you start the game or join a world.

💾 Persistent Settings: Remembers your chosen skin and model in a simple config.json.

🧠 How It Works

The mod replaces the local player’s texture source to load skins from your config/offlineskins/ folder.

OfflineSkinsClient
Initializes the mod, ensures the skin folder and config exist, and registers commands.

OfflineSkinsCommands
Provides simple commands for managing your offline skins.

SkinStorage
Loads and caches PNG skins, registers them as textures, and defaults to Steve/Alex if none are set.

ConfigManager
Saves selectedSkinName and defaultModel preferences to config.json.

AbstractClientPlayerEntitySkinMixin
Overrides the local player’s texture lookup to use offline skins safely.

📁 Folder Layout
.minecraft/
├── mods/
├── config/
│ └── offlineskins/
│ ├── steve.png
│ ├── alex.png
│ ├── yourname.png
│ └── config.json

🧱 Technical Details

Client-only Fabric mod

Entry point defined in fabric.mod.json

Uses Fabric Client Command API v2

Mixin config: mixins.offline_skins.json

No dependencies — simple drop-in functionality

🧍 Example

Want your custom skin offline?
Drop your_skin_name.png into config/offlineskins/ and run:

/offlineskins change your_skin_name

Your offline skin will instantly appear in-game — no internet required! 🎮