Troubleshooting

Troubleshooting

Client Cannot Join

Confirm the server jar metadata still contains displayTest="IGNORE_SERVER_VERSION" and Forge dependency metadata with side="SERVER".

CI validates this, but staging should still test with a client that does not have CraftLedger Jobs installed.

Config Reload Fails

Read the error from:

/craftledger reload

Common causes:

• Item ids are not namespaced, such as bread instead of minecraft:bread.
• Prices or payouts are 0, negative, NaN, or infinite.
• Job ids contain spaces or uppercase letters.

Shop Command Does Not Find an Item

Use the same namespaced id that appears in shop.json, for example:

/shop price minecraft:bread

Job Payouts Are Missing

Check that:

• the player has joined the job
• the event is listed in jobs.json
• dailyPayoutLimit is not blocking the payout
• payoutCooldownSeconds is not blocking repeated payouts

If currencyEnabled = false, only XP payouts from blockBreakXp and entityKillXp are paid. Currency payout maps are ignored while currency is disabled.

If the block was placed by a player and trackPlacedBlocks = true, the break is intentionally ignored for job payouts.

Balances Look Wrong After Restart

Check the active storage backend:

• JSON: world/craftledger/players.json
• SQLite: world/craftledger/craftledger.sqlite

Review server logs for save errors and back up world/craftledger/ with the world.

Need Recent Audit Entries

Use:

/craftledger transactions tail [lines]
/craftledger transactions tail player <player> [lines]

The command is capped at 50 lines.