Skip to main content

Flag-Based Text Control

Use flags recorded in internal story information (Notes) to toggle the hiding and revealing of theme text. (Ver2.7.0)

By hiding descriptions that are no longer needed or not yet needed according to the story stage from the AI, you can expect to reduce the AI's inference load.

Syntax

Supported tags (nestable):

TagReveal Condition
<flag:NAME>…</flag:NAME>Reveal if flag is truthy
<flag-not:NAME>…</flag-not:NAME>Reveal if flag is falsy / unset
<if:KEY=VALUE>…</if:KEY=VALUE>Reveal if flag value matches exactly
<if-not:KEY=VALUE>…</if-not:KEY=VALUE>Reveal if value does not match
  • flag: / flag-not: tags are dedicated to notes flags; the actual key is automatically prefixed with the indirect prefix flag: like <flag:NAME>notes["flag:NAME"] (corresponds to AI flag notation flag:name).

  • if: / if-not: tags are generic; KEY is matched directly as a notes key.

  • Values that are null (deleted) or non-existent are treated as falsy.

  • You need to instruct the AI: "When condition XX is met, set the flag flag:xxx."

  • This text control becomes effective from the turn after the flag is set.

    • Processing checks the parent node's flag status at generation time.

Notes

  • The AI may not always manage flags correctly. Therefore, it is recommended to design usage that assumes "expected flags may not be set" — specifically, only hide detailed portions that become unnecessary as the story progresses.
  • Since attached file contents change, the AI provider's cache will no longer be used, slightly increasing usage costs.