/score-get [playerName] - Displays the player's score.
/score-add [playerName] <amount> - Add amount points to the player's score.
/score-subtract [playerName] <amount> - Subtracts amount points from the player's score.
/score-reset [playerName] - Resets the player's score to 0.
/score-archive [playerName|all] - Archives the caller/selected player or every bucket (operators); archived scores reset to their bucket's initial value.
/score-archive bucket <bucketId> - Archives and resets all scores in one bucket (operators).
/score-archive-list [archiveId] - Lists saved archive IDs or displays the scores in one archive.
/score-bucket [bucketId] - Switches your active bucket.
/score-bucket create <id> <singular> <plural> <initialValue> [admin|global|player|none] - Creates a bucket (operators).
/score-bucket <playerName|all> <bucketId> - Switches a player or the server default (operators).
/score-run start <bucket> <topN> <reset:true|false> target <score> - Starts a target-score run (operators).
/score-run start <bucket> <topN> <reset:true|false> duration <time> - Starts a timed run; time uses s, m, h, d, or w (operators).
/score-run start <bucket> <topN> <reset:true|false> until-disabled - Starts a run without automatic expiry (operators).
/score-run stop <bucket> - Ends an active run (operators).

When a player's active bucket changes, they are told the bucket name and their current score with its singular or plural unit.

NOTES:

All commands will use the executing player in place of [playerName] if it is omitted.
Permissions support is coming AFTER I get archive to work.
The commands aside from get are intended for admins and whatnot as some other plugin should be using the methods instead of letting player's execute commands.

Bucket reporting defaults to none; admin notifies operators and score admins, global notifies all online players, and player notifies only the scored player. Other plugins can create buckets with createBucket(id, singular, plural, initialValue, reporting) and use the bucket-aware score methods. Existing score methods operate on the player's active bucket. Bucket definitions, reporting policies, assignments, and scores are saved in plugins/ScoreKeeper/scores.yml; archives are saved separately in plugins/ScoreKeeper/archives.yml.

Other plugins can start runs with startTargetScoreRun, startTimedScoreRun, or startUntilDisabledScoreRun, and end one with stopHighScoreRun. During a run, players receive their own score changes, while changes by current top-n players are reported globally. Finished runs publish a deterministic score-ordered table and each online player's place; reset runs restore the pre-run bucket scores.

Development

See CONTRIBUTING.md for development environment setup instructions.

Tooling note:

Gradle is configured with Java Toolchains and will automatically download an appropriate JDK when needed during builds.