OBSIDREL / DOCS

Documentation

Guides, tutorials and technical references for the Obsidrel ecosystem.

DocumentationFind and fix project issues with Project Health

Find and fix project issues with Project Health

Project Health scans the project's recognized YAML definitions and resource references. Use it after creating, importing, editing or restoring content, especially before exporting a project. A clean scan is useful but not proof of Minecraft runtime compatibility.

Inspect a project

  1. Open the intended project and choose Project Health in the sidebar.
  2. Select Diagnostics, refresh the scan, and read the counts for files, definitions, errors and warnings.
  3. Filter by category, severity or search term to find the affected YAML file and resource ID.
  4. Fix malformed YAML, duplicate IDs and broken references in the appropriate editor; save with backup.
  5. Run the scan again. If the scan is marked Partial or Truncated, repair access or reduce the project before trusting the result.

Common problems

  • Invalid YAML: reopen the original file, check indentation and type-specific fields; use Advanced YAML with a backup.
  • Duplicate definition or import target: rename or archive the duplicate deliberately; update references from recipes, actions and menus.
  • Missing model/texture: inspect pack/source/assets/namespace/, including the JSON model's parent and texture paths. Run Assets → Verify models & textures.
  • Importer warnings: a Partial conversion can be structurally valid but lack a gameplay mechanic; consult the provider-specific report.
  • Conflict while saving: another editor changed the source. Reload and compare instead of overwriting.
  • Exported content behaves differently in Minecraft: confirm Core version, materials, dependencies and generated resource pack; Studio diagnostics cannot execute a server.

Recovery

Use History to preview backups or archived definitions and restore one deliberately. Restoring an individual YAML file is not the same as undeleting a Cloud project. Preserve the current source before recovery.

See Backup and conflicts, Importers and Pack not loading.

Was this article helpful?Loading ratings…

Help us improve Obsidrel documentation. One vote per account and article. Discord AI feedback can also contribute when the answer cites this article.