Add anatomical character customization at initial creation

This commit is contained in:
dingo
2026-09-12 16:00:15 -04:00
parent 90e33cbcd9
commit 4aca703b6f
25 changed files with 733 additions and 133 deletions
+12
View File
@@ -12,6 +12,18 @@
.appearance-swatches{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:10px}
.appearance-swatches input[type=color]{width:100%;height:36px;padding:3px;border:1px solid #5e7576;border-radius:8px;background:#17272e;cursor:pointer}
.appearance-actions{display:flex;flex-wrap:wrap;gap:8px}.appearance-editor button{background:#38514e!important;color:#e7f1df!important;border:1px solid #638079!important;border-radius:8px;padding:9px 12px;font-size:12px;cursor:pointer}
.appearance-controls [hidden]{display:none!important}
.humanoid-controls{display:grid;gap:15px}.anatomy-region{margin:0;padding:14px;border:1px solid #5e75765c;border-radius:8px;display:grid;gap:14px;min-width:0}
.anatomy-region legend{color:#ddcfaa;padding:0 5px;font-size:12px}.anatomy-region label>span{display:flex;justify-content:space-between;gap:8px}.anatomy-region output{color:#b9d5c8;font-variant-numeric:tabular-nums}
.anatomy-region input[type=color]{width:100%;height:34px;padding:3px;background:#17272e;border:1px solid #5e7576}
.appearance-views{position:absolute;left:16px;right:16px;bottom:35px;display:flex;justify-content:center;gap:8px}
.appearance-views button{min-height:30px;padding:5px 12px;background:#17272ecc!important}
.arrival-creator{width:min(1040px,96vw);max-width:96vw;max-height:94dvh;overflow:auto;padding:24px}
.arrival-creator h1{font-size:29px;margin:8px 0}.arrival-creator #arrival-status{margin-bottom:14px}
.arrival-creator #join-form{display:block}.arrival-creator #join{width:100%;margin-top:0}
.arrival-creator .appearance-editor{margin:14px 0}.arrival-creator .appearance-controls{max-height:460px;overflow:auto;padding:20px}
.arrival-creator .appearance-stage{min-height:460px}.arrival-creator .appearance-editor button{margin-top:0;font-weight:400}
@media(max-width:640px){.arrival-creator{padding:16px}.arrival-creator .appearance-stage{min-height:250px}.arrival-creator .appearance-controls{max-height:250px;padding:14px}.arrival-creator .appearance-caption{top:12px;left:14px}.arrival-creator .appearance-caption strong{font-size:17px}}
.appearance-note,.appearance-status{font-size:11px;line-height:1.6;color:#a8bcb5;margin:0}.appearance-status:empty{display:none}
.appearance-dialog{box-sizing:border-box;width:min(920px,96vw)!important;max-width:96vw!important;max-height:94dvh;overflow:auto;background:#18272b!important;color:#f1eee2!important;padding:28px!important;border:1px solid #536b66!important;border-radius:22px!important;box-shadow:0 24px 100px #0008}
.appearance-dialog::backdrop{background:#071317b8;backdrop-filter:blur(7px)}
+23 -28
View File
@@ -3,7 +3,7 @@ import * as T from 'three';
import { OrbitControls } from 'three/addons/controls/OrbitControls.js';
import { GLTFExporter } from 'three/addons/exporters/GLTFExporter.js';
import { buildAppearance, defaultAppearance, disposeAppearance, forms } from './appearance-model';
import { registerMenu } from './menu-focus';
import { humanoidControls } from './humanoid-controls';
import type { Appearance, VisualPreset } from './generated';
const node = <K extends keyof HTMLElementTagNameMap>(tag: K, text = '', className = '') => {
@@ -11,27 +11,28 @@ const node = <K extends keyof HTMLElementTagNameMap>(tag: K, text = '', classNam
};
const button = (text: string, action: () => void) => { const b = node('button', text); b.type = 'button'; b.onclick = action; return b; };
export function createAppearanceEditor(families: string[], initial?: Appearance, library: VisualPreset[] = []) {
export function createAppearanceEditor(families: string[], initial?: Appearance, library: VisualPreset[] = [], creation = false) {
let value = structuredClone(initial ?? defaultAppearance(families[0]));
const root = node('section', '', 'appearance-editor');
const stage = node('div', '', 'appearance-stage'), canvas = node('canvas');
canvas.setAttribute('aria-label', '3D model preview. Drag to rotate and scroll to zoom.');
const caption = node('div', '', 'appearance-caption');
caption.append(node('span', 'AETERNALIS / CREATOR'), node('strong', 'A little life, shaped by you.'));
caption.append(node('span', 'AETERNALIS / CREATOR'), node('strong', 'Shape your traveler.'));
const hint = node('p', 'Drag to orbit · scroll to zoom', 'appearance-hint');
stage.append(canvas, caption, hint);
const panel = node('div', '', 'appearance-controls');
root.append(stage, panel);
const family = node('select'), variant = node('select'), presets = node('select');
for (const f of families) family.append(new Option(f === 'human' ? 'Character' : f[0].toUpperCase() + f.slice(1), f));
const field = (label: string, input: HTMLElement) => { const wrap = node('label', label); wrap.append(input); panel.append(wrap); };
const field = (label: string, input: HTMLElement) => { const wrap = node('label', label); wrap.append(input); panel.append(wrap); return wrap; };
if (families.length > 1) field('Create', family);
field('Form', variant);
const formField = field('Form', variant);
const legacyFields: HTMLElement[] = [];
const sliders = new Map<string, HTMLInputElement>(), colors = new Map<string, HTMLInputElement>();
const colorLabels = new Map<string, HTMLSpanElement>();
for (const [key, label, min, max] of [['height', 'Height', .75, 1.25], ['width', 'Build / fullness', .75, 1.25], ['detail', 'Feature size / foliage', 0, 1]] as const) {
const input = node('input'); input.type = 'range'; input.min = String(min); input.max = String(max); input.step = '.01';
sliders.set(key, input); field(label, input);
sliders.set(key, input); legacyFields.push(field(label, input));
}
const swatches = node('div', '', 'appearance-swatches');
for (const [key, label] of [['primary', 'Skin / main'], ['secondary', 'Hair / secondary'], ['accent', 'Clothes / accent']] as const) {
@@ -39,7 +40,8 @@ export function createAppearanceEditor(families: string[], initial?: Appearance,
}
panel.append(swatches);
const seed = node('input'); seed.type = 'number'; seed.min = '1'; seed.max = '65535'; seed.step = '1'; seed.required = true;
field('Variation seed', seed);
legacyFields.push(field('Variation seed', seed));
const anatomy = humanoidControls(() => value, next => { value = next; sync(); }); panel.append(anatomy.node);
presets.append(new Option('Choose a saved design…', ''));
for (const preset of library.filter(p => families.includes(p.appearance.family))) presets.append(new Option(preset.name, preset.id));
if (presets.options.length > 1) field('Start from the visual library', presets);
@@ -48,17 +50,23 @@ export function createAppearanceEditor(families: string[], initial?: Appearance,
const variation = crypto.getRandomValues(new Uint16Array(4));
value.seed = 1 + variation[0] % 65535;
value.variant = (value.variant + 1 + variation[1] % 3) % 4;
if (value.version === 2) { sync(); return; }
value.detail = Math.round(variation[2] / 65535 * 100) / 100;
value.width = .8 + (variation[3] % 41) / 100;
sync();
}));
const exportButton = button('Download GLB', () => void exportModel()); actions.append(exportButton); panel.append(actions);
actions.append(button('Reset all', () => { value = defaultAppearance(value.family); sync(); }));
const exportButton = button('Download GLB', () => void exportModel()); exportButton.hidden = creation; actions.append(exportButton); panel.append(actions);
const status = node('p', '', 'appearance-status'); status.setAttribute('role', 'status'); panel.append(status);
panel.append(node('p', 'Your look does not change your stats, movement, or reach.', 'appearance-note'));
panel.append(node('p', creation ? 'Your name and look are saved when you enter the world. Appearance changes will be available later.' : 'Your look does not change your stats, movement, or reach.', 'appearance-note'));
let renderer: T.WebGLRenderer | undefined, controls: OrbitControls | undefined, model: T.Group | undefined;
const scene = new T.Scene(); scene.background = new T.Color('#18262c');
const camera = new T.PerspectiveCamera(35, 1, .01, 100);
let viewAngle = -.30;
const views = node('div', '', 'appearance-views');
for (const [name, angle] of [['Front', 0], ['Side', Math.PI / 2], ['Back', Math.PI]] as const) views.append(button(name, () => { viewAngle = angle; framedForm = ''; rebuild(); }));
stage.append(views);
scene.add(new T.HemisphereLight('#f5f3e8', '#728382', 2.5));
const key = new T.DirectionalLight('#ffebd3', 3); key.position.set(-3, 6, -4); scene.add(key);
const rim = new T.DirectionalLight('#9cdbd9', 2); rim.position.set(3, 3, 2); scene.add(rim);
@@ -80,12 +88,16 @@ export function createAppearanceEditor(families: string[], initial?: Appearance,
const frameKey = value.family + ':' + value.variant;
if (framedForm !== frameKey) {
controls?.target.set(0, centerY, 0);
camera.position.set(height * .9, centerY + height * .45, -height * 2.3); camera.lookAt(0, centerY, 0);
camera.position.set(Math.sin(viewAngle) * height * 2.15, centerY + height * .12, -Math.cos(viewAngle) * height * 2.15); camera.lookAt(0, centerY, 0);
framedForm = frameKey;
}
controls?.update(); dirty = true;
}
function sync() {
const human = value.version === 2 && value.family === 'human';
for (const field of legacyFields) field.hidden = human;
anatomy.node.hidden = !human; anatomy.sync();
formField.firstChild!.textContent = human ? 'Hair style' : 'Form';
family.value = value.family; variant.replaceChildren(...forms[value.family].map((name, i) => new Option(name, String(i)))); variant.value = String(value.variant);
for (const [key, input] of sliders) input.value = String(value[key as 'height' | 'width' | 'detail']);
for (const [key, input] of colors) input.value = value[key as 'primary' | 'secondary' | 'accent'];
@@ -94,7 +106,7 @@ export function createAppearanceEditor(families: string[], initial?: Appearance,
seed.value = String(value.seed); rebuild();
}
function readInputs() {
value = { ...value, variant: Number(variant.value), seed: Number(seed.value), ...Object.fromEntries([...sliders].map(([k, i]) => [k, Number(i.value)])), ...Object.fromEntries([...colors].map(([k, i]) => [k, i.value])) };
value = { ...value, variant: Number(variant.value), ...(value.version === 2 ? {} : { seed: Number(seed.value), ...Object.fromEntries([...sliders].map(([k, i]) => [k, Number(i.value)])) }), ...Object.fromEntries([...colors].map(([k, i]) => [k, i.value])) };
if (seed.validity.valid && seed.value) rebuild();
}
family.onchange = () => { value = defaultAppearance(family.value); sync(); };
@@ -134,20 +146,3 @@ export function createAppearanceEditor(families: string[], initial?: Appearance,
sync(); frame = requestAnimationFrame(tick);
return { node: root, read: () => structuredClone(value), dispose };
}
export function showCharacterCreator(initial: Appearance | undefined, save: (appearance: Appearance) => Promise<void>) {
const dialog = node('dialog', '', 'appearance-dialog'), header = node('header'), editor = createAppearanceEditor(['human'], initial);
header.append(node('div', 'YOUR CHARACTER', 'appearance-eyebrow'), node('h2', 'Give your traveler a face.'));
const footer = node('footer'), error = node('p', '', 'error'), form = node('form');
let busy = false;
const menu = registerMenu(dialog, () => { if (!busy) { dialog.close(); editor.dispose(); dialog.remove(); menu.dispose(); } });
const cancel = button('Cancel', () => menu.close()), submit = node('button', 'Save appearance'); submit.type = 'submit';
footer.append(cancel, submit); form.append(editor.node, error, footer); dialog.append(header, form);
form.onsubmit = async event => {
event.preventDefault(); if (busy) return; busy = true; submit.disabled = cancel.disabled = true; editor.node.inert = true;
try { await save(editor.read()); busy = false; menu.close(); }
catch (e) { error.textContent = (e as Error).message; }
finally { busy = false; submit.disabled = cancel.disabled = false; editor.node.inert = false; }
};
const previous = document.activeElement; document.body.append(dialog); dialog.showModal(); menu.opened(previous);
}
+4
View File
@@ -1,6 +1,7 @@
import * as T from 'three';
import { mergeGeometries } from 'three/addons/utils/BufferGeometryUtils.js';
import type { Appearance } from './generated';
import { buildHumanoid, defaultBody } from './humanoid-model';
export const forms: Record<string, string[]> = {
human: ['Tousled hair', 'Side swept', 'Rounded bob', 'Twin braids'],
@@ -11,6 +12,7 @@ export const forms: Record<string, string[]> = {
};
export function defaultAppearance(family = 'human'): Appearance {
if (family === 'human') return { version: 2, family, variant: 0, seed: 42, height: 1, width: 1, detail: .5, primary: '#c99573', secondary: '#392b28', accent: '#456c70', body: defaultBody() };
const colors: Record<string, string[]> = {
human: ['#d8a582', '#493947', '#578f8b'],
creature: ['#cd8959', '#fff0cf', '#607a67'],
@@ -27,6 +29,7 @@ export function defaultAppearance(family = 'human'): Appearance {
* draw per leaf. No collision or gameplay attributes are inferred from the mesh.
*/
export function buildAppearance(a: Appearance): T.Group {
if (a.family === 'human' && a.version === 2) return buildHumanoid(a);
const buckets = new Map<string, T.BufferGeometry[]>();
const transform = new T.Object3D();
let seed = a.seed;
@@ -174,6 +177,7 @@ export function buildAppearance(a: Appearance): T.Group {
export function disposeAppearance(root: T.Object3D) {
root.traverse(o => {
if (o instanceof T.SkinnedMesh) o.skeleton.dispose();
if (o instanceof T.Mesh) { o.geometry.dispose(); for (const m of Array.isArray(o.material) ? o.material : [o.material]) m.dispose(); }
});
}
+23
View File
@@ -114,6 +114,7 @@ export interface MobDefinition {
export interface Appearance {
accent: string;
body?: HumanoidBody;
detail: number;
family: string;
height: number;
@@ -125,6 +126,28 @@ export interface Appearance {
width: number;
}
export interface HumanoidBody {
armLength: number;
armWidth: number;
chest: string;
chestWidth: number;
eyeColor: string;
eyeHeight: number;
eyeSpacing: number;
eyebrows: string;
footSize: number;
headDepth: number;
headLength: number;
headWidth: number;
hipsWidth: number;
legLength: number;
legWidth: number;
mouthHeight: number;
mouthStyle: string;
noseHeight: number;
noseScale: number;
}
export interface MobSpawn {
biomes: string[];
count: number;
+60
View File
@@ -0,0 +1,60 @@
import type { Appearance, HumanoidBody } from './generated';
import { defaultBody } from './humanoid-model';
export function humanoidControls(read: () => Appearance, change: (next: Appearance) => void) {
const root = document.createElement('section'); root.className = 'humanoid-controls';
const label = document.createElement('label'); label.textContent = 'Customize region';
const region = document.createElement('select'); label.append(region); root.append(label);
const panels = new Map<string, HTMLElement>(), syncers: (() => void)[] = [];
const defaults = defaultBody();
const set = (key: keyof HumanoidBody, value: string | number) => change({ ...read(), body: { ...read().body!, [key]: value } });
function group(id: string, title: string) {
region.append(new Option(title, id));
const section = document.createElement('fieldset'); section.className = 'anatomy-region';
const legend = document.createElement('legend'); legend.textContent = title; section.append(legend);
panels.set(id, section); root.append(section); return section;
}
function range(parent: HTMLElement, key: keyof HumanoidBody | 'height', title: string, min: number, max: number, step = .01) {
const wrap = document.createElement('label'), caption = document.createElement('span'), output = document.createElement('output');
const input = document.createElement('input'); input.type = 'range'; input.min = String(min); input.max = String(max); input.step = String(step);
input.setAttribute('aria-label', title); caption.append(document.createTextNode(title), output); wrap.append(caption, input); parent.append(wrap);
input.oninput = () => key === 'height' ? change({ ...read(), height: Number(input.value) }) : set(key, Number(input.value));
syncers.push(() => { const value = key === 'height' ? read().height : read().body![key] as number; input.value = String(value); output.textContent = min < 0 ? `${value > 0 ? '+' : ''}${Math.round(value * 1000)}` : `${Math.round(value * 100)}%`; });
}
function select(parent: HTMLElement, key: keyof HumanoidBody, title: string, values: [string, string][]) {
const wrap = document.createElement('label'); wrap.textContent = title;
const input = document.createElement('select'); input.setAttribute('aria-label', title);
for (const [id, text] of values) input.append(new Option(text, id)); wrap.append(input); parent.append(wrap);
input.onchange = () => set(key, input.value); syncers.push(() => { input.value = String(read().body![key]); });
}
const head = group('head', 'Head');
range(head, 'headLength', 'Head length', .85, 1.15); range(head, 'headWidth', 'Head width', .85, 1.15); range(head, 'headDepth', 'Head depth', .85, 1.15);
const eyes = group('eyes', 'Eyes & eyebrows');
range(eyes, 'eyeSpacing', 'Eye spacing', .8, 1.2); range(eyes, 'eyeHeight', 'Eye height', -.035, .035, .001);
const colorLabel = document.createElement('label'); colorLabel.textContent = 'Eye color';
const eyeColor = document.createElement('input'); eyeColor.type = 'color'; colorLabel.append(eyeColor); eyes.append(colorLabel);
eyeColor.oninput = () => set('eyeColor', eyeColor.value); syncers.push(() => { eyeColor.value = read().body!.eyeColor; });
select(eyes, 'eyebrows', 'Eyebrows', [['none', 'None'], ['thin', 'Thin'], ['bushy', 'Bushy']]);
const nose = group('nose', 'Nose'); range(nose, 'noseHeight', 'Nose height', -.035, .035, .001); range(nose, 'noseScale', 'Nose scale', .75, 1.25);
const mouth = group('mouth', 'Mouth'); range(mouth, 'mouthHeight', 'Mouth height', -.025, .025, .001);
select(mouth, 'mouthStyle', 'Mouth style', [['neutral', 'Neutral'], ['smile', 'Soft smile'], ['stern', 'Stern']]);
const chest = group('chest', 'Chest & stature');
select(chest, 'chest', 'Chest form', [['male', 'Male'], ['female', 'Female']]);
range(chest, 'height', 'Overall height', .9, 1.1); range(chest, 'chestWidth', 'Chest width', .85, 1.15);
range(group('hips', 'Hips'), 'hipsWidth', 'Hip width', .85, 1.15);
const arms = group('arms', 'Arms'); range(arms, 'armLength', 'Arm length', .9, 1.1); range(arms, 'armWidth', 'Arm fullness', .8, 1.2);
const legs = group('legs', 'Legs'); range(legs, 'legLength', 'Leg length', .9, 1.1); range(legs, 'legWidth', 'Leg fullness', .8, 1.2);
range(group('feet', 'Feet'), 'footSize', 'Foot size', .85, 1.15);
const reset = document.createElement('button'); reset.type = 'button'; reset.textContent = 'Reset this region';
const keys: Record<string, (keyof HumanoidBody)[]> = { head: ['headLength', 'headWidth', 'headDepth'], eyes: ['eyeSpacing', 'eyeHeight', 'eyeColor', 'eyebrows'], nose: ['noseHeight', 'noseScale'], mouth: ['mouthHeight', 'mouthStyle'], chest: ['chest', 'chestWidth'], hips: ['hipsWidth'], arms: ['armLength', 'armWidth'], legs: ['legLength', 'legWidth'], feet: ['footSize'] };
reset.onclick = () => {
const next = structuredClone(read());
for (const key of keys[region.value]) Object.assign(next.body!, { [key]: defaults[key] });
if (region.value === 'chest') next.height = 1;
change(next);
};
root.append(reset);
region.onchange = () => { for (const [id, panel] of panels) panel.hidden = id !== region.value; };
region.value = 'head'; for (const [id, panel] of panels) panel.hidden = id !== 'head';
return { node: root, sync: () => { if (read().body) for (const update of syncers) update(); } };
}
+190
View File
@@ -0,0 +1,190 @@
import * as T from 'three';
import type { Appearance, HumanoidBody } from './generated';
export const defaultBody = (): HumanoidBody => ({
headLength: 1, headWidth: 1, headDepth: 1, eyeSpacing: 1, eyeHeight: 0,
eyeColor: '#547d75', eyebrows: 'thin', noseHeight: 0, noseScale: 1,
mouthHeight: 0, mouthStyle: 'neutral', chest: 'male', chestWidth: 1,
hipsWidth: 1, armLength: 1, armWidth: 1, legLength: 1, legWidth: 1, footSize: 1,
});
type Ring = [x: number, y: number, z: number, width: number, depth: number];
type Influence = [first: number, second: number, blend: number];
/** Version 2: shaped cross-sections with a stable bind-pose topology, paired
* proportions and named joints. Clothes are a fitted base outfit, not equipment.
* World peers still use the bind pose through the existing instancing path.
*/
export function buildHumanoid(a: Appearance): T.Group {
const b = a.body ?? defaultBody(), female = b.chest === 'female';
const root = new T.Group(); root.name = 'humanoid-v2';
root.userData.rigVersion = 1;
const bones: T.Bone[] = [], locations: T.Vector3[] = [];
function bone(name: string, parent: number | undefined, x: number, y: number, z = 0, limits = [-.6, .6, -.4, .4, -.4, .4]) {
const joint = new T.Bone(); joint.name = name;
const location = new T.Vector3(x, y, z).multiplyScalar(a.height);
joint.position.copy(location);
if (parent !== undefined) { joint.position.sub(locations[parent]); bones[parent].add(joint); }
else root.add(joint);
joint.userData.connection = { profile: name, rotationMin: [limits[0], limits[2], limits[4]], rotationMax: [limits[1], limits[3], limits[5]] };
locations.push(location); bones.push(joint); return bones.length - 1;
}
const hip = .98 * b.legLength, waist = hip + .15, chest = hip + .39, shoulder = hip + .51;
const neck = shoulder + .105, head = neck + .19 * b.headLength;
const pelvis = bone('pelvis', undefined, 0, hip), spine = bone('spine', pelvis, 0, waist);
const thorax = bone('chest', spine, 0, chest), neckBone = bone('neck', thorax, 0, neck);
const headBone = bone('head', neckBone, 0, head);
const positions: number[] = [], colors: number[] = [], indices: number[] = [], skinIndices: number[] = [], weights: number[] = [];
const tint = new T.Color();
function vertex(x: number, y: number, z: number, color: string, influence: Influence) {
const index = positions.length / 3;
positions.push(x * a.height, y * a.height, z * a.height);
tint.set(color); colors.push(tint.r, tint.g, tint.b);
skinIndices.push(influence[0], influence[1], 0, 0);
weights.push(1 - influence[2], influence[2], 0, 0);
return index;
}
const fixed = (id: number): Influence => [id, id, 0];
const blend = (y: number, pivot: number, first: number, second: number, width = .06): Influence =>
[first, second, T.MathUtils.clamp((y - pivot + width) / (2 * width), 0, 1)];
function tube(rings: Ring[], color: string, influence: (y: number) => Influence, sides = 12, shape?: (x: number, y: number, z: number, cosine: number) => number) {
const start = positions.length / 3;
for (const [cx, y, cz, rx, rz] of rings) {
for (let i = 0; i < sides; i++) {
const angle = i / sides * Math.PI * 2, cosine = Math.cos(angle), x = cx + Math.sin(angle) * rx;
const z = cz - cosine * rz;
vertex(x, y, shape ? shape(x, y, z, cosine) : z, color, influence(y));
}
}
for (let j = 0; j < rings.length - 1; j++) for (let i = 0; i < sides; i++) {
const p = start + j * sides + i, q = start + j * sides + (i + 1) % sides;
indices.push(p, p + sides, q, q, p + sides, q + sides);
}
for (const [j, reverse] of [[0, true], [rings.length - 1, false]] as const) {
const [x, y, z] = rings[j], center = vertex(x, y, z, color, influence(y));
for (let i = 0; i < sides; i++) {
const p = start + j * sides + i, q = start + j * sides + (i + 1) % sides;
indices.push(center, reverse ? p : q, reverse ? q : p);
}
}
}
function feature(geometry: T.BufferGeometry, color: string, x: number, y: number, z: number, sx: number, sy: number, sz: number, joint = headBone) {
const p = geometry.getAttribute('position'), offset = positions.length / 3;
for (let i = 0; i < p.count; i++) vertex(x + p.getX(i) * sx, y + p.getY(i) * sy, z + p.getZ(i) * sz, color, fixed(joint));
if (geometry.index) for (const n of geometry.index.array) indices.push(offset + n);
else for (let i = 0; i < p.count; i++) indices.push(offset + i);
geometry.dispose();
}
function anchor(name: string, joint: number, x = 0, y = 0, z = 0) {
const socket = new T.Object3D(); socket.name = `equipment:${name}`;
socket.position.set(x * a.height, y * a.height, z * a.height); bones[joint].add(socket);
}
const pants = '#333d49', boots = '#44372f';
const hipWidth = (female ? .215 : .19) * b.hipsWidth, chestWidth = .235 * b.chestWidth;
tube([[0, hip - .095, 0, hipWidth * .88, .125], [0, hip, 0, hipWidth, .14], [0, waist, 0, hipWidth * .84, .12],
[0, waist + .10, 0, chestWidth * .86, .13], [0, chest, 0, chestWidth, .155], [0, shoulder - .05, 0, chestWidth * 1.04, .14],
[0, shoulder + .015, 0, chestWidth * .9, .105], [0, neck - .025, 0, .072, .07]], a.accent,
y => y < waist ? blend(y, hip + .07, pelvis, spine) : blend(y, chest - .10, spine, thorax), 16,
(x, y, z, front) => z - (female && front > 0 ? .065 * Math.exp(-(((y - (chest - .015)) / .075) ** 2)) * Math.exp(-(((Math.abs(x) - chestWidth * .48) / .065) ** 2)) * front : 0));
const beltWidth = Math.max(hipWidth * .92, chestWidth * .86);
tube([[0, waist - .015, 0, beltWidth, .14], [0, waist + .025, 0, beltWidth, .14]], boots, () => fixed(spine), 16);
feature(new T.BoxGeometry(1, 1, 1), '#b99457', 0, waist + .005, -.145, .055, .035, .015, spine);
tube([[0, neck - .045, 0, .07, .066], [0, neck + .055, 0, .068, .068]], a.primary, () => fixed(neckBone));
for (const sign of [-1, 1]) {
const side = sign < 0 ? 'right' : 'left';
const legX = sign * hipWidth * .58, knee = .54 * b.legLength;
const thigh = bone(`${side}-thigh`, pelvis, legX, hip, 0, [-1.4, .7, -.5, .5, -.6, .6]);
const shin = bone(`${side}-shin`, thigh, legX, knee, 0, [0, 2.2, 0, 0, 0, 0]);
const foot = bone(`${side}-foot`, shin, legX, .14, 0, [-.5, .5, -.2, .2, -.2, .2]);
const legWeight = (y: number) => blend(y, knee, shin, thigh);
tube([[legX, .14, 0, .048 * b.legWidth, .05], [legX, .26 * b.legLength, .01, .057 * b.legWidth, .064],
[legX, .39 * b.legLength, .008, .072 * b.legWidth, .079], [legX, knee - .035, -.012, .059 * b.legWidth, .065],
[legX, knee + .035, -.012, .065 * b.legWidth, .073], [legX, .76 * b.legLength, 0, .088 * b.legWidth, .10],
[legX, hip - .045, 0, .104 * b.legWidth, .12], [legX, hip + .025, 0, .09 * b.legWidth, .10]], pants, legWeight);
tube([[legX, .025, -.055, .071 * b.footSize, .143 * b.footSize], [legX, .065, -.055, .075 * b.footSize, .146 * b.footSize],
[legX, .12, -.035, .07 * b.footSize, .118 * b.footSize], [legX, .18, 0, .054 * b.legWidth, .057],
[legX, .24, 0, .057 * b.legWidth, .06]], boots, () => fixed(foot));
const sx = sign * (chestWidth + .035), elbowY = shoulder - .27 * b.armLength;
const elbowX = sx + sign * .10, wristY = shoulder - .52 * b.armLength, wristX = sx + sign * .14;
const upper = bone(`${side}-upper-arm`, thorax, sx, shoulder - .04, 0, [-1.8, 1.4, -.8, .8, -1.6, 1.6]);
const lower = bone(`${side}-forearm`, upper, elbowX, elbowY, 0, [-2.2, 0, 0, 0, 0, 0]);
const hand = bone(`${side}-hand`, lower, wristX, wristY, 0);
const armWeight = (y: number) => blend(y, elbowY, lower, upper, .055);
tube([[wristX, wristY, 0, .039 * b.armWidth, .041], [wristX - sign * .018, wristY + .07 * b.armLength, 0, .046 * b.armWidth, .049],
[elbowX + sign * .012, elbowY - .06, 0, .059 * b.armWidth, .064], [elbowX, elbowY, 0, .05 * b.armWidth, .051],
[elbowX - sign * .02, elbowY + .075, 0, .059 * b.armWidth, .065], [sx, shoulder - .10, 0, .076 * b.armWidth, .078],
[sx - sign * .025, shoulder, 0, .065 * b.armWidth, .067]], a.primary, armWeight);
tube([[sx + sign * .04, shoulder - .16, 0, .078 * b.armWidth, .081], [sx, shoulder - .09, 0, .083 * b.armWidth, .085],
[sx - sign * .025, shoulder + .005, 0, .071 * b.armWidth, .071]], a.accent, () => fixed(upper));
tube([[wristX, wristY - .11, -.004, .041 * b.armWidth, .025], [wristX, wristY - .04, 0, .047 * b.armWidth, .029],
[wristX, wristY + .01, 0, .037 * b.armWidth, .032]], a.primary, () => fixed(hand), 10);
for (let finger = 0; finger < 4; finger++) {
const x = wristX + (finger - 1.5) * .021 * b.armWidth, bottom = wristY - .15 - (finger === 1 || finger === 2 ? .015 : 0);
tube([[x, bottom, -.002, .008, .010], [x, wristY - .085, 0, .009, .012]], a.primary, () => fixed(hand), 6);
}
tube([[wristX - sign * .065, wristY - .095, -.01, .012, .015], [wristX - sign * .035, wristY - .025, 0, .016, .021]], a.primary, () => fixed(hand), 8);
anchor(`${side}-glove`, hand); anchor(`${side}-boot`, foot); anchor(`${side}-shoulder`, upper);
anchor(sign < 0 ? 'weapon' : 'offhand', hand, 0, -.07, -.025);
for (let ring = 0; ring < 4; ring++) anchor(`ring${(sign < 0 ? 0 : 4) + ring + 1}`, hand, (ring - 1.5) * .021 * b.armWidth, -.10, 0);
}
const hw = .148 * b.headWidth, hd = .139 * b.headDepth, hy = (v: number) => head + v * b.headLength;
tube([[0, hy(-.18), -.009, hw * .42, hd * .60], [0, hy(-.145), 0, hw * .68, hd * .81],
[0, hy(-.09), .007, hw * .89, hd * .91], [0, hy(-.025), 0, hw, hd], [0, hy(.04), 0, hw * .96, hd * .99],
[0, hy(.11), .012, hw * .94, hd * .92], [0, hy(.165), .016, hw * .76, hd * .70],
[0, hy(.195), .014, hw * .25, hd * .22]], a.primary, () => fixed(headBone), 20);
const eyeY = hy(.018) + b.eyeHeight, ex = .060 * b.headWidth * b.eyeSpacing;
const faceDepth = (x: number) => -hd * Math.sqrt(Math.max(.1, 1 - (x / hw) ** 2));
for (const sign of [-1, 1]) {
feature(new T.SphereGeometry(1, 10, 6), a.primary, sign * hw * 1.015, hy(-.015), .01, .027, .049, .026);
const x = sign * ex, z = faceDepth(x);
feature(new T.SphereGeometry(1, 12, 8), '#e4dcd2', x, eyeY, z - .003, .027, .012, .009);
feature(new T.SphereGeometry(1, 12, 8), b.eyeColor, x, eyeY, z - .012, .010, .010, .003);
feature(new T.SphereGeometry(1, 10, 6), '#202429', x, eyeY, z - .015, .0045, .006, .002);
if (b.eyebrows !== 'none') {
feature(new T.BoxGeometry(1, 1, 1), a.secondary, x, eyeY + .027, z - .005, .055, b.eyebrows === 'bushy' ? .013 : .006, .008);
}
}
// A tapered bridge and triangular nose tip, rather than a spherical button.
const noseY = hy(-.03) + b.noseHeight, ns = b.noseScale;
const nose = new T.BufferGeometry();
nose.setAttribute('position', new T.Float32BufferAttribute([-.013,.05,0, .013,.05,0, -.025,-.025,0, .025,-.025,0, 0,-.017,-.044, 0,-.035,-.015], 3));
nose.setIndex([0,1,4, 0,4,2, 1,3,4, 2,4,5, 3,5,4, 2,5,3, 0,3,1, 0,2,3]);
feature(nose, a.primary, 0, noseY, -hd * .97, ns, ns, ns);
const mouthY = hy(-.105) + b.mouthHeight, lip = '#985e51';
for (const sign of [-1, 1]) {
const y = mouthY + (b.mouthStyle === 'smile' ? .004 : b.mouthStyle === 'stern' ? -.004 : 0);
feature(new T.SphereGeometry(1, 10, 6), lip, sign * .019, y, -hd * .89, .023, .005, .005);
}
// Four fitted hair silhouettes share the same head transform.
const hairRing = (y: number, width: number, depth: number): Ring => [0, hy(y), .018, hw * width, hd * depth];
tube([hairRing(.085, 1.015, 1.00), hairRing(.14, .91, .88), hairRing(.19, .66, .64), hairRing(.214, .16, .16)], a.secondary, () => fixed(headBone), 20);
if (a.variant === 0 || a.variant === 1) {
for (let i = 0; i < 5; i++) {
const x = (i - 2) * hw * .34, height = a.variant === 1 ? .043 + (i + 2) * .008 : .065 + (i % 2) * .012;
tube([[x - (a.variant === 1 ? .035 : 0), hy(height), -hd * .87, .019, .012],
[x, hy(.115), -hd * .80, .042, .035], [x * .75, hy(.177), -hd * .49, .026, .033]], a.secondary, () => fixed(headBone), 8);
}
}
for (const sign of [-1, 1]) {
if (a.variant === 2) tube([[sign * hw * .83, hy(-.15), .025, .041, hd * .89], [sign * hw * .95, hy(-.04), .03, .038, hd * .88], [sign * hw * .85, hy(.10), .025, .04, hd * .78]], a.secondary, () => fixed(headBone), 10);
if (a.variant === 3) {
const rows: Ring[] = [];
for (let i = 0; i < 7; i++) rows.push([sign * (hw + .015 + Math.sin(i * Math.PI / 2) * .01), hy(-.30 + i * .06), .06, .022 + i * .001, .026]);
tube(rows, a.secondary, () => fixed(headBone), 8);
feature(new T.BoxGeometry(1, 1, 1), a.accent, sign * (hw + .015), hy(-.27), .06, .046, .022, .05);
}
}
anchor('helmet', headBone, 0, .15 * b.headLength); anchor('mask', headBone, 0, -.04, -hd);
anchor('necklace', neckBone, 0, -.035, -.08); anchor('earrings', headBone, hw, -.035, 0);
anchor('chest', thorax, 0, 0, -.15); anchor('pants', pelvis); anchor('cape', thorax, 0, .05, .15); anchor('bag', spine, 0, 0, .17);
const geometry = new T.BufferGeometry();
geometry.setAttribute('position', new T.Float32BufferAttribute(positions, 3));
geometry.setAttribute('color', new T.Float32BufferAttribute(colors, 3));
geometry.setAttribute('skinIndex', new T.Uint16BufferAttribute(skinIndices, 4));
geometry.setAttribute('skinWeight', new T.Float32BufferAttribute(weights, 4));
geometry.setIndex(indices); geometry.computeVertexNormals();
const mesh = new T.SkinnedMesh(geometry, new T.MeshStandardMaterial({ vertexColors: true, roughness: .88 }));
mesh.name = 'humanoid-body'; mesh.castShadow = mesh.receiveShadow = true;
root.add(mesh); root.updateMatrixWorld(true); mesh.bind(new T.Skeleton(bones)); mesh.skeleton.update();
return root;
}
+9 -10
View File
@@ -1,7 +1,5 @@
import './style.css';
import { showCharacterCreator } from './appearance-editor';
import type { Appearance } from './generated';
let draftAppearance: Appearance | undefined;
import { createAppearanceEditor } from './appearance-editor';
import {createItemActions} from './item-actions';
import { showTravel } from './travel';
import { createHousingPanel } from './housing-panel';
@@ -357,15 +355,16 @@ async function boot() {
}
if(config.kind==='hub'){visible('join-form',false);$('arrival-error').textContent='Enter a hub through travel from your current character. Open your account to continue.';}
}
const customize = document.createElement('button'); customize.type = 'button'; customize.textContent = 'Create your look';
customize.onclick = () => showCharacterCreator(draftAppearance, async appearance => { draftAppearance = appearance; customize.textContent = 'Edit your look'; });
$('join-form').insertBefore(customize, $('join'));
const restyle = document.createElement('button'); restyle.type = 'button'; restyle.textContent = 'Character appearance';
restyle.onclick = () => showCharacterCreator(snapshot?.self.entity.appearance, async appearance => { await api('/api/appearance', appearance); notice('Appearance saved.'); });
$('settings').append(restyle);
let characterEditor: ReturnType<typeof createAppearanceEditor> | undefined;
if (me && !me.character && !me.active && config.kind !== 'hub') {
characterEditor = createAppearanceEditor(['human'], undefined, [], true);
$('arrival').classList.add('arrival-creator');
$('arrival-status').textContent = 'Choose your name and appearance. This is who you will be in this life.';
$('join-form').insertBefore(characterEditor.node, $('join'));
}
$<HTMLFormElement>('join-form').onsubmit = async event => {
event.preventDefault(); const button = $<HTMLButtonElement>('join'); button.disabled = true;
try { await api('/api/join', { name: $<HTMLInputElement>('name').value, passage: '', appearance: draftAppearance }); $<HTMLDialogElement>('arrival').close(); connect(); }
try { await api('/api/join', { name: $<HTMLInputElement>('name').value, passage: '', appearance: characterEditor?.read() }); $<HTMLDialogElement>('arrival').close(); characterEditor?.dispose(); connect(); }
catch (e) { $('arrival-error').textContent = (e as Error).message; }
finally { button.disabled = false; }
};
+6
View File
@@ -33,6 +33,12 @@ The highest-risk requirements are:
## Implemented boundaries
The [initial character creator](CHARACTER-CREATION.md) saves a bounded version-2
humanoid recipe alongside the name in the durable join transaction. Existing
characters retain their saved version and cannot restyle through the old endpoint.
The browser's 17-bone humanoid and equipment sockets are presentation metadata;
authoritative hitboxes, stats, time, and lifecycle rules are unchanged.
The [creator detour](CREATOR-WORKSHOP.md) adds bounded, versioned procedural
appearance recipes. Go validates and persists character looks and admin-authored
visual presets; resource/mob definitions copy their selected recipes. Three.js
+76
View File
@@ -0,0 +1,76 @@
# 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.
+7
View File
@@ -1,5 +1,12 @@
# Creator detour: rounded fantasy models
**September 12 character flow supersedes the instructions below:**
[Initial character creation](CHARACTER-CREATION.md) adds anatomical version-2
humanoids. Name and appearance are chosen together before entering the world.
Existing-character appearance edits are disabled, including the old API route;
a future cost-based restyle system remains planned. Creature/scenery instructions
below still apply. Earlier free-restyle playtest steps are historical only.
**Playtest direction revised:** the user rejected the current character styling
and requested anatomical body/face controls and a Spore-like creature part builder.
See [Modular creators](../planning/MODULAR-CREATORS.md) for the confirmed controls,
+5
View File
@@ -240,6 +240,11 @@ direction to anatomical region/face controls and a Spore-like modular mob builde
[Modular creators](MODULAR-CREATORS.md) records the complete requested part list,
connection profiles/joint limits, version compatibility, and proposed review slices.
September 12: anatomical player customization is implemented for initial character
creation only, together with the name. See [Character creation](../docs/CHARACTER-CREATION.md).
The old free-restyle action is removed; a future change-for-cost mechanism is
planned. Modular mobs and the remaining presentation work are still pending.
Milestones 1–3 have implementation handoffs above. Milestone 4 now includes the
storage work that must precede expanding worlds; it is no longer only a rules
discussion. The [reliability issue register and persistence plan](RELIABILITY-AND-PERSISTENCE.md)
+9 -4
View File
@@ -1,7 +1,9 @@
# Modular characters and creature builder
September 11 follow-up to the first creator playtest. This records the user's
revised direction, not a claim that these controls or rigs are implemented.
September 11 follow-up to the first creator playtest, updated September 12.
The initial-only humanoid creator is now implemented; see
[Character creation](../docs/CHARACTER-CREATION.md) for its scope and manual checks.
The modular creature builder and production animation/equipment work remain planned.
The first [creator workshop](../docs/CREATOR-WORKSHOP.md) remains a version-1
prototype. Its rounded preset characters did not meet the desired visual style.
@@ -146,8 +148,11 @@ should be agreed after the base humanoid review.
- Keep version-1 appearances and published visual presets renderable. Introduce
a new recipe version; never silently reinterpret an old preset as a new anatomy.
- Existing characters can opt into a new base appearance without losing items,
progression, identity, or cosmetic entitlements. Failed saves retain the old look.
- Appearance is selected alongside the name during initial character creation.
Existing characters cannot restyle themselves. A later paid/cost-based mechanism
is planned; its currency, price, location, and restrictions remain undecided.
- Reconnect and creation retries preserve the saved look. Each replacement chooses
its own name and appearance; existing version-1 looks remain supported.
- Closing, saving, or canceling a creator must restore the surrounding interface;
gameplay input stays blocked only while a relevant menu is actually open.
- Check world and housing rendering, reconnect, travel, revival, replacement,
+5
View File
@@ -27,6 +27,11 @@ requested anatomical player controls, male/female chest forms, modular creature
parts, connection profiles and joint limits. It supersedes the initial character
styling direction; the version-1 workshop is still the implemented prototype.
September 12: [initial character creation](../docs/CHARACTER-CREATION.md) implements
the anatomical humanoid controls alongside the name. Existing-character restyling
is disabled; a later cost-based change mechanism remains planned. Creature assembly,
production animation, and visible equipment remain pending.
Draft for discussion, 2026-09-08. This document organizes requested work; it does
not authorize gameplay implementation or finalize the open decisions below.
Existing behavior is described in `docs/ARCHITECTURE.md` and `docs/PROGRESSION.md`.
+5
View File
@@ -110,6 +110,11 @@ Tracked across:
capacity enforcement remain undecided.
## Cosmetics (planned)
- Base character name and appearance are chosen together at initial creation.
Existing-character appearance changes are disabled until a later mechanism with
a cost is designed. Restart, travel, and revival preserve the same appearance;
replacement opens a fresh creator. See [Character creation](../docs/CHARACTER-CREATION.md).
- Cosmetics are permanently **account-bound**, not character-bound. They cannot
be traded or lost; an item's applied appearance is separate from the unlock.
- Cosmetics change the player, worn/held items, and items in houses.
+85
View File
@@ -209,6 +209,7 @@
"type": "object",
"additionalProperties": false,
"properties": {
"body": { "$ref": "#/definitions/HumanoidBody" },
"version": {
"type": "integer"
},
@@ -253,6 +254,90 @@
"accent"
]
},
"HumanoidBody": {
"type": "object",
"additionalProperties": false,
"properties": {
"headLength": {
"type": "number"
},
"headWidth": {
"type": "number"
},
"headDepth": {
"type": "number"
},
"eyeSpacing": {
"type": "number"
},
"eyeHeight": {
"type": "number"
},
"noseHeight": {
"type": "number"
},
"noseScale": {
"type": "number"
},
"mouthHeight": {
"type": "number"
},
"chestWidth": {
"type": "number"
},
"hipsWidth": {
"type": "number"
},
"armLength": {
"type": "number"
},
"armWidth": {
"type": "number"
},
"legLength": {
"type": "number"
},
"legWidth": {
"type": "number"
},
"footSize": {
"type": "number"
},
"eyeColor": {
"type": "string"
},
"eyebrows": {
"type": "string"
},
"mouthStyle": {
"type": "string"
},
"chest": {
"type": "string"
}
},
"required": [
"headLength",
"headWidth",
"headDepth",
"eyeSpacing",
"eyeHeight",
"noseHeight",
"noseScale",
"mouthHeight",
"chestWidth",
"hipsWidth",
"armLength",
"armWidth",
"legLength",
"legWidth",
"footSize",
"eyeColor",
"eyebrows",
"mouthStyle",
"chest"
]
},
"VisualPreset": {
"type": "object",
"additionalProperties": false,
+30 -1
View File
@@ -24,12 +24,41 @@ func ValidateAppearance(a *Appearance, families ...string) error {
if a == nil {
return nil
} // Existing worlds retain their original models.
if !slices.Contains(families, a.Family) || a.Version != 1 || a.Variant < 0 || a.Variant > 3 || a.Seed < 1 || a.Seed > 65535 || !finiteRange(a.Height, .75, 1.25) || !finiteRange(a.Width, .75, 1.25) || !finiteRange(a.Detail, 0, 1) || !appearanceColor.MatchString(a.Primary) || !appearanceColor.MatchString(a.Secondary) || !appearanceColor.MatchString(a.Accent) {
if !slices.Contains(families, a.Family) || (a.Version != 1 && a.Version != 2) || a.Variant < 0 || a.Variant > 3 || a.Seed < 1 || a.Seed > 65535 || !finiteRange(a.Height, .75, 1.25) || !finiteRange(a.Width, .75, 1.25) || !finiteRange(a.Detail, 0, 1) || !appearanceColor.MatchString(a.Primary) || !appearanceColor.MatchString(a.Secondary) || !appearanceColor.MatchString(a.Accent) {
return fmt.Errorf("invalid appearance: choose a supported form, bounded proportions, and six-digit colors")
}
if a.Version == 1 {
if a.Body != nil {
return fmt.Errorf("legacy appearance cannot include anatomy")
}
return nil
}
b := a.Body
if a.Family != "human" || b == nil || !finiteRange(a.Height, .9, 1.1) || a.Width != 1 || !appearanceColor.MatchString(b.EyeColor) || !slices.Contains([]string{"none", "thin", "bushy"}, b.Eyebrows) || !slices.Contains([]string{"neutral", "smile", "stern"}, b.MouthStyle) || !slices.Contains([]string{"male", "female"}, b.Chest) {
return fmt.Errorf("invalid humanoid anatomy")
}
for _, v := range []float64{b.HeadLength, b.HeadWidth, b.HeadDepth, b.ChestWidth, b.HipsWidth, b.FootSize} {
if !finiteRange(v, .85, 1.15) {
return fmt.Errorf("body proportion outside supported range")
}
}
for _, v := range []float64{b.EyeSpacing, b.ArmWidth, b.LegWidth} {
if !finiteRange(v, .8, 1.2) {
return fmt.Errorf("body width outside supported range")
}
}
if !finiteRange(b.ArmLength, .9, 1.1) || !finiteRange(b.LegLength, .9, 1.1) || !finiteRange(b.NoseScale, .75, 1.25) || !finiteRange(b.EyeHeight, -.035, .035) || !finiteRange(b.NoseHeight, -.035, .035) || !finiteRange(b.MouthHeight, -.025, .025) {
return fmt.Errorf("facial feature or limb outside supported range")
}
return nil
}
func DefaultCharacterAppearance() *Appearance {
return &Appearance{Version: 2, Family: "human", Seed: 42, Height: 1, Width: 1, Detail: .5, Primary: "#c99573", Secondary: "#392b28", Accent: "#456c70", Body: &p.HumanoidBody{
HeadLength: 1, HeadWidth: 1, HeadDepth: 1, EyeSpacing: 1, EyeColor: "#547d75", Eyebrows: "thin", NoseScale: 1, MouthStyle: "neutral", Chest: "male", ChestWidth: 1, HipsWidth: 1, ArmLength: 1, ArmWidth: 1, LegLength: 1, LegWidth: 1, FootSize: 1,
}}
}
func (c Catalog) validateVisuals() error {
if len(c.Visuals) > 1024 {
return fmt.Errorf("visual library is full")
+26
View File
@@ -23,3 +23,29 @@ func TestAppearanceValidation(t *testing.T) {
}
}
}
func TestHumanoidAppearanceBounds(t *testing.T) {
base := DefaultCharacterAppearance()
if err := ValidateAppearance(base, "human"); err != nil {
t.Fatal(err)
}
for _, mutate := range []func(*Appearance){
func(a *Appearance) { a.Body.HeadWidth = math.NaN() },
func(a *Appearance) { a.Body.LegLength = 1.2 },
func(a *Appearance) { a.Body.NoseHeight = .1 },
func(a *Appearance) { a.Body.EyeColor = "red" },
func(a *Appearance) { a.Body.Eyebrows = "unknown" },
func(a *Appearance) { a.Body.Chest = "unknown" },
func(a *Appearance) { a.Body.MouthStyle = "unknown" },
func(a *Appearance) { a.Family = "creature" },
func(a *Appearance) { a.Width = 1.1 },
func(a *Appearance) { a.Body = nil },
func(a *Appearance) { a.Version = 1 },
} {
a := DefaultCharacterAppearance()
mutate(a)
if ValidateAppearance(a, "human", "creature") == nil {
t.Fatal("invalid anatomy accepted", a)
}
}
}
+31 -25
View File
@@ -1,36 +1,42 @@
package game
import (
"aeternalis/server/content"
p "aeternalis/server/internal/protocol"
"encoding/json"
"reflect"
"testing"
)
func TestAppearanceRestartAndReplacement(t *testing.T) {
w, c := fixture(t)
a := p.Appearance{Version: 1, Family: "human", Variant: 1, Seed: 42, Height: 1, Width: 1, Detail: .5, Primary: "#d8a582", Secondary: "#493947", Accent: "#578f8b"}
c.View.Entity.Appearance = &a
raw, err := json.Marshal(w)
if err != nil {
t.Fatal(err)
}
var restored World
if err = json.Unmarshal(raw, &restored); err != nil {
t.Fatal(err)
}
if err = restored.Restore(w.now); err != nil {
t.Fatal(err)
}
life := restored.Characters[c.View.Entity.ID]
if life.View.Entity.Appearance == nil || *life.View.Entity.Appearance != a {
t.Fatal("appearance lost on restart")
}
restored.kill(life, "test replacement")
replacement, err := restored.Join(c.Account, "Replacement")
if err != nil {
t.Fatal(err)
}
if replacement.View.Entity.ID == life.View.Entity.ID || replacement.View.Entity.Appearance != nil {
t.Fatal("replacement inherited prior life's appearance")
for _, a := range []*p.Appearance{
{Version: 1, Family: "human", Variant: 1, Seed: 42, Height: 1, Width: 1, Detail: .5, Primary: "#d8a582", Secondary: "#493947", Accent: "#578f8b"},
content.DefaultCharacterAppearance(),
} {
w, c := fixture(t)
c.View.Entity.Appearance = a
raw, err := json.Marshal(w)
if err != nil {
t.Fatal(err)
}
var restored World
if err = json.Unmarshal(raw, &restored); err != nil {
t.Fatal(err)
}
if err = restored.Restore(w.now); err != nil {
t.Fatal(err)
}
life := restored.Characters[c.View.Entity.ID]
if !reflect.DeepEqual(life.View.Entity.Appearance, a) {
t.Fatal("appearance lost on restart")
}
restored.kill(life, "test replacement")
replacement, err := restored.Join(c.Account, "Replacement")
if err != nil {
t.Fatal(err)
}
if replacement.View.Entity.ID == life.View.Entity.ID || replacement.View.Entity.Appearance != nil {
t.Fatal("replacement inherited prior life's appearance")
}
}
}
+2 -2
View File
@@ -1,7 +1,7 @@
package game
import (
p "aeternalis/server/internal/protocol"
"aeternalis/server/content"
"encoding/json"
"reflect"
"testing"
@@ -153,7 +153,7 @@ func TestCastingInterruptMissAndWeaponUnlock(t *testing.T) {
func TestCorpseRevivalKeepsLootAndDailyBudget(t *testing.T) {
w, c := fixture(t)
appearance := p.Appearance{Version: 1, Family: "human", Variant: 2, Seed: 42, Height: 1, Width: 1, Detail: .5, Primary: "#d8a582", Secondary: "#493947", Accent: "#578f8b"}
appearance := *content.DefaultCharacterAppearance()
c.View.Entity.Appearance = &appearance
rescuer, e := w.Join("rescuer", "Rescuer")
if e != nil {
+33 -10
View File
@@ -115,16 +115,39 @@ type MobDefinition struct {
}
type Appearance struct {
Accent string `json:"accent"`
Detail float64 `json:"detail"`
Family string `json:"family"`
Height float64 `json:"height"`
Primary string `json:"primary"`
Secondary string `json:"secondary"`
Seed int64 `json:"seed"`
Variant int64 `json:"variant"`
Version int64 `json:"version"`
Width float64 `json:"width"`
Accent string `json:"accent"`
Body *HumanoidBody `json:"body,omitempty"`
Detail float64 `json:"detail"`
Family string `json:"family"`
Height float64 `json:"height"`
Primary string `json:"primary"`
Secondary string `json:"secondary"`
Seed int64 `json:"seed"`
Variant int64 `json:"variant"`
Version int64 `json:"version"`
Width float64 `json:"width"`
}
type HumanoidBody struct {
ArmLength float64 `json:"armLength"`
ArmWidth float64 `json:"armWidth"`
Chest string `json:"chest"`
ChestWidth float64 `json:"chestWidth"`
EyeColor string `json:"eyeColor"`
EyeHeight float64 `json:"eyeHeight"`
EyeSpacing float64 `json:"eyeSpacing"`
Eyebrows string `json:"eyebrows"`
FootSize float64 `json:"footSize"`
HeadDepth float64 `json:"headDepth"`
HeadLength float64 `json:"headLength"`
HeadWidth float64 `json:"headWidth"`
HipsWidth float64 `json:"hipsWidth"`
LegLength float64 `json:"legLength"`
LegWidth float64 `json:"legWidth"`
MouthHeight float64 `json:"mouthHeight"`
MouthStyle string `json:"mouthStyle"`
NoseHeight float64 `json:"noseHeight"`
NoseScale float64 `json:"noseScale"`
}
type MobSpawn struct {
+1 -1
View File
@@ -64,7 +64,7 @@ func runTravelTests(t *testing.T, dsn string) {
c.View.Experience = 7
c.View.StatPoints = 20
c.DailySeconds = 123
c.View.Entity.Appearance = &content.Appearance{Version: 1, Family: "human", Variant: 2, Seed: 42, Height: 1, Width: 1, Detail: .5, Primary: "#d8a582", Secondary: "#493947", Accent: "#578f8b"}
c.View.Entity.Appearance = content.DefaultCharacterAppearance()
c.WorldsSurvived = 2
if e = source.AdminItems(c, "grant-item", "spear:1"); e != nil {
t.Fatal(e)
+5 -44
View File
@@ -1,54 +1,15 @@
package transport
import (
"aeternalis/server/content"
p "aeternalis/server/internal/protocol"
"context"
"net/http"
"time"
)
import "net/http"
// Looks are committed together with the name on initial join. Keep the old route
// explicit so a stale client cannot silently offer a free appearance change.
func (h *HTTP) appearanceRoutes(mux *http.ServeMux) {
mux.HandleFunc("POST /api/appearance", func(w http.ResponseWriter, r *http.Request) {
account, err := h.auth.account(r)
if err != nil {
if _, err := h.auth.account(r); err != nil {
fail(w, 401, "sign in required")
return
}
var appearance p.Appearance
if decode(w, r, &appearance) != nil || content.ValidateAppearance(&appearance, "human") != nil {
fail(w, 400, "invalid character appearance")
return
}
h.s.mu.Lock()
defer h.s.mu.Unlock()
if !h.s.ready.Load() {
fail(w, 503, "world unavailable")
return
}
c := h.s.world.ForAccount(account)
if c == nil || (c.View.Entity.State != "alive" && c.View.Entity.State != "eligible") {
fail(w, 409, "no living character in this world")
return
}
ctx, cancel := context.WithTimeout(r.Context(), 5*time.Second)
defer cancel()
active, err := h.auth.db.ActiveCharacter(ctx, account)
if err != nil {
fail(w, 503, "character registry unavailable")
return
}
if active == nil || active.WorldID != h.s.world.ID || active.ID != c.View.Entity.ID || active.State == "transit" {
fail(w, 409, "character belongs to another world or is traveling")
return
}
previous := c.View.Entity.Appearance
c.View.Entity.Appearance = &appearance
if err := h.s.persist(ctx, ""); err != nil {
c.View.Entity.Appearance = previous
fail(w, 503, "appearance could not be saved")
return
}
respond(w, 200, map[string]bool{"saved": true})
fail(w, 403, "appearance can only be chosen when creating a character")
})
}
+20 -8
View File
@@ -9,6 +9,7 @@ import (
"net/http"
"net/http/httptest"
"path/filepath"
"reflect"
"strings"
"testing"
"time"
@@ -28,12 +29,14 @@ func TestCharacterAppearanceOwnershipAndDurability(t *testing.T) {
t.Fatal(err)
}
svc := NewService(world, lease)
a := content.Appearance{Version: 1, Family: "human", Variant: 3, Seed: 42, Height: 1, Width: 1, Detail: .5, Primary: "#d8a582", Secondary: "#493947", Accent: "#578f8b"}
a := *content.DefaultCharacterAppearance()
a.Body.HeadWidth = 1.1
a.Body.Chest = "female"
view, err := svc.join(ctx, "artist", "Artist", "", &a)
if err != nil {
t.Fatal(err)
}
if view.Entity.Appearance == nil || *view.Entity.Appearance != a {
if !reflect.DeepEqual(view.Entity.Appearance, &a) {
t.Fatal("new character appearance missing")
}
other := a
@@ -41,7 +44,7 @@ func TestCharacterAppearanceOwnershipAndDurability(t *testing.T) {
if _, err = svc.join(ctx, "artist", "Artist", "", &other); err != nil {
t.Fatal(err)
}
if *world.ForAccount("artist").View.Entity.Appearance != a {
if !reflect.DeepEqual(world.ForAccount("artist").View.Entity.Appearance, &a) {
t.Fatal("join retry overwrote appearance")
}
auth, _ := NewAuth(ctx, db, true, "http://127.0.0.1", "", "", "")
@@ -72,15 +75,24 @@ func TestCharacterAppearanceOwnershipAndDurability(t *testing.T) {
}
bad := other
bad.Family = "creature"
if request(bad, token, server.URL) != 400 {
if request(bad, token, server.URL) != 403 {
t.Fatal("player could choose creature")
}
before := world.ForAccount("artist").View.Stats["movementSpeed"]
if request(other, token, server.URL) != 200 {
t.Fatal("appearance save rejected")
before := world.ForAccount("artist").View.Stats["moveSpeed"]
if request(other, token, server.URL) != 403 {
t.Fatal("existing character appearance could be changed")
}
record, err := db.ActiveCharacter(ctx, "artist")
if err != nil || *record.Character.View.Entity.Appearance != other || record.Character.View.Stats["movementSpeed"] != before {
if err != nil || !reflect.DeepEqual(record.Character.View.Entity.Appearance, &a) || record.Character.View.Stats["moveSpeed"] != before {
t.Fatal("appearance not durable or changed stats", err)
}
invalid := *content.DefaultCharacterAppearance()
invalid.Body.NoseScale = 200
if _, err := svc.join(ctx, "invalid", "Invalid", "", &invalid); err == nil || world.ForAccount("invalid") != nil {
t.Fatal("invalid initial appearance created a character")
}
plain, err := svc.join(ctx, "plain", "Plain", "")
if err != nil || !reflect.DeepEqual(plain.Entity.Appearance, content.DefaultCharacterAppearance()) {
t.Fatal("creation without customization did not get the default anatomy", err)
}
}
+7
View File
@@ -159,8 +159,15 @@ func (s *Service) join(ctx context.Context, account, name, claim string, appeara
return p.Character{}, err
}
copy := *appearance[0]
if copy.Body != nil {
body := *copy.Body
copy.Body = &body
}
chosen = &copy
}
if existing == nil && chosen == nil {
chosen = content.DefaultCharacterAppearance()
}
if claim != "" {
c, err = s.lease.DB.ReadPassage(ctx, claim, account)
if err != nil {
+59
View File
@@ -0,0 +1,59 @@
import assert from 'node:assert/strict';
import { build } from 'esbuild';
import { mkdir, rm, writeFile } from 'node:fs/promises';
import { pathToFileURL } from 'node:url';
import { resolve } from 'node:path';
import * as T from 'three';
// Geometry-only validation; does not launch browsers or change game state.
const temporary = resolve('.local/humanoid-check.mjs');
await mkdir('.local', { recursive: true });
try {
await build({ entryPoints: ['client/src/appearance-model.ts'], outfile: temporary, bundle: true, platform: 'node', format: 'esm', packages: 'external' });
const { buildAppearance, defaultAppearance, disposeAppearance } = await import(pathToFileURL(temporary));
let topology;
for (const chest of ['male', 'female']) for (const extent of [-1, 0, 1]) {
const a = defaultAppearance(); a.body.chest = chest;
for (const key of ['headLength', 'headWidth', 'headDepth', 'chestWidth', 'hipsWidth', 'footSize']) a.body[key] = 1 + extent * .15;
for (const key of ['armWidth', 'legWidth', 'eyeSpacing']) a.body[key] = 1 + extent * .2;
for (const key of ['armLength', 'legLength']) a.body[key] = 1 + extent * .1;
a.body.eyeHeight = a.body.noseHeight = extent * .035; a.body.mouthHeight = extent * .025;
const root = buildAppearance(a), mesh = root.getObjectByName('humanoid-body');
assert(mesh?.isSkinnedMesh);
const p = mesh.geometry.getAttribute('position'), weights = mesh.geometry.getAttribute('skinWeight');
assert([...p.array].every(Number.isFinite));
const count = [p.count, mesh.geometry.index.count];
if (topology) assert.deepEqual(count, topology); else topology = count;
assert.equal(mesh.skeleton.bones.length, 17);
for (let i = 0; i < weights.count; i++) assert(Math.abs(weights.getX(i) + weights.getY(i) - 1) < 1e-6);
for (const name of ['helmet', 'chest', 'pants', 'weapon', 'offhand', 'cape', 'bag', 'ring1', 'ring8']) assert(root.getObjectByName('equipment:' + name));
const before = new T.Vector3(); mesh.getVertexPosition(100, before);
const leg = root.getObjectByName('left-shin'); leg.rotation.x = .5;
root.updateMatrixWorld(true); mesh.skeleton.update();
let displaced = 0;
for (let i = 0; i < p.count; i++) {
const vertex = mesh.getVertexPosition(i, new T.Vector3());
assert([vertex.x, vertex.y, vertex.z].every(Number.isFinite));
if (vertex.distanceTo(new T.Vector3().fromBufferAttribute(p, i)) > .01) displaced++;
}
assert(displaced > 20, 'joint rotation must actually deform weighted vertices');
disposeAppearance(root);
}
for (const variant of [0, 1, 2, 3]) {
const a = defaultAppearance(); a.variant = variant;
const root = buildAppearance(a); assert(new T.Box3().setFromObject(root).getSize(new T.Vector3()).y > 1.5); disposeAppearance(root);
}
const legacy = { ...defaultAppearance(), version: 1, body: undefined };
const old = buildAppearance(legacy); assert.equal(old.name, 'human-0-v1'); disposeAppearance(old);
if (process.argv.includes('--preview-data')) {
const designs = [];
for (const chest of ['male', 'female']) {
const a = defaultAppearance(); a.body.chest = chest;
const root = buildAppearance(a), mesh = root.getObjectByName('humanoid-body');
designs.push({ chest, positions: [...mesh.geometry.attributes.position.array], colors: [...mesh.geometry.attributes.color.array], indices: [...mesh.geometry.index.array] });
disposeAppearance(root);
}
await writeFile('.local/humanoid-preview.json', JSON.stringify(designs));
}
console.log(`Humanoid bounds, topology, weights, joint deformation, anchors and legacy rendering passed (${topology[0]} vertices, ${topology[1] / 3} triangles).`);
} finally { await rm(temporary, { force: true }); }