Character Creator

Cursor-based character creation system with NPC preview, gender selection, and interactive UI.

Overview

The Creator is an advanced character creation system using a mouse cursor-like interface for players to customize their character. It's designed for first-join experiences and RP servers.

Features

First-join character creation — automatic prompt for new players with cinematic intro support
Gender & body type selection — Male (Steve/Alex) and Female variants
Interactive NPC preview with drag-to-spin and zoom (press Q)
Hair color system — Each hairstyle supports multiple color variants (blonde, brown, black, ginger, etc.)
Height/Scale system — adjust character height (Minecraft 1.20.5+)
Custom items from Nexo, ItemsAdder, or Oraxen for UI elements
Camera positioning and cinematic camera paths

The cursor-based creator is the primary and recommended character creation system. The legacy hotbar creator (creator.yml) is deprecated.

Quick Setup

Create a dedicated area

Build or designate a space/world for character creation (a creation room or void world works well).

Set the camera position

Stand where you want the camera and run: ```bash /clothes cursor setcamera ```

Add creator overlays

Place your overlay PNGs in the creator folder structure (see below).

Regenerate the configuration

Run /clothes cursor regenerate to auto-detect overlays and generate sections.

Reload

Run /clothes cursor reload to apply the new configuration.

Test

Run /clothes cursor start to test the experience.

Creator Overlay Folder Structure

The creator auto-detects overlays from these folders. Each overlay category (eyes, hairs, shirts, etc.) supports gender subfolders and optional model-type variants:

overlays
- hairs
- Long.png
- Ponytail_Bangs.png
brown
- Curtain_Bangs.png
- Long.png
male
- blonde
- Curly.png
skin-colours
- cursor
- honey.png
- caramel.png
steve-male
- ivory.png
- honey.png
alex-male
- ivory.png
- honey.png
eyes
- cursor
- brown.png
- green.png
male
- blue.png
- brown.png
eyebrows
- cursor
shirts
- cursor
- Cropped_Tank.png
steve-male
- Black_Tee.png
- Hoodie.png
alex-male
- Black_Tee.png
- Hoodie.png

Auto-Detection: File names become display names automatically. Use underscores for spaces (e.g., Curtain_Bangs.png → "Curtain Bangs").

Folder Rules

Gender-specific: Place overlays in cursor/female/ or cursor/male/ subfolders
Model-type variants: For male, use cursor/steve-male/ and cursor/alex-male/ to provide separate Steve/Alex arm model overlays
Hair colors: Hairstyles support color subfolders (e.g., hairs/cursor/female/blonde/, hairs/cursor/female/brown/). The creator auto-detects colors and lets players switch between them.
Categories: Each top-level overlay folder (hairs, eyes, skin-colours, shirts, pants, shoes, etc.) becomes a creator section

Configuration

The creator configuration is split across multiple files in the creator/ folder:

File	Purpose
`settings.yml`	Core toggles, first-join, camera, NPC preview, blackout effects
`sections.yml`	Main menu layout, category sections, gender options, messages
`ui.yml`	Cursor appearance, UI backgrounds, navigation arrows, sounds
`races.yml`	Race display names, stats, and allowed classes
`classes.yml`	Class display names, powers, and allowed races
`panels.yml`	Panel layout definitions

See the full Creator Configuration reference for all options.

Creator Commands

Command	Description
`/clothes cursor start`	Start the cursor creator for yourself
`/clothes cursor start`	Start the creator for another player
`/clothes cursor stop`	Stop the current cursor session
`/clothes cursor setcamera`	Set camera position at your location
`/clothes cursor setjoincamera`	Set the first-join camera position
`/clothes cursor reload`	Reload creator configuration
`/clothes cursor resetplayer`	Reset a player's creator data (triggers first-join again)
`/clothes cursor resetall`	Reset all players' creator data
`/clothes cursor triggerjoin [player]`	Manually trigger the first-join UI for a player
`/clothes cursor regenerate`	Regenerate creator config from overlay folder structure
`/clothes cursor cinematic record start`	Start recording a cinematic camera path
`/clothes cursor cinematic record stop`	Stop recording a cinematic path

Gender & Body Type Selection

The gender section supports three body type variants with multi-command presets that apply default overlays:

yaml

sections:
  gender:
    cycle-options:
      - id: gender_female_alex
        display: <light_purple>♀ <black>Female <gray>(Alex)
        gender: female
        model-type: alex
        command: 'clothes reset; delay:5; clothes wear eyes/...,hairs/...,shirts/...'
      - id: gender_male_alex
        display: <aqua>♂ <black>Male <gray>(Alex - Slim Arms)
        gender: male
        model-type: alex
        command: 'clothes reset; delay:5; clothes wear eyes/...,hairs/...,shirts/...'
      - id: gender_male_steve
        display: <blue>♂ <black>Male <gray>(Steve - Classic Arms)
        gender: male
        model-type: steve
        command: 'clothes reset; delay:5; clothes wear eyes/...,hairs/...,shirts/...'

Commands are separated by ; (semicolon). Use delay:XX to wait XX ticks before the next command.

Vanilla Configuration (No Resource Pack)

ClothesPlus ships with a vanilla configuration pack in the vanilla-configs/ folder for servers running without a resource pack. All custom model data, custom font glyphs, and plugin-specific items are replaced with vanilla Minecraft equivalents.

Area	Default	Vanilla
Custom Model Data	Various IDs (10007, 550000, etc.)	All set to `0`
GUI Titles	/	Plain colored text
UI Backgrounds	Custom font glyphs	Native `background-color` (ARGB)
Cursor Material	PAPER + custom model data	`ARROW` (vanilla-visible)

To use vanilla mode:

Back up your existing configs
Copy all .yml files from vanilla-configs/ into plugins/ClothesPlus/
Run /clothes reload and /clothes cursor reload

The vanilla configs use Minecraft's native Text Display background-color feature (1.19.4+) for UI backgrounds instead of custom font images — no resource pack needed.

Height/Scale System

New in 3.0.3 — Requires Minecraft 1.20.5+

Players can adjust their character's height using Minecraft's generic.scale attribute. The NPC preview reflects the selected scale in real-time.

yaml

sections:
  scale:
    title: <gradient:#32CD32:#228B22>── 📏 Height ──</gradient>
    title-scale: 0.75
    cycle-enabled: true
    show-navigation: true
    cycle-options:
      - id: scale_tiny
        display: <gray>Tiny
        scale-value: 0.83
      - id: scale_short
        display: <yellow>Short
        scale-value: 0.9
      - id: scale_normal
        display: <green>Normal
        scale-value: 1.0
      - id: scale_tall
        display: <aqua>Tall
        scale-value: 1.1
      - id: scale_giant
        display: <light_purple>Giant
        scale-value: 1.15

Auto-Setup: When upgrading from older versions, the scale system toggle, default presets, and Height button are automatically injected into your existing config on startup.

The scale attribute requires Minecraft 1.20.5+. On older servers, the section will display but height changes won't be visible. The plugin auto-detects version compatibility.

← PreviousOutfits Next →Shading & Color Tinting