Build a basic bot

Step-by-step guide to creating your first rebootpy bot

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()

Using device auth (recommended)

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