Skip to main content

Change the EssentialsX starting balance for new players only

Applies to: EssentialsX Economy; match the linked maintainer documentation to your installed platform and release.
Documentation checked .

A new-player allowance should not reset established accounts. Treat the starting balance as an onboarding rule and verify it with an account that has no existing EssentialsX economy record.

Before you start

EssentialsX economy settings affect player money and the plugins that use its economy service. Keep player UUIDs, the active provider and the exact EssentialsX build in your change record. Use a normal test account rather than an operator.

Work through the check

  1. Choose the intended allowance and record the balances of an established test player before changing anything.
  2. Open the generated EssentialsX configuration and locate starting-balance; compare its comment with the template for your installed release.
  3. Save the previous value, edit only the allowance, and apply it during a controlled restart rather than altering player-data files.
  4. Join with a genuinely new test identity, then rejoin with the established player and compare both balances.

What to compare

Use a genuinely new test identity on an isolated copy to check the first-join amount. Reconnecting an established player does not demonstrate how newly created economy accounts receive their initial money.

Confirm the result

The new player should receive the chosen allowance once. Existing players should retain their previous balances after joining again.

If the result differs

If an old account receives another allowance, investigate first-join reward plugins and command automation. If the new balance differs, confirm EssentialsX is the active economy provider and inspect other onboarding rewards.

Recover safely

Restore the previous starting-balance value if the policy is wrong. Correct only verified test transactions through supported economy commands; do not mass-reset user files to repeat the experiment.

Documentation and related help

Check the EssentialsX Economy maintainer documentation and EssentialsX Economy maintainer reference against your installed release before applying changes.