Commands

Default (no arguments)

Player-only. Opens the farmpass-main menu (MenuContainer.computeAndOpen). If the menu fails to build, the error is logged with the player's name and nothing opens — there is no "no active season" path any more: a season always exists for the current month.

reload

Permission: farmpass.reload. Console or player. Runs AstralFarmPass.loadConfiguration() — config.yml, rewards.yml, messages.yml, the blueprints/ folder and the menus. Reports Farm Pass configuration reloaded. on success; on exception the sender gets a failure message and the stack trace is logged. See Configuration § Reloading for what a reload does and does not touch.

points

Permission: farmpass.admin (on every points form). Tab-completion is @players.

All five forms resolve the target as an online player and read their FarmPassPlayerData through SyncAPI.findData. Pass data only exists for a connected player whose snapshot has loaded, so offline players cannot be targeted: when no data is found, the sender is told The farm pass data of <name> isn't loaded yet. and nothing changes.

The four mutating forms clamp the result at 0 — points can never go negative, whatever amount is passed. On success the sender gets points-updated and the target gets points-changed, both carrying the new total.

Points are part of the synced snapshot, so an adjustment made on one server follows the player across the network. It is wiped by the next season rollover like any other progress.