☰

OpenFront Game Notifier

Notifies you when a public OpenFront lobby matches your filters (mode, team format, capacity, modifiers) via in-page highlight, sound, and optional desktop notifications. Never auto-joins.

How to install

You will need to install an extension such as Tampermonkey, Greasemonkey or Violentmonkey to install this script.

You will need to install an extension such as Tampermonkey to install this script.

You will need to install an extension such as Tampermonkey or Violentmonkey to install this script.

You will need to install an extension such as Tampermonkey or Userscripts to install this script.

You will need to install an extension such as Tampermonkey to install this script.

You will need to install a user script manager extension to install this script.

(I already have a user script manager, let me install it!)

How to install

You will need to install an extension such as Stylus to install this style.

You will need to install an extension such as Stylus to install this style.

You will need to install an extension such as Stylus to install this style.

You will need to install a user style manager extension to install this style.

You will need to install a user style manager extension to install this style.

You will need to install a user style manager extension to install this style.

(I already have a user style manager, let me install it!)

Author
DeLoWaN
Daily installs
1
Total installs
52
Ratings
0 0 0
Version
2.10.11
Created
2025-11-11
Updated
2026-05-10
Size
73 KB
License
UNLICENSED
Applies to

OpenFront Game Notifier

A TypeScript userscript for OpenFront v0.31+ that watches public lobbies and notifies you when one matches your filters — via in-page highlight, sound, and optional desktop notification. It also enhances OpenFront's native join modal. Never auto-joins.

For Players

image

Features

Lobby discovery

  • Filter FFA and Team public lobbies by mode, format, team count, capacity, and modifiers
  • Team panel splits into Format (Humans Vs Nations) and Number of teams (2–7)
  • Capacity sliders use the right semantics per mode: total lobby size for FFA, players-per-team for Team
  • Per-team slider uses log-scaled stops with editable steppers; optional 2× lock pins the max to twice the minimum
  • Tri-state modifier filters cycle Any → Required → Excluded, grouped by Map / Gameplay / Economy

Alerts

  • Pulse highlight on the matching homepage queue card the moment a lobby matches
  • Optional sound alert on new matches
  • Optional desktop notification when the OpenFront tab is in the background
  • Sound on game start, triggered by OpenFront's own ?live URL transition

Smart UX

  • Stronger highlight for your own player row (and your team card) inside the native join modal
  • Filter settings persist across reloads
  • Discovery feedback automatically pauses while you're already inside a joined lobby flow

Modifier filters

  • Compact
  • Random Spawn
  • Crowded
  • Hard Nations
  • Alliances Disabled
  • Ports Disabled
  • Nukes Disabled
  • SAMs Disabled
  • Peace Time
  • Water Nukes
  • Starting Gold 1M, 5M, 25M
  • Gold Multiplier x2

Requirements

Install

  1. Install Tampermonkey or Greasemonkey.
  2. Install from Greasy Fork: OpenFront Game Notifier.
  3. Visit openfront.io.

Usage

  1. Open the Play page on openfront.io.
  2. In the OpenFront Game Notifier panel, enable FFA, Team, or both.
  3. For Team, optionally toggle Humans Vs Nations and pick allowed team counts (2–7).
  4. Set capacity bounds; click modifier chips to require or exclude them.
  5. When a queue card pulses on the homepage, click it yourself to join.

What this doesn't do

  • Never auto-joins, auto-rejoins, or switches lobbies.
  • Never modifies the native join modal — the player-row highlight is purely additive styling.
  • Doesn't read or write any cross-domain data.

For Developers

Project structure

.
├── src/
│   ├── config/                                 # constants, theme tokens
│   ├── data/
│   │   └── LobbyDataManager.ts                 # WebSocket + HTTP polling fallback
│   ├── modules/
│   │   └── lobby-discovery/
│   │       ├── CurrentPlayerHighlighter.ts     # additive native-modal enhancer
│   │       ├── LobbyDiscoveryEngine.ts         # criteria matching
│   │       ├── LobbyDiscoveryHelpers.ts        # pure helpers
│   │       ├── LobbyDiscoveryTypes.ts
│   │       ├── LobbyDiscoveryUI.ts             # panel UI
│   │       ├── RangeSlider.ts                  # per-team log-scaled slider component
│   │       └── RangeSliderHelpers.ts           # pure stop/position helpers
│   ├── styles/
│   ├── types/
│   ├── utils/
│   │   ├── BrowserNotificationUtils.ts
│   │   ├── LobbyUtils.ts
│   │   ├── SoundUtils.ts
│   │   └── URLObserver.ts
│   └── main.ts
├── tests/
├── dist/bundle.user.js
├── package.json
├── tsconfig.json
├── esbuild.config.js
└── vitest.config.js

Quick start

Prerequisites: Node.js 18+ and npm.

npm install
npm run build:prod   # writes dist/bundle.user.js

Common scripts:

npm run dev          # esbuild watch
npm run build:prod   # production bundle
npm run test         # vitest --run (use --watch for TDD)
npm run type-check   # tsc --noEmit

Storage keys

  • OF_LOBBY_DISCOVERY_SETTINGS — criteria, sound/desktop preferences, 2× toggle

Testing

Vitest with JSDOM. The suite covers the matching engine, helpers, panel UI, the native-modal highlighter, and the LobbyDataManager connection fallback.

npm run test
npm run test -- --watch
npm run test -- --coverage

Contributing

  • Follow the existing layered architecture (config → types → styles → utils → data → modules → main).
  • Use @/ path aliases.
  • Keep new logic covered by tests; run npm run test and npm run type-check before shipping.
  • Rebuild dist/bundle.user.js for releases (npm run build:prod).

License

UNLICENSED — private project.

Authors

DeLoVaN · SyntaxMenace · DeepSeek · Claude