Summary

Since 2.19.3, registering an ES6 script class without an explicit name and referencing it by the class name stopped working — the script silently fails to attach. Reported by a user with "hundreds of scripts" extending pc.ScriptType and registered via pc.registerScript(Class).

Root cause

#8831 changed the name registerScript/createScript derive when no explicit name is given:

// before (≤ 2.19.2): verbatim class name → "PlayerController"
name = name || script.__name || ScriptType.__getScriptName(script);
// after (2.19.3, #8831): lowerCamelCase → "playerController"
name = name || getScriptRegistryName(script);

The registry is keyed by that name, so an entity referencing the script as PlayerController no longer resolves it. Passing an explicit name works, but that's painful across hundreds of scripts.

Fix

Restore the verbatim class-name fallback in registerScript only:

name = name ||
    (Object.prototype.hasOwnProperty.call(script, '__name') && script.__name) ||
    getScriptName(script); // own scriptName, else verbatim class name

• Own-property only, so Fix ESM script registration by name and subclass name collision #8831's two real fixes are preserved: the ESM static scriptName class-field case and the subclass-name-collision case.
• Scoped to registerScript. ScriptComponent.create, ScriptRegistry.add and the asset loader still use the lowerCamelCase getScriptRegistryName. The editor and asset pipeline always pass an explicit name, so they're unaffected — only code-driven nameless registerScript(Class) changes (the regressed path).

This was chosen over a dual-name alias (previous draft, #8840) to avoid the long-term maintenance cost and edge cases of registering each script under two names.

Note on create(Class)

create() is unchanged. For the register-then-reference flow it stays consistent: registerScript(Class) sets __name to the verbatim name, and create() reuses an existing own __name rather than recomputing. lowerCamelCase derivation in create(Class) only applies to a class that was never registered — long-standing behavior.

Tests

• Updated the two tests that asserted the lowerCamelCase fallback to assert verbatim.
• Added a regression test: registerScript(class PlayerController) → entity.script.create('PlayerController') attaches the instance.
• Full suite: 1749 passing.

🤖 Generated with Claude Code