> ## Documentation Index
> Fetch the complete documentation index at: https://ugcore.urging.ch/llms.txt
> Use this file to discover all available pages before exploring further.

# ug-multicharacter

> Cinematic character selection, creation and spawning for UgCore.

`ug-multicharacter` is where players meet their characters. They arrive to an intro over your scene, see their characters standing in a lineup, create new ones, and choose where to spawn with a camera that flies over the city.

It is built on `ug-core` (characters, spawning rules, security) and `ug-lib` (utilities and the shared theme). There is no separate spawn resource: spawning lives here.

## The flow

**1. Intro**

The screen starts black. The camera fades in high over your scene and descends onto the lineup while your server name appears. Enter or Escape skips it.

**2. Selection**

Every character stands in its own slot with its own animation. Hovering a card glides the camera to that character. Empty slots show a faint figure.

**3. Creation**

An empty slot opens the creation form built from your config. Choosing a body changes the figure in the scene at once.

**4. Spawn**

"Where to?" lists the last location and your spawn points. Hovering one flies the camera over it. Choosing dives to the ground and hands over to the game camera.

## Principles

* **The server decides.** Which characters exist, what a new character may be called, where a character goes and whether the player got there are decided on the server. The page only shows and asks. See [Security](https://ugcore.urging.ch/ug-multicharacter/security.md).
* **Nothing snaps.** Every camera move is an eased shot, every cut hides behind a fade. See [Cinematic](https://ugcore.urging.ch/ug-multicharacter/cinematic.md).
* **One config file.** `config.lua` is generated on the first start, never overwritten by updates, and checked with clear errors. See [Configuration](https://ugcore.urging.ch/ug-multicharacter/configuration.md).
* **Swappable appearance.** Creation offers a body choice today. A future `ug-appearance` resource plugs in through a small contract. See [Appearance contract](https://ugcore.urging.ch/ug-multicharacter/appearance.md).

## Next steps

> [card] [Installation](https://ugcore.urging.ch/ug-multicharacter/installation.md)
>
> Requirements, building the page and the first start.

> [card] [Configuration](https://ugcore.urging.ch/ug-multicharacter/configuration.md)
>
> Fields, scene, spawn points and cinematic options.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.