Skip to content

t1k:unity:base:text-config

FieldValue
Modulebase
Version5.116.6
Efforthigh
Tools—

Keywords: configuration, localization, text config

/t1k:unity:base:text-config

Enables autonomous editing of Unity configuration files as text (JSON/YAML), then refreshing Unity to apply changes without using the GUI.

FileEdit?MethodRefresh
.asmdef✅ SafeJSON text editt1k unity refresh
manifest.json✅ SafeJSON text editEditor restart only
ProjectSettings/Packages/*/Settings.json✅ SafeJSON text editt1k unity refresh
ProjectSettings *.asset⚠️ LimitedYAML simple values onlyt1k unity refresh
.prefab⚠️ LimitedYAML simple values onlyt1k unity refresh
.asset (ScriptableObject)⚠️ ModerateYAML simple values onlyt1k unity refresh
.unity scene❌ NeverUse EditorSceneManager APIN/A
NavMesh.asset❌ NeverRegenerate (rebake)N/A
LightingData.asset❌ NeverRegenerate (rebake)N/A

Edit references, platform filters, define constraints.

{
"name": "MyAssembly",
"references": ["Unity.Entities", "OtherAssembly"],
"includePlatforms": ["Editor"],
"autoReferenced": true,
"defineConstraints": ["UNITY_INCLUDE_TESTS"]
}

After edit: call t1k unity refresh.

Edit dependencies and overrides sections.

{ "dependencies": { "com.unity.textmeshpro": "3.2.0" } }

After edit: Editor restart required — t1k unity refresh does NOT trigger Package Manager reload. Never pin com.unity.entities/com.unity.entities.graphics/com.unity.physics/com.unity.collections — since Unity 6000.5 these are builtin packages whose version is the editor’s; the registry still carries only the abandoned legacy 1.x line, and pinning it is a downgrade (see references/hard-rules-guide.md G2).

Located at ProjectSettings/Packages/<package-name>/Settings.json.

{
"m_Dictionary": [
{ "type": "System.String, mscorlib", "key": "m_EnableCodeCoverage", "value": "true" }
]
}

After edit: call t1k unity refresh.

Tier 2 — YAML (Limited, Risky for References)

Section titled “Tier 2 — YAML (Limited, Risky for References)”

Before editing any YAML file, verify it is text format:

  • Check header: %YAML 1.1 = text-serialized, safe to attempt
  • Binary header = do not edit

Safe YAML edits: primitive values only (int, float, string, bool, enum int).

# ProjectSettings/TimeManager.asset
TimeManager:
Fixed Timestep: 0.02 # safe: simple float
m_TimeScale: 1 # safe: simple int
# ScriptableObject .asset
MonoBehaviour:
MaxHealth: 100 # safe: primitive int
Speed: 5.5 # safe: primitive float
TeamColor: 1 # safe: enum as int

After any YAML edit: call t1k unity refresh.

Never touch in YAML: fileID, guid, m_Script, any {fileID: ..., guid: ...} reference block.

Files: NavMesh.asset, LightingData.asset, any .asset with [PreferBinarySerialization], .fbx, .png.

To modify: regenerate via Editor API (rebake NavMesh, rebake lighting).

MethodWhen to Use
t1k unity refreshAfter JSON or YAML text edits
AssetDatabase.ImportAsset(path)Single-asset surgical refresh (faster)
AssetDatabase.ForceReserializeAssets(paths)After Asset Serialization Mode change
Editor restartOnly for manifest.json — Package Manager requires restart
TaskUse Instead
Modify prefab componentsPrefabUtility.LoadPrefabContents() + C# + SaveAsPrefabAsset()
Modify scene objectsEditorSceneManager API
Modify ProjectSettingsSerializedObject API (load asset, find property, apply)
Modify ScriptableObjectAssetDatabase.LoadAssetAtPath<T>() + SerializedObject

→ See references/hard-rules-guide.md for critical failure modes

FileContent
references/hard-rules-guide.mdFileID fragility, manifest refresh failure, binary detection, scene editing danger