Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/xmistt/rebootpy/llms.txt

Use this file to discover all available pages before exploring further.

This guide will walk you through creating a basic Fortnite bot using rebootpy.
1

Install rebootpy

First, install rebootpy using pip:
pip install rebootpy
2

Create your bot file

Create a new Python file (e.g., bot.py) and import the necessary modules:
import rebootpy
from rebootpy.ext import commands
3

Initialize the bot

Create a bot instance with a command prefix:
bot = commands.Bot(
    command_prefix='!',
    auth=rebootpy.AuthorizationCodeAuth()
)
The command prefix (! in this example) is what users will type before commands.
4

Add event handlers

Event handlers let your bot respond to events. Add a ready event to know when your bot is online:
@bot.event
async def event_ready():
    print(f'Bot ready as {bot.user.display_name} ({bot.user.id})')
Add a friend request handler to automatically accept friend requests:
@bot.event
async def event_friend_request(request):
    await request.accept()
    print(f'Accepted friend request from {request.display_name}')
5

Add commands

Commands allow users to interact with your bot:
@bot.command()
async def hello(ctx):
    await ctx.send('Hello!')

@bot.command()
async def party(ctx):
    await ctx.send(f'Party size: {bot.party.member_count}')
6

Run the bot

Finally, start the bot:
bot.run()
When you run this script, you’ll be prompted to get an authorization code from Epic Games.

​
Complete example

Here’s the complete bot code: 
import rebootpy
from rebootpy.ext import commands

bot = commands.Bot(
    command_prefix='!',
    auth=rebootpy.AuthorizationCodeAuth()
)

@bot.event
async def event_ready():
    print(f'Bot ready as {bot.user.display_name} ({bot.user.id})')

@bot.event
async def event_friend_request(request):
    await request.accept()
    print(f'Accepted friend request from {request.display_name}')

@bot.command()
async def hello(ctx):
    await ctx.send('Hello!')

@bot.command()
async def party(ctx):
    await ctx.send(f'Party size: {bot.party.member_count}')

bot.run()
For a more persistent bot that doesn’t require manual authorization each time, use AdvancedAuth: 
import rebootpy
import json
import os
from rebootpy.ext import commands

filename = 'device_auths.json'

def get_device_auth_details():
    if os.path.isfile(filename):
        with open(filename, 'r') as fp:
            return json.load(fp)
    return {}

def store_device_auth_details(details):
    with open(filename, 'w') as fp:
        json.dump(details, fp)

device_auth_details = get_device_auth_details()
bot = commands.Bot(
    command_prefix='!',
    auth=rebootpy.AdvancedAuth(
        prompt_device_code=True,
        open_link_in_browser=True,
        **device_auth_details
    )
)

@bot.event
async def event_device_auth_generate(details):
    store_device_auth_details(details)

@bot.event
async def event_ready():
    print(f'Bot ready as {bot.user.display_name} ({bot.user.id})')

@bot.event
async def event_friend_request(request):
    await request.accept()

@bot.command()
async def hello(ctx):
    await ctx.send('Hello!')

bot.run()
This example will automatically save device auth credentials to a JSON file after the first run, so you won’t need to re-authenticate.

​
Next steps

Commands extension

Learn more about creating commands and using the commands framework

Party management

Manage your bot’s party, members, and settings

Event handling

Understand all available events and how to use them

Error handling

Handle errors gracefully in your bot

Build docs developers (and LLMs) love

Get started for freeTalk to us