Production tools

Two subcommands help with pictures. Neither is needed to make or play a game, and neither contacts a service, downloads a model, or changes your original images.

gozen art prompt #

You describe the words once, in layers (setting, subject, lighting, …), with IDs, defaults, dependencies, conflicts, priorities and emphasis. gozen art prompt picks the items for a scene, merges duplicates, resolves conflicts, applies the limits, and prints the text. The JSON output records where every word came from, so a surprising word can be traced to its item.

gozen art prompt --config catalog.yaml --scene landscape --format json
gozen art prompt --config catalog.yaml --plan plan.yaml           # a plan holds only item IDs
gozen art prompt -c catalog.yaml --setting studio                 # choose an item of a layer by hand
gozen art prompt -c catalog.yaml --scenes ids.txt --format json   # many scenes, one JSON line each
gozen art prompt lint --config catalog.yaml                       # check every item, dependency and scene

A catalog, abridged from docs/examples/production/catalog.yaml:

version: 1
dialect: sdxl
emphasis: [soft, normal, strong, stronger, strongest]
default_emphasis: normal
priorities: {required: 0, subject: 1, detail: 2}
negative_limit: 2
layers:
  - id: setting
    defaults: [garden]
    items:
      garden:
        positive:
          - {word: quiet garden, priority: subject}
          - {word: soft light, priority: detail}
      studio:
        positive:
          - {word: plain backdrop, priority: subject}
        conflicts: [{layer: subject, id: traveler}]
  - id: subject
    person: true
    max: 1
    items:
      traveler:
        positive:
          - {word: traveler, priority: subject, emphasis: strongest}
        requires: [{layer: setting, id: garden}]
scenes:
  landscape: {select: {setting: [garden]}}
  portrait: {select: {setting: [garden], subject: [traveler]}}

• Emphasis has five steps, 0.9 to 1.5, in SDXL weight syntax. The token count is an estimate, not the model’s tokenizer.
• Unknown fields, several YAML documents in one file, broken references and control characters are rejected.
• When a catalog selects a person layer, the tool adds its own fixed age constraints. A catalog cannot replace or drop them.
• lint fails on errors and passes on warnings alone.

The output is text. Send it to any generator you like; gozen art prompt never does.

gozen art mosaic #

The main use is to pixelate adult-oriented anime-style images distributed in Japan, following the distribution standard. Swap the model and its classes and it also serves other uses, such as anonymizing faces.

gozen art mosaic pixelates regions of the images in <game-dir>/assets/ and writes the results and a report.json outside assets/. The originals are never changed. Regions come from three places, which can be combined:

• a fix file (--fix) written by hand, which needs no model;
• gozen art mosaic manual, which edits a per-image instruction file by coordinates;
• a detection model (--model), optionally with face detection (--face), segmentation masks (--seg) and a tagger (--tagger).

gozen art mosaic auto --fix fixes.yaml -o processed game pattern.png              # hand-written regions, no model
gozen art mosaic auto --model model.onnx --ort libonnxruntime.so -o processed game   # detect every referenced image
gozen art mosaic inspect --fix fixes.yaml -o processed game pattern.png           # report, write nothing
gozen art mosaic manual skip --manual edits.yaml game pattern.png                 # only regions drawn by hand: no model
gozen art mosaic manual add --manual edits.yaml --rect 8,8,6,6 game pattern.png   # add a rectangle by hand
gozen art mosaic manual view --manual edits.yaml --src masked game pattern.png    # draw the result with a scale

A fix file (docs/examples/production/fixes.yaml):

pattern.png:
  skip: true          # no automatic detection for this image
  block: 4            # block size in pixels
  add: [[1, 1, 7, 7], [14, 10, 8, 9]]

How it pixelates:

• Each cell is the average of the original pixels in it. --block 0 uses max(4, ceil(long side / 100)) pixels; 1 leaves the image unchanged.
• Every cell a region touches is filled, so a region’s outline is covered. Regions can be rectangles, boxes, polygons, ellipses or masks.
• Input is PNG, JPEG or WebP; output is PNG or JPEG (a WebP input is written as <name>.png).
• Class names of the --model output are read from --classes a,b,c, then a labels.json (a JSON array of strings) beside the model, then the ONNX metadata names (the Ultralytics export form {0: 'a', 1: 'b'}), then the built-in nipple_f,penis,pussy (nipple_f is a female nipple, the class name of deepghs/anime_censor_detection). --face models use the same lookup. auto --dry-run and inspect print the classes and where they came from (--classes, labels.json, metadata or default). An empty name, a duplicate, or a count that does not match the model output is an error.
• --labels picks the classes to pixelate; the default is penis,pussy, because the Japanese distribution standard does not pixelate nipples by default. With --classes, or a model whose classes differ from the default, and no --labels, every class is pixelated. For example, --model face.onnx --classes face pixelates faces.
• --threshold and --sure (default 0.5) set the detection confidence; detections below --sure are pixelated and also listed for review. Automatic detection does not replace a person looking at the result.

Run gozen art mosaic <subcommand> --help for every option, including --margin, --pad, --min, --dilate, --classes, --labels, --passes and the MOSAIC_* environment variables.

Fetching models #

gozen art fetch [NAME...] downloads pinned revisions of models from Hugging Face into os.UserCacheDir()/gozen/mosaic/<name>/ and checks each file against a SHA-256 written in gozen; a mismatch deletes the download and fails. gozen art fetch --list shows the models and whether each is fetched.

Class names are read from the labels.json that is fetched with each model. The text detector deepghs/text_detection (MIT) is a DBNet model, not the YOLO output [1, 4+classes, N] that --model needs, so it is not offered; to hide names, IDs or garbled signatures, supply a YOLO-format text detector with --model and --classes.

When --model is omitted, the cached censor model is used. If it is not cached, gozen asks “Download the model? About N MB from URL to PATH [y/N]” only when standard input and output are a terminal; otherwise it fails and points at gozen art fetch. --yes skips the question. Only gozen art fetch and a confirmed download use the network.

Detection setup #

Detection runs an ONNX model you supply, through ONNX Runtime. Nothing is bundled or downloaded: not the model, not the runtime library, not training data. Check the license of any model you use.

1. Build gozen with cgo and a C compiler:

   CGO_ENABLED=1 go install github.com/nao1215/gozen/cmd/gozen@latest
   

2. Get the ONNX Runtime shared library from its releases. Gozen uses the 1.29.0 API through onnxruntime_go v1.36.0.

The detection model is a YOLO-style ONNX model with an images input and an output0 output shaped [1, 4 + classes, N]. A model that is given but cannot be read is an error; Gozen never falls back to another method silently.

Without a C compiler, go install builds gozen without inference. Help, hand-written regions and inspect of an existing report still work; a command that needs detection says how to rebuild and exits 1.

Recording voices #

Voices need no tool of their own: they are sound files under assets/ that the lines name (Add voices). A convention that keeps a recording session in order:

• one folder per actor, given as the actor’s voices (assets/keeper/voice/);
• one file per line, named by the event and the line’s number in it (dinner_001.ogg, dinner_002.ogg), so that a script for the actor can be sorted by event;
• Ogg Vorbis or WAV, mono or stereo, any sample rate (the engine resamples).

gozen check warns of the lines of an actor with voices that have no voice yet (GZN0109), with their paths; --format json gives them to a script that writes the list of lines still to record.