Default Player Skins

Ever wanted players to spawn with a specific skin/model automatically?
Default Player Skins is a simple and server-friendly mod that lets you assign default skins for players, both in singleplayer and multiplayer servers.

✅ Set a global default model
✅ Force a model per specific player
✅ Limit which models a player can select (whitelist)
✅ Easy configuration (only a few files needed)
✅ Custom model support
✅ Live config management (OP tools)

Features (v1.3.0)

Default Model Settings

You can configure a global default model for everyone:

defaultModel
defaultScale

Per-Player Forced Models

Force a specific model for certain players:

playerModels

Example:

ExamplePlayer → Bear_Grizzly

Per-Player Available Models (Whitelist)

Control which models each player is allowed to select from the menu:

playerAvailableModels

Example allowed models:

Bear_Grizzly
Wolf
Chicken
Pig

Skin Persistence

New option added in v1.2.0:

persistSkinChange

Behavior:

persistSkinChange: true → The selected skin persists after reconnecting
persistSkinChange: false → The player always returns to the default model from playerModels

Server-Friendly Permissions

Optional OP requirement:

requireOp: false → everyone can use the command
requireOp: true → only OPs can use the command

Commands

Skin Menu

/myskin menu - Opens the skin selection UI

Reload Config (NEW)

/myskin reload - Reloads config.json without restarting the server (OP only)

Config Management Commands (NEW - OP Only)

/myskin config - View current configuration
/myskin config set <option> <value> - Change config settings
/myskin config addmodel <player> <model> - Add an allowed skin to a player
/myskin config removemodel <player> <model> - Remove an allowed skin from a player
/myskin config setdefault <player> <model> - Set player default model
/myskin config list <player> - List all available skins for a player

Permissions

This mod supports permission nodes for better server control:

myskin.use - Use basic commands (menu)
myskin.reload - Reload config.json
myskin.config - Manage config with /myskin config ...

UI Preview

Example of the /myskin menu interface:

MySkin UI Preview

Skin Equipped Example

Configuration

A config file is generated inside the server mods config folder.

Default Config Example

{
  "enabled": true,
  "requireOp": false,
  "defaultModel": "",
  "defaultScale": 1.0,
  "persistSkinChange": true,
  "playerModels": {
    "Scarr": "Werewolf"
  },
  "playerAvailableModels": {
    "Scarr": [
      "Bear_Grizzly",
      "Werewolf",
      "Chicken",
      "Pig"
    ]
  },
  "showScaleInGui": true,
  "minScale": 0.1,
  "maxScale": 10.0,
  "modelDefaultScales": {},
  "playerScales": {
    "Scarr": 5
  },
  "scaleButtons": [0.5, 1.0, 1.5, 2.0, 3.0, 5.0]
}

Config Options

enabled: Enables/disables the mod
requireOp: If true, only OP players can open the menu
persistSkinChange: If true, skin changes persist after reconnecting
defaultModel: Default model applied to everyone (optional)
defaultScale: Default player scale (1.0 = normal)
playerModels: Force a model for specific players
playerAvailableModels: Allowed models per player in the UI

Scale Options (NEW)

showScaleInGui: If true, shows scale controls in the skin menu UI
minScale: Minimum scale players are allowed to use
maxScale: Maximum scale players are allowed to use
modelDefaultScales: Default scale per model (optional)
playerScales: Force a scale for specific players (optional)
scaleButtons: Quick scale presets shown in the UI

Adding Custom Models

To add your own models you only need:

1) Model Files

Place your custom files here:

Common/Characters/

Each model needs:

ModelName.blockymodel (model data)
ModelName.png (texture)

2) JSON Definition

Create a JSON definition file here:

Server/Models/

Example: MyModel.json

{
  "Model": "/Common/Characters/MyModel.blockymodel"
}

Made with ❤️ by Scarforges