Changelog

Detailed version changes.

v3.6.5

Added

• UserSearchPlatform.STEAM

v3.6.4

Bug fixes

• Fixed parameter_required error on email/password login.

• Fixed Client.search_users().

• Fixed fetch multiple stats methods to work with more than 20 stat keys at the same time.

v3.6.3

Bug fixes

• Fixed an issue that made it possible for programs with ill intent to send events to the client.

v3.6.2

Added

• Added timestamps related to fortnite season 17. - SeasonStartTimestamp.SEASON_17 - SeasonEndTimestamp.SEASON_16

Bug Fixes

• Fixed an issue where the client could attempt to clear an emote after it had already left the party.

Misc

• New documentation design. Woo.

v3.6.1

Bug Fixes

• Fixed a critical crash issue introduced in v3.6.0.

v3.6.0

Changes

• (Breaking) Party member meta change events like event_party_member_outfit_change() are no longer emitted by the initial meta update that is received when a member joins the party.

• (Breaking) The “other” argument in event_party_member_team_swap() can now be None if the member swapped to an empty position.

Added

• (Breaking) Added PartyIsFull exception which is now raised by Client.join_party().

• Added functionality related to the new “Request to join” feature. - Added Friend.request_to_join(). Read the warning field in the docs before using it. - Added event_party_join_request().

• Completely reworked party squad assignments and added functionality related to it. - Added the following kwargs to DefaultPartyConfig:

  • default_squad_assignment

  • position_priorities

  • reassign_positions_on_size_change

  • Added ClientPartyMember.set_position().

  • Added ClientParty.set_squad_assignments(). This can be used to “hide” certain members and also change their positions.

  • Added ClientParty.squad_assignments.

  • Added PartyMember.hidden.

• Added kwarg wait_for_member_meta_in_events to Client. It is True by default which introduces a ~1 sec delay to event_party_member_join().

• Added Friend.owns_offer() which can be used to check if a friend owns an offer currently in the item-shop.

• Added timestamps for season 16.

Bug Fixes

• Fixed an issue that caused the client to think that it was party leader after promoting someone else.

• Fixed a rare race condition that could cause event_party_member_promote() to pass the new leaders object as the old one.

• Fixed some applications not closing smoothly due to another bug fix.

• Fixed a relatively hidden bug in PartyMember.swap_position().

Misc

• Fixed event_party_member_team_swap() having the incorrect name specified in the docs.

v3.5.0

Added

• Added the following functionality related to lobby map markers: - PartyMember.lobby_map_marker_is_visible() - PartyMember.lobby_map_marker_coordinates - ClientPartyMember.set_lobby_map_marker() - ClientPartyMember.clear_lobby_map_marker() - event_party_member_lobby_map_marker_is_visible_change() - event_party_member_lobby_map_marker_coordinates_change()

Bug Fixes

• Fixed an issue that caused methods and properties related to party readiness to not work.

• Fixed a possible issue where getting a party members platform could result in an error.

Misc

• Added the kwarg prompt_code_if_invalid=True to all examples by default.

v3.4.0

This update adds Python 3.9 compatibility and other small fixes and features.

Changes

• Bumped aioxmpp compatibility requirement to the latest version (0.12.0)

Added

• Added a new kwarg fetch_user_data_in_events to Client. This is useful for larger applications that might deal with ratelimiting on their ip.

• Added User.fetch() (applies to all objects derived from UserBase too) which can be used to refetch userdata like display name and external auths. This is useful if you have the new kwarg set to False.

Bug Fixes

• Fixed several bugs related to changes in python 3.9 that caused the version to be incompatible with fortnitepy.

• Fixed what I believe to be (hopefully) the last remaining issues that caused ClientParty.me to be None in some rare cases.

• Party leave and party join actions are now under the same lock which should elliminate some race conditions.

• Fixed an issue that caused aiohttp to spam noisy errors on shutdown when using asyncio.ProactorEventLoop.

• Fixed an issue where an error was raised if a meta property was missing.

• Fixed websocket sessions not being correctly closed when reconnecting after an unexpected close.

• Suppressed the websocket stream closed by peer message.

• Suppressed a noisy asyncio error log on shutdown that was introduced in the latest aioxmpp version.

• Fixed an issue that caused processing of event_party_team_swap() to error in some very rare cases.

v3.3.5

Added

• SeasonStartTimestamp.SEASON_15

• SeasonEndTimestamp.SEASON_14

Bug Fixes

• Fixed an issue that caused fetching battlepass levels for a new season to not work if the seasons timestamp was not added yet.

v3.3.4

Fixed typo in the Platform.XBOX_X value. Whoops.

v3.3.3

Added

• Added Platform.XBOX_X

• Added Platform.PLAYSTATION_5

v3.3.2

Hotpatch to fix parties showing as outdated after the Fortnite v14.50 update.

Added

• Added kwarg party_version to Client so that a custom party version can be set.

Bug Fixes

• Fixed parties showing as outdated.

v3.3.1

Small patch to fix a problem with bots showing as offline when added as a friend.

Big Fixes

• Fixed an issue that caused bots to appear as offline when being added by a new friend.

• Fixed an error in the processing of PartyMember.corruption that often resulted in huge error spams.

• Client.set_presence() now also correctly saves the away status.

• Fixed a rare error in the processing of html errors being returned from graphql services.

v3.3.0

Changed

• Changes made to PartyMember.create_variant():

  • (Renamed) PartyMember.create_variants -> PartyMember.create_variant(). This is not breaking though as its aliased to its old name.

  • (Breaking) Removed kwarg particle_config in favor of the new config_overrides.

• Updated build version to fortnite v14.10.

Added

• Added PartyMember.corruption.

• Added kwarg corruption to ClientPartyMember.set_outfit() and ClientPartyMember.set_backpack().

• Added event event_party_member_enlightenments_change().

• Added event event_party_member_corruption_change().

• Added alias abort() for OutgoingPendingFriend.cancel().

Bug Fixes

• Fixed variants not working after fortnite v14.10.

• Fixed outdated lobby errors when the bot was leader.

• Fixed an issue that caused Client.get_outgoing_pending_friend() and Client.get_incoming_pending_friend() to error when it should have return None.

• Fixed a rare race condition issue that could break processing of event_friend_request_abort() and event_friend_request_decline()

v3.2.0

Changed

• (Breaking) Reworked Client.fetch_multiple_battlepass_levels() and other methods related to battlepass levels.

  • They now require a season number to be specified.

  • They now return float instead of int. You no longer have to divide the value yourself by 100.

• (Breaking) Client.add_friend() now raises more specific errors when friendship limits has been exceeded.

• (Breaking) HTTPException.message_vars is now always a list.

• ReceivedPartyInvitation.accept() now returns the newly joined ClientParty.

Added

• Added Client.fetch_multiple_br_stats_collections().

• Added User.fetch_br_stats_collection().

• Added enum StatsCollectionType.

• Added StatsCollection.

• Added HTTPException.route.

• Added User.add().

• Added three new errors related to friend limits:

  • MaxFriendshipsExceeded

  • InviteeMaxFriendshipsExceeded

  • InviteeMaxFriendshipRequestsExceeded

• Exposed Route and documented it.

• Added following classmethods to all enumerations:

  • get_random_member()

  • get_random_name()

  • get_random_value()

• Added SeasonStartTimestamp.SEASON_14 and SeasonEndTimestamp.SEASON_13

Removed

• Removed Client.remove_all_friends() as it had been deprecated by epic.

• Removed the undocumented attribute HTTPClient.session.

Bug Fixes

• Fixed a rare race condition causing the clients party member object to be missing.

• Fixed an issue introduced in the last update which caused season timestamps to be a little incorrect. Fetching battlepass levels was sometimes affected by this issue.

• Fixed an issue that caused the http client to retry a request one too many times.

• Fixed an issue where some graphql requests would error on 500 statuses instead of retrying.

Docs

• Added attribute tables for most models and dataclasses where it makes sense.

• Added source links for methods and classes.

• Changed the font used and cleaned up some other stuff a little.

v3.1.0

Changed

• Renamed event_close() -> event_before_close(). This isn’t a breaking change though as it still exists under event_close().

• Renamed PresenceGameplayStats.num_kills -> PresenceGameplayStats.kills but an alias still exist under the old name.

• The client now reconnects to its last known party on auth refresh.

• [Ext Commands] ext.commands.Group now inherits case_insensitive if not explicitly specified.

Added

• Added event_before_start().

• Added before_start and before_close kwargs to run_multiple().

• Added Friend.wait_until_online().

• Added Friend.wait_until_offline().

• [Ext Commands] Added ext.commands.GroupMixin.qualified_case_insensitive to get the defining case_insensitive value.

Bug Fixes

• event_before_close() now does not break the logout if an error was raised in the callback.

• Fixed fetching battlepass levels for season 13.

• Fixed an issue where HTTPExceptions could hypothetically in some rare cases be incorrect.

• Fixed exponential backoff retries not working because of a typo (oops).

• Fixed a race condition that caused the clients party member to not always equip its default meta.

• Silenced a noisy error raised by aioxmpp on connection lost.

• Fixed a crash on start caused by the special unallowed characters in the clients display name (for good this time).

• Fixed an error raised in the processing of event_party_member_zombie() if the client was not fully started.

• The client now has a correct multi user chat nick (not that it really matters).

v3.0.2

Another quick hotpatch.

Bug Fixes

• Fixed TypeError: _request() got an unexpected keyword argument ‘config’.

v3.0.1

Quick hotpatch.

Changes

• (Breaking) Client.fetch_party() now returns None instead of raising an error if not found.

Bug Fixes

• Fixed event_party_member_kick() (oops).

• Fixed a small race condition issue regarding party reconnect.

v3.0.0

This major update focuses on stability but also introduces lots of additions and changes.

Changed

• (Breaking) Renamed ProfileSearchPlatform -> UserSearchPlatform.

• (Breaking) Renamed ProfileSearchEntryUser -> UserSearchEntry.

• (Breaking) The access attribute for caches now return a copied list of the caches values. This affects these attributes:

  • Client.friends

  • Client.pending_friends

  • Client.blocked_users

  • Client.presences

  • Party.members

• (Breaking) Renamed Client.join_to_party() -> Client.join_party().

• (Breaking) Renamed Client.set_status() -> Client.set_presence().

• (Breaking) Renamed Client.send_status() -> Client.send_presence().

• (Breaking) Renamed event_party_member_disconnect() -> event_party_member_zombie().

• Renamed multiple fetch methods. All of the renamed methods are still aliased to their previous names so this should break anything.

  • Client.fetch_profile_by_display_name() -> Client.fetch_user_by_display_name().

  • Client.fetch_profiles_by_display_name() -> Client.fetch_users_by_display_name().

  • Client.fetch_profile() -> Client.fetch_user().

  • Client.fetch_profiles() -> Client.fetch_users().

  • Client.fetch_profile_by_email() -> Client.fetch_user_by_email().

  • Client.search_profiles() -> Client.search_users().

• Removed usage of the loop parameter internally since asyncio is deprecating it soon.

• The client now logs out and returns the start call (Client.start() or Client.run()) when too many reauth attempts has been tried. This happens even if the client has previously successfully logged in and emitted event_ready().

Added

• Added parameter error_callback to start_multiple() and run_multiple().

• Added parameter away to Client to set the clients presence AwayStatus.

• Added proper ratelimit and retry handling for http requests.

• Added parameter http_retry_config to Client which controls how http ratelimits and retries are handled. Check out its new dataclass HTTPRetryConfig to see the options you can set.

• Added Client.incoming_pending_friends to get a list of the clients incoming pending friends.

• Added Client.outgoing_pending_friends to get a list of the clients outgoing pending friends.

• Added Client.get_incoming_pending_friend() to get an incoming pending friend by their id.

• Added Client.get_outgoing_pending_friend() to get an outgoing pending friend by their id.

• Added Client.wait_until_closed().

• Added Client.fetch_party() to fetch a party by its id.

• Added parameter away to Client.set_presence() and Client.send_presence().

• Added HTTPException.request_headers to access the headers of the request that failed.

• Added alias inbound for attribute incoming to IncomingPendingFriend and OutgoingPendingFriend.

• Added alias outbound for attribute outgoing to IncomingPendingFriend and OutgoingPendingFriend.

• Added parameter offline_ttl to DefaultPartyMemberConfig.

• Added PartyMember.offline_ttl to check a members time to live seconds before leaving the party when its connection is lost.

• Added PartyMember.is_zombie() to check if the members connection is currently lost and therefore not responding.

• Added PartyMember.zombie_since to check when a member lost its connection.

• Added Party.join().

• Added ClientParty.set_max_size() to set the max size of the party while in it.

• Added event_invalid_party_invite().

• Added event_party_member_reconnect().

• Added event_xmpp_session_establish().

• Added event_xmpp_session_lost().

• Added event_xmpp_session_close().

• Added compare magic methods (__eq__ and __ne__) to:

  • Avatar

  • Party

  • ClientParty

  • ReceivedPartyInvitation

  • SentPartyInvitation

  • PartyJoinConfirmation

  • Playlist

  • ExternalAuth

  • User

  • BlockedUser

  • UserSearchEntry

  • SacSearchEntryUser

  • User

  • Friend

  • IncomingPendingFriend

  • OutgoingPendingFriend

  • PartyMember

Removed

• Removed parameter check_private from Client.join_party().

Bug Fixes

• Reworked the invalid access token reauth strategy to fix multiple issues that caused stuff to break down completely.

• Fixed an issue regarding joining a bots party when the bot was party leader but not the original creator.

• Fixed party config patching.

• Fixed an issue where bots were not able to join any new lobbies in some rare circumstances.

• Fixed an issue that caused other users to not be able to rejoin or lookup the bots private party even when the user had already been a part of the party before.

• Fixed an issue where HTTPException would sometimes fail at initializing because of a missing required value.

• Fixed multiple issues regarding graphql error responses that was not correctly catched to raise an HTTPException and would raise an ugly error.

• HTTP retries are now attempted for even more errors.

• Fixed an issue where PartyMember.connection wasn’t always updated to use the latest connection.

• Improved the clients knowledge of which member is actually the party leader.

• Fixed and improved lots of stuff regarding sudden connection loss including recovering and dispatching events, automatic party reconnect if the criterias is met and more.

• Fixed an issue where a member was removed from the party internally if their connection was lost but not expired.

• Lowered the deadtime hard limit values for the xmpp connection before reconnecting.

• Fixed a window where ClientParty.me could be None.

v2.3.1

Stability improvements.

Changed

• Dropped the underlying launcher session since it’s not longer used for anything.

• Authentication now attempts to reauthenticate on startup in some cases.

• Reauthentication on sudden access token invalid has been improved.

Bug Fixes

• Fixed some issues with incorrect handling of websocket disconnects that resulted in the xmpp connection to eventually time out.

• A graceful close is now attempted even if the client is not ready.

• Processing of messages now handles some race conditions that some times resulted in FriendMessage.author being None.

v2.3.0

Huge performance improvements and lots of bug fixes.

Changed

• Internal parsing of xmpp stanzas like presences and messages are now processed by a custom processor which bypasses aioxmpp’s slow processing whenever possible. This is more noticable on accounts with lots of online friends. Internal tests are showing performance speeds to be more than three times faster than before.

Added

• Added missing docs for connector keyword argument in Client.

• Added keyword argument ws_connector to Client.

• Added __slots__ to Avatar.

Removed

• Removed two undocumented attributes related to presences to reduce memory footprint:

  • Presence.raw_properties

  • PresenceParty.raw

Bug Fixes

• Fixed lots of issues regarding the xmpp over websocket solution. The most noticable one is that xmpp will auto reconnect on errors and unexpected closings.

• Fixed invalid refresh token sometimes crashing the bot while refreshing the session. NOTE: This only works when using DeviceAuth or AdvancedAuth.

• Fixed an issue where stored meta changes from DefaultPartyConfig.meta wasn’t always applied correctly when creating a new party.

• Fixed an issue where some meta props wasn’t always updated when using ClientParty.edit() or ClientPartyMember.edit().

• aiohttp.BaseConnector’s passed to Client will no longer be closed when the client is closed.

• Fixed PartyMember.external_auths always being empty when the member was a part of ClientParty.

• Fixed an issue that caused the client to sometimes leave the party some seconds after joining due to an event not being fired.

• The client will no longer send out its presence two times on startup. Sowwy epic :(

v2.2.1

Fixes an issue that caused some accounts with lots of friends to crash on startup.

v2.2.0

Changed

• (Breaking) Split PendingFriend into two separate objects IncomingPendingFriend and OutgoingPendingFriend depending on the direction of the request. Keep in mind that Client.pending_friends can include instances of both classes.

• (Breaking) event_friend_presence() now takes two arguments before and after.

• (Breaking) PendingFriendBase.inbound has been renamed to PendingFriendBase.incoming.

• Made some small visual improvements to the documentation.

Added

• Added SeasonEndTimestamp.SEASON_12 and SeasonStartTimestamp.SEASON_13.

• You can now cancel outgoing friend requests with OutgoingPendingFriend.cancel().

• Added Store.special_featured_items.

• Added Store.special_daily_items.

• Added missing documentation to various attributes, methods and functions. The most relevant is the addition of meta keyword-arg to DefaultPartyConfig which was already implemented but not documented.

• Added missing type hinting to various methods.

Removed

• Removed API KEY usage from the Fortnite-API example. Thanks (cup#9125).

• Removed some piece of code which auto claimed the fortnite entitlement. This has not been actively used for some updates.

• beautifulsoup4 and websockets have been removed from requirements because they’re no longer used.

Bug Fixes

• Fixed various bugs regarding the xmpp over websocket solution introduced in the last minor update. The library now uses aiohttp for websockets instead of the websockets library.

• Fixed a rare issue regarding last_online that sometimes crashed the client on startup.

• Fixed an issue that caused voice chat to not work for regular users in the clients party.

• Fixed a rare error that was sometimes raised in PartyJoinConfirmation.confirm() and PartyJoinConfirmation.reject()

• Silenced an error in processing of event_party_invite().

v2.1.1

Fixes an issue where Friend.last_logout would sometimes be a string after v2.1.0.

v2.1.0

This update fixes the new xmpp authentication issue + some other bugs.

Bug Fixes

• Fixed xmpp authentication by running xmpp over a custom xmpp over websocket connector.

• You can now use ProactorEventLoop with fortnitepy.

• Fixed an issue where a bot would not be able to start in some scenarios because of a friend missing the last_online property.

• Fixed an issue where a party was not created after refreshing the session. This was the cause of error code -93 after refreshes.

• Fixed an issue that caused Client.restart() to not work.

• Silenced an error in processing of party_team_member_swap().

v2.0.7

Fixes bugs introduced in fortnite v13.00 + fixes other bugs and adds some other changes.

Changes

• Client.add_friend() and other methods to add/accept friends now raises more specific exceptions.

• A RuntimeError with more info is now raised if a running ProactorEventLoop is found when importing fortnitepy.

Added

• DuplicateFriendship

• FriendshipRequestAlreadySent

Bug Fixes

• Fixed an issue that caused no party meta related stuff to work after fortnite v13.00 (Invisible players fix).

• Fixed an issue where presence initialization failed because of a missing property.

• Removed party from ClientUser.

• Fixed an issue where the xmpp stream would timeout in some cases. (Fixes issue #67)

• SentPartyInvitation has now been added to the docs.

• event_command_error(), event_command() and event_command_completion() are now properly named in the documentation.

v2.0.6

Various bug fixes

Bug Fixes

• Fixed an issue that caused EmailAndPasswordAuth to not work in some cases.

• Fixed errors not being raised correctly in newer versions when using start_multiple() or run_multiple().

• Unnecessary errors are not longer raised when closing the client before it has started.

• Fixed an issue that caused event_party_member_in_match_change() to not work.

Other

• Added documentation to ClientPartyMember.set_in_match() and ClientPartyMember.clear_in_match().

• Edited docstrings in all examples to be up to date with recent changes.

v2.0.5

Changes

• Added AuthorizationCodeAuth as an auth method.

• Added optional parameter authorization_code to AdvancedAuth.

• Added optional parameter prompt_authorization_code to AdvancedAuth.

• (Breaking) Renamed optional parameter prompt_exchange_code_if_invalid -> prompt_code_if_invalid for AdvancedAuth.

• (Breaking) Renamed optional parameter prompt_exchange_code_if_throttled -> prompt_code_if_throttled for AdvancedAuth.

• (Breaking) Renamed parameter exchange_code -> code for ExchangeCodeAuth.

• Updated all examples to use prompt_authorization_code since thats now the easiest method.

v2.0.4

Small update which introduces some serious memory optimizations for accounts with many friends + exchange code fix.

Changes

• Added keyword argument prompt_exchange_code_if_invalid to AdvancedAuth.

• Exchange code prompt messages now includes the cause for exchange code being needed.

• Added AuthException.original which can be used to retrieve the original error object.

• Made some serious changes to optimize memory usage.

• Corrected the endpoint used for retrieving an exchange code in EmailAndPasswordAuth.

• Fixed an issue that caused invalid party team position swap requests to not be handled correctly.

• Fixed an issue where constructing presences would fail in some cases due to an unexpected type.

v2.0.1

Hotpatches to fix some overlooked major bugs.

v2.0.0

Big update which adds a commands extension and other huge changes.

Changes

• The main way to access the clients party has been moved from ClientUser to Client. client.user.party -> client.party.

• Client’s keyword arg default_party_config has been completely reworked. Read more about it on Client’s page.

• Client’s keyword arg default_party_member_config has been completely reworked. Read more about it on Client’s page.

• Renamed Client.logout() -> Client.close().

• Renamed event_logout() -> event_close().

• Renamed PartyInvitation -> ReceivedPartyInvitation.

• Presence.avatar now returns Avatar.

Added

• Ext.commands has been ported from discord.py to work with fortnitepy. All changes are wayyyy to big to mention in this changelog. You can read more about it here here.

• Added Client.search_profiles() to search up to 100 users by a name prefix.

• Added ProfileSearchEntryUser.

• Added enum ProfileSeachPlatform.

• Added enum ProfileSearchMatchType.

• Added Client.search_sac_by_slug() to search for support a creator code owners by a slug.

• Added SacSearchEntryUser.

• Added Avatar. This can be passed to Client on initialization to set an avatar for the bot.

• Added enum KairosBackgroundColorPreset which offers color presets for Avatar.

• Added Client.set_avatar() to set a new avatar while the client is running.

• Added Friend.fetch_mutual_friends() to fetch friends the client and this friend have in common.

• Added event event_party_team_swap().

• Added event event_party_member_in_match_change().

• Added event event_party_member_match_players_left_change().

• Added new example for integration with the web server Sanic.

• Added an ios session that is kept alive at all times. This means that you finally can use internal device auth methods after launch.

• Added Client.remove_all_friends().

• Added enums SeasonStartTimestamp and SeasonEndTimestamp to help with passing season start and ends to stats methods.

• Added start_time and end_time kwargs to all battlepass level fetch methods. This can be used to fetch levels from past chapter 2 seasons.

• Added enum AwayStatus.

• Added JustChattingClientPartyMember that can be passed to DefaultPartyMemberConfig for the client to

• Added DefaultPartyConfig.

• Added DefaultPartyMemberConfig.

• Added enum PartyDiscoverability.

• Added enum PartyJoinability.

• Added SentPartyInvitation which represents a sent party invite and offers functionality like resending the invite and cancelling it.

• Added ClientParty.edit().

• Added ClientParty.edit_and_keep().

• Added PartyMember.position to get a members position in a party.

• Added PartyMember.will_yield_leadership.

• Added PartyMember.is_just_chatting().

• Added PartyMember.in_match().

• Added ClientPartyMember.set_in_match().

• Added ClientPartyMember.clear_in_match().

• Added PartyMember.match_started_at.

• Added PartyMember.match_players_left.

• Added PartyMember.swap_position().

• Added keyword enlightenment to ClientPartyMember.set_backpack().

• Added Party.get_member().

• Added ClientParty.fetch_invites().

• Added Presence.away.

• Added Presence.in_kairos.

Removed

• Removed Client.update_net_cl().

• Removed Friend.fetch_mutual_friend_count. You can now use the new Friend.fetch_mutual_friends().

• Removed ClientPartyMember.set_shout().

• Removed Presence.avatar_colors.

Bug Fixes

• Fixed an issue that caused party methods and sometimes party to be None whenever a new party was being created.

• Fixed an issue that caused sessions to not be correctly killed when closing.

• Fixed an issue where it was not possible to register more than one of each event.

• Fixed an issue that caused event_party_member_confirm() to not always work.

• Client.to_iso() now only has floating point precision of three like fortnite expects.

• Client.run() and other utility run functions now works correctly in docker environments.

• Fixed an issue that caused display name cache lookups in profile fetch methods to not work.

• Client.event() can now also correctly be used on staticmethods.

• Fixed an issue that caused start_time and end_time in all stats fetch methods to not work.

• Client.fetch_multiple_br_stats() now accepts more than 51 owners.

• Fixed an issue where HTTPException’s were incomplete when raised from a graphql request.

• Fixed an issue that caused some meta values to be incorrect in some instances because of a parsing error.

• Fixed an issue where PartyMember.platform could be None in some rare cases.

• Fixed an issue that crashed the client on startup if the clients display name contained arabic or other letters that are read in the other direction.

Miscellanious

• Updated the build version.

• Removed documentation for old client kwarg engine_build.

• Fixed some documentation issues.

v1.7.0

Update to fix some issues regarding auth and overall control over the application + some more.

Changes

• The exchange_code argument in ExchangeCodeAuth and keyword argument in AdvancedAuth now also accepts a callable or awaitable that must return an exchange code in form of a str.

Added

• Added Client.fetch_profile_by_email() to fetch a User by their email.

• Added RefreshTokenAuth which can be used to authenticate by a launcher refresh token.

• Added keyword argument gap_timeout to start_multiple() and run_multiple(). The value passed decides how long it should sleep between starting the clients to avoid throttling.

• Added PartyMember.enlightenments to check the members enlightenment values.

• Added keyword argument enlightenment to ClientPartyMember.set_outfit(). Read more about it in the docs.

Bug Fixes

• Fixed an issue that caused Client.restart() not to work with all of the available auth methods.

• Fixed an issue where the wrong refresh_token was refreshed which resulted in no active launcher access token to be valid after the first auth refresh (~8 hours).

• Fixed run_multiple() not shutting down correctly in environments that depend on signals to shut down the process.

• The client now ignores ghost pings (invites).

v1.6.2

Fixes HTTPException not being raised and changes some stuff related to AuthException.

Changes

• AuthException is now only raised when invalid credentials (email/password, device auth, exchange code or 2fa code) are passed and some other misc failures. It will no longer eat all errors raised.

• Removed HTTPException.reraise().

Added

• Added parameter prompt_exchange_code_if_throttled to AuthException. If set to True it will prompt exchange code if the account is throttled.

Bug Fixes

• Fixed an issue that caused no HTTPException’s to be raised. This caused other errors which often looked weird.

v1.6.1

Hotpatch to fix bots not being able to start.

Bug Fixes

• Fixed an issue that caused json payloads sometimes not being decoded.

v1.6.0

This update fixes device authentication and adds some new methods to play around with.

Added

• Added ClientPartyMember.set_shout() to set a shout (Unreleased feature which plays small audio clips).

• Added a parameter run_for to ClientPartyMember.set_emoji().

• Added ClientPartyMember.clear_backpack().

• Added ClientPartyMember.clear_pet().

• Added ClientPartyMember.clear_contrail().

• Added ClientPartyMember.clear_assisted_challenge().

Bug Fixes

• Fixed an issue that caused device auth to not work with newly generated details.

• Fixed an issue that caused Client.fetch_profile_by_display_name() to not work if the account requested had linked external platforms to their account.

v1.5.5

Update to fix a breaking issue and also change some other necessary stuff.

Changes

• Friend.last_logout now always is None when the friend is added while the client is running.

Added

• Added Friend.fetch_last_logout() to fetch the last logout of a friend.

Bug Fixes

• Fixed an issue that caused some events not to work correctly due to an unknown payload being received.

• Fixed an issue that caused the client to attempt to join two or more parties at a time.

• Fixed an issue that in rare cases caused cache initialization to fail on startup and therefore break.

• Fixed a race condition between two events that very rarely broke the clients party.

• Readded detailed stack traces for HTTPException in most cases.

v1.5.4

Another hotpatch to fix a breaking auth refreshing issue.

Bug Fixes

• Fixed an issue that caused stuff to break after auth refresh.

• Fixed an issue that caused the cache keyword to be ignored in Client.fetch_profile() and similar fetch profile functions.

• (Docs) Fixed an issue causing ExternalAuth’s section to be empty.

v1.5.3

Hotpatch to fix auth refreshing.

Bug Fixes

• Fixed an issue that caused auth refreshing not to work.

• Silenced an unecessary error raised sometimes when the bot left a party.

v1.5.2

Another update add some changes and fix a big issue introduced in v1.5.0.

Changes

• PartyMember.ready now is a value of the enum ReadyState instead of an Optional[bool].

• ClientPartyMember.set_ready()’s only parameter was renamed to state and now takes a value of ReadyState instead of an Optional[bool]

• event_party_member_ready_change()’s arguments before and after now is a value of the enum ReadyState instead of a str.

• Friend.platform now is a value of the enum Platform instead of a str.

• Presence.platform now is a value of the enum Platform instead of a str.

• PresenceParty.platform now is a value of the enum Platform instead of a str.

• PartyMember.platform now is a value of the enum Platform instead of a str.

Added

• Added enumeration ReadyState.

• Added method PartyMember.is_ready() to check if a member is ready or not.

• Added method Client.is_closed() to check if the client is logged out and closed.

Bug Fixes

• Fixed an issue that caused members of a party not to load correctly when the client was the leader of the party.

• Fixed an issue that caused an incorrect member to be marked as the leader of the party.

• The client will no longer try to promote itself when promoting a random member when changing ready state to ReadyState.SITTING_OUT.

v1.5.1

Quick hotpatch to fix Python 3.5 & 3.6 compatibility.

Bug Fixes

• Fixed Python 3.5 & 3.6 compatibility.

v1.5.0

This update fixes some important bugs and introduces functionality to ban members in party chat.

Removed

• Removed get_event_loop() since it’s no longer needed. Use asyncio.get_event_loop().

Added

• Added Friend.platform to get the currently used platform by the friend if online.

• Added Presence.platform to get the platform the presence was sent from.

• Added PartyMember.chatban() to chatban a member.

• Added PartyMember.is_chatbanned() to check if a member is chatbanned.

• Added ClientParty.chatbanned_members to get a mapping of all chatbanned members.

• Added event event_party_member_chatban() which emits when a party member was chatbanned.

Bug Fixes

• Fixed compatibility with Python 3.8 on windows specifically by setting the event loop policy to asyncio.WindowsSelectorEventLoopPolicy.

• The email passed in event_device_auth_generate() is now never None and always the correct email.

• Fixed an issue that caused party members of a party you joined to have the default meta values.

• Fixed an issue that caused event_party_invite() to not emit.

• Fixed an issue that caused an internal method to never be run.

• Fixed ClientPartyMember.leader.

• Fixed an issue that caused an error to be raised when a message from a non-party member was sometimes received.

v1.4.0

Very breaking update introducing new methods to authenticate, type hinting and more.

Changes

• You no longer pass an email and a password directly when initializing Client. auth is the new parameter taking one of the new authentication methods. Read more about them here here.

• Also moved parameters two_factor_code, launcher_token, fortnite_token and device_id to the auth object.

• Friend.join() now returns the new ClientParty the client just joined.

Bug Fixes

• Fixed ClientPartyMember.set_assisted_challenge().

• Fixed an issue that caused Client.fetch_profile_by_display_name() to return a User with missing external auths.

v1.3.1

Fixes some issues from the last update.

Added

• Client.get_blocked_user() to get a blocked user from the internal cache.

• Client.is_blocked() to check if a user is blocked.

Bug Fixes

• Fixed an issue that broke startup of accounts with a large amount of friends.

• Optimized startup speed of accounts with a large amount of friends.

• Fixed an issue that caused the internal blocked users cache to not get initialized correctly.

• Fixed another breaking issue that would break cache initializations.

• Friend.nickname and Friend.note now correctly is None if not set.

• Fixed an issue causing Client.has_friend() to return the wrong value (even though technically it did work).

• Fixed an issue where some dataclasses inheriting from User was missing external auths at some times.

v1.3.0

Introduces some much awaited utility functions for starting multiple accounts at once and more stability in general.

Changes

• [Breaking] Member meta attributes assisted_challenge, outfit, backpack, pickaxe, contrail and emote now returns the asset path instead of just the id.

• [Breaking] User.external_auths has been changed and fully utilized.

• Optimized the auth flow and general startup speeds by ~1 second.

• Lookup methods now also searches for non-epic accounts.

• User.display_name now uses an external display name if the account is not linked to an epic account.

• Client.fetch_br_stats() now raises Forbidden if the account requested has private stats.

• Changed some examples to reflect some of this updates changes.

Added

• Added a parameter cache_users to Client and can be used to turn off the users cache and therefore in some cases save some memory but sacrificing a little speed on some user lookups.

• Added utility functions run_multiple(), start_multiple() and close_multiple() to help with controlling multiple clients at once.

• Added support for pets with ClientPartyMember.set_pet(), ClientPartyMember.pet and the event event_party_member_pet_change().

• Added support for emojis with ClientPartyMember.set_emoji(), ClientPartyMember.emoji and the event event_party_member_emoji_change().

• Added HTTPException.validation_failures.

• Added User.epicgames_account to check if an account is an epicgames account.

• Added an example for usage with the api https://fortnite-api.com/.

Bug Fixes

• Fixed an issue that caused Client.start() to return whenever Client.restart() was returned.

• Client.restart() now correctly returns errors.

• Fixed an issue that in some rare cases caused task cancelling on shutdown to break.

• Fixed an issue that caused Client.fetch_profiles() to break in some cases where you looked up an id and a display name.

• Some annoyingly long error stack traces should now be a little smaller (without losing any context).

• Fixed an issue that caused buying fortnite on accounts that did not already own it to fail.

• Fixed an issue that caused ClientPartyMember.set_assisted_challenge() to break if no asset was passed.

• Fixed a rare issue that caused some presences to break.

• Fixed a trailing issue from last update that caused some events regarding pending friend requests to not work properly.

v1.2.2

Fixes the login flow and another breaking login bug.

Changes

• [BREAKING] Attribute favorite removed from PendingFriend.

Bug Fixes

• Fixed the login flow (you can now actually log in to an account).

• Fixed an issue where login would break because of a missing parameter in a payload.

v1.2.1

Fixes small mistakes introduced in v1.2.0.

Bug Fixes

• The client no longer sends a party message every time a new member joins (oops).

• Using ClientPartyMember.clear_emote() now cancels current clear tasks created by run_for.

• Fixed some docs issues as well as a logging issue.

v1.2.0

This update adds a lot of new stuff and also increases stability.

[ALL BREAKING] Changes

• event_logout() is no longer called when the client is logged out via Client.restart().

• PartyMember.create_variants() is now a staticmethod.

• [RENAME] Client.get_blocklist() -> Client.fetch_blocklist()

• [RENAME] DefaultCharacters -> DefaultCharactersChapter1

Added

• When setting the clients status, you can now use two placeholders {party_size} and {party_max_size} which is replaced automatically when status is sent.

• Added BlockedUser with a single unique method being BlockedUser.unblock().

• Added a cache for blocked users.

• Added Client.blocked_users.

• Added User.block().

• Added PartyMember.contrail and ClientPartyMember.contrail.

• Added PartyMember.contrail_variants and ClientPartyMember.contrail_variants.

• Added ClientPartyMember.set_contrail().

• Added event event_party_member_contrail_change().

• Added event event_party_member_contrail_variants_change().

• Added DefaultCharactersChapter2. A random skin for ClientPartyMember is now chosen from this enum.

• Added kwarg profile_banner to PartyMember.create_variants().

• Added Region.MIDDLEEAST and removed Region.CHINA.

• Added PresenceGameplayStats.friend.

• Added magic methods to some classes where it made sense:

  • Friend (__repr__, __str__)

  • PendingFriend (__repr__, __str__)

  • ClientUser (__repr__, __str__)

  • User (__repr__, __str__)

  • BlockedUser (__repr__, __str__)

  • PartyMember (__repr__, __str__)

  • ClientPartyMember (__repr__, __str__)

  • Party (__repr__, __str__)

  • ClientParty (__repr__, __str__)

  • PartyInvitation (__repr__)

  • PartyJoinConfirmation (__repr__)

  • FriendMessage (__repr__)

  • PartyMessage (__repr__)

  • BattleRoyaleNewsPost (__repr__, __str__)

  • Playlist (__repr__, __str__)

  • PresenceGameplayStats (__repr__)

  • PresenceParty (__repr__)

  • Presence (__repr__)

  • StatsV2 (__repr__)

  • Store (__repr__)

  • FeaturedStoreItem (__repr__, __str__)

  • DailyStoreItem (__repr__, __str__)

Bug Fixes

• Fixed two factor authentication.

• Fixed an issue that caused event_party_member_confirm() to not work when defined in a subclass of Client.

• Fixed an issue that caused Client.fetch_blocklist() to not work.

• The HTTP client now attempts to resend a request if server_error or concurrent_modifaction_error is received.

• Fixed an issue that caused PartyMember.kick() to raise an incorrect error.

• Calling ClientPartyMember.set_emote() with the run_for keyword argument will now cancel any existing emote cancelling tasks created by run_for before.

• Fixed an issue where an error would be raised if the client was friends with someone that had never entered fortnite before.

• Fixed two rare errors raised because of missing attributes in xmpp event payloads.

• Fixed an noisy issue where the client sometimes attempted to remove a missing pending friend from the cache.

• Fixed an issue that caused the processing of variant changes from other party members to fail.

• Fixed a noisy issue that was raised on startup of some clients (bIsPlaying).

• Fixed an issue that caused PartyInvitation.decline() to raise an error.

v1.1.0

This update adds some much awaited edit functions to ClientPartyMember as well as some important bug fixes.

Added

• Added ClientPartyMember.edit() which patches multiple meta changes at once.

• Added ClientPartyMember.edit_and_keep() which patches multiple meta changes at once and then keeps the changes so they are automatically equipped when joining new parties.

• Added keyword default_party_member_config to Client which takes a list of meta changes and automatically equips them when joining new parties.

Bug Fixes

• Fixed Friend.remove().

• Fixed an issue where PartyMember.outfit would sometimes raise an error.

• Fixed an issue causing an error to sometimes be raised when a new member joined the party.

• Fixed an issue causing an error to sometimes be raised when a message was received from party chat.

v1.0.3

Another hotpatch to fix a silly issue from the last one .-.

Bug Fixes

• Fixed Client.from_iso().

v1.0.2

Another hotpatch.

Changes

• Fixed an issue where event_party_member_kick() would not emit if the member was kicked by the client.

• Fixed a bug that caused an error to be raised when converting a string to a datetime object internally.

• Client.join_to_party() now waits until the client has joined the party before returning.

• PresenceParty.join() now returns the ClientParty that was just joined.

v1.0.1

Quick update to fix some issues brought along with v1.0.0.

Added

• Added event_friend_request_decline() which emits when a friend request in either direction is declined.

Renamed

• Client.get_user()’s only parameter has been renamed from id to user_id.

• Client.get_friend()’s only parameter has been renamed from id to user_id.

• Client.get_presence()’s only parameter has been renamed from id to user_id.

• Client.get_pending_friend()’s only parameter has been renamed from id to user_id.

• Client.has_friend()’s only parameter has been renamed from id to user_id.

• Client.is_pending()’s only parameter has been renamed from id to user_id.

• Client.block_user()’s only parameter has been renamed from id to user_id.

• Client.unblock_user()’s only parameter has been renamed from id to user_id.

Bug Fixes

• Unavailable presences now work as expected again.

• Fixed an issue where an error was raised when when removing a friend in some special cases.

• Fixed an issue that caused Client.remove_or_decline_friend() to not work.

v1.0.0

BREAKING UPDATE

Massive code overhaul and lots of new stuff / bugs fixes. Keep in mind that this is a very big update so issues and bugs might appear. If so, report them either on the issue tracker or on discord.

Added

• Added Client.restart() which restarts the client completely.

• Added Client.accept_friend() which accepts a friend and then returns the Friend object of the friend you added.

• Added Friend.nickname which returns the currently set nickname for a friend.

• Added Friend.note which returns the currently set note for a friend.

• Added Friend.last_logout which returns the time of a friends last logout.

• Added Friend.fetch_mutual_friends_count() which returns the number of mutual friends the friend and the client have.

• Added Friend.set_nickname() to set a friends nickname.

• Added Friend.remove_nickname() to remove the friends nickname.

• Added Friend.set_note() to pin a note to a friend.

• Added Friend.remove_note() to remove the note pinned to a friend.

• Added ClientUser.email_verified.

• Added ClientUser.minor_verified.

• Added ClientUser.minor_expected.

• Added ClientUser.minor_status.

• Added event event_restart() which emits when the client has successfully restarted.

• Added event event_auth_refresh() which emits when the clients authentication has been successfully refreshed.

• Added event event_party_playlist_change() which emits when the playlist of the clients current party is changed.

• Added event event_party_squad_fill_change() which emits when the squad fill value is changed.

• Added event event_party_privacy_change() which emits when the party privacy is changed.

• Added event event_party_member_ready_change() which emits when a members ready state is changed.

• Added event event_party_member_input_change() which emits when a members input is changed.

• Added event event_party_member_assisted_challenge_change() which emits when a members assisted challenge is changed.

• Added event event_party_member_outfit_change() which emits when a members outfit is changed.

• Added event event_party_member_backpack_change() which emits when a members backpack is changed.

• Added event event_party_member_pickaxe_change() which emits when a members pickaxe is changed.

• Added event event_party_member_emote_change() which emits when a members emote is changed.

• Added event event_party_member_banner_change() which emits when a members banner is changed.

• Added event event_party_member_battlepass_info_change() which emits when a members battlepass info is changed.

• Added event event_party_member_outfit_variants_change() which emits when a members outfit variants is changed.

• Added event event_party_member_backpack_variants_change() which emits when a members backpack variants is changed.

• Added event event_party_member_pickaxe_variants_change() which emits when a members pickaxe variants is changed.

[ALL BREAKING] Renamed

• event_party_updated() -> event_party_update()

• Client.remove_friend -> Client.remove_or_decline_friend()

• PartyMember.is_leader -> PartyMember.leader

• ClientPartyMember.is_leader -> ClientPartyMember.leader

• Party.squad_fill_enabled -> Party.squad_fill

• ClientParty.squad_fill_enabled -> ClientParty.squad_fill

• PartyInvitation.author -> PartyInvitation.sender

• PresenceParty.is_private -> PresenceParty.private

• Presence.is_available -> Presence.available

• Presence.is_playing -> Presence.playing

• Presence.is_joinable -> Presence.joinable

Changes

• Client.start() now takes an optional parameter dispatch_ready which determines if the event_ready() should be dispatched when the client is ready.

• Client.logout() now takes an optional parameter close_http which determines if the clients aiohttp.ClientSession should be closed when logged out.

• The decorator Client.event() can now be used by being called. Read more about it on its page.

• [BREAKING] Friend.is_online() is now a method instead of an attribute.

• PendingFriend.accept() now returns the friend object of the friend you just accepted.

• ClientPartyMember.set_ready() now promotes a random member to leader when changing to sitting out.

• [BREAKING] event_party_member_promote() now has an additional parameter which represents the previous leader.

• ClientPartyMember.set_outfit()’s parameter asset is now optional.

• ClientPartyMember.set_backpack()’s parameter asset is now optional.

• ClientPartyMember.set_pickaxe()’s parameter asset is now optional.

Bug Fixes

• Fixed an issue causing the event_party_member_confirm() event to not work.

• Fixed an issue that caused Client.fetch_br_stats() to not work when passing a starttime and an endtime.

• Fixed an issue that caused party_not_found to be raised when the bot was leaving its current party.

• Fixed an issue that caused Friend.favorite to return an incorrect value.

• Swapped some unintentional f-strings (oops) for the python 3.5 supported format method.

• Attempted to fix an issue where an error would be raised saying the clients oauth token was invalid.

• Fixed an issue introduced in fortnite v11.30 that caused adding/removing friends to not work.

• Fixed an issue introduced in fortnite v11.30 that caused inviting and joining parties to not work.

• Fixed an issue that caused Client.fetch_br_stats(), Client.fetch_multiple_br_stats() and Client.fetch_leaderboard() to not work.

• Fixed an issue that caused Presence.playing, Presence.joinable and Presence.has_voice_support to return incorrect values.

• StatsV2.start_time and StatsV2.end_time now returns an UTC timestamp instead of a local timestamp (oops).

• Fixed an issue that caused Client.fetch_item_shop() to emit an error.

• Fixed an issue where Presence.friend would be None.

• Fixed an issue where changing variants with ClientPartyMember.set_outfit(), ClientPartyMember.set_backpack() and ClientPartyMember.set_pickaxe() would sometimes not work properly.

• Fixed an issue where Client.fetch_active_ltms() would sometimes fail and raise an error.

v0.9.0

BREAKING UPDATE

This update adds windows support for python 3.8, removes the need for setting a net_cl and fixes multiple important bugs.

Breaking Changes

• Forbidden has been renamed from PartyPermissionError.

• Reworked and added documentation for Client.join_to_party(). The function no longer takes party as a keyword and a new kwarg check_private has been added.

Changes

• You no longer need to worry about net_cl, ever.

• Added get_event_loop() to get a working event loop on Windows. It isn’t necessary to use this function as long as fortnitepy is imported before the event loop is created.

• Added HTTPException.reraise() which reraises the exception.

• Added Friend.invite() which invites the friend to your party.

• ClientPartyMember.set_banner() and ClientParty.set_playlist()

• The loading time between accepting and joining a party with 2+ users has been significantly decreased.

• PartyInvitation.accept() now raises Forbidden if you attempted to join a private party you have already been a member of before.

Bug Fixes

• Fixed multiple internal issues related to party chat.

• Fixed an issue where that caused invites sent by the client to its private party to not work.

• Fixed an issue where event_party_member_join() would dispatch before party chat was ready.

• Fixed an issue that caused aioxmpp logger to not work.

v0.8.0

BREAKING UPDATE

This update reworks and adds a couple of stats functions, adds some new features that came with Fortnite 2 season 1 and fixes some important bugs.

Breaking Changes

• Most functions with keyword arguments now uses strict kwargs. This means you must specify the argument as a keyword. If you’ve used keyword arguments correctly before, this will not be an issue.

• The new correct way to get stats from the object StatsV2 is now with the StatsV2.get_stats() method. Up until this version the way to get the stats from the object was to call StatsV2.stats.

• Client.fetch_br_stats() now returns None if the user was not found. An empty StatsV2 is still returned if a valid user doesn’t have any recorded stats.

• Client.fetch_multiple_br_stats() now returns None mapped to the passed userid if the user was not found. An empty StatsV2 is still returned if a valid user doesn’t have any recorded stats for the stats you requested.

• The cache keyword argument in Client.fetch_profile(), Client.fetch_profiles() and Client.fetch_profile_by_display_name() now defaults to False which means the client will not attempt to get any of the requested users from the cache.

• Playlist.violator was renamed from violater because of the typo.

• PresenceGameplayStats.players_alive was moved from Presence to PresenceGameplayStats.

Added

• Added a new event event_friend_request_abort() which emits when a sent friend request is aborted before the receiving user has accepted it.

• Added Client.update_net_cl() which updated the current net_cl and party_build_id while the client is running.

• Added Client.fetch_multiple_battleapss_levels() which fetches multiple userids battlepass levels at once.

• Added Client.fetch_battlepass_level() which fetches a userid’s battlepass level.

• You can now pass None to ClientPartyMember.set_ready() to make the client go into the Sitting Out state.

• Added PartyInvitation.net_cl which returnes the net_cl that was sent with a party invitation.

• Added Presence.avatar to get the cid of the friends Kairos avatar.

• Added Presence.avatar_colors to get the background colors of the friends Kairos avatar.

• Added StatsV2.get_stats() which is now the correct approach to getting the users stats mapped to platforms and gamemodes from the object.

• Added StatsV2.get_combined_stats() to get the users combined stats mapped to platforms. There is also an option to combine stats across all platforms.

• Added User.fetch_br_stats() to get a users stats directly from the object. (Function exists for Friend too since it inherits from User)

• Added User.fetch_battlepass_levels() to get a users battlepass level directly from the object. (Function exists for Friend too since it inherits from User)

• Updated net_cl and build info.

Bug Fixes

• StatsV2.start_time and StatsV2.end_time now actually works.

• Removed the new stat s11_social_bp_level from StatsV2.

• Moved the check invalid net_cl check to method PartyInvitation.accept() so it is possible to catch the exception.

• Renamed Playlist.violator from violater because of the typo.

• Waiting for the 2fa code to be entered into console is no longer blocking.

• Playlist now uses __slots__ to reduce its memory footprint.

• Fixed another issue that lead to Incompatible net_cl being incorrectly raised.

• Attempted to fix issue #38.

• Fixed some issues in the docs.

v0.7.0

BREAKING UPDATE

Lots of small bug fixes and some added functionality as well.

Breaking Changes

• Client’s keyword argument platform now accepts the new enumerator Platform instead of str.

• ClientParty.set_playlist() keyword argument region now accepts the enumerator Region instead of str.

• Renamed event_friend_remove() from event_friend_removed.

• Renamed event_party_member_kick() from event_party_member_kicked.

• Renamed event_party_member_disconnect() from event_party_member_disconnected.

• Renamed event_party_member_update() from event_party_member_updated.

• Renamed event_party_member_confirm() from event_party_member_confirmation.

• Renamed event_party_member_cancel() from event_party_member_cancelled.

• Renamed event_party_member_decline() from event_party_member_declined.

• Renamed V2Input from V2Inputs.

• Renamed Region from Regions.

• Removed attribute engine_build from Client since it was not being used.

Added

• Added event_logout() which is called just before the client is about to log out.

• Fortnite is now automatically bought for free on startup if the account does not already own it.

• Added an example to showcase how you can have multiple clients running at the same time.

• Added enumeration Platform.

• Added Client.os. You shouldnt ever need to change this but you could do it by passing a different value with the os keyword when initialising Client.

• Added PartyMember.outfit_variants to get the raw outfit variants of this member.

• Added PartyMember.backpack_variants to get the raw backpack variants of this member.

• Added PartyMember.pickaxe_variants to get the raw pickaxe variants of this member.

• Added keyword variants to ClientPartyMember.set_backpack().

• Added keyword variants to ClientPartyMember.set_pickaxe().

• Added PresenceParty.net_cl to get the net_cl received with this presence.

• Updated net_cl and build info.

Bug Fixes

• Fixed and silenced multiple noisy errors like the OpenSSL error printed on shutdown.

• The default user-agent used internally is now correctly built by Client.build and Client.os.

• Removed the annoying message printed to console every time a friend was added or removed.

• Client now successfully shuts down if an error occurs in the login process.

• You can now try except Client.run().

• Outgoing presences now correctly uses Client.party_build_id instead of Client.net_cl.

• Display names of friends should now always have a value if exists.

• Fixed an issue where a presence would not be sent if a member was promoted to leader of the party.

• Fixed an issue where Presence.friend would sometimes be None.

• Fixed an issue where the platform set would not be visibly changed in-game.

• Fixed an issue where party chat would sometimes not work.

v0.6.4

Little update to push out a better authentication flow.

Added

• Added a more stable, faster and more reliable authentication flow. Thanks iXyles and Bad_Mate_Pat.

v0.6.3

HIGHLY IMPORTANT UPDATE

Fixed authentication to work with the newest changes fortnite made to their services.

Updated

• Updated net_cl.

Bug Fixes

• Fixed authentication.

v0.6.1

Hotpatch to make all datetime objects represented in the UTC timezone.

Changed

• All datetime objects are now represented in the UTC timezone.

Bug Fixes

• Fixed an issue where token refresh would happen at the wrong time.

v0.6.0

BREAKING UPDATE

Reworked parties and added some new stuff. This rework has been in my mind for some time but was recently accelerated because of some breaking bugs that required this rework.

Reworked

• ClientParty is the new object for parties the client is a part of.

• Party is now only used for parties the client is not a part of.

• ClientPartyMember is the new object that represents the client as a partymember.

• PartyMember represents party members like usual but is now mostly read-only with exceptions for some methods.

Note

You can get the ClientPartyMember object from ClientParty.me.

Additions

• Added attr member_count to Party and ClientParty to get the member count of the party.

• Added attr inbound and outgoing to Friend and PendingFriend.

• Added Client.friends to get a mapping of all friends.

• Added Client.pending_friends to get a mapping of all pending friends.

• Added Client.presences to get a mapping of friends latest presence received.

Bug Fixes

• Fixed an issue where PartyMember.direction and PartyMember.favorite would be None in events.

• Fixed an issue where parties would sometimes break down completely when receiving an invite.

v0.5.2

Internal changes 99% of you wont ever notice + some small bug fixes.

Refactored

• Reworked Client.run() to use asyncio.AbstractEventLoop.run_forever() and implemented better task cleanup heavily based of discord.py’s cleanup method.

• Reworked Client.start() and Client.logout() a work better together when logging out while running.

• Changed some internal data body values related to parties to match fortnite’s values.

• The clients XMPP jid will now use a unique id in its resource part.

Bug Fixes

• Fixed an issue with Client.fetch_profiles() where if raw was True and some of the profiles were gotten from cache they would not be returned raw.

• Fixed an issue with Client.fetch_profiles() where if no profiles was retrieved an error would be raised.

v5.0.1

Quick update fixing some small bugs.

Bug Fixes

• Fixed PartyMember.set_emote() raising an error if run_for keyword argument was None.

• Fixed an internal error where the party chatroom was not overwritten correctly when leaving a party.

v0.5.0

Breaking update removing Party.leave() and adding many new meta related party features + important bug fixes.

Breaking Changes

• Removed Party.leave(). Use PartyMember.leave() instead.

New Features

• Added PartyMember.ready which returns the state of a members readiness.

• Added PartyMember.input to check what input a party member is using.

• Added PartyMember.assisted_challenge to get a members currently set party-assisted challenge.

• Added PartyMember.outfit to get the CID of the current outfit a member has equipped.

• Added PartyMember.outfit_variants to get the raw variants of the current outfit a member has equipped.

• Added PartyMember.backpack to get the BID of a members currently equipped backpack.

• Added PartyMember.pickaxe to get a members currently set pickaxe.

• Added PartyMember.emote to get a members currently playing emote.

• Added PartyMember.banner to get a tuple consisting of the members currently set banner.

• Added PartyMember.battlepass_info to get a tuple consisting of the members battlepass info.

• Added PartyMember.platform to get a members platform.

• Added Party.playlist_info to get a tuple consisting of information about the currently set playlist.

• Added Party.squad_fill_allowed which returns the state of squad fill.

• Added Party.privacy to get the partys privacy.

• Added keyword-argument run_for to PartyMember.set_emote() for setting how long an emote should be playing for in seconds.

Updated

• Updated Client.net_cl to match the value from the Fortnite v10.10 update.

• Updated Client.build to match the value from the Fortnite v10.10 update.

• Updated Client.engine_build to match the value from the Fortnite v10.10 update.

Bug Fixes

• Fixed the naming of event_member_updated() not matching the docs.

• Fixed Client.has_friend() returning the opposite of the correct value.

• Fixed PartyMember.create_variants() not working like intended in some situations.

• Fixed an issue where you would get an error if you tried to initialize the client with a different default party privacy.

• Fixed an issue where Party.set_privacy() would raise an error causing the function to fail.

• Fixed an issue where an error were sometimes raised due to attempting to create a new party while already in a another.

• Fixed PartyMember.set_assisted_challenge() only taking a full path for the quest argument.

• Fixed an issue where members of a party the client is joining would not have updated metas.

• Fixed an issue where an unecessary error would be raised when sending a message to a party chat.

Miscellanious

• Added missing event_party_member_leave() to the event reference.

• Added “How can I fix the Incompatible net_cl error” to the faq.

• Updated the faq answer regarding two factor auhentication usage.

• Updated arena docs example for Party.set_privacy() to match the new arena playlist information introduced in Fortnite v10.

v0.4.1

Small update which adds some basic functionality and fixes some important bugs like invites not working.

New Features

• Added Client.is_ready() which checks if the internal state of the client is ready.

• Added Client.wait_until_ready() which waits for the clients internal state to get ready.

Updated

• Updated Client.net_cl to match the value from the Fortnite v10 update.

• Updated Client.build to match the value from the Fortnite v10 update.

• Updated Client.engine_build to match the value from the Fortnite v10 update.

Bug Fixes

• Fixed party invites not emitting the event_party_invite() event.

• Fixed an issue where event_friend_add() would in some cases return the clients user instead of the player added.

v0.4.0

This is a small feature update I’m releasing before I go on a small vacation. I have a couple more features planned that I wished I had time to add to this update that unfortunately didn’t make it in. They will be included in the next update.

New Features

• event_friend_presence() is now also emitted when a user goes offline on Fortnite.

• Added Presence.is_available to show if the user that emitted this presence is online or went offline.

• Added Friend.is_online to show if a friend is currently online on Fortnite.

• Added support for two factor auhentication. If you do not pass a 2fa code when initializing the client, you will be asked to enter it into console when that time comes.

• You can now pass Client.two_factor_code and Client.device_id to client when initializing.

• Added HTTPException.raw to get the raw error received from Fornite services.

Bug Fixes

• Client.fetch_profile_by_display_name() and Client.fetch_profile() now correctly returns None when the user was not found.

• Fixed an issue where the fetching of friends on startup did not work as intended.

• Fixed an issue where the client would fail to automatically recreate a party in some situations.

• Fixed an issue where party presences was processed as a user presence.

Miscellanious

• Added missing documentation to some functions.

• The Incompatible build id error message will now say Incompatible net_cl to avoid some confusion around what the problem really is.

v0.3.1

Minor release to update build info to match the new values changed in v9.41.

Updated

• Updated Client.net_cl.

• Updated Client.build.

• Updated Client.engine_build.

v0.3.0

This update fixes some of the big issues and bugs with this library making it much more stable. It also introduces a couple of missing methods and attributes.

New Features

• Added PartyMember.leave() for leaving a party and creating a new one.

• Reworked HTTPException to include more data of the request and exception gotten from Fortnite services.

• Added attributes display_names and violator to FeaturedStoreItem and DailyStoreItem.

Bug Fixes

• Fixed XMPP service timing out after a while due to pinging not being handled well enough.

• Fixed asyncio.TimeoutError sometimes occurring when a new party was being made (mainly noticed on startup) which completely shut down the clients party services.

• Fixed stale_revision sometimes occurring when party related request happened making the request completely fail.

• Fixed error code -93 sometimes occurring when trying to join the clients party.

v0.2.0

This is the first major update for fortnitepy. This update includes a fix for an issue with invites not working after the Fortnite v9.40 as well as a couple of new features.

Thanks to amrsatrio and Luc1412 for suggestions and help with this update.

New Features

• Added Client.fetch_lightswitch_status() for checking Fortnite’s status.

• Added Client.fetch_item_shop() for fetching the current item shop.

• Added Client.fetch_br_news() for fetching the current Battle Royale news.

• Added Client.fetch_multiple_br_stats() for fetching a list of stats for multiple users at the same time.

• Added Client.fetch_leaderboard() for fetching the leaderboard for a stat.

• Added the enum V2Inputs for better access to the different input types.

• Added StatsV2.create_stat() for easier and more understandable interaction with V2 stats.

• Added Client.fetch_br_playlists() for fetching all known playlists registered on Fortnite.

• Added Client.fetch_active_ltms() for fetching the active Limited Time Gamemodes for a specific region.

• Added the enum Regions for better access to the regions used by Fortnite services.

• Added PartyMember.create_variants() for easier building of variants used for outfits. The variants system used by Fortnite follows little logic and therefore this function is probably a little confusing. Expect a guide on outfit variants in not too long.

Bug Fixes

• Fixed an issue introduced with the Fortnite v9.40 update that made party invites not work.

• Fixed an issue where the client would not make a new party if the client expires from an earlier party. (fix for fortnite error code -93 upon attempting to join the clients party.)

Miscellanious

• Added some enums and functions to make ready for StatsV1 support coming in a later update.

v0.1.3

Quick update to update new build info that came with the Fortnite v9.40 update.

Updates

• Updated net_cl.

• Updated engine_build.

• Updated build.