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.

ही स्क्रिप्ट इंस्टॉल करा ?

Ask a question, post a review, or report the script.

लेखक

DeLoWaN

दैनिक इंस्टॉल

एकूण इंस्टॉल

रेटिंग

0 0 0

आवृत्ती

2.10.11

बनवली

2025-11-11

अपडेट केली

2026-05-10

आकार

73 KB

License

UNLICENSED

यांवर लागू होते:

openfront.io

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

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

OpenFront v0.31+
Tampermonkey or Greasemonkey
Browser notification permission (only if you want desktop alerts)

Install

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

Usage

Open the Play page on openfront.io.
In the OpenFront Game Notifier panel, enable FFA, Team, or both.
For Team, optionally toggle Humans Vs Nations and pick allowed team counts (2–7).
Set capacity bounds; click modifier chips to require or exclude them.
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