IndySkin – Advanced Item Model Swapping System
IndySkin is a highly customizable Minecraft plugin that allows server admins to enable players to apply and remove item models (CustomModelData) through drag-and-drop, without requiring commands or permissions.
It’s designed for RPG servers, cosmetic systems, and any gameplay where item visuals matter.
Supports Minecraft 1.18 – 1.21.5 Compatible with Spigot and Paper
Core Features
- Enable model swapping on specific items
- Use "skin items" to apply models to compatible items
- Use "remover items" to remove models and extract skin items
- Prevent model swapping or removal unless conditions are met
- Define model names, lores, and display behavior in config.yml
- Built-in language system language.yml
- GUI confirmation system (in development)
Admin Commands (All OP-only)
| Command | Description |
|---|---|
| /insk reload | Reloads the plugin configuration |
| /insk help | Lists all available commands |
| /insk on | Marks the item in hand as swappable (model can be added/removed) |
| /insk off | Disables model swapping for the item in hand |
| /insk set | Sets the CustomModelData of the held item |
| /insk remove | Removes the CustomModelData from the held item |
| /insk get | Gives the player a remover item |
| /insk give <player> <amount> | Gives remover items to a specific player |
| /insk default | Sets the held item’s model as the default. Cannot be removed afterward. |
Item Behavior
Skin Items
- Used to apply models to compatible items (same material).
- Can only be applied if the target item has been marked as on
- Will consume itself when successfully applied.
Remover Items
- Used to remove models from eligible items (those marked as on
- Will not work on default-model items.
- If removal is allowed:
- Creates a new skin item with the removed model.
- Resets the original item to its default model.
Example Configuration config.yml
yaml
CopyEdit
remover:
name: "&2SKIN &cRemover"
lore: "&eCan remove skins from eligible items"
material: "PAPER"
custommodeldata: 0
skin:
name: "&aSKIN"
lore: "&eApply to compatible items to change their model"
Rules and Logic Summary
- Items must be marked on to support applying or removing models.
- default models are protected and cannot be removed.
- Skin items:
- Can only be applied to matching materials
- Cannot be applied to items is not enable Swap mode "command: /ik on"
Remover items: - Only remove models if the item is marked on and is not already at its default model " /ik default "
- Create a new skin item with the extracted model
Player Workflow
To Apply a Skin:
- Admin runs /insk on on the mode swap item (this item can replace and extract)
- Player drags a compatible skin item onto the item
- If allowed, the model is applied and the skin item is consumed
To Remove a Skin:
- Admin sets the item’s default model with /insk default
- Player drags a remover item onto the target item
- If allowed, a skin item is created with the extracted model and the original item is reset to default
Compatibility
- Minecraft 1.20 to 1.20.6
- Spigot & Paper
Translatable messages via language.yml- GUI confirmation system (coming soon)
Perfect for:
- RPG servers
- Cosmetic collections
- Custom model shops
- Any server that values visual item customization
