Create Cosmiq accessories and emotes directly in Blockbench.
', + 'Target : Minecraft: Java Edition
', + 'Bring your Minecraft character ideas to life with Cosmiq Creator.
', + '' + description + + '
{{ description }}
touch_appSelect a card, then choose Continue.
', + 'You can name and create the .bbmodel, but export and upload remain disabled.
You can create and save this cape as a .bbmodel now. Runtime export and upload remain disabled.
' + escapeHtml(armWidthBranchSummary(inspection)) + '
', + 'No exports one authored model as universal so it appears on both ' + + 'Wide and Slim players. Yes preserves separate Wide and Slim models.
' + ], + form: { + arm_width_mode: { + label: 'Arm Width Fit', + type: 'select', + options: { + unconfigured: 'Choose an answer', + shared: 'No - use the same model for Wide and Slim', + dependent: 'Yes - use separate Wide and Slim models' + }, + value: inspection.configuredMode + } + }, + buttons: ['Save & Continue', 'Cancel'], + confirmIndex: 0, + cancelIndex: 1, + onConfirm: function (form) { + const selectedMode = normalizeArmWidthMode(form.arm_width_mode); + if (selectedMode === ARM_WIDTH_MODES.UNCONFIGURED) { + Blockbench.showQuickMessage('Choose Yes or No to continue.'); + return false; + } + Project.cosmiq_arm_width_mode = selectedMode; + refreshMetadata(true); + if (typeof onConfigured === 'function') { + setTimeout(onConfigured, 0); + } + return true; + } + }); + activeDialog.show(); + return true; + } + + function emoteActorOptions() { + const count = Math.max( + EMOTE_ACTOR_MIN, + Math.min( + EMOTE_ACTOR_MAX, + Math.floor(Number(Project.cosmiq_emote_actor_count)) || EMOTE_ACTOR_MIN + ) + ); + const options = {}; + for (let actorIndex = 1; actorIndex <= count; actorIndex++) { + options[String(actorIndex)] = 'Actor ' + actorIndex; + } + return options; + } + + function emoteAnimationScopeOptions() { + return { + scene: 'Combined Scene - all actors and Object-Actors', + actor: 'Individual Actor - one numbered player role' + }; + } + + function showAddEmoteAnimationDialog() { + activeDialog = new Dialog('cosmiq_add_emote_animation', { + title: 'Add Emote Animation', + width: 560, + form: { + animation_name: { + label: 'Animation Name', + description: 'A readable editor label. Scope and actor identity are stored separately.', + type: 'text', + value: 'scene.extra' + }, + scope: { + label: 'Animation Scope', + type: 'select', + value: EMOTE_ANIMATION_SCOPES.SCENE, + options: emoteAnimationScopeOptions() + }, + actor_index: { + label: 'Actor Number', + description: 'Used only when Animation Scope is Individual Actor.', + type: 'select', + value: '1', + options: emoteActorOptions() + }, + length_seconds: { + label: 'Duration (seconds)', + type: 'number', + value: 2, + min: 0.05, + max: LIMITS.animationSeconds, + step: 0.05 + }, + loop: { + label: 'Loop Clip', + type: 'checkbox', + value: false + } + }, + onConfirm: function (form) { + const rawName = String(form.animation_name == null ? '' : form.animation_name); + const name = normalizeEmoteDraftName(rawName); + const scope = form.scope; + const actorIndex = Number(form.actor_index); + const lengthSeconds = Number(form.length_seconds); + if (!name || name.length > 64 || containsForbiddenControl(rawName, false)) { + Blockbench.showQuickMessage('Enter a readable animation name up to 64 characters.'); + return false; + } + if (scope !== EMOTE_ANIMATION_SCOPES.SCENE && scope !== EMOTE_ANIMATION_SCOPES.ACTOR) { + Blockbench.showQuickMessage('Choose Combined Scene or Individual Actor.'); + return false; + } + if (scope === EMOTE_ANIMATION_SCOPES.ACTOR && + (!Number.isInteger(actorIndex) || !emoteActorOptions()[String(actorIndex)])) { + Blockbench.showQuickMessage('Choose a valid actor number for this project.'); + return false; + } + if (!Number.isFinite(lengthSeconds) || lengthSeconds < 0.05 || + lengthSeconds > LIMITS.animationSeconds) { + Blockbench.showQuickMessage( + 'Animation duration must be from 0.05 through ' + LIMITS.animationSeconds + ' seconds.' + ); + return false; + } + Undo.initEdit({animations: []}); + const animation = createEmptyEmoteAnimation(name, scope, actorIndex); + animation.length = lengthSeconds; + animation.loop = form.loop === true ? 'loop' : 'once'; + Undo.finishEdit('Add Cosmiq emote animation', {animations: [animation]}); + animation.select(); + refreshMetadata(true); + activeDialog.hide(); + Blockbench.showQuickMessage('Added empty ' + name + ' animation lane.'); + return true; + } + }); + activeDialog.show(); + } + + function showConfigureEmoteAnimationDialog() { + const animation = selectedAnimation(); + if (!animation) { + Blockbench.showQuickMessage('Select an animation first.'); + return; + } + const savedScope = animation.cosmiq_emote_scope === EMOTE_ANIMATION_SCOPES.ACTOR + ? EMOTE_ANIMATION_SCOPES.ACTOR + : EMOTE_ANIMATION_SCOPES.SCENE; + const savedActorIndex = emoteActorOptions()[String(animation.cosmiq_emote_actor_index)] + ? String(animation.cosmiq_emote_actor_index) + : '1'; + activeDialog = new Dialog('cosmiq_configure_emote_animation', { + title: 'Configure Emote Animation', + width: 560, + form: { + animation_name: { + label: 'Animation Name', + description: 'Renaming does not change the stable clip identity.', + type: 'text', + value: animation.name || 'emote.animation' + }, + scope: { + label: 'Animation Scope', + type: 'select', + value: savedScope, + options: emoteAnimationScopeOptions() + }, + actor_index: { + label: 'Actor Number', + description: 'Used only when Animation Scope is Individual Actor.', + type: 'select', + value: savedActorIndex, + options: emoteActorOptions() + } + }, + onConfirm: function (form) { + const rawName = String(form.animation_name == null ? '' : form.animation_name); + const name = normalizeEmoteDraftName(rawName); + const scope = form.scope; + const actorIndex = Number(form.actor_index); + if (!name || name.length > 64 || containsForbiddenControl(rawName, false)) { + Blockbench.showQuickMessage('Enter a readable animation name up to 64 characters.'); + return false; + } + if (scope !== EMOTE_ANIMATION_SCOPES.SCENE && scope !== EMOTE_ANIMATION_SCOPES.ACTOR) { + Blockbench.showQuickMessage('Choose Combined Scene or Individual Actor.'); + return false; + } + if (scope === EMOTE_ANIMATION_SCOPES.ACTOR && + (!Number.isInteger(actorIndex) || !emoteActorOptions()[String(actorIndex)])) { + Blockbench.showQuickMessage('Choose a valid actor number for this project.'); + return false; + } + Undo.initEdit({animations: [animation]}); + animation.name = name; + animation.cosmiq_clip_id = animation.cosmiq_clip_id || runtimeId( + normalizeProjectId(Project.cosmiq_project_id) || 'creator:untitled_emote', + 'animation', + animation.uuid + ); + animation.cosmiq_trigger_kind = 'none'; + animation.cosmiq_trigger = ''; + animation.cosmiq_emote_scope = scope; + animation.cosmiq_emote_actor_index = scope === EMOTE_ANIMATION_SCOPES.ACTOR + ? actorIndex + : 0; + Undo.finishEdit('Configure Cosmiq emote animation', {animations: [animation]}); + refreshMetadata(true); + activeDialog.hide(); + Blockbench.showQuickMessage('Saved ' + name + ' as a ' + + (scope === EMOTE_ANIMATION_SCOPES.SCENE ? 'combined Scene' : 'numbered Actor') + ' clip.'); + return true; + } + }); + activeDialog.show(); + } + + function moveSelectionToAnchorDialog() { + const nodes = selectedOutlinerNodes(); + if (nodes.length === 0) { + Blockbench.showQuickMessage('Select one or more cosmetic groups, cubes, or meshes first.'); + return; + } + if (nodes.some(function (node) { + const role = node.cosmiq_role || ROLES.NONE; + return role === ROLES.EXPORT_ROOT || role === ROLES.MODEL_VARIANT || role === ROLES.STRUCTURE || + role === ROLES.ANCHOR || role === ROLES.REFERENCE_ROOT || + role === ROLES.REFERENCE || role === ROLES.PARTICLE_MARKER || + TEMPLATE_ATTACHMENT_POINTS.some(function (point) { return point.modelGroup === node.name; }); + })) { + Blockbench.showQuickMessage( + 'Reserved Cosmiq attachment, reference, and marker nodes cannot be moved this way.' + ); + return; + } + activeDialog = new Dialog('cosmiq_move_to_anchor', { + title: 'Move Cosmetic To Player Anchor', + width: 480, + form: { + model_variant: { + label: 'Cosmetic Model Type', + type: 'select', + value: 'wide', + options: {wide: 'Wide', slim: 'Slim'} + }, + anchor: { + label: 'Player Anchor Parent', + type: 'select', + value: 'cosmiq:player/torso', + options: anchorOptions() + } + }, + onConfirm: function (form) { + const attachmentPoint = TEMPLATE_ATTACHMENT_POINTS.find(function (point) { + return point.anchorId === form.anchor && ( + point.modelVariant === 'universal' || point.modelVariant === form.model_variant + ); + }); + const attachmentGroup = attachmentPoint && Group.all.find(function (group) { + return group.name === attachmentPoint.modelGroup && + group.cosmiq_role === ROLES.AUTHORING; + }); + if (!attachmentGroup) { + Blockbench.showQuickMessage('That [Model bodypart] attachment group is missing.'); + return false; + } + Undo.initEdit({outliner: true}); + nodes.forEach(function (node) { + node.addTo(attachmentGroup); + }); + Undo.finishEdit('Move accessory to Cosmiq attachment group', {outliner: true}); + refreshMetadata(true); + activeDialog.hide(); + Blockbench.showQuickMessage( + 'Moved selection beneath ' + attachmentPoint.modelGroup + ' (' + attachmentPoint.label + ').' + ); + return true; + } + }); + activeDialog.show(); + } + + function applyLegacyPlayerAnchorNormalization() { + const changes = legacyAnchorNormalizationPlan(collectLiveNodes()); + const byUuid = Object.create(null); + (typeof Group !== 'undefined' && Array.isArray(Group.all) ? Group.all : []).forEach(function (group) { + byUuid[group.uuid] = group; + }); + const applied = []; + changes.forEach(function (change) { + const group = byUuid[change.uuid]; + if (!group) return; + group.cosmiq_role = ROLES.ANCHOR; + group.cosmiq_anchor = change.anchorId; + group.origin = change.origin.slice(); + applied.push(change); + }); + if (applied.length > 0 && typeof Canvas !== 'undefined' && typeof Canvas.updateAll === 'function') { + Canvas.updateAll(); + } + return applied; + } + + function normalizeLegacyPlayerAnchorsAction() { + const changes = legacyAnchorNormalizationPlan(collectLiveNodes()); + if (changes.length === 0) { + Blockbench.showQuickMessage('All player anchors already match the Cosmiq V3 rest pose.'); + return []; + } + Undo.initEdit({outliner: true}); + const applied = applyLegacyPlayerAnchorNormalization(); + Undo.finishEdit('Normalize legacy Cosmiq player anchors', {outliner: true}); + refreshMetadata(true); + Blockbench.showQuickMessage( + 'Normalized ' + applied.length + ' player anchor' + (applied.length === 1 ? '' : 's') + + ' to the Cosmiq V3 rest pose.' + ); + return applied; + } + + + function issueSummary(result) { + const errors = result.issues.filter(function (issue) { return issue.severity === 'error'; }); + const warnings = result.issues.filter(function (issue) { return issue.severity === 'warning'; }); + const info = result.issues.filter(function (issue) { return issue.severity === 'info'; }); + const lines = [ + errors.length + ' error(s), ' + warnings.length + ' warning(s), ' + info.length + ' information message(s).' + ]; + result.issues.slice(0, 24).forEach(function (issue) { + lines.push('[' + issue.severity.toUpperCase() + '] ' + issue.code + ': ' + issue.message); + }); + if (result.issues.length > 24) { + lines.push('...and ' + (result.issues.length - 24) + ' more issue(s).'); + } + if (result.issues.length === 0) { + lines.push('Cosmiq source metadata is internally consistent. Runtime conversion still validates independently.'); + } + return lines.join('\n'); + } + + function showExportBlocked(title, issues) { + Blockbench.showMessageBox({ + title: title, + message: issueSummary({issues: issues}), + buttons: ['OK'] + }); + } + + function packageFileName(category) { + const safeName = String(category || 'cosmiq') + .trim() + .replace(/[<>:"/\\|?*\u0000-\u001f]+/g, '_') + .replace(/[. ]+$/g, '') || 'cosmiq'; + return safeName; + } + + function escapeHtml(value) { + return String(value == null ? '' : value) + .replace(/&/g, '&') + .replace(//g, '>') + .replace(/"/g, '"') + .replace(/'/g, '''); + } + + function packageSnapshot(snapshot) { + const source = snapshot || {}; + const project = source.project || {}; + return Object.assign({}, snapshot, { + project: Object.assign({}, project), + animations: animationsWithPackageContent(source.animations, project.timelineCues) + }); + } + + function uniqueIssues(issues) { + const seen = Object.create(null); + return (Array.isArray(issues) ? issues : []).filter(function (issue) { + if (!issue) return false; + const key = [issue.severity, issue.code, issue.message, issue.sourceUuid || ''].join('|'); + if (seen[key]) return false; + seen[key] = true; + return true; + }); + } + + function unsupportedCreatorInputs(root) { + const entries = []; + const issues = []; + const seenEntries = Object.create(null); + const seenObjects = new Set(); + const pending = [{value: root, location: 'project'}]; + function report(type, location, blocking) { + const safeLocation = boundedCreatorString(location, 160); + const key = type + '|' + safeLocation; + if (seenEntries[key] || entries.length >= 64) return; + seenEntries[key] = true; + entries.push({type: type, location: safeLocation, bundled: false, blocking: blocking !== false}); + if (blocking === false) return; + issues.push(makeIssue( + 'error', + 'COSMIQ_PACKAGE_UNSUPPORTED_' + type.toUpperCase(), + type.replace(/_/g, ' ') + ' input at ' + safeLocation + ' cannot be bundled in a creator package.' + )); + } + while (pending.length > 0 && entries.length < 64) { + const current = pending.pop(); + const value = current.value; + if (!value || typeof value !== 'object' || seenObjects.has(value)) continue; + seenObjects.add(value); + Object.keys(value).forEach(function (key) { + const child = value[key]; + const location = current.location + '.' + key; + const normalizedKey = key.toLowerCase(); + if (PATH_FIELD_NAMES.indexOf(normalizedKey) !== -1 && child != null && child !== '') { + const isEmbeddedPngTexturePath = /(?:^|\.)textures\.\d+\.(?:path|relative_path|source_path)$/i.test(location) && + isEmbeddedPngDataUri(value.source); + const isRootProjectEditorPath = /^project\.(?:bbmodel\.)?(?:path|relative_path|source_path|save_path)$/i.test(location); + if (isEmbeddedPngTexturePath || isRootProjectEditorPath) { + report('editor_path_excluded', location, false); + } else { + report('filesystem_path', location, true); + } + if (/\.(?:ogg|wav|mp3|m4a|flac)$/i.test(String(child))) report('raw_audio', location, true); + if (/\.gif$/i.test(String(child))) report('gif', location, true); + } + if (typeof child === 'string') { + if (/^data:image\/gif/i.test(child) || /\.gif(?:$|[?#])/i.test(child)) report('gif', location, true); + const canonicalEmbeddedOgg = /\.embeddedOgg$/i.test(location) && + /^data:audio\/ogg;base64,[A-Za-z0-9+/]*={0,2}$/.test(child); + if (!canonicalEmbeddedOgg && ( + /^data:audio\//i.test(child) || /\.(?:ogg|wav|mp3|m4a|flac)(?:$|[?#])/i.test(child) + )) { + report('raw_audio', location, true); + } + if (/^(?:https?:|file:|blob:)/i.test(child)) report('remote_url', location, true); + } else if (child && typeof child === 'object') { + pending.push({value: child, location: location}); + } + }); + } + return {entries: entries, issues: issues}; + } + + function buildExportInventory(snapshot, manifest, bbmodel, sourceResult, issues, rawProject) { + const source = snapshot || {}; + const project = source.project || {}; + const metadata = bbmodel && bbmodel.cosmiq && typeof bbmodel.cosmiq === 'object' + ? bbmodel.cosmiq + : ((sourceResult && sourceResult.metadata) || {}); + const packagedAnimations = Array.isArray(bbmodel && bbmodel.animations) ? bbmodel.animations : []; + const snapshotAnimations = Array.isArray(source.animations) ? source.animations : []; + const packagedIds = Object.create(null); + const snapshotById = Object.create(null); + snapshotAnimations.forEach(function (animation) { + if (animation && animation.uuid) snapshotById[animation.uuid] = animation; + }); + packagedAnimations.forEach(function (animation) { + if (animation && animation.uuid) packagedIds[animation.uuid] = true; + }); + const bindingMap = metadata.animationBindings && typeof metadata.animationBindings === 'object' + ? metadata.animationBindings + : {}; + const animations = packagedAnimations.map(function (animation) { + const snapshotAnimation = snapshotById[animation.uuid] || {}; + const binding = bindingMap[animation.uuid] || {}; + const markers = collectTimelineMarkers(animation.markers || binding.markers); + const lengthSeconds = numberOrDefault( + snapshotAnimation.lengthSeconds, + numberOrDefault(animation.length, numberOrDefault(binding.durationMs, 0) / 1000) + ); + return { + uuid: animation.uuid || '', + name: animation.name || binding.sourceName || snapshotAnimation.name || 'Unnamed animation', + scope: binding.scope || snapshotAnimation.emoteScope || null, + actorIndex: binding.actorIndex == null ? null : binding.actorIndex, + durationMs: Math.max(0, Math.round(lengthSeconds * 1000)), + keyframeCount: animationKeyframeCount(animation), + markers: markers + }; + }); + const markers = []; + animations.forEach(function (animation) { + animation.markers.forEach(function (marker) { + markers.push(Object.assign({ + animationUuid: animation.uuid, + animationName: animation.name + }, marker)); + }); + }); + + const nodeBindings = metadata.nodeBindings && typeof metadata.nodeBindings === 'object' + ? metadata.nodeBindings + : {}; + const cosmeticNodes = []; + const playerBones = []; + const objectActorNodes = []; + Object.keys(nodeBindings).forEach(function (uuid) { + const binding = nodeBindings[uuid] || {}; + const item = { + uuid: uuid, + name: binding.sourceName || uuid, + role: binding.role || '', + modelVariant: binding.modelVariant || '', + hasGeometry: binding.hasGeometry === true, + actorIndex: binding.actorIndex == null ? null : binding.actorIndex + }; + if (manifest && (manifest.assetKind === 'accessory' || manifest.assetKind === 'cape')) { + cosmeticNodes.push(item); + } + if (binding.role === ROLES.PLAYER_BONE) playerBones.push(item); + if (binding.role === ROLES.OBJECT_ACTOR_NODE) objectActorNodes.push(item); + }); + const geometryObjects = (Array.isArray(source.nodes) ? source.nodes : []).filter(function (node) { + return node && node.export !== false && (node.type === 'cube' || node.type === 'mesh') && + node.role !== ROLES.REFERENCE && node.role !== ROLES.PARTICLE_EFFECT_LOCATOR && + node.role !== ROLES.SOUND_EFFECT_LOCATOR; + }).map(function (node) { + return { + uuid: node.uuid || '', + name: node.name || node.uuid || 'Geometry', + type: node.type, + role: node.role || '', + actorIndex: Number(node.actorIndex) || null, + modelVariant: node.modelVariant || '' + }; + }); + + const textureRoleById = Object.create(null); + (Array.isArray(source.textures) ? source.textures : []).forEach(function (texture) { + if (texture && texture.uuid) textureRoleById[texture.uuid] = texture.role; + }); + const runtimePngs = []; + const referencePngs = []; + (Array.isArray(bbmodel && bbmodel.textures) ? bbmodel.textures : []).forEach(function (texture) { + const record = { + uuid: texture && texture.uuid || '', + name: texture && texture.name || 'texture.png', + embeddedPng: !!(texture && isEmbeddedPngDataUri(texture.source)), + bundled: true + }; + const role = texture && (texture.cosmiq_role || texture.role) || textureRoleById[record.uuid]; + (role === ROLES.REFERENCE ? referencePngs : runtimePngs).push(record); + }); + + const resources = Array.isArray(metadata.resourceReferences) ? metadata.resourceReferences.slice() : []; + const cues = Array.isArray(metadata.timelineCues) ? metadata.timelineCues.slice() : []; + const particleResources = resources.filter(function (resource) { + return isParticleResource(resource); + }); + const soundResources = resources.filter(function (resource) { + return resource && resource.type === RESOURCE_TYPES.SOUND; + }); + const particleCues = cues.filter(function (cue) { return cue && cue.type === CUE_TYPES.PARTICLE; }); + const soundCues = cues.filter(function (cue) { return cue && cue.type === CUE_TYPES.SOUND; }); + const comments = cues.filter(function (cue) { return cue && cue.type === CUE_TYPES.COMMENT; }); + const effectLocators = Object.keys(metadata.effectLocatorBindings || {}).map(function (uuid) { + return Object.assign({uuid: uuid}, metadata.effectLocatorBindings[uuid]); + }); + const unresolved = resources.filter(function (resource) { + return !resource || + (resource.type === RESOURCE_TYPES.SOUND + ? !resource.embeddedOgg + : !isParticleResource(resource)); + }).map(function (resource) { + return { + type: 'resource', + id: resource && resource.id || '', + name: resource && resource.displayName || 'Unnamed resource', + reason: resource && resource.type === RESOURCE_TYPES.SOUND + ? 'embedded Ogg Vorbis data is missing' + : 'resource declaration is incomplete' + }; + }); + cues.forEach(function (cue) { + if (cue && cue.atMs == null) { + unresolved.push({ + type: 'cue', + id: cue.id || '', + name: cue.markerName || cue.id || 'Unnamed cue', + reason: 'marker timestamp unresolved' + }); + } + }); + const inputResult = unsupportedCreatorInputs(rawProject || {}); + const inputEntries = inputResult.entries; + const unsupported = inputEntries.filter(function (entry) { return entry.blocking !== false; }); + const excludedInputs = inputEntries.filter(function (entry) { return entry.blocking === false; }); + const actors = Array.isArray(metadata.actors) ? metadata.actors.slice() : []; + const objectActors = metadata.props && Array.isArray(metadata.props.objectActors) + ? metadata.props.objectActors.slice() + : []; + const omittedAnimations = snapshotAnimations.filter(function (animation) { + return animation && !packagedIds[animation.uuid]; + }).map(function (animation) { + return { + uuid: animation.uuid || '', + name: animation.name || 'Unnamed animation', + reason: 'empty: no keyframes' + }; + }); + const wideNodes = cosmeticNodes.filter(function (node) { return node.modelVariant === 'wide'; }); + const slimNodes = cosmeticNodes.filter(function (node) { return node.modelVariant === 'slim'; }); + const universalNodes = cosmeticNodes.filter(function (node) { + return node.modelVariant !== 'wide' && node.modelVariant !== 'slim'; + }); + return { + kind: manifest && manifest.assetKind || project.kind || PROJECT_KINDS.COSMETIC, + draft: false, + runtimeExportReady: true, + cosmeticNodes: cosmeticNodes, + wideNodes: wideNodes, + slimNodes: slimNodes, + universalNodes: universalNodes, + actors: actors, + playerBones: playerBones, + objectActors: objectActors, + objectActorNodes: objectActorNodes, + geometryObjects: geometryObjects, + runtimePngs: runtimePngs, + referencePngs: referencePngs, + animations: animations, + markers: markers, + particleResources: particleResources, + soundResources: soundResources, + particleCues: particleCues, + soundCues: soundCues, + comments: comments, + effectLocators: effectLocators, + unresolved: unresolved, + unsupported: unsupported, + excludedInputs: excludedInputs, + unsupportedMedia: Array.isArray(metadata.unsupportedMedia) ? metadata.unsupportedMedia.slice() : [], + omittedAnimations: omittedAnimations, + issues: uniqueIssues((Array.isArray(issues) ? issues : []).concat(inputResult.issues)), + counts: { + geometryObjects: geometryObjects.length, + runtimePngs: runtimePngs.length, + referencePngs: referencePngs.length, + animations: animations.length, + markers: markers.length, + particleCues: particleCues.length, + soundCues: soundCues.length, + comments: comments.length + } + }; + } + + function buildCreatorExportCandidate(snapshot, rawProject) { + const packagedSnapshot = packageSnapshot(snapshot || {}); + const requestedKind = packagedSnapshot.project && packagedSnapshot.project.kind; + const kind = requestedKind; + const validKind = [ + PROJECT_KINDS.COSMETIC, + PROJECT_KINDS.EMOTE, + PROJECT_KINDS.CAPE + ].indexOf(kind) !== -1; + const sourceResult = !validKind + ? { + metadata: {}, + issues: [makeIssue( + 'error', + 'COSMIQ_PACKAGE_KIND', + 'Project kind must be explicitly cosmetic, cape, or emote.' + )] + } + : kind === PROJECT_KINDS.EMOTE + ? buildEmoteSourceMetadata(packagedSnapshot) + : kind === PROJECT_KINDS.CAPE + ? buildCapeSourceMetadata(packagedSnapshot) + : buildSourceMetadata(packagedSnapshot); + const rawInput = rawProject && typeof rawProject === 'object' ? rawProject : null; + const preparationIssues = []; + let editableProject = null; + if (!rawInput) { + preparationIssues.push(makeIssue( + 'error', + 'COSMIQ_PACKAGE_BBMODEL_TYPE', + 'Blockbench did not provide an editable project to normalize.' + )); + } else { + try { + editableProject = JSON.parse(JSON.stringify(rawInput)); + editableProject.cosmiq = JSON.parse(JSON.stringify(sourceResult.metadata)); + normalizePackagedNodeVisibility( + editableProject, + sourceResult.metadata.nodeBindings + ); + } catch (error) { + preparationIssues.push(makeIssue( + 'error', + 'COSMIQ_PACKAGE_BBMODEL_JSON', + 'Blockbench could not serialize the editable project.' + )); + } + } + let packageIssues = uniqueIssues([].concat(sourceResult.issues || []).concat(preparationIssues)); + if (kind === PROJECT_KINDS.CAPE) { + packageIssues = uniqueIssues(packageIssues.concat([makeIssue( + 'error', + 'COSMIQ_CAPE_COMING_SOON', + '[COMING SOON] Cape .bbmodel package export and upload are not available yet. ' + + 'You can keep authoring and save the .bbmodel locally.' + )])); + } + let compiled = null; + let packageContent = null; + if (editableProject && !packageIssues.some(function (issue) { return issue.severity === 'error'; })) { + try { + packageContent = encodeCosmiqBbmodel(editableProject); + } catch (error) { + packageIssues.push(makeIssue( + 'error', + error && error.code ? error.code : 'COSMIQ_PACKAGE_ENCODE', + error && error.message ? error.message : 'Exact V3 .bbmodel validation failed.' + )); + } + try { + compiled = compileBlockbenchCosmiqPackage(packagedSnapshot, editableProject); + } catch (error) { + packageIssues.push(makeIssue( + 'info', + 'COSMIQ_LEGACY_REVIEW_PROJECTION', + 'The retired V2 review projection could not be generated and was ignored: ' + + (error && error.message ? error.message : 'unknown projection error') + )); + } + packageIssues = uniqueIssues(packageIssues); + } + const manifest = compiled ? compiled.manifest : cosmiqBaseManifest( + kind === PROJECT_KINDS.CAPE || kind === PROJECT_KINDS.EMOTE ? kind : 'accessory' + ); + const inventory = buildExportInventory( + packagedSnapshot, + manifest, + editableProject, + sourceResult, + packageIssues, + {snapshot: snapshot, bbmodel: rawInput} + ); + return { + kind: kind, + assetKind: manifest.assetKind, + draft: false, + runtimeExportReady: kind !== PROJECT_KINDS.CAPE, + filename: packageFileName(manifest.assetKind), + manifest: manifest, + bbmodel: editableProject, + snapshot: packagedSnapshot, + sourceResult: sourceResult, + inventory: inventory, + issues: packageIssues, + content: packageContent + }; + } + + function cosmeticExportSummary(snapshot) { + const packaged = packageSnapshot(snapshot); + const sourceResult = buildSourceMetadata(packaged); + const bindings = sourceResult.metadata.nodeBindings || {}; + const geometry = {wide: 0, slim: 0}; + Object.keys(bindings).forEach(function (uuid) { + const binding = bindings[uuid]; + if (binding && binding.hasGeometry && (binding.modelVariant === 'wide' || binding.modelVariant === 'slim')) { + geometry[binding.modelVariant]++; + } + }); + return { + snapshot: packaged, + sourceResult: sourceResult, + wideGeometry: geometry.wide, + slimGeometry: geometry.slim, + animations: packaged.animations.map(function (animation) { + return { + uuid: animation.uuid, + name: animation.name, + keyframeCount: animationKeyframeCount(animation) + }; + }), + omittedEmptyAnimations: Math.max(0, snapshot.animations.length - packaged.animations.length) + }; + } + + function boundedReviewList(items, renderItem, emptyMessage) { + const records = Array.isArray(items) ? items : []; + if (records.length === 0) { + return '' + escapeHtml(emptyMessage || 'None') + '
'; + } + const visible = records.slice(0, 80); + const remainder = records.length - visible.length; + return '' + + reviewText(cape.frameWidth || '?') + ' x ' + reviewText(cape.frameHeight || '?') + + ' per frame · ' + Number(cape.frameCount || 0) + ' frame(s)
{{ description }}
', + primaryVisual, + candidate.kind === PROJECT_KINDS.CAPE ? '' : + ' Animation detected automatically: ' + + animationMode + '', + '{{ copyStatus }}
', + 'Normalized package: canonical cosmiq.package.v2 content; ' + + 'editable Blockbench source is not embedded.
'; + const categoryLabel = candidate.manifest.assetKind === CATEGORIES.ACCESSORY + ? 'Accessories' + : candidate.manifest.assetKind === CATEGORIES.EMOTE + ? 'Emotes' + : 'Capes'; + const classification = 'Title, description, price, discovery tags, and the generated thumbnail remain outside the package.
'; + const projectContent = candidate.kind === PROJECT_KINDS.EMOTE + ? 'Wide: ' + inventory.wideNodes.length + ' · Slim: ' + inventory.slimNodes.length + + ' · Universal/shared: ' + inventory.universalNodes.length + '
' + + boundedReviewList(inventory.cosmeticNodes, function (node) { + return reviewText(node.name) + ' — ' + reviewText(node.modelVariant || 'shared') + + (node.hasGeometry ? ' (geometry)' : ''); + }, 'No cosmetic nodes included.'); + const animationRows = boundedReviewList(inventory.animations, function (animation) { + const scope = animation.scope ? ' — ' + reviewText(animation.scope) : ''; + const actor = animation.actorIndex ? ' Actor ' + Number(animation.actorIndex) : ''; + return '' + reviewText(animation.name) + '' + scope + actor + ' — ' + + Number(animation.durationMs) + ' ms, ' + Number(animation.keyframeCount) + ' keyframe(s), ' + + animation.markers.length + ' marker(s)'; + }, 'No authored animation content is included.'); + const markerRows = boundedReviewList(inventory.markers, function (marker) { + return '' + reviewText(marker.name || '(unnamed)') + ' in ' + + reviewText(marker.animationName) + ' at ' + + (marker.atMs == null ? 'unresolved' : Number(marker.atMs) + ' ms'); + }, 'No timeline markers included.'); + const resourceRow = function (resource) { + return reviewText(resource.displayName || resource.id) + ' — ' + + reviewText(resource.type === RESOURCE_TYPES.SOUND + ? 'embedded Ogg Vorbis' + : resource.assetRef || 'authored particle effect'); + }; + const cueRow = function (cue) { + return reviewText(cue.id || cue.markerName) + ' — ' + reviewText(cue.markerName) + ' at ' + + (cue.atMs == null ? 'unresolved' : Number(cue.atMs) + ' ms') + + (cue.endAtMs == null ? '' : ' through ' + Number(cue.endAtMs) + ' ms'); + }; + const issueRows = boundedReviewList(candidate.issues, function (issue) { + return '' + reviewText(String(issue.severity || '').toUpperCase(), 16) + ' ' + + reviewText(issue.code, 96) + ': ' + reviewText(issue.message, 512); + }, 'No validation issues.'); + return '' + errors.length + ' error(s), ' + warnings.length + ' warning(s).
' + issueRows + + '