Skip to content

Ducki67/AthenaOG

Repository files navigation

AthenaOG

An OG Fortnite backend written in JavaScript, supports 1.7.2 – 1.10 (Chapter 1, Season 0/1). Node + Express, no database — accounts, profiles and friends are just JSON files on disk, so everything is easy to read and back up. Made by Ducki67.

The part that actually took work was XMPP + matchmaking on the early builds — the cert situation on the 2017 clients is cursed (see the setup guide). It works now: chat connects and you matchmake straight into a game on 1.7.2, 1.8.2 and 1.9.1. 1.10+ is easier — no TCP XMPP and no SSL cert needed.

what it does

  • accounts + OAuth, full MCP profiles (locker, cosmetics, V-Bucks, loadouts) — per-account, nobody shares a locker
  • XMPP server over TCP/STARTTLS (5222) and WebSocket (80) — chat, presence, parties
  • global chat — a shared MUC room everyone lands in
  • matchmaking (HTTP tickets + the ws status flow) that drops you onto your game server
  • item shop with auto-rotate, news, friends, stats / leaderboards, lightswitch / maintenance mode

running it

npm install
npm start

Default ports: HTTP 3551, XMPP ws 8080 / tcp 5222, matchmaker ws 80, shop site 7473. Everything is configured in Config/config.json.

For XMPP + matchmaking to actually work on the old builds you need a TLS cert the game trusts — that whole process (free and paid) is written up in MATCHMAKING-SETUP.md. Read it before you bang your head on the "unable to connect to the chat server" wall like I did.

notes

  • point matchmaking.ip / port at your game server (Erbium / Reboot). use your Radmin or public IP if friends are joining.
  • certs/ holds the TLS cert (fullchain.pem + privkey.pem). they're gitignored, so each setup brings its own.
  • the shop, news, maintenance mode and seasons are all configurable in config.json.

todo

  • global chat (chat with other players, for authentic private-server gameplay)
  • XMPP parties (friend invites / join via presence) — 1.7.2 has it currently
  • store tab with V-Bucks on 1.8+

credits

  • Ducki67
  • shoutout to the OGFN people who helped figure things out
  • Toffee (@toffeeexists on discord) for the 1.7.2 and 1.8.2 build ids <3
  • TCP-Backend — cracked the TCP XMPP + cert situation for the old builds. couldn't have figured out the STARTTLS / trusted-cert stuff without it, big thanks.

license

MIT — see LICENSE. do what you want with it, just keep the credit.

About

An OG Fortnite backend written in JavaScript, supports: 1.7.2 - 1.10

Resources

License

Stars

4 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors