> For the complete documentation index, see [llms.txt](https://docs.cheddah-development.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cheddah-development.net/plugin-documentaion/skin-statues/creating-statues.md).

# Creating Statues

### Create a statue

Stand at the level where the statue's feet should begin. Face the direction in which the statue should extend, then run:

```
/statue <name> <scale>
```

Example:

```
/statue Alex 2
```

SkinStatues places the statue in front of you, centers it from left to right, aligns it to the nearest cardinal direction, and turns its front toward you.

The target player does not need to be online or to have joined your server. The name must be a valid Minecraft username containing 1–16 letters, numbers, or underscores.

### Choose a scale

Scale controls the size of every skin pixel:

* Scale `1`: each skin pixel becomes a `1 × 1 × 1` block
* Scale `2`: each skin pixel becomes a `2 × 2 × 2` cube
* Scale `4`: each skin pixel becomes a `4 × 4 × 4` cube

The base player model is `32 × scale` blocks tall. When outer layers are enabled, the hat and other overlays add a thin one-block shell around their body parts.

The default maximum scale is `4`. Server owners can change it up to the built-in hard limit of `16`, but large scales consume substantially more blocks, memory, build time, and world space.

{% hint style="warning" %}
SkinStatues replaces every block occupied by the statue. Check the full area before building and restrict access to trusted players.
{% endhint %}

### During construction

Skin lookup and statue planning happen away from the main server tick. Blocks are then placed in batches from the feet upward.

A player can have only one SkinStatues build or undo operation running at a time. Different authorized players can start their own operations.

If planning fails, no statue blocks are placed. If construction is interrupted after it begins, SkinStatues attempts to roll back the partial build.

### Skin appearance

SkinStatues supports:

* Modern `64 × 64` skins
* Legacy `64 × 32` skins
* Classic and slim arms
* Transparent skin pixels
* Hats, jackets, sleeves, and pants when `outer-layer` or `outerLayer` is enabled

Visible colors are matched to the closest material in a curated 53-block palette. The result is an approximation because Minecraft skins can use millions of colors while the statue uses a limited set of blocks.

See Palette customization if you want to remove or retune materials.

### World height

Build the statue far enough below the world's maximum build height. Blocks that would be above or below the buildable range are omitted, so a statue placed too high can be cut off.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.cheddah-development.net/plugin-documentaion/skin-statues/creating-statues.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
