WeaponSkin

SpigotMC

Apply cosmetic skins to weapons without replacing items! (Oraxen & Resource Pack support).

29 downloads

latest v1.0.0 SpigotMC

1.21 – 1.21

⚔ WeaponSkin ⚔

A Minecraft plugin that lets players apply and remove cosmetic skins on weapons — without replacing the item itself.

Supports Oraxen and a fully built-in resource pack system (no dependencies required).

✨ Features

Apply custom weapon skins via drag-and-drop (inventory interaction)
Remove skins with a dedicated Skin Remover item
Preview skins before applying with Shift + Right Click
Built-in resource pack builder, HTTP host server, and auto-push to players
Supports Oraxen as an alternative provider
Code (Text):

auto

provider detection — uses Oraxen if available, falls back automatically
Multi-language support — configurable language files (English, Vietnamese)
Granular permissions — individual permission nodes for each sub-command

Requirements

PacketEvents — Required (equipment packet handling)
Oraxen — Optional (only needed if provider: oraxen)
Minecraft 1.21+ — API version 1.21 (item_model requires 1.21.4+)

Installation

Download

Code (Text):

WeaponSkin.jar

and place it in your

Code (Text):

plugins/

folder
Download PacketEvents and place it in

Code (Text):

plugins/
Start the server — config files will be generated automatically
Edit

Code (Text):

plugins/WeaponSkin/config.yml

and

Code (Text):

skins.yml
Run

Code (Text):

/weaponskin pack build

(or

Code (Text):

/ws pack build

)

⚙️ Configuration

config.yml

Code (Text):

prefix: "&7[&eWeaponSkin&7] "
update-checker: true
language: en
apply-sound: ENTITY_PLAYER_LEVELUP
remove-sound: ENTITY_ITEM_BREAK
provider: auto

pack:
description: "WeaponSkin resource pack"
namespace: "weaponskin"

host:
enabled: true
required: true
type: "self-host"

self-host:
ip: "localhost"
port: 8765

external-host:
url: "https://example.com/packs"

skins.yml

Code (Text):

rivers_of_blood:
model_id: riversofblood_sword
allowed_materials:
- DIAMOND_SWORD
- NETHERITE_SWORD

Each skin requires a

Code (Text):

model_id

and a list of

Code (Text):

allowed_materials

.

Provider Modes

Code (Text):

auto

— Uses Oraxen if installed, otherwise falls back to item_model
Code (Text):

item_model

— Built-in system (resource pack generation and hosting)
Code (Text):

oraxen

— Delegates skin model lookup to Oraxen

Commands

Code (Text):

/weaponskin give <player> <skinId> [amount]
/weaponskin remove <player> [amount]
/weaponskin remover <player> [amount]
/weaponskin list
/weaponskin reload
/weaponskin pack build
/weaponskin pack apply <url>

Alias:

Code (Text):

/ws

Permissions

Code (Text):

weaponskin.admin
weaponskin.give
weaponskin.remove
weaponskin.list
weaponskin.reload
weaponskin.pack

Code (Text):

weaponskin.admin

grants all child permissions automatically.

How It Works (Player Side)

Drag skin item onto a weapon in inventory → Applies the skin
Drag Skin Remover onto a skinned weapon → Removes the skin
Shift + Right Click a skin item → Preview the skin

Resource Pack Hosting

Self-host (default)
The plugin starts an internal HTTP server on the configured port.
Make sure the port is open in your firewall.

External host

Code (Text):

/weaponskin pack apply https://your-cdn.com/WeaponSkin-pack.zip

Multi-Language Support

Available languages:

English (en)
Vietnamese (vi)

Change language in:

Code (Text):

plugins/WeaponSkin/config.yml

Then run:

Code (Text):

/weaponskin reload

️ Building from Source

Code (Text):

git clone https://github.com/k4han/WeaponSkin.git
cd WeaponSkin
./gradlew build

Output:

Code (Text):

build/libs/WeaponSkin-*.jar

License

This project is licensed under the MIT License.

☕ Support

If you find this plugin helpful and want to support development:

Versions

Release

1.0.0

Release

1.0.0

Comments 0

No comments yet. Be the first to share your thoughts.

WeaponSkin

Versions

Comments 0

Download WeaponSkin