← All Tools
Points Bot

Discord Bot

Points Bot

Full-featured cult management, real-time win scraping, customizable claim buttons, leaderboards, and milestone reward roles for Territorial.io Discord servers.

Quick Start

Three commands and the bot is fully operational.

1

Set a bot manager role

Designate a Discord role whose members can run admin commands. Without this, only server administrators can configure the bot.

/bot_manager <role>
2

Configure the win log

Point the bot at a channel and your clan's Territorial.io tag. The scraper will start watching territorial.io/clan-results and posting win log messages automatically.

/set_winlog <channel> <clan_tag>
3

Add claim buttons optional

Attach 1×, 1.3× Duo, and 1.5× Solo buttons to win log messages so members can claim points manually. Link accounts with /account_linking so wins credit automatically without any button click.

/add_claim_button
Features

Everything your Territorial.io server needs in one bot.

Cult & War System

Create and manage clans ("cults"), declare wars between them with time-limited durations, and track combat scores automatically.

Real-Time Win Scraping

Scrapes territorial.io/clan-results every 2 seconds for near-instant win log reporting. Linked accounts receive points automatically.

Customizable Claim Buttons

Attach fully custom claim buttons (1×, 1.3× Duo, 1.5× Solo, or any label/multiplier) to win log messages. Add, edit, or remove buttons per server with position control.

Leaderboards

Paginated server-wide player leaderboards and cult leaderboards. Switch between points and wins. Filter to any time window.

Reward Roles

Auto-assign Discord roles when players hit points/wins milestones. Choose stackable (keep all earned) or highest-only mode. Bulk-refresh for all members.

Account Linking

Map Discord users to their 5-character Territorial.io account codes. Linked accounts get points credited automatically on every win, no button needed.

Event Multipliers

Set a server-wide points multiplier for special events. All claimed points are scaled automatically. Edit or end at any time.

Commands

All slash commands, organized by category. Badges show who can use each command.

EveryoneEveryone / AdminAdminBot OwnerLeader / Officer
General 2
/help Everyone

Show all command categories and a quick overview of the bot.

/invite Everyone

Get the invite link to add this bot to another server.

Economy 4
/profile [user] Everyone

View points, wins, server rank, cult, and next milestone progress for yourself or another user. Includes interactive Points Graph and Wins Graph buttons.

/leaderboard [days] Everyone

Paginated server leaderboard for points or wins. Optionally filter to the last N days. Toggle between Points and Wins with a single button.

/add <points> [user] [wins] Everyone / Admin

Add points to your own account (1 argument, everyone) or to another user (admin only). Automatically applies the active server multiplier. Triggers reward role checks.

/remove [points] [wins] [user] Everyone / Admin

Remove points or wins from your own account (everyone) or from another user (admin only).

Cults 11
/cult_create <name> Everyone

Create a new cult and become its leader. Each user can only be in one cult at a time.

/cult_info [cult_name] Everyone

Show detailed information about a cult — members, stats, leader, and description.

/cult_list Everyone

List all active cults in this server.

/cult_stats Everyone

Show detailed stats for your own cult including total points, wins, and member breakdown.

/cult_leaderboard Everyone

Server-wide ranking of all cults by total points or wins.

/join_cult <cult_name> Everyone

Join an existing cult. You must not already be a member of another cult.

/promote_member <user> Leader / Officer

Promote a cult member to officer rank within your cult.

/cult_war <target_cult> [duration] Leader / Officer

Declare war on another cult. Duration defaults to 7 days. War scores are tracked automatically.

/end_war Leader / Officer

End your cult's ongoing war and finalize scores.

/cult_alliance <ally_cult> Leader / Officer

Form a formal alliance with another cult.

/end_alliance Leader / Officer

Dissolve an existing cult alliance.

Multipliers 4
/multiplier_info Everyone

Check if a multiplier is currently active, its value, description, and when it was set.

/set_multiplier <value> [description] Admin

Set a server-wide points multiplier (e.g. 1.5, 2.0). All points claimed while active are scaled by this value.

/edit_multiplier <value> [description] Admin

Update the value or description of the currently active multiplier without restarting it.

/end_multiplier Admin

Deactivate the current multiplier. Points return to 1× rate immediately.

Reward Roles 9
/rolelist Everyone

Show all configured reward role milestones and their thresholds. Publicly visible.

/rewardrole <role> <amount> <type> <channel> Admin

Create a new milestone reward role. Triggers automatically when a player hits the points or wins threshold.

/editrewardrole <role> <new_amount> [new_channel] Admin

Update the threshold or announcement channel for an existing reward role.

/deletereward <role> Admin

Remove a reward role milestone configuration.

/listrewards Admin

List all configured reward roles including thresholds, type, and announcement channel.

/set_reward_stackable <yes/no> Admin

Toggle between stackable mode (users keep all earned roles) or highest-only mode (only the top milestone role is kept).

/force_refresh_rewards Admin

Re-evaluate every server member and assign or remove roles based on current points/wins totals.

/debug_rewards Admin

Show your own eligibility status against every configured reward role — useful for diagnosing missing role assignments.

/cleanup_roles Admin

Scan all members and remove duplicate milestone roles, keeping only the highest earned role per type.

Win Log Buttons 4
/add_claim_button Admin

Add a custom claim button to win log messages. Configure the label, points multiplier, style, and emoji.

/edit_claim_button <position> Admin

Edit an existing claim button by its position number. Update label, multiplier, style, or emoji.

/remove_claim_button <position> Admin

Remove a claim button by its position number.

/list_claim_buttons Admin

List all configured claim buttons for win log messages with their position, label, and multiplier.

Admin / Config 5
/bot_manager <role> Admin

Designate a Discord role as bot manager. Members with this role can use admin commands.

/set_winlog [channel] [clan_tag] Admin

Configure the win log channel and Territorial.io clan tag to monitor. No arguments = view current config.

/remove_winlog [backup] Admin

Remove the win log configuration. Choose to archive data (soft-delete), pause (keep data, remove config), or permanently delete.

/account_linking <user> <account_name> [remove] Admin

Link a Discord user to their Territorial.io account code for automatic point crediting. Set remove=true to unlink.

/edit_cult Admin

Admin override to edit any cult's name, description, icon, or leader.

Owner Commands 4
/authorize <status> Bot Owner

Authorize or deauthorize a server for bot use. Deauthorized servers have all commands blocked; data is preserved.

/adminpoints <message_id> Bot Owner

Parse and import points from a leaderboard message ID. Used for bulk data migrations.

/adminwins <message_id> Bot Owner

Parse and import wins from a leaderboard message ID. Used for bulk data migrations.

/export_winlog Bot Owner

Export the full win log history for this server as a CSV file.