Repository navigation
FAQ and limits
The Custom Player Model tab shows only while a selector is in the world. Spawn one. See Getting started.
Press Apply. On Customize, Effects and Armature, changes show only in your preview until you do.
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.
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.
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.
No. Scripts have no audio input. A beat is worked out from time.
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.
Mounted models take the whole-model tint only, not colors for single parts. Finishes do work on them.
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.
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.
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.
A little, and within caps. See How it stays fast.
| 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 |
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.
| 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) |
| 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 |
See Shapes and stickers.
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.
8 worn. Each stays under half the model's height, within a quarter of its height from its joint.
16 KB per script, 32 KB per look, measured minified. See Scripting.
See Workshop.
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.
- 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.
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.
- Tag the object holding the body's
SkinnedModelRendererplayer_body. - 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.
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.
Start
Your model
Effects and weapons
Code
Sharing and servers