SkinMorph

# SkinMorph A Minecraft plugin that allows seamless skin changing, featuring a modern GUI and advanced features. # `/skin` Command Usage The `/skin` command lets players change, reset, favorite, and manage skins. All subcommands require the `skinmorph.command.skin` permission. ## Usage | Command | Description | |---|---| | `/skin` | Opens the skin selection menu. **Player only.** | | `/skin set ` | Sets your own skin to ``. **Player only.** | | `/skin set ` | Sets ``'s skin to ``. | | `/skin default` | Resets your own skin to default. **Player only.** | | `/skin default ` | Resets ``'s skin to default. | | `/skin random` | Applies a random skin to yourself. **Player only.** | | `/skin random ` | Applies a random skin to ``. | | `/skin favorites add ` | Adds `` to your favorites list. **Player only.** | | `/skin favorites remove ` | Removes `` from your favorites list. **Player only.** | | `/skin settings` | Opens the settings menu. **Player only.** | | `/skin cache clear` | Clears the entire skin cache. | | `/skin cache remove ` | Removes a specific skin from the cache. | | `/skin cache info` | Displays cache statistics (total skins cached, cache size). | | `/skin help [page]` | Displays the help menu. Defaults to page 1 if no page is given. | > **Player only** commands will respond with a "player-only" message if run from console or another non-player sender. --- ## Subcommand Details ### `/skin` Opens the skin selection GUI menu, resuming on whatever page the player last had open. ### `/skin set` - `/skin set ` — Applies `` to yourself. - `/skin set ` — Applies `` to another online player. Fails with a "player-not-found" message if `` isn't online. ### `/skin default` - `/skin default` — Resets your skin to the default. - `/skin default ` — Resets another online player's skin. Fails if `` isn't online. ### `/skin random` - `/skin random` — Applies a randomly selected skin to yourself. - `/skin random ` — Applies a random skin to another online player. Fails if `` isn't online. ### `/skin favorites` - `add ` — Adds a skin to your favorites. - `remove ` — Removes a skin from your favorites. Both actions are player-only. ### `/skin settings` Opens the plugin's settings menu for the executing player. ### `/skin cache` - `clear` — Wipes the entire skin cache. - `remove ` — Removes one skin from the cache. Responds with whether it was actually cached. - `info` — Shows the number of skins cached and total cache size. ### `/skin help [page]` Displays a paginated help menu. - If `` is omitted, page 1 is shown. - If `` isn't a valid number, an "invalid-help-page" error is shown. - If `` doesn't exist, an "invalid-help-page" error is shown. **Player view:** Clickable/hoverable entries — clicking suggests the command in chat, hovering shows the description. Includes `←` / `→` navigation buttons between pages. **Console/non-player view:** Plain text list of `command - description` pairs. **Help pages:** | Page | Contents | |---|---| | 1 | `/skin`, `/skin set `, `/skin set `, `/skin default`, `/skin default ` | | 2 | `/skin random`, `/skin random `, `/skin favorites add `, `/skin favorites remove `, `/skin settings` | | 3 | `/skin cache clear`, `/skin cache remove `, `/skin cache info` | --- ## Tab Completion | Argument position | Context | Suggestions | |---|---|---| | 1st arg | always | `set`, `default`, `help`, `favorites`, `random`, `settings`, `cache` | | 2nd arg | `set` | Online player names + your favorited skins | | 2nd arg | `random`, `default` | Online player names | | 2nd arg | `favorites` | `add`, `remove` | | 2nd arg | `help` | `1`, `2`, `3` | | 2nd arg | `cache` | `clear`, `remove`, `info` | | 3rd arg | `set ...` | Online player names | | 3rd arg | `favorites add ...` | Online player names + your current skin (if not already favorited) | | 3rd arg | `favorites remove ...` | Your favorited skins | | 3rd arg | `cache remove ...` | Your favorited skins* | \* Tab completion for `cache remove` currently suggests the player's own favorites rather than all cached skin names — worth double-checking if that's intended, since cache entries aren't necessarily tied to any one player's favorites list. All suggestions are filtered against the partial text already typed for the current argument. --- ## Argument Limits Validated by `isValidUsage()` before any subcommand logic runs: | Subcommand | Valid argument counts | |---|---| | *(none)* | 0 | | `set` | 2 or 3 | | `default` | 1 or 2 | | `random` | 1 or 2 | | `favorites` | 3 (with `add` or `remove` as 2nd arg) | | `help` | 1 or 2 | | `settings` | 1 | | `cache` | 2 (`clear`/`info`) or 3 (`remove`) | Any other combination (including unknown first arguments, or more than 3 total arguments) returns an "invalid-usage" error. ## Permission | Permission | Applies to | |---|---| | `skinmorph.command.skin` | All `/skin` subcommands | ~ Developed with 💚 by Luvoos