Ultimate Progression Framework System - UPFS

🚀 Ultimate Progression Framework System (UPFS)

📉 The Complete, Scalable Progression Architecture for Unity

Every game grows.

What starts as a single level, upgrade, or stat boost can quickly expand into hundreds of progression entries, tiered milestones, evolving values, saved states, and interconnected game mechanics.

Without a dedicated foundation, progression logic becomes scattered across ad-hoc scripts, custom formulas, disconnected spreadsheets, and manually maintained data tables. Every new feature takes longer to build, balancing becomes tedious, and even minor adjustments require hours of repetitive data entry.

UPFS provides a complete, modular, and data-driven foundation for building, balancing, and managing progression systems of any type and scale.

From simple linear upgrades to massive incremental games with hundreds of levels, milestones, and evolving stats, UPFS gives you an enterprise-grade architecture—so you never have to rebuild progression logic from scratch.

🎮 Built for Any Genre & Any Scale

UPFS is completely genre-agnostic and adapts to your game’s unique design:

• Character & RPG Systems: Stat growth, leveling, skill trees, and class-rank unlocks.
• Weapons & Equipment: Multi-tier weapon upgrades, rarity evolution, and stat scaling.
• Idle & Incremental Games: Multiplier tiers, automated generator levels, and milestone rewards.
• Strategy & Tycoon Games: Building upgrades, facility expansion, technology trees, and production capacity.
• Vehicles & Machines: Multi-attribute tuning for speed, grip, acceleration, durability, and more.
• World & Meta-Progression: Stage unlocks, chapter progression, reward tracks, and difficulty levels.
• Resources & Inventory: Capacity growth, storage limits, and energy or stamina pools.

🧱 Structured Progression with Big & Small Upgrades

Unlike simple list-based tools, UPFS introduces a hierarchical Big Upgrade and Small Upgrade structure.

This lets you organize granular progression steps inside meaningful groups, tiers, chapters, or milestones:

• Single Source of Truth: Centralized Upgrade ScriptableObjects manage identities, base values, level hierarchies, current and next states, milestone completion, and persistence.
• Milestone & Tier Logic: Automatically track both overall progression and local progress within the active Big Upgrade group.
• State & Query Engine: Instantly query the current level, next available level, affordability, global indices, and full completion state with minimal runtime overhead.

⚡ Automated Data Generation & Smart Distribution Patterns

Eliminate manual calculations and spreadsheet copy-pasting.

Define your progression structure, starting values, target limits, and growth curve UPFS automatically generates and populates the complete progression hierarchy.

Choose from multiple built-in distribution patterns:

• Linear: Consistent and predictable step-by-step growth.
• Exponential / Ease In: Gradual early progression that transitions into steep late-game scaling.
• Logarithmic / Ease Out: Fast initial gains that smoothly stabilize with diminishing returns.
• Ease In Out: Smooth S-curve progression with controlled starting and finishing phases.
• Step: Tiered, stage-based growth with steady plateau intervals.
• Random: Procedurally varied values generated within defined boundaries.
• Custom Curve: Complete artistic and mathematical control using Unity’s AnimationCurve.

Designer-Friendly Control:

Automated generation handles the repetitive work, while you retain complete control. Every generated value and milestone can still be reviewed, edited, or fine-tuned individually through custom Unity Inspectors.

🧩 Modular, Decoupled Architecture

UPFS includes a suite of specialized, decoupled components that work together seamlessly without cluttering your core gameplay scripts.

1. Upgrade ScriptableObject

The central brain of your progression system.

It manages level structures, progression values, milestone states, event dispatching, and runtime persistence.

2. Currency ScriptableObject

Reusable numeric containers supporting both integer and floating-point precision.

Use them to manage gold, gems, XP, energy, tokens, skill points, or any custom gameplay resource.

3. Upgrade Economy Handler

Connects progression systems with your game economy.

It manages multi-resource transactions, real-time affordability checks, currency priorities, and safe deduction logic.

4. Upgrade Info Provider

Attach rich presentation metadata to individual progression steps or complete milestone tiers without modifying the core progression logic.

Supported data includes:

• Text: Names, descriptions, labels, lore, and other string-based information.
• Numbers: Integer and floating-point modifiers or custom values.
• Visuals: Sprites, textures, colors, and materials.

5. Event Listeners & Scene Bindings

Connect progression events directly to scene objects, UI elements, audio sources, visual effects, and gameplay systems. Use Inspector-based UnityEvents for fast setup or strongly typed C# events for advanced integrations.

6. Editor Utilities & Settings

Access framework-wide settings, validation tools, confirmation dialogues, and a built-in PlayerPrefs viewer for faster authoring, debugging, and testing.

💾 Built-In Persistence & Runtime State

Keep progression data safe between gameplay sessions:

• Built-In PlayerPrefs Saving: Automatically save and load progression states, currency balances, and active milestone tiers.
• Runtime Management: Use dedicated APIs and Inspector actions to save, load, reset, or restore default states during development.

🎓 20 Practical Demo Scenes

UPFS includes 20 comprehensively designed demo scenes to help you understand and implement the framework immediately.

These are not basic test scenes. They are realistic, functional examples demonstrating:

• Diverse progression structures across multiple game genres.
• Component relationships and complete data flow.
• Event-driven UI updates, progress bars, and feedback animations.
• Multi-currency economy integration and transaction validation.
• Practical use of public APIs in real gameplay scenarios.
• Step-by-step setup workflows that accelerate implementation from day one.

|| EXPLORE DEMOS ONLINE ||

📖 Clear, Comprehensive Online Documentation

UPFS includes detailed, structured documentation written for both indie developers and technical teams:

• Step-by-Step Quick Start Guide: Go from zero to a fully working progression system in minutes.
• Inspector-by-Inspector Reference: Understand every setting, toggle, component, and configuration field.
• Complete Public API Reference: Explore documented methods, state queries, properties, and event signatures.
• Best Practices & Architecture Guides: Learn how to structure and scale progression across large production projects.

🚀 Build on the Right Foundation Today

Rebuilding custom upgrade scripts, mathematical formulas, data tables, and saving systems for every project wastes valuable development time and creates unnecessary technical debt.

Ultimate Progression Framework System gives you an all-in-one, industry-grade progression engine that scales effortlessly with your game from the first prototype to the final release.

Streamline your workflow. Balance with precision. Build your progression with UPFS.

EXPLORE DEMOS ONLINE | ONLINE DOCUMENTATION

📩 Support & Queries

For support, questions, feedback, or any setup-related queries, feel free to contact us anytime.

Email: bcylylabs@gmail.com

Website: https://bcylylabs-game-dev.github.io/bcylyLabs.Portfolio

Note:

The demos use fonts from Google Fonts.

The core package is less than 1 MB. Most of the package size comes from the included demo scenes, Sprites assets, and sample resources.