This project emulates mec-gw.ops.dice.se, the web gateway component of the Mirror's Edge Catalyst server stack. The game client communicates with this server via JSON-RPC over HTTP to handle its asynchronous multiplayer features. Following EA's server shutdown, this project replaces the dead endpoints to restore the game's "Social Play" functionality

• Beat LEs: Handles creating, placing, and loading user Beat LEs across the map
• Time Trials: Saves and serves custom checkpoints, replay files, and leaderboard times
• Dashes & Leaderboards: Saves, tracks and returns player rankings across leaderboards
• Customization: Handles progression stats, Player Tags, Runner Kits, and Echoes
• Achievements: Allows getting all of the in-game achievements

• Rust toolchain (2024 edition)
• Discord application for authentication
• PostgreSQL (tested with version 17)
• S3-compatible object storage (tested with SeaweedFS 4.13)

Configure the gateway using the following environment variables in your .env file:

Upon startup, the server automatically synchronizes the database schema using SeaORM registry synchronization

cargo run --release

docker build -t pamplona-gateway .
# Match the port mapping to the PORT defined in your .env
docker run -p 3000:3000 --env-file .env pamplona-gateway

To play on the private server, the game client needs to be pointed towards the custom redirector instance

Use an existing launcher - BeatLink to skip manual client patching entirely

The game's executable must be patched to disable SSL verification and redirect traffic from EA's servers to the custom instance. This can be done via:

• editing the assembly instructions
• using a runtime hook

• WarrantyVoider - sharing tons of info publicly, help with dumping and reversing the game
• Doomaholic - guidance on early server architecture and patching the executable
• av1d and wagwan piffting blud - created mec-scrape, for downloading the original server data
• wagwan piffting blud - prototyped Rust port of pamplona-future, helping identify a critical roadblock
• The Beat Revival team - creating the initiative, capturing packets, community updates, scraping the servers

Some parts of this codebase were assisted or generated using AI tools, then manually reviewed, refactored, and tested for accuracy

This is a free, open-source research and preservation project. It is not affiliated with, endorsed by, or connected to Electronic Arts (EA), DICE, or any of their associated entities

• No Copyrighted Material: This repository does not contain, distribute, or host any copyrighted assets, binaries, or game files from Mirror's Edge Catalyst. It is a clean-room implementation based entirely on network analysis
• Non-Commercial: This software is distributed strictly free of charge for historical preservation and educational purposes. No monetization, donations, or commercial transactions are accepted
• Trademarks: All product names, logos, and brands are property of their respective owners. Their use here is solely for compatibility identification purposes

This project is licensed under the GNU Affero General Public License v3.0 - see the LICENSE file for details