Skip to content

Signature Ledger

CaptainGummiball edited this page Nov 17, 2026 · 1 revision

Signature Ledger

Besides the data on the item, the server keeps a history of every signature it creates: the ledger. It is what /signit info compares an item with and what /signit history lists.

Where it is

<world folder>/signit_modern/signatures.db        (SQLite, default)
<world folder>/signit_modern/signatures.db-wal    (belongs to it while the server runs)
<world folder>/signit_modern/signatures.jsonl     (text file, when the JSONL backend is used)

Each world has its own ledger. In singleplayer, every save has its own file.

What is stored

Field Example
signature id a8f3c2d1-0000-4000-8000-000000000001
signer UUID and name 00000000-…-0000000000aa, Alex
time (UTC) 2026-11-17 14:03:00
item minecraft:diamond_sword
rarity rare
server label, dimension optional, see Configuration

How it works

  • No database server is needed: the SQLite driver is part of the mod jar.
  • Writing happens on a background thread, never on the server tick, so signing never makes the server wait for the disk.
  • If SQLite cannot be loaded on a system, SignIt Modern switches to the signatures.jsonl text file and writes a warning into the server log. You can also choose the text file yourself (ledger.backend = jsonl).
  • With ledger.enabled = false nothing is written; /signit info then says "disabled on this server".

Backups

Back up the signit_modern folder together with the world (stop the server first, or make sure signatures.db and signatures.db-wal are copied together). Losing the ledger does not remove signatures from items; only the "matches the entry" check of /signit info is lost for older items.

Limits

  • The ledger entry is written right after the item is signed. If the server crashes in that moment, the item is signed but its ledger entry can be missing – the item is never lost.
  • The ledger only knows signatures of this server and world. An item signed elsewhere shows "no entry".
  • The ledger is not a proof against people with access to the server files: they can edit both the world and the ledger.

Reading the database

The SQLite file can be opened with any SQLite tool (for example DB Browser for SQLite). The table is called signatures; the columns are described in Item Data Format.

Clone this wiki locally