NoxBoosters commands and permissions

Applies to 0.1.0, source aeea4cd. Commands below use the leading / in game; console commands omit it. Use the lowercase subcommands shown.

Player commands

Command	Behavior
/boosters	Opens the boost menu and retries queued item refunds. Aliases: /boost, /nb.
/thanks	Attempts a thank-you claim for every eligible active global booster.
/thanks <global_type>	Restricts claims to that exact configured global type ID. Example: /thanks farm_money.

These commands require an in-game player. This version declares no separate player permission nodes for them. Booster item use also has no separate permission check; island items require island membership.

Admin permission

noxboosters.admin protects every /nbadmin subcommand and defaults to op. Console can use these commands. Give this permission only to administrators: it includes issuing items and changing source values.

Admin commands

Command	What it does
/nbadmin reload	Reloads and validates configuration, refreshes limits, schedules, rank values, and active modifiers. Keeps the current database connection.
/nbadmin keys	Lists registered keys, their types, and final caps.
/nbadmin give <player> <player|island> <type>	Gives one item with a fresh serial to an online player with an empty slot. player reads personal.yml; island reads island.yml.
/nbadmin global start <type> <minutes> [buyer]	Starts or extends a type from global.yml, using the explicit duration in minutes.
/nbadmin island start <player> <type> <minutes>	Starts or extends a type from island.yml on that online player’s island.
/nbadmin set <player> <source> <key> <ADD_PERCENT|MULTIPLY> <value>	Replaces that online player’s entire named source with one modifier.
/nbadmin clear <player> <source>	Clears that online player’s named source from the calculation. Use this with a source you own.
/nbadmin inspect <player> <key>	Shows the final value, raw value, key cap, and source contributions for an online player.

Every required <player> argument above must match an online player’s name. The optional global buyer is a name, not an online-player requirement. When omitted, an in-game sender becomes the buyer; console has no named buyer. Use a valid player name of 1–16 letters, digits, or underscores.

Durations for global start and island start must be positive whole minutes. The configured duration is used by issued items; it does not replace the command’s required <minutes> argument. A single duration and the accumulated remaining duration are each limited to 365 days.

Examples with the supplied types

/nbadmin give Steve player farm_money_2x_30m
/nbadmin give Steve player mine_money_2x_30m
/nbadmin give Steve island island_money_30m
/nbadmin global start farm_money 30 Steve
/nbadmin island start Steve island_money_30m 30

The corresponding consumer keys must exist. Global boosters are started by command; /nbadmin give does not issue global items. Item activation uses a main-hand right-click.

Temporary source inspection

/nbadmin set Steve debug hoes.money ADD_PERCENT 0.2
/nbadmin inspect Steve hoes.money
/nbadmin clear Steve debug

With no other effects, this gives a central value of 1.20. set replaces all previous keys in the debug source. The override is held in memory and is lost on player quit or plugin shutdown. Source IDs must start with a lowercase letter and use at most 48 lowercase letters, digits, _, ., or -.

The built-in IDs rank, personal, island, global, and event, plus another producer’s ID such as pets, belong to their respective managers. Overriding them can be replaced by the next refresh. clear is not a persistent command to cancel a stored timed booster. This version has no dedicated force-stop or time-removal admin subcommand.

How thanks rewards work

The supplied defaults allow claims during the first 300 seconds of a global boost and give 10 vanilla XP points per successful claim. thanks.reward-commands can add console commands; {player} is replaced by the thanking player’s name.

A player cannot thank their own booster, or claim twice for the same active booster. Extending the same type retains its original start time, buyer, and claim history; it does not reopen the reward window. The extension announcement can name the new purchaser while thanks still refers to the original buyer.

The claim is saved before XP or commands are awarded. Disconnecting or shutting down between those steps can leave a claim recorded without its reward; rewards are not automatically replayed.