Log inGet started
World

Builtin Library

Branchmain
Branchesmainpublish
Commite8beb5604c

README.md

world_vcs.sceneEdits

The live scene edits the world's publication calls are judged on. A live-edited scene journals its runtime delta into a <name>.scene/scene_dirty/ overlay; the scene saver (assetTypes.scene.shared.saver) answers which of the overlay's edits the saved scene.json does not carry.

  • isSceneDirtyPath(path), sceneFolderForDirtyPath(path) and sceneFolderForScenePath(path) place a path relative to a scene and its overlay.
  • flushSceneMarks() drains the engine's pending save marks into each scene's overlay.
  • dirtyOverlayScenes(scope?) answers each scene (of scope, or the whole source tree) whose overlay holds edits its saved file does not carry, with those edits.
  • noticeSceneEditsLeftOut(verb, scenes) posts the notice naming the live edits a call left out of what it recorded.
  • unbakedSceneEditsMessage(verb, scenes) answers the refusal a call raises over those scenes, or nil for none.
  • SCENE_EDIT_KEEP names the calls that write a scene's pending edits into its scene.json.
local SceneEdits = require("modules.world_vcs.sceneEdits")
SceneEdits.flushSceneMarks()
for _, scene in ipairs(SceneEdits.dirtyOverlayScenes()) do print(scene.path, #scene.edits) end