Files
aeternalis/docs/CHARACTER-CREATION.md

77 lines
4.1 KiB
Markdown

# Initial character customization
September 12 playable handoff. This supersedes the character flow in the
[first creator workshop](CREATOR-WORKSHOP.md). Creature/scenery editors retain
their existing scope; the Spore-like builder is still planned.
## Player flow
New characters choose a name and appearance together on the arrival screen.
The live preview supports orbit/zoom and Front, Side, and Back views. Hair style,
skin/hair/outfit colors, and a region selector provide:
- Head length, width, depth.
- Eye spacing, height, color; no/thin/bushy eyebrows.
- Nose height and scale; mouth height and neutral/smile/stern styles.
- Male/female chest form, chest width, overall height, hip width.
- Arm and leg length/fullness, and foot size.
- Reset this region, reset all, and hair variations.
Enter world creates the name and look in one server-owned durable join. The
preview is a draft until that request succeeds. Failed creation keeps the draft;
a page reload before creation discards it. Default anatomy is valid without any
slider edits. The player flow has no model export or appearance-edit settings.
Existing characters keep their current appearance and cannot change it. The
former POST /api/appearance endpoint rejects authenticated edits with 403;
repeating join cannot overwrite a living character's name/look. A future way to
restyle for a cost is recorded in the roadmap, with no price or currency set yet.
## Model and ownership
Version 2 is a human-only bounded anatomy recipe. Version 1 remains supported for
existing players and published visuals. There is no silent conversion of saved
looks. Go validates body proportions, feature styles and colors. The same builder
is used by the creation preview, world, housing, and Control's human visuals.
The body uses shaped cross-section meshes, a fitted base shirt/trousers/boots,
hands/fingers, and smaller facial features. Male/female forms and proportion
sliders share body topology and a 17-bone hierarchy. Named joints have preliminary
rotation limits; skin weights and equipment sockets follow the edited proportions.
The default mesh contains 2,352 vertices and 3,884 triangles; hair and eyebrow
choices can change decorative geometry counts. No increased capacity is claimed.
This is a rig foundation, not completed production animation or fitted equipment.
World peer instances currently use the bind pose. Clothing is a base outfit;
visible inventory gear, armor deformation/body masking, final motion clips, and
sound hooks remain in the presentation milestone. Control GLB export preserves
the humanoid skin/skeleton; scenery still uses static merged geometry.
Appearance is character-owned. Travel, restart, and corpse resurrection preserve
it. Replacement resets it and offers a new initial creator. Only account cosmetic
entitlements carry forward. Appearance does not affect gameplay stats, reach,
collision, daily time, inventory, or death rules.
## Verification and manual playtest
Required checks: npm run check, npm run build, npm run test:contracts, Go tests,
and node tools/check-humanoid.mjs (bounds, topology, weights, joint deformation,
equipment anchors, and legacy rendering). Lifecycle coverage exercises locked
appearance, join retries, invalid anatomy, persistence, travel, and resurrection.
Manual acceptance:
1. Start a new character, set its name, and try every region at its bounds. Review
male/female forms and hair from all three views; confirm face/body proportions.
2. Enter world and reconnect. Confirm the chosen appearance and name remain.
Existing characters must have no appearance-edit action in Display settings.
3. Travel and enter housing; verify your own and another player's appearance.
Resurrection retains the look; a replacement opens a fresh creator.
4. On a phone, scroll the creation screen and the control column; confirm all
controls and Enter world remain reachable. Verify movement after creation.
5. In Control, verify old visuals still preview and new human visuals export with
a skeleton. Check future equipment-fitting work against extreme proportions.
The reference style still needs the user's visual acceptance; a passing build
does not establish that the art direction is final.