t1k:unity:tof:core-editor
| Field | Value |
|---|---|
| Module | tof |
| Version | 3.46.8 |
| Effort | medium |
| Tools | — |
Keywords: editor-tooling, inspector, localization-sync, prefab-tools, script-define, theonefeature-core
How to invoke
Section titled “How to invoke”/t1k:unity:tof:core-editorEditor
Section titled “Editor”Scope — this is a candidate index, not an inventory. This skill indexes one source folder. A feature can span
Assets/TheOneFeature/,Packages/com.gdk.*, and siblingAssets/TheOne.*packages, and this skill will only show the folder it was built from. A capability missing here is not evidence that it is absent — verify against source (grep over a stated scope) before concluding anything does not exist. See The1Studio/theonekit-unity#350.
Purpose
Section titled “Purpose”Editor-only tooling for TheOneFeature: the script-define symbol toggle UI (the mechanism that gates
~20 other tof-* asmdefs on/off), prefab import/replace/addressable-repack tools, per-feature
localization key sync modules, and a project-auditor optimizer pass. TheOne.Features.Editor is a
top-level sibling of Core/ and UI/, not nested under either.
Public API
Section titled “Public API”class (namespace TheOne.Features.Editor unless noted)
ScriptDefineToolModule(ScriptDefineToolModule.cs) — the define-symbol toggle UI. Owns the manualDefineSymbolEntrylist (X_FEATURES_TRACKING,X_SPINE,X_LIVES,X_IAP,X_GUILD,X_FRIEND,X_AUTHENTICATION[_FACEBOOK|_APPLE],X_PROFILE,X_LEADERBOARD,X_CLOUDSAVE,X_COMMUNICATION,X_FIRESTORE,X_FACEBOOK_SDK).AddressableRepackToolModule(AddressableRepackToolModule.cs)AutoImportPrefabsToolModule(AutoImportPrefabsToolModule.cs)BoosterLocalizationSyncModule,DailyMissionLocalizationSyncModule,FTUELocalizationSyncModule,NotificationLocalizationSyncModule— per-feature localization key sync, all extendLocalizationSyncModuleBaseLocalizationKeyManagerModule,LocalizationToolModulePrefabAddressableConfig,PrefabImportConfig(config assets for the import/repack tools)PrefabReplacerToolModule(PrefabReplacerToolModule.cs)ProjectAuditorOptimizerToolModule(ProjectAuditorOptimizerToolModule.cs)TimeCheatToolModule(TimeCheatToolModule.cs)CopyAbsolutePathMenuItem(namespaceTheOne.Features.Utilities.Editor)CreatePrefabVariantAtPath(namespaceTheOne.Features.UI.Utilities)TheOneFeaturePrefabToolEditor(namespaceTheOne.PrefabTools.Editor),TheOneFeatureSpriteToolEditor(namespaceEditor)
Signals / Events
Section titled “Signals / Events”None detected.
Config / ScriptableObjects
Section titled “Config / ScriptableObjects”PrefabAddressableConfigPrefabImportConfig
Integration Steps
Section titled “Integration Steps”- Reference package
TheOneFeaturein your project. - Open
ScriptDefineToolModule’s tab (see Hard rules) to enable/disable feature packages. - Prefab/localization sync modules run as on-demand editor tools, not runtime services — no DI registration needed.
Architecture
Section titled “Architecture”19 files at Assets/TheOneFeature/Editor/ (top level) plus a nested Migration/LitMotion/ asmdef.
Two asmdefs: TheOne.Features.Editor and TheOne.Features.Editor.Migration.LitMotion.
Resolved symbol status
Section titled “Resolved symbol status”Every X_* symbol found across Assets/TheOneFeature/** and Packages/** asmdefs, with
how it can be turned on and what it actually gates. Machine-checked (0 unparseable asmdefs;
note these files carry a UTF-8 BOM, so a naive JSON parse silently skips them and under-counts).
This table is about mechanism, not verdict. Whether a given symbol is on is per-project — resolve it yourself with the three-way check in Hard rules. What is stable across projects is which lever exists.
| Symbol | Toggle in ScriptDefineToolModule? | versionDefine provider | asmdefs gated | .cs gated by #if |
|---|---|---|---|---|
X_NATIVE_GALLERY | no | — (none) | 21 | 3 |
X_FIRESTORE | yes | com.google.firebase.firestore | 11 | 1 |
X_GUILD | yes | com.theone.feature.guild.core | 7 | 1 |
X_FIREBASE_AUTH | no | com.google.firebase.auth | 5 | 2 |
X_FIREBASE_CORE | no | com.google.firebase.app | 2 | 0 |
X_FRIEND | yes | — (none) | 2 | 0 |
X_COMMUNICATION | yes | — (none) | 2 | 0 |
X_LIVESHELP | no | com.theone.features.lives.help, …puzzle.ui.lives | 0 | 8 |
X_LOCALIZATION | no | com.unity.localization | 0 | 7 |
X_PROFILE | yes | com.theone.feature.profile.core | 0 | 6 |
X_LIVES | yes | com.theone.features.lives.core | 0 | 5 |
X_AUTHENTICATION_FACEBOOK | yes | — (none) | 0 | 5 |
X_FEATURES_TRACKING | yes | — (none) | 0 | 4 |
X_IAP | yes | — (none) | 0 | 3 |
X_LEADERBOARD | yes | com.theone.feature.leaderboard.core | 0 | 3 |
X_SPINE | yes | com.esotericsoftware.spine.spine-unity | 0 | 2 |
X_AUTHENTICATION_APPLE | yes | — (none) | 0 | 2 |
X_FIREBASE_FUNCTIONS | no | com.google.firebase.functions | 0 | 2 |
X_CLOUDSAVE | yes | — (none) | 0 | 1 |
X_AUTHENTICATION | yes | — (none) | 0 | 0 |
X_FACEBOOK_SDK | yes | — (none) | 0 | 0 |
X_SOCIAL | no | com.theone.feature.friend.core | 0 | 0 |
X_SOFTMASK | no | com.coffee.softmask-for-ugui | 0 | 0 |
X_FEATURES_EDITOR | no | com.theone.feature | 0 | 0 |
X_LITMOTION_MIGRATION_FROM_DOTWEEN | no | com.annulusgames.lit-motion.animation | 0 | 0 |
Three things this table exists to prevent:
- “It’s not in the toggle list, so it isn’t gated.”
X_NATIVE_GALLERYhas no toggle and no provider, yet gates 21 asmdefs — the largest gate in the package. It can only be set by hand in Player Settings. - “It’s not in
ProjectSettings.asset, so it’s off.” AversionDefinesymbol never appears there and is still defined whenever its provider package is installed (X_SPINE,X_LOCALIZATION,X_SOFTMASK). - “0 asmdefs gated, so it doesn’t matter.” Several symbols gate nothing at asmdef level but
gate method bodies via
#ifin source —X_LIVESHELP(8 files),X_LOCALIZATION(7),X_PROFILE(6). The assembly builds; the behaviour silently disappears. That failure mode is harder to notice than a missing type, because nothing fails to compile.
Note the two columns are independent: a symbol can be reachable both ways (X_FIRESTORE,
X_GUILD, X_LIVES, X_SPINE, X_PROFILE, X_LEADERBOARD are in the
toggle list and have a provider package).
Dependencies
Section titled “Dependencies”Not yet documented. This section was never filled in; it is a known gap, not a
statement that the feature has no dependencies. Read the .asmdef next to the source
folder above for the authoritative list.
Last Updated
Section titled “Last Updated”No git history available (submodule may be uninitialized).
Hard rules
Section titled “Hard rules”- Path correction: the source is NOT nested under
Core/—Editor/is a top-level sibling ofCore/andUI/in this package. Verified on disk:Assets/TheOneFeature/Editor/(containsMigration/LitMotion/,README.md,CHANGELOG.md,LOCALIZATION_README.md);Assets/TheOneFeature/Core/Editor/does not exist. ScriptDefineToolModule(ModuleName: "Script Define Symbols Manager") is aToolModuleBasemodule, not a standalone[MenuItem]window — it is hosted inside the larger TheOne Feature editor tool window as one tab among several.- Three kinds of
X_*symbol exist; the toggle list only covers one of them. CheckingProjectSettings.assetalone misclassifies the other two in both directions:Kind Set by Example Appears in scriptingDefineSymbols?Manual, with a toggle ScriptDefineToolModule→PlayerSettings.SetScriptingDefineSymbolsForGroupX_IAP,X_CLOUDSAVEYes, once toggled Manual, no toggle hand-edited Player Settings only X_NATIVE_GALLERYOnly if added by hand Auto versionDefinesasmdef versionDefines, satisfied by the package being installedX_LOCALIZATION,X_SPINE,X_SOFTMASKNo — never listed, yet still defined So: a symbol absent from scriptingDefineSymbolsmay still be live (aversionDefinewhosepackage is installed), and a symbol absent from this module’s toggle list may still **gate real code** ( X_NATIVE_GALLERYgates 21 asmdefs and has no toggle at all). Resolve a symbol bychecking the asmdef defineConstraints/versionDefinesand Player Settings, never one alone. - Toggling a symbol here only rewrites
PlayerSettings.SetScriptingDefineSymbolsForGroup— it does not install the underlying package. versionDefinesare per-assembly, not global — the same symbol name can be defined in one assembly and undefined in another.X_LOCALIZATIONis declared onTheOne.Features.Localization.Corebut not onGameFoundation.Utilities, socom.gdk.core’sLocalizationHelperis inert (GetLocalizationString[Async]returns the raw key; add/remove-listener calls are no-ops) even in a project where localization demonstrably works inside TheOneFeature. Same symbol, opposite verdict, different assembly — so “is X defined?” is only answerable per assembly, never project-wide.- The toggle list is 15 entries, and that is the whole list.
X_FEATURES_TRACKING,X_SPINE,X_LIVES,X_IAP,X_GUILD,X_FRIEND,X_AUTHENTICATION,X_AUTHENTICATION_FACEBOOK,X_AUTHENTICATION_APPLE,X_PROFILE,X_LEADERBOARD,X_CLOUDSAVE,X_COMMUNICATION,X_FIRESTORE,X_FACEBOOK_SDK. Anything else you see in adefineConstraints—X_NATIVE_GALLERY,X_LIVESHELP,X_LOCALIZATION, the threeX_FIREBASE_*— has no toggle and must come from a package or a hand edit. - Dependency validation (
SymbolDependencies) that enforces e.g. “X_AUTHENTICATION_FACEBOOKrequiresX_AUTHENTICATION” lives inPackages/com.gdk.core/Editor/Validator/Utils/ScriptDefineSymbolUtils.cs, a different package — not duplicated here.
References
Section titled “References”- Source:
Assets/TheOneFeature/Editor/ - Define-symbol dependency validator (separate package):
Packages/com.gdk.core/Editor/Validator/Utils/ScriptDefineSymbolUtils.cs