⚔ WeaponSkin
A Minecraft plugin that lets players apply and remove cosmetic skins on weapons — without replacing the item itself.
✨ Features
Custom Weapon Skins
Apply custom cosmetic skins to weapons via simple drag-and-drop
inventory interaction.
Built-in Resource Pack
No dependencies required! Built-in resource pack builder, HTTP
host server, and auto-push to players.
Oraxen Support
Supports Oraxen as an alternative provider with automatic
detection and fallback.
Skin Preview
Preview skins before applying with Shift + Right Click. See how
it looks before committing!
Multi-Language
Configurable language files with English and Vietnamese
included out of the box.
Granular Permissions
Individual permission nodes for each sub-command for
fine-grained access control.
📋 Requirements
| Dependency | Type | Notes |
|---|---|---|
| PacketEvents | Required | For equipment packet handling |
| Oraxen | Optional | Only needed if provider: oraxen |
| Minecraft | Required | 1.21+ (API version 1.21, item_model requires 1.21.4+) |
🚀 Quick Start
Download & Install
Start Server
Start the server — config files will be generated automatically in
plugins/WeaponSkin/.
Configure
Edit
config.yml and skins.yml to customize the plugin for your
server.
Build Resource Pack
Run
/weaponskin pack build (or /ws pack build) to generate and
host the resource pack.
💡 Tip
For detailed installation instructions, see the Installation Guide.
🎮 How It Works (Player Side)
| Action | Result |
|---|---|
| Drag skin item onto a weapon in inventory | Applies the skin to the weapon |
| Drag Skin Remover onto a skinned weapon | Removes the skin from the weapon |
| Shift + Right Click a skin item | Preview the skin on your equipped weapon |
📦 Provider Modes
| Provider | Description |
|---|---|
auto |
Uses Oraxen if installed, otherwise falls back to item_model |
item_model |
Built-in system — manages resource pack generation and hosting |
oraxen |
Delegates skin model lookup entirely to Oraxen |