Skip to content

Configuration

CaptainGummiball edited this page Nov 17, 2026 · 1 revision

Configuration

File: config/signit_modern.properties on the server (in singleplayer: the game's config folder). It is created on the first start with every key, a comment and the default value. No change is needed to play.

Edit it with any text editor, then run /signit reload (or restart). Invalid values are replaced by their defaults and reported in the server log; the file is rewritten so it only contains valid values.

Cost

Key Default Values Meaning
cost.emeralds 1 0–64 emeralds per signature, always taken from the off hand
cost.free_in_creative true true/false creative players sign for free

With cost.emeralds = 0 signing is free, but an emerald in the off hand is still the trigger.

Who may sign what

Key Default Values Meaning
signing.permission_level 0 0–4 permission level needed to sign; 0 = everyone, 2 = operators
signing.allow_resign false true/false allow signing a signed item again; the new signature replaces the old one and its lore lines
signing.require_sneak false true/false sign only while sneaking; a normal right-click then always works as usual
signing.cooldown_ticks 10 1–200 after an attempt, further clicks of the same player are ignored for this many ticks (20 ticks = 1 s)
items.whitelist empty list if not empty, only these items can be signed
items.blacklist empty list these items can never be signed

Lists are comma-separated. Entries:

Entry Matches
minecraft:diamond_sword exactly this item
somemod:* every item of that mod
#minecraft:swords every item in that item tag

Example: only weapons and tools, but never netherite:

items.whitelist = #minecraft:swords, #minecraft:pickaxes, #minecraft:axes, minecraft:bow, minecraft:trident
items.blacklist = minecraft:netherite_sword, minecraft:netherite_pickaxe, minecraft:netherite_axe

Rarity

Key Default
rarity.common 600
rarity.uncommon 250
rarity.rare 100
rarity.epic 40
rarity.legendary 10

Relative weights (0–1,000,000), see Rarity.

Tooltip and messages

Key Default Meaning
tooltip.show_time true show the UTC time after the date
tooltip.show_rarity true show the rarity line
tooltip.show_signature_id true show the short id line
messages.success true chat message to the player after signing
messages.announce none none, epic or legendary: announce signatures of that tier or better to everyone

Tooltip settings apply to new signatures; lines on items signed earlier stay as they are.

Ledger and stored data

Key Default Meaning
ledger.enabled true keep a server-side history of all signatures
ledger.backend sqlite sqlite (signatures.db) or jsonl (signatures.jsonl), see Signature Ledger
signature.server_name empty optional label (max. 64 characters) stored with every new signature, shown by /signit info
signature.store_world true store the dimension id (e.g. minecraft:overworld) with every new signature

Ledger settings need a server restart.

Example: a trading server

cost.emeralds = 5
cost.free_in_creative = false
signing.require_sneak = true
messages.announce = legendary
signature.server_name = Emerald Bay

Clone this wiki locally