Log inGet started
Package

makeAFilm.workflow

README.md

makeAFilm

A runnable workflow that makes a film of a Zero world with filmRig, one stage at a time. Each stage is one agent's whole job: it is told what to produce, which filmRig names to use, and how to prove the stage is done before it answers. The run carries the shot list, the film module's name and what each stage reported into the next stage, so nobody has to hold the whole film in mind.

Stages

  1. Shot list: pick the landmarks, give each an entity name, write the shots (what we see, how long, the move).
  2. Film module: write film/trailer.module/init.luau with Film.cutscene({...}), real moves and lenses.
  3. Transitions and titles: a film-wide transition, per-shot overrides, title cards in film time.
  4. Events: events = { { t, event, data } } and a cues module whose Film.on handlers stay local.
  5. Look, frame and music: look, frame, lens, quality, music / musicVolume, fades.
  6. FilmDirector: entity.spawn("Director").component.add("filmRig.FilmDirector", { film = "film.trailer" }) in the scene's build.luau inside content(); a brand-new world uses its starter scene scenes.main (or, with no scene at all, gets one at that name and opens it with zero scene load scenes.main).
  7. Review: play, cutscene seek / pause each shot, capture with source = "main", fix framing.
  8. After and multiplayer: after / afterOptions / replayButton, and a check that nothing about the film is replicated.
  9. Record: require("@builtin::modules.api.editor.recording").start({ cadence = "frame", ... }), then zero zeromind setMedia to put the take on the world page.

Starting it

zero workflow start --name makeAFilm --args '{"subject":"a 40-second golden-hour trailer of my harbour town"}'

or from Luau tools.use("workflow", "start", { name = "makeAFilm", args = { subject = "...", seconds = 40 } }). Then take each request with zero workflow next --runner <you> and hand back the result with zero workflow answer --request <id> --value '<json>'. zero workflow status shows the stage.

Args (all optional): subject (what the film is of, in the asker's words), film (module name, default film.trailer), seconds (target length, default 45), record (false skips stage 9).

It needs filmRig installed in the world. The run answers with the film module's name, its shots, the scene it plays in, the review notes and the recorded take. Every option the stages name is listed in full in filmRig's README and the guide "How to make a trailer, cinematic or intro film of my world"; the same stages are written out as prose in "Workflow: make a film step by step".