Read Spreadsheet in Unity. Fast. Clean. Production-ready.
Type-safe queries with 50–100× faster access using smart indexing.
Built for mobile, VR, and large data tables.Spreadsheet EasyHigh-Performance Spreadsheet Reader & Data Framework for UnityA production-ready way to read Spreadsheet data in Unity, with clean APIs, strong typing, and serious performance.DocumentationStop fighting Spreadsheet data at runtime.SpreadsheetEasy is a production-ready Spreadsheet data framework for Unity.It lets you query Spreadsheet files by column name instead of cell index, with type-safe APIs and an index cache that makes repeated access extremely fast.This is not a demo script or an editor-only tool.SpreadsheetEasy is designed for real projects, large tables, and performance-sensitive platforms like mobile and VR.Why SpreadsheetEasy?Most Spreadsheet readers work, but break down once your project grows.SpreadsheetEasy solves the common pain points:Slow repeated queriesString-based parsing everywhereFragile cell indexingRuntime GC spikesSpreadsheet parsing cost on mobile and VRThe result is a clean API on the surface, and a highly optimized data layer underneath.Core FeaturesClean, Type-Safe APIRead data by column name, not by cell position.int hp = SpreadsheetReader.GetInt("PlayerConfig", "Players", "ID", "P001", "HP");float speed = SpreadsheetReader.GetFloat("PlayerConfig", "Players", "ID", "P001", "Speed");No magic numbers. No brittle cell indices.TryGet APIs (No try-catch)Gracefully handle missing or invalid data without exceptions.if (SpreadsheetReader.TryGetInt("PlayerConfig", "Players", "ID", "P001", "HP", out int hp)){// Safe to use}Cleaner code. Clear intent.High-Performance Index Cache (50–100× Faster)SpreadsheetEasy builds column and row indices automatically.O(1) column lookupsCached row search resultsDesigned for frequent queries and Update() usageReal benchmarks are included. This is measurable, not theoretical.SpreadsheetRow for Bulk AccessWhen you need multiple values from the same row, fetch once and read many times.SpreadsheetRow row = SpreadsheetReader.GetRow("PlayerConfig", "Players", "ID", "P001");int hp = row.GetInt("HP");float speed = row.GetFloat("Speed");Significantly faster than repeated single queries.Runtime Parsing or ScriptableObject ModeChoose how data is loaded.Runtime ParsingRead Spreadsheet directly from StreamingAssets.ScriptableObject ModePre-bake Spreadsheet data into ScriptableObjects for zero parsing cost at runtime.Best for mobile, VR, and production builds.Same API. Different performance profiles.FREE BONUS: Built-in JSON Validation ToolValidate JSON stored inside Spreadsheet cells before it breaks your game.Writing JSON inside Spreadsheet cells is error-prone. A single missing comma can crash your game. We included a powerful editor tool to save your sanity!One-Click Validation: Just drag your folder and click check.Pinpoint Accuracy: Tells you exactly which File, Sheet, Row, and Column has the error.Batch Processing: Scans thousands of files recursively in seconds.Zero Setup: Works directly on .xlsx, .xls files, no runtime code needed.A practical tool you will actually use.Rich Data Type SupportOut of the box support for:string, int, float, double, boolEnum (string or numeric)Vector3Color (hex or RGBA)Arrays (int[], float[], string[])No custom parsing code required.Designed for Real ProjectsWorks in Editor and RuntimeMobile and VR friendlyHandles large tables efficientlyLazy loading or preload at startupClear error handling strategyNo dependency lock-inThis asset is meant to stay in your project for the long term.Example Use CasesGame configuration and balancingItem and skill databasesLocalization tablesLive-tuned gameplay parametersData-driven design workflowsIf your project relies on Spreadsheet, SpreadsheetEasy fits naturally.What This Is NotNot a visual editor replacementNot an editor-only helperNot a fragile demo scriptSpreadsheetEasy is a data access layer, built for production.Requirements:- Unity 2020.3 or laterThird-Party Components:ExcelDataReader (included)License: MIT LicenseAsset uses ExcelDataReader under MIT License; see Third-Party Notices.txt file in package for details.
