Skip to content

Z3R039/Surge-Backend-V1

Repository files navigation

Doesent Work

Feel free to take inspiration from it.

Banner

Surge Backend

A modern backend implementation for Fortnite, focused on performance and scalability.

Features

Core Features

  • ✅ XMPP Support (TCP & WebSocket)
  • ✅ Matchmaker System
  • ✅ Party System (V1 & V2)
  • ✅ Authentication with Permissions
  • ✅ Profile Management
  • ✅ Automated Session Management
  • ✅ Security System

Matchmaking Features

  • ✅ Region-Based Matchmaking
    • NA (North America)
    • EU (Europe)
    • OCE (Oceania)
    • ASIA (Asia)
  • ✅ Multiple Server Support
    • Multiple IPs per region
    • Automatic game mode distribution
    • Load balancing
    • Server health monitoring
  • ✅ Game Mode Management
    • BR Solo (40% allocation)
    • BR Duos (30% allocation)
    • BR Squads (20% allocation)
    • Late Game (5% allocation)
    • Save the World (5% allocation)
  • ✅ Region Failover
    • Automatic region switching
    • Configurable failover order
    • Ping-based routing
    • High availability

Game Features

  • ✅ VBucks Rewards System
    • Kill rewards
    • Victory rewards
    • Customizable amounts
  • ✅ Auto-Shop System
    • Daily rotations
    • Configurable items
    • Automated updates
  • ✅ Leaderboards
    • Global rankings
    • Stats tracking
    • Real-time updates
  • ✅ Arena Mode
    • Point system
    • Division rankings
    • Competitive matchmaking
  • ✅ Tournament System
    • Custom tournaments
    • Scoring system
    • Prize distribution

Save the World Features

  • ✅ Mission System
    • Dynamic mission generation
    • Various mission types
    • Rotating mission alerts
    • V-Bucks missions
    • Custom modifiers
  • ✅ Hero Management
    • Hero leveling
    • Evolution system
    • Perk unlocks
    • Hero loadouts
  • ✅ Survivor Squads
    • Squad bonuses
    • Personality matching
    • Power level calculation
    • Auto-fill optimization
  • ✅ Rewards System
    • Mission rewards
    • Daily rewards
    • Quest rewards
    • V-Bucks missions
  • ✅ Storyline System
    • Quest chains
    • Character dialogue
    • Voice acting support
    • Zone progression
    • Multiple quest types
    • Dynamic requirements
    • Reward system integration

Configuration

Matchmaking Configuration

API Documentation

Authentication

  • POST /api/auth/login - Login and get session token
  • POST /api/auth/register - Register new account

Profile

  • GET /api/profile - Get user profile
  • PUT /api/profile - Update profile

Stats

  • GET /api/system/stats - Get system statistics
  • GET /api/leaderboard - Get global leaderboard

Shop

  • GET /api/shop/current - Get current shop items
  • POST /api/shop/purchase - Purchase item

Arena

  • GET /api/arena/stats - Get arena statistics
  • GET /api/arena/division - Get current division

Tournaments

  • GET /api/tournaments - List active tournaments
  • POST /api/tournaments/register - Register for tournament

Game Server

  • POST /api/gameserver/register - Register new game server
  • GET /api/gameserver/:serverId - Get server status
  • PUT /api/gameserver/:serverId/status - Update server status
  • POST /api/gameserver/match - Request matchmaking
  • GET /api/gameserver/match/:ticketId - Check match status

Save the World

  • GET /api/stw/missions/current - Get current missions
  • POST /api/stw/missions/:missionId/complete - Complete mission
  • GET /api/stw/storyline/current - Get current quest
  • GET /api/stw/storyline/progress - Get zone progress
  • POST /api/stw/storyline/progress - Update quest progress

Security

The backend implements several security measures:

  • Automated session management
  • Token-based authentication
  • Request validation
  • Rate limiting
  • Session cleanup

Integration

Game Server Integration

To integrate with Surge-Gameserver:

  1. Configure your server IPs in the MATCHMAKING_REGIONS setting
  2. The backend will automatically:
    • Assign game modes based on distribution
    • Handle region-based routing
    • Manage server health
    • Balance player load

Contributing

  1. Fork the repository
  2. Create your feature branch
  3. Commit your changes
  4. Push to the branch
  5. Create a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

  • Thanks to all contributors
  • Inspired by various Fortnite backend implementations
  • Special thanks to Me Z3R039 for the game server implementation

About

An up to date backend with tons of features.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages