# ezfndev/ezfn-lobbybot

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/ezfndev-ezfn-lobbybot).**

6,867 stars · 424 forks · Python

## Links

- GitHub: https://github.com/EZFNDEV/EZFN-Lobbybot
- Homepage: https://ezfn.dev
- awesome-repositories: https://awesome-repositories.com/repository/ezfndev-ezfn-lobbybot.md

## Topics

`bot` `easy-to-use` `ezfn` `fortnite` `fortnite-bot` `fortnitebot` `fortnitebr` `fortnitepy` `lupusleaks` `python`

## Description

EZFN-Lobbybot is an automated Fortnite lobby bot that runs a headless game client to log into Fortnite servers as a real player, maintaining a persistent session without human interaction. Its core purpose is to join Fortnite parties and display every cosmetic item in the game for preview, using a local database of cosmetic item definitions that it injects into the bot's player state.

The bot operates through an ephemeral-client architecture, processing incoming party commands via a FIFO queue to avoid race conditions, while listening for real-time party events through Epic's WebSocket API to react to join and leave requests. It maintains its connection through periodic keepalive packets sent to Fortnite's matchmaking service, and loads all configuration from environment variables or a config file at startup without persisting runtime state.

## Tags

### Software Engineering & Architecture

- [Headless Game Clients](https://awesome-repositories.com/f/software-engineering-architecture/event-logging/bot-event-logs/bot-client-starters/headless-game-clients.md) — Runs a headless Fortnite client that logs into servers as a real player for automated operation.
- [Cosmetic Data Injectors](https://awesome-repositories.com/f/software-engineering-architecture/integration-extensibility/dependency-injection/environment-asset-injection/game-asset-injection/cosmetic-data-injectors.md) — Injects cosmetic item definitions from a local database into the bot's player state to display any item.

### Game Development

- [Lobby Bot Automations](https://awesome-repositories.com/f/game-development/game-automation-bots/lobby-bot-automations.md) — Creates and runs a persistent Fortnite lobby bot for cosmetic previews and party management.
- [Lobby Bots](https://awesome-repositories.com/f/game-development/game-automation-bots/lobby-bots.md) — An automated bot that joins Fortnite parties to display and preview every cosmetic item in the game.

### Graphics & Multimedia

- [In-Game Cosmetic Previews](https://awesome-repositories.com/f/graphics-multimedia/digital-face-filters/virtual-cosmetics/in-game-cosmetic-previews.md) — Joins Fortnite parties to display every cosmetic item in the game for preview. ([source](https://cdn.jsdelivr.net/gh/ezfndev/ezfn-lobbybot@master/README.md))

### Networking & Communication

- [Game State Event Listeners](https://awesome-repositories.com/f/networking-communication/distributed-systems-p2p/distributed-computing/communication-protocols/websocket-implementations/websocket-event-systems/game-state-event-listeners.md) — Listens for real-time party events via Epic's WebSocket API to react to join and leave requests.
