Zixer1andevanpelle 1c2091d897 feat(featured-stream): off-web exclusion, ad-free close, keep through lobby wait (#4698)
Three related changes to the homepage featured-stream panel.

## 1. Exclude the embed off the open web (ToS)
Never mount the Twitch embed on **CrazyGames** or the **desktop (Steam)
shell**, and never load the Twitch SDK there. Matches how the app
already suppresses its own promos off-web via `window.adsEnabled`:

- **CrazyGames:** [only SDK-served ads are
allowed](https://docs.crazygames.com/requirements/ads/) and no external
cross-promotion; a Twitch embed serves Twitch's own ads and is
third-party content.
- **Steam:** Steam [does not support advertising models in
games](https://partner.steamgames.com/doc/marketing/advertising); a live
Twitch player carries Twitch ad breaks, and the desktop shell can't
satisfy Twitch's `parent`-domain requirement.

## 2. Close button for ad-free users
Ad-free users (any shop purchase makes a user `adfree` for life, which
zeroes `window.adsEnabled`) get an `×` in the minimized bar. The close
is remembered **for the current day** (the day is stored in
`localStorage`), so the panel stays gone across reloads that day and
resets for the next day's stream. Ad-supported users keep minimize only;
their mobile flick stays session-only. The minimized state is scoped to
the day the same way.

## 3. Keep the panel through the lobby wait
The panel used to hide the moment you joined a lobby (`join-lobby`). Now
it stays up through the **queue/lobby wait** and hides only once the
game actually starts. `Main.ts` dispatches a new `game-starting` event
at `prestart` (the real start moment); the panel hides on that instead
of on `join-lobby`, and reappears on `leave-lobby`.

> Heads-up for maintainers: (1) and (2) couple this OFM widget to OF's
own ad/entitlement signals (`crazyGamesSDK.isOnCrazyGames()`,
`isDesktopShell()`, `window.adsEnabled`); (3) adds a small shared
`game-starting` document event in `Main.ts`. Flagging in case you'd
rather gate/signal differently.

## Tests
Verified locally: prettier, eslint, tsc, tests all green. Reuses the
existing `common.close` i18n key (no locale-file changes).

Follow-up to #4335 / #4673. Sizing (Twitch's 400×300 minimum) landed in
#4696.
2026-07-24 18:57:08 -07:00
2026-07-23 13:11:34 -07:00
2026-03-23 13:59:34 -07:00
2026-01-21 10:00:55 -08:00
2026-07-23 13:11:34 -07:00

OpenFrontIO Logo

OpenFront.io is an online real-time strategy game focused on territorial control and alliance building. Players compete to expand their territory, build structures, and form strategic alliances in various maps based on real-world geography.

This is a fork/rewrite of WarFront.io. Credit to https://github.com/WarFrontIO.

CI Crowdin CLA assistant License: AGPL v3 Assets: CC BY-SA 4.0

License

OpenFront source code is licensed under the GNU Affero General Public License v3.0

Current copyright notices appear in:

  • Footer: "© OpenFront and Contributors"
  • Loading screen: "© OpenFront and Contributors"

Modified versions must preserve these notices in reasonably visible locations.

See the LICENSE for complete requirements.

For asset licensing, see LICENSE-ASSETS.
For license history, see LICENSING.md.

🌟 Features

  • Real-time Strategy Gameplay: Expand your territory and engage in strategic battles
  • Alliance System: Form alliances with other players for mutual defense
  • Multiple Maps: Play across various geographical regions including Europe, Asia, Africa, and more
  • Resource Management: Balance your expansion with defensive capabilities
  • Cross-platform: Play in any modern web browser

📋 Prerequisites

  • npm (v10.9.2 or higher)
  • A modern web browser (Chrome, Firefox, Edge, etc.)

🚀 Installation

  1. Clone the repository

    git clone https://github.com/openfrontio/OpenFrontIO.git
    cd OpenFrontIO
    
  2. Install dependencies

    npm run inst
    

    Do NOT use npm install nor npm i but instead use our npm run inst. It runs the safer npm ci --ignore-scripts to install dependencies exactly according to the versions in package-lock.json and doesn't run scripts. This can prevent being hit by a supply chain attack.

🎮 Running the Game

Development Mode

Run both the client and server in development mode with live reloading:

npm run dev

This will:

  • Start the webpack dev server for the client
  • Launch the game server with development settings
  • Open the game in your default browser (to disable this behavior, set SKIP_BROWSER_OPEN=true in your environment)

Client Only

To run just the client with hot reloading:

npm run start:client

Server Only

To run just the server with development settings:

npm run start:server-dev

Connecting to staging or production backends

Sometimes it's useful to connect to production servers when replaying a game, testing user profiles, purchases, or login flow.

To replay a production game, make sure you're on the same commit that the game you want to replay was executed on, you can find the gitCommit value via https://api.openfront.io/game/[gameId]. Unfinished games cannot be replayed on localhost.

To connect to staging api servers:

npm run dev:staging

To connect to production api servers:

npm run dev:prod

🛠️ Development Tools

  • Format code:

    npm run format
    
  • Lint code:

    npm run lint
    
  • Lint and fix code:

    npm run lint:fix
    
  • Testing

    npm test
    

🏗️ Project Structure

  • /src/client - Frontend game client
  • /src/core - Deterministic game simulation
  • /src/server - Backend game server
  • /resources - Static assets (images, maps, etc.)

🤝 Contributing

Contributions and translations are welcome! See CONTRIBUTING.md for the workflow, the approved-issue process, project governance, and translation info.

S
Description
No description provided
Readme AGPL-3.0
5.4 GiB
Languages
TypeScript 91.4%
GLSL 2.5%
JavaScript 2%
HTML 1.5%
Go 1%
Other 1.5%