koishi-plugin-apexrankwatch

koishi-plugin-apexrankwatch is an Apex Legends query and monitoring plugin for Koishi.

It supports querying player rank, score, level, online status, season end time, Master/Predator player counts, and Predator RP threshold. It also supports continuously monitoring player score changes in group chats and pushing notifications automatically.

Features

• Query a player's current rank, RP, level, online status, current legend, and UID
• Supports queries with the uid: / uuid: prefix
• Supports automatic platform fallback: PC -> PS4 -> X1 -> SWITCH
• Supports querying the current season end time
• Supports querying Master/Predator player counts and Predator RP threshold
• Supports continuous monitoring of player score changes in group chats with automatic notifications
• Compatible with the original usage habits and historical data directory of older Koishi plugins
• Includes protection against abnormal point loss and API exceptions to prevent erroneous data from directly overwriting original records

Installation

yarn add koishi-plugin-apexrankwatch

After installation, enable the plugin in Koishi and fill in an available Apex API Key.

Common Commands

• /apextest
• /apexhelp
• /apexrank <player name|uid:...> [platform]
• /apexrankwatch <player name|uid:...> [platform]
• /apexranklist
• /apexrankremove <player name|uid:...> [platform]
• /apexpredator
• /apexseason
• /apexblacklist <add|remove|list|clear> <player ID>
• /season off
• /season on

Command Aliases

• apex help
• apexrankhelp
• apex query
• query
• apex monitor
• continuous query
• apex list
• apex remove
• cancel continuous query
• apex predator
• apex season
• new season
• apex test
• apex blacklist
• query forbidden
• apexban

Usage Examples

Query a player:

/apexrank moeneri
/apexrank moeneri pc
/apexrank uid:1010153800824

Add group monitoring:

/apexrankwatch moeneri
/apexrankwatch moeneri ps4

View the monitoring list:

/apexranklist

Remove monitoring:

Query season information:

Query Predator threshold:

Instructions

• If no platform is specified, the plugin will automatically try multiple platforms
• If players with the same name are being monitored across multiple platforms, it is recommended to explicitly specify the platform when removing one
• Season information comes from the public site apexseasons.online
• Player queries, monitoring, and Predator threshold features depend on api.mozambiquehe.re
• If no available API Key is configured, the plugin can still be loaded, but online query features will be unavailable

Data Directory

The default data directory is:

Main files include:

• groups.json: group monitoring data
• settings.json: dynamic blacklist and season keyword switch

License

MIT