Skip to content

FAQ and limits

zeljkovranjes edited this page Nov 5, 2026 · 1 revision

Questions

Why can't I find the tab?

The Custom Player Model tab shows only while a selector is in the world. Spawn one. See Getting started.

Why don't others see my change?

Press Apply. On Customize, Effects and Armature, changes show only in your preview until you do.

Why doesn't my effect show?

Look at its row under Wearing.

  • Hidden on this server: the host turned something off or muted you. Point at it to see which.
  • Over this server's budget: remove or switch off other layers, or ask the host.
  • It may have a key. Then it shows only when you press the key.
  • It may only show at a moment. Check each layer's When.
  • You lowered Effects quality under What You See.

Why does my key do nothing?

Starting an effect with a key works once every 2 minutes for each player, whichever effect it is for. The Key group shows how long you have left. It can't be changed by the host, a setting or a script. Switching off and letting go are always free. In the test bar there is no wait, because nothing is sent.

Why isn't the tracer where my bullet went?

Tracers follow your aim, not the bullet's spread. Other machines don't know the spread. Each works out the shot itself, from what it sees, and nothing is sent per shot.

Can an effect react to sound or music?

No. Scripts have no audio input. A beat is worked out from time.

Can a sticker script scroll its text?

No. A sticker script can't move letters inside its picture. It colors the layers and moves the sprites showing it. To scroll text, build it from kept sprites and move those with a particle function.

Why is my model's color not changing on one part?

Mounted models take the whole-model tint only, not colors for single parts. Finishes do work on them.

Why does a model show a checker pattern?

Its package's shader was built for an older s&box, or it was published without its materials. A package without materials is refused when you pick it and leaves the grid. An older shader shows the error material in its bind pose.

Why doesn't View Model list arms from my mounted game?

Counter-Strike, Half-Life and Deadlock have no first-person arms Sandbox's weapons can move. Their view models come with the weapon built in.

Do other players download my effects?

No. Effect pictures, shapes and stickers are drawn on each machine, and shapes and stickers travel inside your look. Models and Workshop items are downloaded, and those count towards your limit on the server.

Do my changes cost other players anything?

A little, and within caps. See How it stays fast.

Where is my work kept?

What Where
Looks you applied, effects you wear, weapon designs With your look, sent to the server
Saved looks, styles, My effects, My shapes, drafts, What You See On your machine
What you shared The Workshop

Limits

These are hardcoded maximums. Most are checked on the host and on every machine, so a tampered look can't get past them. The host can lower or switch off many of them. See Server settings.

Effects

What Most
Effects worn 8
Layers in an effect 8
Layers in a look 32
Spread of a layer's shape 48 units
How far from its joint 24 units each way
Sprite size 48 (never drawn past 128, whatever a script asks)
Sprites a second, from one layer 100
A burst 100 sprites
How long a sprite or trail lasts 5 seconds
A moment showing 5 seconds
Light reach, brightness 400 units, 4
Colors in a palette 32
My effects 50
Effect name 32 characters
A moment counted 10 a second (shots 20)

Keys

What Value
Starting an effect with a key Once every 2 minutes, per player, for all their effects
Switching off, letting go Always free
Show time for "Shows it for" 10 seconds
Changeable by host, setting or script No

Shapes and stickers

See Shapes and stickers.

Weapons

See Weapons. A prop's longest side is at most 16 units, or the part it replaces if that is longer. It stays inside the weapon's bounds grown by 8 units.

Items

8 worn. Each stays under half the model's height, within a quarter of its height from its joint.

Scripts

16 KB per script, 32 KB per look, measured minified. See Scripting.

Workshop

See Workshop.

Downloads

Each player other than the host brings in 3 new sbox.game models every 5 minutes by default. The host can set this up to 50 over up to 60 minutes.

How it stays fast

  • Effects are built when a look changes, never each frame. A crowd joining has its effects built a few at a time.
  • Other players' models are posed every frame only near you: past 750 units 30 times a second, past 2,000 units 15, and out of view 10.
  • Other players' effects show in full within 750 units, half their sprites up to 2,000 and none past that. They pause out of view.
  • All of them together show at most 6,000 sprites and 16 lights, the nearest players first.
  • A drawn shape is drawn once and shared by everyone wearing it, within 16 MB (256 shapes or 64 stickers). Past that, the furthest players show a plain circle.
  • A moving weapon skin is worked out 60 times a second near you, 30 at mid distance, 10 far away and not at all out of view.
  • A hundred players with the same skin share its materials.
  • Effects fade as they near your camera, whole from 60 units away and gone by 20.

For addon makers

Show a player's model on your own body

An addon that shows a player as a body of its own while it has them (a skateboard's rider, a seated driver) gets the player's model on that body too.

  1. Tag the object holding the body's SkinnedModelRenderer player_body.
  2. Make it under a network object the player owns, as a rider spawned with NetworkSpawn( player ) is.

Every client then shows that player's pick on it from its first frame, posed from the body's own animation. A stock character is dressed in the player's own outfit. It takes the model off with the body.

Only the object's own tag counts, not one it has through a parent. In a lobby, a tagged body that isn't under a networked object is left alone. The Skateboard addon tags its rider this way.

Component options

Set on the PlayerModelSelector component of Assets/entity/player_model_selector.prefab.

Option Default What it does
Models Human Female, Classic Citizen Models always offered, after Default. Each entry is a title and a model: a path that ships with the game or an sbox.game ident
Cloud Search type:model playermodel sort:popular The sbox.game search the window fills itself from
Cloud Count 50 How many results each search looks at
Facepunch Search type:model org:facepunch human A second search, for the Facepunch group. Empty turns it off
Human Search type:model category:human sort:popular sbox.game's Human category, under Other. Empty turns it off
More Searches none More searches for player models
View Model Searches type:model first person arms, type:model hands Searches the View Model grid fills itself from

Only the rigged humanoids a search finds get a tile. Every search's next page is fetched when you reach the end of Other or Facepunch.

Clone this wiki locally