Spreadsheet Easy

Spreadsheet Easy

High-Performance Spreadsheet Reader & Data Framework for Unity

A production-ready way to read Spreadsheet data in Unity, with clean APIs, strong typing, and serious performance.

Documentation

Stop 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 queries
• String-based parsing everywhere
• Fragile cell indexing
• Runtime GC spikes
• Spreadsheet parsing cost on mobile and VR

The result is a clean API on the surface, and a highly optimized data layer underneath.

Core Features

Clean, Type-Safe API

Read 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 lookups
• Cached row search results
• Designed for frequent queries and Update() usage

Real benchmarks are included. This is measurable, not theoretical.

SpreadsheetRow for Bulk Access

When 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 Mode

Choose how data is loaded.

• Runtime Parsing

Read Spreadsheet directly from StreamingAssets.

• ScriptableObject Mode

Pre-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 Tool

Validate 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 Support

Out of the box support for:

• string, int, float, double, bool
• Enum (string or numeric)
• Vector3
• Color (hex or RGBA)
• Arrays (int[], float[], string[])

No custom parsing code required.

• Designed for Real Projects
• Works in Editor and Runtime
• Mobile and VR friendly
• Handles large tables efficiently
• Lazy loading or preload at startup
• Clear error handling strategy
• No dependency lock-in

This asset is meant to stay in your project for the long term.

Example Use Cases

• Game configuration and balancing
• Item and skill databases
• Localization tables
• Live-tuned gameplay parameters
• Data-driven design workflows

If your project relies on Spreadsheet, SpreadsheetEasy fits naturally.

What This Is Not

• Not a visual editor replacement
• Not an editor-only helper
• Not a fragile demo script

SpreadsheetEasy is a data access layer, built for production.

Requirements:

- Unity 2020.3 or later

Third-Party Components:

• ExcelDataReader (included)
• License: MIT License
• Asset uses ExcelDataReader under MIT License; see Third-Party Notices.txt file in package for details.