A professional-grade currency and economy engine for Unity — balances, policies, escrow, idempotency, exchange, and Buy/Sell/Craft/Reward flows with explicit rollback handling.💸 RevFramework — Currency & EconomyIf something fails, it tells you why.That's the rule every RevFramework system is built around.Explicit APIs. Deterministic behaviour. Real failure codes. No hidden state. No guesswork.RevFramework gives you production-ready Currency and Economy systems — with the documentation, testing, and debugging infrastructure to match.⚠️ Requires C# scripting knowledge. This is not a no-code tool or drag-and-drop economy kit.--------------------------------------------------------🧩 What You Actually GetTwo runtime systems built for developers who need financial infrastructure they can trust:💸 Currency — credit, debit, transfer, escrow, exchange, rollback-safe transactions, authority-aware mutations🧠 Economy — shop services, crafting cost integration, reward distribution, atomic item delivery, rollback on failureBoth systems work independently. Neither requires the other.This is not a shop template. It's financial infrastructure for gameplay systems.Plus the infrastructure most assets skip:15 YouTube tutorialsPublic MkDocs documentation site — freely accessible before you buy. Read it before you decide.Interactive teachable panels that call real APIs and show live resultsFolder-level READMEs across the entire codebaseThe full documentation site is publicly accessible — no purchase required. Read it before you decide.📚 Documentationhttps://revandrab.github.io/RevFramework/SKUs/CurrencyEconomy/--------------------------------------------------------🔥 Why It's DifferentMost Unity economy assets give you UI and hope the numbers add up.RevFramework gives you correctness.Instead of fragile flows like "deduct currency, give item, hope nothing breaks" — every operation in RevFramework is deterministic, rollback-safe, and explicit about what happened and why.If a transaction fails, you know why. If rollback occurs, you can trace it. If authority validation fails, it's explicit.There are no black boxes here.--------------------------------------------------------💸 Currency SystemA deterministic currency pipeline with overflow-safe execution and rollback-safe transaction staging.Credit, debit, and transfer operationsOverflow-safe executionResult-based APIs — every operation returns a CurOpResult with success flag, reason code, and messagePolicy enforcementAudit metadata supportAuthority-aware mutations with clear rejection codesEscrow and hold systems with commit, release, and TTL expiryRollback-safe transaction stagingRequest ID replay protection for safe multiplayer transaction flows--------------------------------------------------------💱 Exchange & TransactionsCurrency exchange rates with fees and limitsQuote and execute workflowsDeterministic roundingRollback-safe executionAtomic batch operationsStructured transaction logs and audit buffersEvent hooksAsync and coroutine support--------------------------------------------------------🧠 Economy LayerBuilt on top of the Currency system. Handles the flows where currency meets gameplay.Shop ServicesBuy and sell pipelinesAtomic item deliveryRollback on failureDeterministic transaction flowCrafting IntegrationCurrency and item cost bundlesRefund and restore supportDeterministic crafting costsReward ServicesCurrency payoutsReward distribution flowsExplicit failure handlingEvery operation returns a result code, reason, and message — ideal for debugging, analytics, multiplayer logging, and validation.--------------------------------------------------------🌐 Multiplayer & NetworkingRevFramework is netcode-agnostic by design.Authority binders let you gate mutations through your own ownership and permission rules — whether that's NGO, Mirror, Photon, Fusion, or a custom solution.Replication, prediction, and rollback are yours to implement.We give you the rules — your netcode drives the simulation.--------------------------------------------------------🎓 Learning InfrastructureThis is where RevFramework is genuinely different from other assets.Teachable PanelsInteractive panels built directly into the framework. Each one:Calls real public APIs — no shortcuts, no internalsShows live transaction results and reason codes in the sceneDemonstrates rollback behaviour and failure paths directlyProves the public API works by being a hostile consumer of itIf the teachable panels compile and run correctly, the public API works. Not just documented — actually usable.DocumentationPublic MkDocs site — freely accessible before you buyEvery system has: Overview, Mental Model, Integration Surfaces, Public API, System Guarantees Matrix, Testing Philosophy, System Boundaries, and FAQ400+ folder-level READMEs explaining intent and reasoning, not just "this does this"Eight dedicated onboarding documents per systemVideos15 YouTube tutorials covering every teachable panel4 core onboarding videos covering scope, teachables, documentation, and modularityEach video shows real behaviour in a real scene--------------------------------------------------------🧪 Testing & ReliabilityRevFramework testswith 1600+ tests across the full framework.The goal was never coverage percentages.The goal was predictable architectural behaviour.Hostile Consumer TestsValidate the public API the way a real project would — through supported surfaces only, with no access to internals. If these pass, the contract holds.Internal Truth TestsLock down framework assumptions so future refactors don't silently change behaviour. Transaction rollback paths, authority rejection, audit semantics, escrow behaviour.PlayMode Smoke TestsCatch Unity lifecycle failures that EditMode tests can't reach.Test assemblies are not shipped with the framework. You get clean runtime, editor, sample, and teaching assemblies — no NUnit dependencies, no compile overhead.--------------------------------------------------------🎮 Built for Both 2D and 3DAll systems are fully dimension-agnostic.No physics assumptionsNo controller requirementsNo camera dependenciesWorks in any genre or project structure--------------------------------------------------------🧱 What's IncludedRuntime SystemsCurrency coreEscrow and exchange systemsEconomy servicesShop servicesReward systemsLearning & DebuggingTeachable panelsDemo scenesReference UI examplesExample integrationsDocumentationFull MkDocs siteFolder-level READMEs15 YouTube tutorials--------------------------------------------------------🚫 What This Is NotNot a shop UI prefab packNot a visual economy editorNot a networking implementationNot a progression systemNot a drag-and-drop economy builderNot a locked UI workflowRevFramework is financial infrastructure for gameplay systems — not a game template.--------------------------------------------------------🎨 UIReference UI is included for Currency and Economy.It shows you how to talk to the systems correctly.It is not your game UI.Build your own using Unity Canvas, UI Toolkit, or whatever fits your project. RevFramework puts no constraints on how you present its systems to players.--------------------------------------------------------🔗 Other RevFramework ModulesInventory, Pickups & CraftingHealth & Status EffectsRevFramework Complete — all systems togetherAll modules share the same architecture, documentation standard, and testing philosophy. Each one works independently or integrates cleanly with the others.--------------------------------------------------------🧑💻 Who This Is ForRevFramework is for developers who:Are comfortable writing C#Need deterministic financial systems they can trustCare about rollback safety and authority gatingWant debuggable economy logic with real failure reasonsPrefer extending frameworks instead of rewriting themIf you want a no-code solution or a drag-and-drop economy builder, this is not the right package. That's not a criticism — it's just a different tool for a different job.--------------------------------------------------------🙋 Core PhilosophyEvery system. Every operation. Every failure.If something fails, it tells you why.That's not a feature. That's the foundation everything else is built on.If you value clarity, structure, and real engineering — this framework will feel like home.Unity & RenderingUnity 6 or newerBuilt-in Renderer supportedURP supportedHDRP supportedRuntime code is render-pipeline agnosticArchitecture100% C#Modular runtime assembliesNo native pluginsNo required singletonsNo prefab or UI lock-inRuntime assemblies have no Editor dependenciesSystems are opt-in and adapter-drivenIncluded SystemsCurrency runtime systemEconomy runtime layerPolicy capsEscrow / holdsIdempotency supportExchange engineAudit and batch eventsShop, reward, and crafting-cost servicesReference UI helpersPersistence helpersTeachable PanelsSample scenesEditor utilitiesIntegration PointsICurrencyAuthorityIValueLedgerIItemStoreCurrency policy interfacesCurrency ↔ Inventory adaptersCustom cost / reward / shop integrationsAuthority validation seamsMultiplayer / AuthorityNetcode-agnosticAuthority-aware mutation gatesSuitable for server-authoritative projectsCompatible with NGO, Mirror, Fusion, Photon, or custom RPC layersNetworking and replication are not includedPerformanceDesigned for low-GC hot pathsDeterministic transaction pipelinesRollback-safe operationsIncludes diagnostic/performance smoke-test scenesPerformance depends on user integration, UI, custom rules, and event handlersDocumentation & SamplesFull MkDocs documentationFolder-level README filesXML documentation on public APIsSample scenesTeachable Panels using real runtime APIsMatching tutorial videosRequirementsUnity 6+C# scripting knowledgeFamiliarity with interfaces/composition recommended2D and 3D compatibleThis asset was developed using AI-assisted workflows as part of an iterative human-led development process.AI was used to assist with coding, architecture exploration, debugging, and tooling workflows — while all systems, testing, validation, and production decisions remained manually directed and reviewed throughout development.
