Running Reality ยท App updates

Release Notes

Running Reality continuously updates its desktop app and web app. The desktop app updates when new factoid data is submitted, adopting approved new factoids into the baseline world. This is the world available to everyone in the desktop app and the web app. Bug fixes and new editor features are also deployed in each release. The app has an auto-update feature that notifies users of an app update and offers to install it.

2026 Releases

WindowsmacOSLinux

  • Enabled 3D "globe" view so 3D can do all zoom levels and is now feature complete.
  • Enabled "Native 3D" in the sidebar and editor 3D views.
  • Optimized 3D CPU and GPU usage.
  • Unified visibility rules across web and app for all types. All types now render in 3D.
  • Using Java 26 and key libraries.

WindowsmacOSLinux

  • Making the new "Native 3D" the default 3D library. The prior 3D library is now deprecated but still used for the sidebar.
  • Editing in 3D is enabled for factoids and data sources. Most editing tools have been migrated to 3D.
  • Added about 30 more default character models across time periods and regions.
  • Added a movement data field for "facing" to specify the direction a moveable character or vehicle is facing.
  • Using Java 26 and key libraries.

WindowsmacOSLinux

  • Updated to a game engine 3D library. To try it, in the display preferences switch to "Native 3D" for rendering. This will become the default 3D library in a future update.
  • Updated the Sidebar UI for search, highlights, and objects to the new, cleaner style.
  • Includes newly submitted factoids.
  • Using Java 26 and key libraries.

WindowsmacOSLinux

  • Ability to use camera to create an image data source, look up a book title, ISBN, or DOI, or import printed text.
  • Added 37k global dinosaur fossils from PBDB.org!
  • Added capability to display cuneiform.
  • Added an "inventory" to people and military units to carry items such as letters and documents.
  • Unified image copy, paste, and cropping.
  • Data transformer improvements, including using an LLM to suggest a data layout.
  • Includes newly submitted factoids.
  • Using Java 26 and key libraries.

WindowsmacOSLinux

  • Zotero integration to access your library of research documents from within the RR app.
  • Military unit templates can now have weapons and a mount/ride like a horse.
  • Character animation corrections and initial streamlining of slow sidebar animation frame rate.
  • Fixed some Open StreetMap import semantics to handle roads over bridges and culverts and with segments with slight punctuation differences.
  • Includes newly submitted factoids.
  • Using Java 26 and key libraries.

WindowsmacOSLinux

  • Buildings in 3D have inferred architectures, and architectural style or properties can be specified by factoids.
  • Buildings in 3D have Level of Detail (LOD) representations (footprint, "mass", and model) that can be separately specified over time and from different citations.
  • Renamed 3D data properties to have semantic names, i.e replacing has pattern3d = with has body = in factoid text.
  • Walls in 3D have materials and gate and tower features.
  • Military units and crowds have factoids for adding 3D model "templates" and a separate deployment or arrangement of their members. Templates and deployments can be separately specified over time and from different citations.
  • Improved the import of polygons from raster data sources, such as historical map layers.
  • Fixed 3D initialization bug on Windows.
  • Includes newly submitted factoids.
  • Using Java 26 and key libraries.

WindowsmacOSLinux

  • Data sources with in-map layers now show in the 3D aerial view.
  • Bug fix to Ground Control Points (GCPs) to fix a 10-15m ground calibration error.
  • Additional bug fixes for preferences persistence.
  • Using Java 26 and key libraries.

WindowsmacOSLinux

  • Added texture up-scaling to 3D models based on distance, with 3D models editors and creators handling the new texture management protocol.
  • Additional correction to data source handling on Windows.
  • Using Java 26 and key libraries.

WindowsmacOSLinux

  • Correction to data source handling on Windows.
  • Enable right-mouse-click data source metadata editing.
  • Using Java 26 and key libraries.

WindowsmacOSLinux

  • Ctrl-B or Command-B to create a Building at the location of the mouse pointer.
  • Added (finally) the does not exist factoid as a complement to the exists factoid.
  • Added suggestions to sidebar to assist with common tasks, like suggesting links from infantry to armies or identifying when historical building timelines might overlap modern ones.
  • Fixed data source bugs in renaming and Windows file path.
  • Includes newly submitted factoids.
  • Using Java 26 and key libraries.

WindowsmacOSLinux

  • Added "scene" creator to gather People together within a tight radius for a historical scene.
  • Added polygon city block detection to simplify creating BlockOfBuildings enclosed by streets.
  • Fixed the World "Reality" being able to have its own configuration files for adding data sources.
  • Workaround for MacOS bug driving memory leaks during animations.
  • Includes newly submitted factoids.
  • Using Java 26 and key libraries.

WindowsmacOSLinux

  • Added multi-polygon capability to machine-learning polygon import.
  • Improved polygon detection for machine-learning polygon import.
  • Two-row in-map toolbar.
  • Fixed Windows bug affecting file loading from other than the C:\ drive.
  • Fixed a large number of small engine and editor errors.
  • Using Java 26 and key libraries.

WindowsmacOSLinux

  • Enabled animation of 3D characters.
  • Improved editors with crosshair cursor and a clearer view of what you are editing.
  • Improved copy-paste of factoids across lists, including multi-select of factoids.
  • Improved memory handling including a new preferences pane to control caches to avoid app stability problems.
  • Includes newly submitted factoids.
  • Using Java 26 and key libraries.

WindowsmacOSLinux

  • Improved memory handling within the 3D system to avoid app stability problems.
  • More types can be rendered by the 3D system.
  • Code color highlighting for viewing raw files such as factoid XML files, logs, and JSON files.
  • Movement editor fixes to improve re-editing prior movements.
  • Sidebar visual fixes with disclosure buttons. There is a new preference for remembering the previously open object subpanel.
  • Includes newly submitted factoids.
  • Using Java 26 and key libraries.

WindowsmacOSLinux

  • The 3D system is stable enough to be given a switch on the main display. It is still not fully rendering everything correctly and it is not optimized for speed. However, it is usable to position and align 3D content like people, buildings, and military units.
  • Engine bugfixes for propagation of relationships in time.
  • Corrected 3D inference system for selecting military units based on flag / uniform color.
  • Includes a huge number of newly submitted factoids.
  • Using Java 26 and key libraries.

WindowsmacOSLinux

  • Major revisions to the sidebar:
    • New "disclosure" triangles to expand content
    • Objects with 3D data now open with a 3D view as the default. (configurable via an app preference setting)
    • Better management of minimized data panes.
  • Interactive character "chat" dialog system implemented in the app, now mirroring the web version's ability.
  • Interactive character "chat" dialog system implemented for military units in addition to individual people. (Also for web version)
  • Upgraded dialog editor and creator, including major prompt upgrades for better dialog drafts.
  • 3D inference system expanded with more characters, including regional and period armor for infantry. (Also for web version)
  • Using Java 26 and key libraries.

WindowsmacOSLinux

  • Additional updates to the prototype 3D map renderer to bring the desktop 3D on par with the web 3D.
  • Bug fixes to factoid deletion and editing.
  • Bug fixes to object selection when object is a 3D model.
  • Includes a huge number of newly submitted factoids.
  • Updated to use Java 26 and key libraries.

WindowsmacOSLinux

  • Create 3D models from a historical photo.
  • Major update to the prototype 3D map renderer for the desktop app and web.
  • Add better hinting for military units in ObjectCreator, including quick links of units to a nearby Army.
  • Fixes to the georectification of historical maps when the map has been rotated and is using GCPs
  • Fixes to the ObjectCreator's handling of anonymous objects.
  • Includes newly submitted factoids.
  • Using Java 25 and key libraries.

WindowsmacOSLinux

  • Enabled AI structured data extraction from articles (including Wikipedia pages) for OpenAI, Google Gemini, Anthropic Claude, Meta Llama, and models locally served using Ollama.
  • Initial "J hook" detector for marking the point of maximum advance for Infantry in battle.
  • Includes newly submitted factoids.
  • Using Java 25 and key libraries.

WindowsmacOSLinux

  • New types and subtypes for Animal and Fossil to complement the Species type.
  • New types and subtypes for Hominid to enable modeling more of prehistory.
  • Includes newly submitted factoids.
  • Using Java 25 and key libraries.

WindowsmacOSLinux

  • Additional Updates to the 3D model inference system.
  • Better factoid handling in the world sidebar, including directly editing the MyFactoids.xml file.
  • Includes newly submitted factoids.
  • Using Java 25 and key libraries.

WindowsmacOSLinux

WindowsmacOSLinux

  • Updates to the 3D model inference system, including for aggregate objects such as TentGroup and BlockofBuildings.
  • New 3D models for military units and railroads.
  • Updates to handling OpenStreetMap Overpass vector data and better notification to the user when Overpass servers are overloaded.
  • Additional capabilities for reviewing of factoid submissions in-app.
  • Includes newly submitted factoids.
  • Using Java 25 and key libraries.

WindowsmacOSLinux

  • Rendering fixes for ships and submarines.
  • Reviewing of factoid submissions in-app.
  • Additional fixes to synchronizing data sources between the desktop app's project system and the web site's projects.
  • Includes newly submitted factoids.
  • Using Java 25 and key libraries.

WindowsmacOSLinux

  • Bug fixes to multiple data source subsystems.
  • Additional fixes to synchronizing data sources between the desktop app's project system and the web site's projects.
  • Using Java 25 and key libraries.

WindowsmacOSLinux

  • Types for BlockofBuildings and LineOfBuildings upgraded with new renderer.
  • Additional fixes to synchronizing data sources between the desktop app's project system and the web site's projects.
  • Includes newly submitted factoids.
  • Using Java 25 and key libraries.

WindowsmacOSLinux

2025 Releases

WindowsmacOSLinux

  • Updated 3D inference system, 3D model selector, and added 20+ new person and military models.
  • Fixed bugs in project menu and in creating historical events.
  • Includes newly submitted factoids.
  • Using Java 25 and key libraries.

WindowsmacOSLinux

  • Updated relationship, event, and linkage editors to use more intuitive verb/relationship/preposition word order.
  • Fixed multiple engine errors related to relationship linkages and to timeline inference.
  • Relationship panels now correctly show both explicit discrete relationships and aggregate relationships.
  • Repaired KML support and fixed a GeoJSON bug.
  • Includes newly submitted factoids.
  • Using Java 25 and key libraries.

WindowsmacOSLinux

  • Web projects are now separate worlds in the desktop app, available from the world menu.
  • Updated pattern3d editor with vertex editing fixes.
  • Fixed multiple engine errors.
  • Includes newly submitted factoids.
  • Using Java 25 and key libraries.

WindowsmacOSLinux

  • Updated editors for pattern3d, route, and movement data.
  • Includes newly submitted factoids.
  • Using Java 25 and key libraries.

WindowsmacOSLinux

  • Updated pattern3d system with preliminary Level of Detail (LOD) for buildings.
  • Includes newly submitted factoids.
  • Using Java 25 and key libraries.

WindowsmacOSLinux

  • Added the Species type and improved rendering of pre-historic eras back through 400Mya.
  • Includes newly submitted factoids.
  • Using Java 25 and key libraries.

WindowsmacOSLinux

  • Updated pattern3d editor to show and select GLTF models.
  • Updated GLTF models to new high fidelity models with animations.
  • Includes newly submitted factoids.
  • Using Java 24 and key libraries.

WindowsmacOSLinux

  • Updated GeoJSON handling and editing. Added a "when" editor for GeoJSON-T, MF-JSON, and JSON-LD compatibility.
  • Introduced first prototype 3D rendering capabilities.
  • Includes newly submitted factoids.
  • Using Java 24 and key libraries.

WindowsmacOSLinux

  • Completely revised data source import system with AI/LLM features.
  • Includes newly submitted factoids.
  • Using Java 21 and key libraries.

2007-2024 Releases

Older releases did not have release notes. The first widely available release was in 2007 with the debut of the www.runningreality.org website. The web app's map debuted in 2014, so from 2007 to 2014 the way to view the map was to download the desktop app.

1997-2007 Releases

Older releases did not have release notes. The first version of Running Reality was built for the core team in September 1997. Some core RRObjectTypes and their icons date from the 1997 code, such as the building icon. Some precursor code was written in the summer of 1996.

Mobile Releases

Releases for mobile devices are made continuously via updates to the website. The server is updated at least weekly.

Continuous iOSAndroid

  • Includes newly submitted factoids.
  • Using Java 21, Jakarta 10, and GWT 2.12.

Key Libraries

These are some of the key libraries used by the Running Reality desktop app and distributed as standalone libraries within the app's installation directory:

LibraryDescriptionLicense
FlatLAF UI library Apache 2.0
Install4j Installer Commercial
JavaFX UI library GPL 2.0
FXyz3D 3D library Copyright Notice
JOOQ Database interface Apache 2.0
Derby Java based database Apache 2.0
IcePDF PDF parsing library Apache 2.0
Twelve Monkeys Image library for WEBP, TIFF, etc BSD 3
Apache JENA RDF parsing library Apache 2.0
Apache Commons CSV parsing library and other routines Apache 2.0
Saxon-HE XML parsing library with EpiDOC capability Mozilla Public License
jSoup HTML parsing and analysis library MIT License
jGLTF 3D library for GLTF and GLB files MIT License
ONNX Engine Microsoft Machine Learning model engine MIT License
PyTorch Engine DJL Machine Learning model engine Apache 2.0
Proj4j LocationTech coordinate projection library Apache 2.0
LibraryDescriptionLicense
Additional libraries and data for optional features, with download methods described below. See the optional installer components.
SAM2 Facebook Segment Anything 2 machine learning library. Downloaded by the app itself, separately from the installer. Apache 2.0
GeoNames The GeoNames geographical database, available through the optional geocoder databases installer component. CC-BY
AlgorithmDescriptionLicense
Thin-plate spline Thin-plate spline by AllMaps and the Radial Basis Function code cited by AllMaps. AllMaps

See our citations page for more detailed information about other Running Reality data, such as historical data, map tiles, and icons.

Feedback

If you would like more information about a topic on this page, please feel free to ask us for help. Send us an email if you would like us to get back to you with a response:

Email the team