This opt-in feature generates recognizable businesses as the player drives. It uses the map to decide which building, wall, or roadside point belongs to the business, and a shared catalog to decide what to draw there.
Browse all 250 models in the alphabetical catalog Ôö¼├Ç Generator documentation
What is included
| Part | Behavior and coverage |
|---|---|
| Standalone buildings | The mapped footprint sets the outline. Brand profiles supply materials, glazing, signs, and suitable entrances. Distinctive models include a porch for Cracker Barrel, a low diner for Waffle House, and a blue warehouse with a yellow canopy for IKEA. |
| Shared retail buildings | A tenant can receive a ground-floor frontage when a mapped place, an exterior wall, and a parking approach agree. Other tenants constrain the available space. |
| Enclosed malls | Exterior access records, mapped customer doors, and public approaches support tenant signs. Extra wall space can carry indoor tenant banners. Eligible flat-roof malls without mapped finishes use brick and precast wall courses. Covered entrances and directories are placed where public walks reach the building. |
| Local businesses | Optional signs use mapped trading names for restaurants, venues, banks, car washes and other supported categories. Projecting venue signs are visible along the street. |
| Sign artwork | Apple uses a symbol, Freddy's uses short script, and Burger King uses a stacked bun badge. Domino's combines the tile and name when the panel has room. |
| Roadside signs | A bundled global OSM extract identifies 184 mapped sign nodes, including 16 Burger Kings. A sign can appear on a different road tile from its store. Its height defaults to 6 m. Direction comes from the tag or a nearby road. |
| Materials | Streaming uses mapped wall material. The offline importer can also apply a supplied photo observation to the wall it matches. Automatic retrieval of street imagery is outside this PR. |
| Loading and reuse | The server exports GLB models and reuses them from its local cache. Installed local models take precedence. Sign discovery uses the bundled index without a per-tile sign-data request. |
Enable Storefronts and business signs in BeamNG.Earth Settings → Experimental, then select Restart world server. The checkbox defaults to off and enables both storefronts and local signs. Manual server launches can use BNE_STOREFRONTS=1 and BNE_LOCAL_BUSINESS_SIGNS=1. Both settings participate in tile cache identity. Building profiles represent typical branches.
Architecture and review guide
- Map evidence. The near-tile building pass preserves footprint and elevation. The place matcher evaluates trading names, status and confidence. Low-confidence or unrecognized tenants can still reserve space on a shared building.
- Placement. A standalone model fits a footprint. A tenant sign needs a wall. A roadside sign needs a mapped sign node. Shared-building and mall placement reuse the parking-frontage calculation. Confirmed customer entrances take priority over inferred panels.
- Rendering and reuse. The live server and offline tools use the same brand catalog, sign artwork and GLB exporter. The cache key includes placement, artwork parameters and exporter version. The public-frontage target is one visible retail identity per 38 m, capped at 18 on a shared shell. Banners identify indoor tenants and create no additional doors.
One mapped site
At 40.581107, -83.095555 on Mount Vernon Avenue, the mapped sign is about 29 m from the Burger King building center. These are renders of the exported meshes from a 1.6 m eye height. The map supplies the positions and the renderer uses the default sign height.
Validation
- The in-game drive confirmed the branded Walmart exterior. Downtown had a handful of visible business labels. Tootsies remains individually unconfirmed in-game.
- Review fixes at
72a4fad5preserve separate retail tenants inside a named big-box footprint and require consistent one-way coverage along a service road before using it to place drive-through fixtures. Regression tests cover both cases. The offline photo-wall export checks also passed for 251 detailed chains and the legacy model. - All 59 storefront tests passed locally. The offline sweep found a road or parking-aisle sightline for 84 of 86 generated panels. The other two had a mapped pedestrian sightline. These checks cover geometry. Readability and tenant freshness still depend on location.
- A 16-tile downtown replay generated 0, 19, then 0 branded models with storefronts off, on, then off. Median local generation times over three runs with map data cached were 0.22 s disabled, 0.35 s enabled with a fresh model cache, and 0.34 s on revisit. In-game frame times and streaming stalls remain unmeasured.
Activity
55This pull request is a draft
Merging is unavailable until it is marked ready for review.