Skip to content

Unreal Engine Threaded Physics Factory - UETPFCore is a Template framework for building real-world physics-driven projects in Unreal Engine 5.7. It outlines a native and robust subsystem architecture for multi-scale simulations, supporting everything from planetary-scale coordinate systems down to centimeter-precision physics interactions.

License

Notifications You must be signed in to change notification settings

ThreadedPixelFactory/UETPFCore

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

14 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

UETPFCore - Unreal Engine Threaded Physics Factory Core

A Multi-Scale Simulation Framework for Unreal Engine 5.7

UETPFCore is an Apache 2.0-licensed forward looking framework leveraging experimental engine features and aims to become a simple production-ready, framework for building physics-driven programs and scientific simulations in Unreal Engine 5.7+.

It provides cognitive structure for projects with a robust ready-to-build subsystem architecture inside a minimal project aimed at high fidelity multi-scale simulations, supporting everything from planetary-scale coordinate systems down to centimeter-precision physics interactions.

Key Features

๐ŸŒ Multi-Scale Coordinate System

  • Large World Coordinates (LWC) integration
  • Seamless km โ†” cm transformations
  • Coordinate frame management for planetary bodies
  • Precision handling across vast scales

โš™๏ธ Subsystem Architecture

  • TimeSubsystem: Configurable time dilation and progression
  • WorldFrameSubsystem: Multi-scale coordinate transformations
  • EnvironmentSubsystem: Medium specs (air, water, vacuum)
  • SurfaceQuerySubsystem: Material behavior (friction, deformation)
  • BiomeSubsystem: Environmental region management
  • PhysicsIntegrationSubsystem: Chaos physics integration

๐ŸŽฏ Dual-Domain Physics

  • MediumSpec: Fluid/atmosphere physics (drag, buoyancy, sound)
  • SurfaceSpec: Contact material behavior (friction, compliance, FX)
  • Data-driven specs via UE Data Assets
  • Runtime-loadable configurations

๐Ÿ’พ Delta Persistence System

  • Sparse delta storage for world state changes
  • Surface deltas (snow, wetness, deformation)
  • Fracture/destruction state
  • Transform deltas for dynamic objects
  • Assembly state for complex objects

๐ŸŒŒ Celestial Body Management

  • Generic celestial body framework
  • LOD proxy/simulation actor patterns
  • Orbital mechanics support
  • Atmospheric rendering integration

Quick Start

Prerequisites

  • Unreal Engine 5.7
  • Windows (primary support)
  • Visual Studio 2022 or later

Installation

  1. Clone or download this repository
  2. Run Scripts/build.bat to compile the project
  3. Run Scripts/editor.bat to launch the editor
  4. Explore the example content in Content/TPF/Examples/

See SETUP.md for detailed setup instructions.

Module Structure

UETPFCore (Runtime)

The core physics framework providing subsystems and base classes.

GameLauncher (Runtime)

Generic menu system for launching game modules. Demonstrates:

  • Main menu architecture
  • Enhanced Input integration
  • Level loading patterns

SinglePlayerStoryTemplate (Runtime)

Template module demonstrating single-player game patterns:

  • Local file-based persistence (FileDeltaStore)
  • JSON spec loading (SpecPackLoader)
  • Story game mode and player controller examples

Documentation

Example Content (coming soon)

Located in Content/TPF/:

  • Example Data Assets (air, water, rock specs)
  • Example materials (atmosphere, terrain)
  • Example Blueprints (proxy/simulation actors)
  • Minimal demo level

Use Cases

This framework is ideal for:

  • Space exploration games
  • Planetary surface games
  • Multi-scale simulation games
  • Physics-driven story games
  • Flight simulators
  • Vehicle simulations

Epic Games Mega Grant

This project is being submitted for the Epic Games Mega Grant program. The framework demonstrates production-quality systems architecture using Unreal Engine best practices and is designed to benefit the Unreal Engine community by providing a solid foundation for physics-based games and simulations. Helpful feedback that can help the platform succeed is welcomed.

The project also aims to benefit the larger developer community and the general public at large. We aim for the project to expand beyond games to facilitate cities to build robust simulations that can help iterate through climate resilience solutions affordably. We are currently using approximations for performance, however the project is built to be extensible to high fidelity implementations.

We are available to facilitate them.

License

This project is licensed under the Apache License, Version 2.0 - see LICENSE.txt for details.

Copyright 2026 Threaded Pixel Factory LLC

Support This Project

UETPFCore is free and open source, developed and maintained by Threaded Pixel Factory.

๐Ÿ› Community Support

๐Ÿ’– Financial Support

Monthly or one-time support helps us maintain and improve this framework:

  • ๐Ÿ’– GitHub Sponsors - Recurring support helps the platform grow.
  • โ˜• Ko-fi - One-time tips or additional monthly support
  • ๐ŸŽจ Patreon - Supporters get Early access to exclusive development blog posts that are open to feedback before they're published. Your contributions help the platform grow!
  • โญ Star this repo - Free way to help others discover the project

๐Ÿข Professional Services

  • Enterprise Support - Priority bug fixes and technical consultation for commercial projects
  • Custom Development - Advanced features and integration work for your game
  • Training & Workshops - Team training on framework architecture and best practices coming soon.

Contact us for professional service inquiries.

Acknowledgments

Built with:

  • Unreal Engine 5.7 by Epic Games
  • Chaos Physics System
  • World Partition streaming
  • PCG (Procedural Content Generation)
  • Niagara VFX
  • MetaSounds audio

Roadmap

  • ๐Ÿ“ฆ Additional example content
  • ๐ŸŽฅ Video tutorials
  • ๐Ÿ”ท Blueprint-only workflow examples
  • ๐Ÿ“ฑ Mobile platform support
  • ๐Ÿง Linux/Mac support

Built for the Unreal Engine community by Threaded Pixel Factory ๐ŸŽฎ

About

Unreal Engine Threaded Physics Factory - UETPFCore is a Template framework for building real-world physics-driven projects in Unreal Engine 5.7. It outlines a native and robust subsystem architecture for multi-scale simulations, supporting everything from planetary-scale coordinate systems down to centimeter-precision physics interactions.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published