SANDBOX — this is a test environment. No servers are actually deployed and no real payments are charged.
Source-checkedLibraries & compatibility

Player Model lib

by VSCustodian · for Vintage Story

Library for adding new player races

488KDownloads
1.20.7Latest game version
Vintage Story ModDBSource

About Player Model lib

From Vintage Story ModDB

Library for adding new player races

You can support me on Patreon:


 

Requires: JSON Patches lib, Overhaul lib

 

Library implements off thread shape tessellation to eliminate freezes related to it. This can cause issues with mods that add their own code for attaching items to player shape. Please report those issues, they can be solved.

 

About virus alerts: learn.microsoft.com

 

This is a library for adding new player models. It does not add new model on its own. Players can choose a model they want in the character-creation window. All players will see the model they choose. This mod is required both on client and server.

On its own, allows players to choose their model size.

Use Config lib to change default model parameters.

You can turn off custom classes and traits for all models globaly in config. This will turn them purely cosmetic and allow to use all classes added by other mods.

Skin presets are exported to and imported from: VintagestoryData\ModConfig\player-model-skins.

The "Export to CPM Model" button will save a copy of your current skin to VintagestoryData\ModConfig\custom-player-models\<model-name>. This is for making edits with the Custom Player Model mod.

Barber in the lore location does not work, and can lead to crashes, and as of rn there are no plans to fix it, so just dont use it.

Please report bugs via official VS discord server. Comments on moddb have high chance to be ignored.

 

Replaces character selection dialog. Adds scroll areas to skin parts and class selection tabs.

Replaces armor textures with ones that dont hide face inside helmets.

Adds two commands, that allow for specified players to be able to select specified player model even if it is disabled.

<pre class="language-markup">/player &lt;player_name&gt; enablePlayerModel &lt;domain:code&gt; /player &lt;player_name&gt; disablePlayerModel &lt;domain:code&gt;</pre>

&nbsp;

Mods that change default seraph model skin parts might be incompatible with this library (but some of them will still work).

Mods that change the default seraph model itself will most probably be incompatible.

&nbsp;

Some mods that use this library:

&nbsp;

A more complete list can be found here, maintained by Dracomancerwill

&nbsp;

Known issues:

  • Additional hairstyles from lore location dont work
  • Using .charsel in multiplayer with two people simultaneously leads to avatar changes not loading for the other player; leaving and re-joining will show the changes to both players.

&nbsp;

Thanks to Kathanon for scroll functionality for skin parts, it is integrated into the lib, no need in Scroll in Character Creation mod if you have this library installed.

&nbsp;


For modders:

&nbsp;

To add your own model to be used with this library, make a content mod that depends on this library. Make the model, skin parts, textures. Then create 'config' folder inside your domain folder, and in it create 'customplayermodels' folder. Add JSON file with configuration of your model to this folder.

Read the full description on Vintage Story ModDB →

Highlights

From source data

Game versions

Built for Vintage Story 1.20.7.

Footprint

Rated a light load on a server.

Player Model lib on Nxeon

From our catalogue
One-click install
Supported on Nxeon Vintage Story servers. We download it from Vintage Story ModDB, place it, and restart the server.
Server side
Required on the server
Server load
light
Smallest plan we suggest
Vintage Story — 1 GB (1 GB RAM). This follows our own load rating above, not a benchmark.

Run Player Model lib on a Vintage Story server

Pick a server or deploy a new one above; it is installed in one click.

What kind of mod it is

From the catalog
Listed on Vintage Story ModDB as “Mod”

Libraries & compatibility

Foundations and fixes other mods build on. Usually installed because something else needs it.

Runs on your server

From source side support

Vintage Story ModDB lists Player Model lib as required on the server. Check its Vintage Story ModDB page to see whether players need it too.

Compatibility

Game
Vintage Story
Runs on
Serverrequired on the server
Game versions
1.20.7

Verified at the source

  • ✓Vintage Story ModDBOfficial listing, checked 2026-09-24Open ↗
  • ✓AuthorVSCustodian, as published on Vintage Story ModDB
  • ✓LicenseNot published by the sourceFree

Player Model lib, answered

Generated from the mod’s own source data.

Do my players need to install Player Model lib?

Vintage Story ModDB lists Player Model lib as required on the server. Check its Vintage Story ModDB page to see whether players need it too.

Is it free?

Yes. Player Model lib is free to download from Vintage Story ModDB.

How do I add it to my Nxeon server?

Use “Add to a server” on this page, or open NxLabs from your dashboard. We install it, restart your server and switch it on.

NxLabs

Run Player Model lib on a Vintage Story server.

Deploy in about a minute from $4.00 a month, then add Player Model lib in one click.