Lumbridge Simulate Engine — the city, and the licence it can actually ship under

LSE is the third of the three, beside lumbridge-compute and lumbridge-bench: a
3D engine for walkable places. This first commit is the outside of the world —
San Francisco — plus the seams the inside will attach to.

The engine renders a City and a list of Markers and knows nothing else. It does
not know markers are usually companies and it will never learn that "rejected"
is red; that mapping lives in an adapter. Which is what lets one renderer serve
a private map, a public one, and a self-hoster with no Lumbridge account, none
of them a fork of the others.

Three things were designed around the licence rather than discovered after it,
because each one is a promise Apache 2.0 makes that is easy to break by
accident. No trademarks in the repo — logos are fetched at runtime, and
public/logos/ is gitignored. No OpenStreetMap-derived coordinates, which is why
every coastline in cities/sf.ts was traced by hand: Nominatim output is ODbL,
share-alike, and would attach to the whole pack. And no FlightRadar24 client —
their terms forbid scraping and redistribution, so flights are an interface
with a simulator and open community ADS-B behind it.

The privacy constraint and the licence constraint turned out to want the same
thing. Geocoded company positions and pipeline status both stay behind Workie's
API; the open repo holds the city and the renderer. The tempting shortcut —
commit an sf-companies.json — breaks both at once.

Ported out of Workie, where a 3D city engine had no business living. Workie's
/live is deleted rather than deprecated.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Karti Tripathi
2026-08-04 21:49:08 -07:00
commit 67f8df8d53
20 changed files with 4789 additions and 0 deletions
+72
View File
@@ -0,0 +1,72 @@
LSE — Lumbridge Simulate
Copyright 2026 Lumbridge Corp.
This product includes software developed at Lumbridge Corp.
Licensed under the Apache License, Version 2.0 (see LICENSE).
ORIGIN AND ORIGINALITY
----------------------
LSE's city view was inspired by the interaction model of two prior works —
Levels.fyi Atlas, and Nutlope's NYC AI Atlas (https://github.com/Nutlope/
nyc-ai-atlas), which itself credits Levels.fyi. What was taken is the *idea*:
a left-hand chapter legend, animated camera flights into map areas, clickable
place labels, and ambient motion in the scene.
No code, geometry, or asset from either work is present here. LSE's renderer,
its terrain system, its block-lattice building placement, and every coordinate
in every city pack were written from scratch. The two projects do not even
share a subject: the NYC atlas renders hand-traced Manhattan on flat ground,
and LSE's premise is relief — a city you cannot read without its section.
Stating this plainly matters, because at the time of writing the NYC AI Atlas
repository carries no LICENSE file. Absent a licence grant, the default is that
no rights are given, so nothing from it could have been reused even had we
wanted to. Attribution here is courtesy toward a good idea, not a licence
obligation.
GEOGRAPHIC DATA
---------------
All geography in src/cities/ is original expression, traced by hand.
It is deliberately NOT derived from OpenStreetMap. OSM data — including
coordinates returned by Nominatim geocoding — is licensed under the Open
Database License (ODbL), whose share-alike terms would attach to any derivative
database and cannot be reconciled with the permissive licence above.
Where real elevation data is used in future, it will come from USGS/SRTM
sources, which are United States government works in the public domain.
TRADEMARKS
----------
This repository contains no third-party logos, wordmarks, or brand assets.
Organisation logos displayed by applications built on LSE are fetched at
runtime and are never redistributed as part of this project. All trademarks,
service marks, and trade names are the property of their respective owners.
Any use is nominative — to identify the organisation referred to — and does not
imply affiliation with or endorsement by the trademark holder.
THIRD-PARTY DEPENDENCIES
------------------------
three.js — MIT License — Copyright (c) 2010-2026 three.js authors
https://github.com/mrdoob/three.js
Build tooling (Vite, TypeScript, esbuild) is a development dependency only and
is not redistributed in built output.
AIRCRAFT DATA
-------------
The flight sources shipped in this repository are a simulator (original work)
and clients for open community ADS-B feeds. No commercial aviation data
provider's data is included or redistributed, and no client for a provider
whose terms prohibit such use is present.