Version 2.0 (Previously released as Versatile Third Person Controller) Welcome to the official documentation for the Modular Third Person Framework (MTPF).

This framework provides a complete, modular third-person locomotion and interaction system for Unity — designed to save you months of development time while giving you the flexibility to customize and extend for your project’s needs.

Overview

MTPF (Modular Third Person Framework) is a production-ready third person framework for Unity designed around modular architecture, extensibility, and long-term maintainability. Built for solo developers, indie teams, and small studios, MTPF provides advanced locomotion, interaction, camera, vitality, animation, and environment systems within a modular architecture-first solution. Whether building prototypes, adventure games, exploration games, survival games, action games, or custom third person projects, MTPF provides a scalable foundation that can be customized to meet project requirements.

Why MTPF?

Build Your Gameplay Foundation Faster

MTPF provides the core systems commonly required by third person games, helping developers avoid rebuilding the same functionality across multiple projects.

Designed For Long-Term Development

The framework follows modular architecture principles that support maintainability, extensibility, and scalability as projects evolve.

Create Without Restrictions

Developers can customize, replace, or extend individual systems without introducing unnecessary dependencies throughout the project.

Learn Faster

The framework includes documentation, architecture references, setup resources, and examples designed to accelerate onboarding and implementation.

Key Features

Advanced Locomotion Systems

Walk
Jog
Sprint
Crouch
Crawl
Roll
Climb
Parkour
Swim
Dive
Cover

Interaction Systems

Interactive Objects
Environment Interactions
IK-Based Interactions
Context-Sensitive Actions
Custom Interaction Extensions

Camera Systems

Dynamic Third Person Camera
Aiming Camera
Swimming Camera
Diving Camera
Smooth State Transitions

Vitality Systems

Health System
Stamina System
Breath System
Reusable Event-Driven Architecture

Technical Systems

Runtime Debug Tools
Editor Utilities
State Machines
Dynamic Colliders
UI Manager
Input Manager

Core Architecture

MTPF follows architecture-first development practices designed to reduce coupling and improve long-term maintainability.

Architectural Principles

Composition Over Inheritance
Interface-Based Design
Event-Driven Communication
Dependency Injection Principles
Inversion Of Control Principles
State Machines
Scriptable-Object Configuration
Enum-Based Configuration
Runtime Extensibility

The framework is organized around modular systems that communicate through clearly defined interfaces and events, making customization easier while maintaining clean architecture.

Development & Customization

MTPF was designed to support customization at every level. Developers can:

Create new movement mechanics
Create new interaction systems
Add project-specific gameplay features
Configure systems through Scriptable-Objects
Extend character states
Replace existing components
Customize UI systems
Create custom character types
Integrate project-specific functionality

The framework encourages extension and integration rather than modification of core systems.

Specialized Systems

Climbing System

Supports ladders, ropes, poles, walls, and custom climbing implementations.

Cover System

Includes high and low cover mechanics with configurable transitions.

Parkour System

Supports vaulting, climbing, traversal, and obstacle navigation.

IK Interaction System

Provides hand and foot placement support for natural interactions.

Water System

Supports entering water, swimming, diving, underwater transitions, and breath mechanics.

Documentation & Learning Resources

MTPF includes resources designed to help developers understand, configure, and extend the framework.Available resources include:

User Documentation
Architecture References
Setup Guides
Configuration Examples
Demonstration Scenes
Learning Resources

These materials are intended to help developers understand both framework usage and architectural design.

Compatibility

MTPF supports:

Unity New Input System
Cinemachine
Animation Rigging
Unity Starter Assets (Demo Character)

Character Models & Animations

MTPF does not include production-ready character models, animation packs, or third-party art assets.Developers are expected to use their own:

Character Models
Animation Packs
Motion Capture Animations
Marketplace Assets
Internal Studio Assets

The framework provides the systems and integration points required to connect custom content to gameplay mechanics.

Getting Started

Getting started with MTPF is straightforward:

Import the framework into a Unity project.
Install required Unity packages.
Import a compatible character model and animation assets.
Configure systems using Scriptable-Objects.
Configure character states and interactions.
Begin extending gameplay systems for your project.

Build Your Next Third Person Game

MTPF provides a modular foundation for creating scalable third person games in Unity. Combining advanced locomotion, interaction, vitality, camera management, extensibility, and architecture-first design, MTPF helps developers focus on creating gameplay instead of repeatedly rebuilding core systems.