💻 Commands

Complete list of all available commands and their usage.

🗂 Overview

The main command is /weaponskin with the alias /ws. All sub-commands require appropriate permissions.

💡 Tip

You can use /ws as a shortcut for /weaponskin in all commands.

📋 Command Reference

Command Description Permission
/weaponskin give [amount] Give a skin item to a player weaponskin.give
/weaponskin remove [amount] Give a Skin Remover item to a player weaponskin.remove
/weaponskin remover [amount] Alias for /weaponskin remove weaponskin.remove
/weaponskin list List all registered skins weaponskin.list
/weaponskin reload Reload config, skins, language, and host settings weaponskin.reload
/weaponskin pack build Build the resource pack from skin assets weaponskin.pack
/weaponskin pack apply Apply a built pack hosted on an external URL weaponskin.pack

📑 Detailed Usage

🎁 Give Command
/weaponskin give   [amount]
/ws give   [amount]

Gives a skin item to the specified player.

Argument Required Description
player Yes The name of the player to give the skin to
skinId Yes The ID of the skin (as defined in skins.yml)
amount No Number of skin items to give (default: 1)

Examples:

/ws give Steve leaf_weapon
/ws give Steve leaf_weapon 5
/weaponskin give Alex rivers_of_blood 3
🗑 Remove Command
/weaponskin remove  [amount]
/weaponskin remover  [amount]
/ws remove  [amount]

Gives a Skin Remover item to the specified player. The Skin Remover is used to remove skins from weapons.

Argument Required Description
player Yes The name of the player to give the remover to
amount No Number of remover items to give (default: 1)

Examples:

/ws remove Steve
/ws remove Steve 3
/weaponskin remover Alex 2
📄 List Command
/weaponskin list
/ws list

Displays all registered skins with their allowed materials.

Example Output:

=== Skin List ===
leaf_weapon | Materials: DIAMOND_SWORD, NETHERITE_SWORD
rivers_of_blood | Materials: DIAMOND_SWORD, NETHERITE_SWORD
🔄 Reload Command
/weaponskin reload
/ws reload

Reloads all configuration files:

  • config.yml - Main configuration
  • skins.yml - Skin definitions
  • Language files
  • Host settings
⚠ Note

If you've changed host settings (IP, port), you may need to restart the server for changes to take full effect.

📦 Pack Build Command
/weaponskin pack build
/ws pack build

Builds the resource pack from all skin assets in pack/skins/. The generated pack is saved to pack/WeaponSkin-pack.zip.

What it does:

  • Reads all items.yml files from pack/skins/*/
  • Copies models and textures to the pack
  • Generates pack.mcmeta and content files
  • If self-host is enabled, starts/restarts the HTTP server
  • Pushes the pack to all online players

Example Output:

Building resource pack...
Build successful! Pack served at: http://your-server:8765/WeaponSkin-pack.zip
Pack file: plugins/WeaponSkin/pack/WeaponSkin-pack.zip
SHA1: abc123def456...
Pushed to 5 player(s) online
🌐 Pack Apply Command
/weaponskin pack apply 
/ws pack apply

Applies a resource pack from an external URL. Use this when hosting the pack on a CDN or external server.

Argument Required Description
url Yes The full URL to the resource pack ZIP file

Example:

/ws pack apply https://cdn.myserver.com/packs/WeaponSkin-pack.zip
💡 Tip

Run /ws pack build first, then upload the generated ZIP file to your external host before using this command.

📖 In-Game Help

When running /weaponskin without arguments, a help menu is displayed:

=== WeaponSkin Commands ===
/weaponskin give   [amount] - Give skin item
/weaponskin remove  [amount] - Give remove-skin item
/weaponskin remover  [amount] - Alias for /weaponskin remove
/weaponskin list - View skin list
/weaponskin reload - Reload config
/weaponskin pack build - Build resource pack
/weaponskin pack apply  - Apply pack (external-host)
Alias: /ws can be used instead of /weaponskin

📖 Next Steps

🔒
Permissions
Learn about permission nodes and how to set them up.
🎨
Custom Skins
Create and add your own custom weapon skins.