Commands

AstralFarmPass registers two commands: the base /pass command for players and staff, and a points subcommand grouped under the /farmpass alias for adjusting a player's season points. Every permission node is collected in the Permission summary.

`/pass`

Base command, aliases /pass and /farmpass.

Subcommand	Syntax	Permission	Description
(none)	`/pass`	— (player-only)	Opens the main Farm Pass menu. If there is no active season, sends the `no-active-season` message instead.
`info`	`/pass info <player>`	`farmpass.info`	Prints the target's season ID, season points, and quest count.
`reset`	`/pass reset <player>`	`farmpass.reset`	Clears the target's quests, claimed rewards, points, and season.
`reload`	`/pass reload`	`farmpass.reload`	Reloads all configuration files.
`reroll`	`/pass reroll`	`farmpass.reroll`	Deletes the current season and its quests, then creates a fresh season with newly generated quests.

Default (no arguments)

Running /pass with no arguments is player-only. It checks the plugin's cached current season:

If no season is cached, it sends the NO_ACTIVE_SEASON message (no-active-season in messages.yml: "There is currently no active season. Please check back later.").
Otherwise, it opens the main Farm Pass menu for the player.

`info`

Looks up the target's FarmPassData via SyncAPI.findData. If found, sends three lines: season ID, season points, and the number of quests in the target's quest list. If no data is found, sends a "No Farm Pass data found" message instead.

`reset`

Looks up the target's FarmPassData and, if found, calls FarmPassData.resetSeason(), which clears the quest list, clears claimed rewards, zeroes points, and clears the season ID. If no data is found, sends a "No Farm Pass data found" message instead.

`reload`

Reloads the plugin's configuration files (plugin.loadConfiguration()). Reports success or, on exception, logs the error and reports failure to the sender.

`reroll`

Calls SeasonRotationService.rerollSeason(), which:

Deletes all quests belonging to the current season.
Deletes the season itself.
Clears blueprint tracking for the deleted season.
Creates a new season for the current month and populates it with fresh daily and weekly quests, exactly as automatic rotation does.

On completion, the sender is told the new season ID; on failure, the error is logged and the sender is notified. See Seasons & Categories and Quests & Goals.

`/farmpass points`

A separate command class (PointsCommand) registered under @CommandAlias("farmpass") with a shared @Subcommand("points"), so every subcommand below is invoked as /farmpass points <action> <player> <points>. All three actions operate on the target's synced FarmPassData (looked up via SyncAPI.findData) and use tab-completion @players @nothing for <player> <points>.

Subcommand	Syntax	Permission	Description
`add`	`/farmpass points add <player> <points>`	`farmpass.points.add`	Adds `<points>` to the target's season points.
`take`	`/farmpass points take <player> <points>`	`farmpass.points.take`	Subtracts `<points>` from the target's season points, clamped at a minimum of `0`.
`set`	`/farmpass points set <player> <points>`	`farmpass.points.set`	Sets the target's season points to `<points>` exactly.

If no FarmPassData is found for the target, each action instead sends a "No Farm Pass data found" message and makes no change.

Permission summary

Node	Grants
`farmpass.info`	`/pass info <player>`.
`farmpass.reset`	`/pass reset <player>`.
`farmpass.reload`	`/pass reload`.
`farmpass.reroll`	`/pass reroll`.
`farmpass.points.add`	`/farmpass points add <player> <points>`.
`farmpass.points.take`	`/farmpass points take <player> <points>`.
`farmpass.points.set`	`/farmpass points set <player> <points>`.

/pass with no arguments has no permission node — it is open to any player, but requires an active season to do anything.

Last modified: 25 July 2026