Skip to main content

Commands

Here is a list of commands for ajLeaderboards.
As always, <> marks a required argument, and [] marks an optional argument. Never put <> or [] around the arguments.

The strings listed next to the command name are aliases for that command.

Admin Commands (/ajLeaderboards, /ajl, /ajlb)

These commands are intended for admins to manage the plugin or leaderboards.

All commands require the ajleaderboards.use permission.

Board Commands

  • Add Board (/ajleaderboards add)

    • Description: Registers a placeholder with ajLeaderboards.
    • Syntax: /ajleaderboards add <placeholder>
  • Remove Board (/ajleaderboards remove)

    • Description: Delete a leaderboard and all its data in the ajLeaderboards cache.
    • Syntax: /ajleaderboards remove <board>
  • Check Update (/ajleaderboards checkupdate, /ajleaderboards updatecheck)

    • Description: Check if there could be an issue with automatically updating a player.
    • Note: This command will not fix the issue by itself. You need to read the warnings this command tells you about.
    • Syntax: /ajleaderboards checkupdate <board> <player>
  • List Boards (/ajleaderboards list)

    • Description: List all boards or display the top players on a specific board.
    • Syntax: /ajleaderboards list [board] [type]
    • Arguments:
      • [board] (Optional): Name of the board to show the top players of. If not specified, all board names registered with ajLeaderboards will be listed.
      • [type] (Optional): Time frame (default is alltime if not specified)
  • Remove Player (/ajleaderboards removeplayer, /ajleaderboards rmplayer, /ajleaderboards rmpl)

    • Description: Clear a player from the cache on a specific board or all boards.
    • Syntax: /ajleaderboards removeplayer <player> <board>
  • Reset Board Data (/ajleaderboards reset)

    • Description: Clear all leaderboard data for a specified board.
    • Note: This only clears ajLeaderboard's cache. You will need to reset the data in the target placeholder before running this if you want to reset properly.
    • Syntax: /ajleaderboards reset <board>
  • Update All Offline Players (/ajleaderboards updatealloffline)

    • Description: Attempt to update statistics for all offline players on a specific board.
    • Syntax: /ajleaderboards updatealloffline <board> [start/progress]
  • Update Player (/ajleaderboards updateplayer)

    • Description: Manually update a player's stats on the leaderboard.
    • Note: If a player is not being updated automatically, make sure to read the warnings from this command or /ajlb checkupdate! Running this command will not fix the issue by itself.
    • Syntax: /ajleaderboards updateplayer <board> <player>

Sign Commands

  • Signs Add (/ajleaderboards signs add)

    • Description: Create a leaderboard sign at the sign you are looking at.
    • Syntax: /ajleaderboards signs add <board> <position> <type>
  • Signs List (/ajleaderboards signs list)

    • Description: List all created signs along with their details.
    • Syntax: /ajleaderboards signs list
  • Signs Remove (/ajleaderboards signs remove)

    • Description: Remove the sign you are looking at.
    • Syntax: /ajleaderboards signs remove
  • Signs Teleport (/ajleaderboards signs teleport, /ajleaderboards signs tp)

    • Description: Teleport to a specific sign. Meant to be used by clicking on a sign in /ajlb signs list
    • Syntax: /ajleaderboards signs teleport <sign_number>

Other Commands

  • Reload Configs (/ajleaderboards reload)

    • Description: Reload the configuration files.
    • Syntax: /ajleaderboards reload
  • Export (/ajleaderboards export)

    • Description: Export cache to a .json file that can be imported later.
    • Syntax: /ajleaderboards export <file>
  • Import (/ajleaderboards import)

    • Description: Import cache data from a file.
    • Syntax: /ajleaderboards import <file>
  • Viewer (/ajleaderboards viewer, /ajleaderboards webviewer)

    • Description: Upload cache data to ajlb-viewer.ajg0702.us for easier debugging of issues.
    • Syntax: /ajleaderboards viewer [boards...]
    • Arguments:
      • [boards...] (Optional): List of boards to export. If not specified, all boards will be exported. To specify multiple boards, separate them with a space. You should use this argument if you get a 413 error when ajLeaderboards tries to upload to the viewer.
  • Version (/ajleaderboards version, /ajleaderboards ver)

    • Description: Display the plugin version.
    • Syntax: /ajleaderboards version