@importpointspreview

Permission: ADMIN

Preview a BogusTrivia player points file before importing. Shows player records found, any parse errors, and an import summary. Accepts space, colon, or equals as delimiters between nick and points.

For BogusTrivia files the preview also shows how many hostmask identifiers would be attached to the players' accounts, and lists conflicts (an identifier that another account already owns is not attached, but the points still import) and skipped hostmasks, three at a time followed by a count. The preview runs the import in a transaction and rolls it back, so it writes nothing.

With --hostmasks-only the preview is for a backfill: identifiers are attached to existing accounts only, no points are written, no accounts are created, and nicks with no account are listed as no account: <nick>. The preview is rate-limited to once per 60 seconds per hostmask, and a throttled preview is ignored without a reply.

The file path is not confined to a directory: any file the bot can read is accepted. Keep player files in Limnoria's data directory (supybot.directories.data) by convention. See Where to Put Import Files.

Syntax

@importpointspreview [--hostmasks-only] <file_path>

Example

@importpointspreview /home/bot/limnoria/data/players.pts
@importpointspreview --hostmasks-only /home/bot/limnoria/data/players.pts