Field Construction - mess1re/axiomata GitHub Wiki

Placement

The placement preview uses the finished entity's bounds and the player's facing.

Ground

  • The targeted support block must have a sturdy top face.
  • Sturdy blocks must support at least 40% of the result footprint.
  • The entity bounds must be free of world collision and other unfinished machines.

Water

  • The target and sampled points under the result footprint must contain water.
  • The entity bounds must be free of collision and other unfinished machines.
  • The blueprint must specify result.entity.

The real result entity is placed immediately in an unfinished state. Axiomata does not swap a separate construction-site entity for the result at completion, so only entities that support construction can be built this way; see Blueprint Data.

Stage work

Stages follow the order in the blueprint JSON.

  • The result decides whether a hammer hit is on the current section.
  • The complete current-stage material kit is consumed on the first accepted hit.
  • Later hits advance work without consuming the same kit again.
  • Completing a stage reveals the next section; completing the last stage marks the result finished.
  • Creative builders neither consume nor receive materials.

Work per stage is:

base hits = clamp(ceil(allocated items × hitsPerItem), minStageHits, maxStageHits)
final hits = clamp(round(base hits × quality multiplier), minStageHits, maxStageHits)

An explicit positive hits value replaces the first calculation, but quality and clamping still apply.

Dismantling unfinished results

Sneak-right-click with the construction hammer.

  1. If the current stage has partial work, that work is cancelled and its committed materials are returned.
  2. Otherwise the last completed stage is removed and its materials are returned.
  3. If nothing has been built, the unfinished entity is removed.

Completed results are no longer handled by Axiomata's construction interaction. Maintenance or dismantling of finished content belongs to the consuming mod.

Ending a build early

When a blueprint sets minStages, sneak-attack the unfinished result with the construction hammer once that many stages stand. The build ends where it is and the result is finished with only the stages built. Each hammer hit reports whether the build can already end there. See Blueprint Data.

Starter items

A blueprint with a starter can be opened without a drawn blueprint: hold the starter item in the off hand and the hammer in the main hand. The build begins with the stages the item already represents, and the item is consumed when construction starts.