Frequently Asked Questions (FAQ)¶

Authentication¶

Why are there so many different authentication methods?¶

With the deprecation of email and password authentication, there was a need of different ways to authenticate. Therefore, rebootpy tries to offer as many different authentication methods as possible. You can read more about the different possibilities over here.

Which authentication method should I use?¶

The answer to this question depends completely on what information you already have, for example, if you’ve just made a fresh Epic Games account, I’d use AdvancedAuth or my other library DeviceAuthGenerator first in order to generate device auths, and then after that I’d just use the DeviceAuth authentication method. If you are unsure how to use AdvancedAuth, you can take a look at the examples folder where it’s used in all of the examples.

Whats the best way of storing the device auth details of an account?¶

This depends on the complexity of the bot with multiple accounts in mind. For a program running a single bot, the easiest method of storage would be using a json file. A method for this is showcased in all examples.

For bots with multiple accounts I suggest using a database for the single reason that file io is blocking and sometimes the operating system might spit out errors because too many files are opened at the same time.

Note: If you’re going to use a database for anything in the same program as the fortnite bot, please use an asynchronous database library. I can personally recommend using a postgresql database and asyncpg as the library.

General¶

What is async/await and how do I use it?¶

Asynchronous programming lets the program sort of perform multiple actions at once. For newcomers to python/programming in general, the discord.py faq has a great simplified explanation of its basic concepts. For people with existing knowledge of asynchronous programming that want to know even more about it, I can suggest this article on it. As well as breakign down pretty much all you need to know about asynchronous programming, it also explains the differences between multiprocessing, threading and asyncio in python in an understandable way.

Where can I find usage examples?¶

You can find example code in the examples folder in the github repository.

How can I access the clients current party object?¶

The clients current party object can be accessed through Client.party.

How can I access the clients current party member object?¶

The clients current party member object can be accessed through ClientParty.me. Example usage: await client.party.me.set_emote('EID_Floss')

How can I send a DM?¶

To send a DM you first need the Friend object of the friend you want to send the dm to and then use Friend.send(). Example:

friend = client.get_friend('7e9f8dd37a924496bc5083733887b44c')
await friend.send('Hello friend!')

If you want to respond to a friend message in event_friend_message(), you can do this by using FriendMessage.reply(). Example:

@client.event
async def event_friend_message(message):
    await message.reply('Thanks for the message!')

    # Not as clean but would still work:
    await message.author.send('Thanks for the message!')

How can I set a status?¶

You can pass a status message for the client to use when creating client.

client = rebootpy.Client(
    auth=rebootpy.Auth, // Here goes an authentication method like rebootpy.AdvancedAuth or rebootpy.DeviceAuth
    status="This is my status"
)

Warning

This will override all status messages in the future. The standard status message (In Lobby - {current_playlist}) will also be overridden. If you just want to send a status message once and not override all upcoming status messages, Client.send_presence() is the function you are looking for.

Alternatively you can change the presence with Client.set_presence().

How can I get the CID of a skin?¶

There is no good easy way to obtain these yourself. However, there are some APIs made by other people that you can use to find cosmetic IDs, I recommend: - NotOfficer’s API.

How can I get a users K/D or Win Percentage?¶

Since the stats request does not return a K/D or win percentage, you must calculate them yourself. Just to make it easy StatsV2 includes functions that calculates these values for you.

Take a closer look at StatsV2.get_kd() and StatsV2.get_winpercentage().

Why are some cosmetics invisible/dances not playing?¶

Since ~C4S3, cosmetics have been stored in 2 paths, some in the old folder but the majority in a new folder called BRCosmetics. Since the path in rebootpy is hard-coded, theres no good way of getting the correct path since it would require installing the entire game to wherever your instance of rebootpy is running. However, the best way I have found is to use a third party API such as Fortnite-API to get the path.

Outfits do not have this issue anymore as they no longer require a path at all, so you can just pass the ID of any outfit to ClientPartyMember.set_outfit() and regardless of its location, it will show correctly (as long as the ID is valid).

Guide to find path using Fortnite-API:

Head over to the Fortnite-API docs.
Choose an endpoint that you want to use to lookup cosmetics, either via ID or name.

3. The response will have a key called path in data, if it contains BRCosmetic, just pass the plain ID to the set_ function as this is the path that the library is already using.

If the cosmetic is in the original path, use

/Game/Athena/Items/Cosmetics/<CosmeticPath>/

as the path, example usage for a dance would be:

await bot.party.me.set_emote('/Game/Athena/Items/Cosmetics/Dances/EID_Coronet.EID_Coronet')

Here is an example of using Fortnite-API to get the correct path for a dance:

@bot.command()
async def emote(ctx, *, search: str):
    async with aiohttp.ClientSession() as session:
        async with session.request(
            method="GET",
            url="https://fortnite-api.com/v2/cosmetics/br/search?name=" \
            f"{search}&matchMethod=contains&backendType=AthenaDance"
        ) as request:
            if request.status == 404:
                return await ctx.send('Dance not found!')

            data = await request.json()

    if "brcosmetics" in data['data']['path'].lower():
        await bot.party.me.set_emote(asset=data['data']['id'])
    else:
        path = f"/Game/Athena/Items/Cosmetics/Dances/{data['data']['id']}.{data['data']['id']}"
        await bot.party.me.set_emote(asset=path)

A full example can be found here.