Troubleshooting - mess1re/axiomata GitHub Wiki

A blueprint is missing from the drawing table

  • The definition must be under data/<namespace>/blueprints/.
  • An outline must be under data/<namespace>/blueprint_outlines/.
  • The outline ID must match the definition's outline field, or the blueprint ID if that field is omitted. Starter-only blueprints do not appear at the drawing table.
  • All item, tag and entity IDs must be valid; the log names the field at fault.
  • placement needs result.entity, and that entity must support construction.
  • A blueprint needs an outline or a starter; the log warns when it has neither.
  • index.json is ignored.

Check the server log for Skipping blueprint, Skipping outline or Failed to load, then run /reload.

The visible guide and scoring do not match

Regenerate the texture and base64 mask from the same source drawing. Verify that the outline JSON points to the generated texture and that cells matches the number of set mask bits.

The paper was destroyed

The pen travelled too far away from the guide. Insert another sheet and trace more closely. The ink remains in the table until a completed blueprint consumes it or it is removed before drawing.

A blueprint does not open

  • Put the blueprint in the off hand.
  • Put the Axiomata construction hammer in the main hand.
  • Verify that the blueprint's definition still exists after the last data-pack reload.

Start Construction is disabled

  • Look at a block or water surface within interaction range.
  • Clear the preview bounds of blocks, entities and other unfinished machines.
  • For ground placement, use a sturdy target with enough support under the result footprint.
  • For water placement, use a large enough continuous water surface.

Hammer hits do nothing

  • Right-click the unfinished entity; attacking does not build it.
  • Do not sneak unless dismantling is intended.
  • Aim at the highlighted current section.
  • Carry the complete material kit requested for that stage.
  • Wait for hitCooldownTicks between accepted hits.

Stage costs do not match the definition

Drawing quality changes field-construction material totals; check the quality multipliers. Starter builds use each stage's materials without these multipliers. For old-format files only, check that construction stage allocations add up to each key count.

Config changes affect the wrong world

axiomata-server.toml is stored per world. Edit the copy under the active world's serverconfig directory and restart the server.

An update notice appears in chat

Set [updates].showNotice = false in config/axiomata-client.toml to hide the download link. No jars are downloaded or installed automatically. See Commands and Configuration.

⚠️ **GitHub.com Fallback** ⚠️