Engine & Standards
- Unity Version: Supports Unity 2021.3 LTS or higher. Full compatibility has been verified for Unity 6, including the new Render Graph and updated assembly definitions.
- Data Standard: Fully compliant with RFC 4180. This ensures that complex CSV features—such as fields containing commas, double-quotes, or literal newlines—are parsed and exported correctly.
- Global Localization: Implements
CultureInfo.InvariantCulturefor all numeric and date parsing. This ensures your CSV data remains consistent across all global regions, regardless of the user’s OS language or decimal separator settings (e.g., 1.50 vs 1,50).
Architecture & Performance
- State Machine Parsing: Unlike simple
string.Splitmethods, this suite utilizes a character-based state machine. This approach is significantly more robust and prevents data corruption when handling escaped characters. - Stateless Design: The
CanleyCSVManageris designed to be stateless. It automatically clears internal memory and resets the Reader state before every new load operation to prevent data “bleeding” between different files. - Memory Efficiency: Optimized for low-allocation data access, making it suitable for large RPG databases, localization systems, and real-time telemetry logging.
Input & Interaction
- Input Systems: Fully compatible with both the Legacy Input Manager and the Modern Input System. The included Demo scenes rely on the Canley Core Bridge to detect your project settings automatically.
- TextMesh Pro: The demo interface and CSV-to-Table examples require TextMesh Pro. For the smoothest installation, ensure you have imported TMP Essential Resources via the Unity Package Manager.
File I/O & Platform Support
The Canley CSV suite features a “Smart Pathing” system that detects the user’s environment at runtime to provide the safest possible I/O experience.
- Universal Pathing: Supports Resources, StreamingAssets, and Absolute Paths.
- Automated Directory Integrity: The
SaveToFilemethod recursively checks for and creates missing sub-folders in your path (e.g.,Saves/Profiles/Player1.csv) before writing. - BOM Stripping: Automatically detects and removes UTF-8 Byte Order Marks (BOM). This prevents “invisible” characters from breaking header lookups when importing files exported directly from Microsoft Excel.
- Cross-Platform Verified: Optimized for PC, Mac, Linux, iOS, and Android.
Unity 6 Installation Notes
- Input System: If a mismatch is detected between your Project Settings and your Scene’s EventSystem, a one-time migration assistant will appear. This check runs once per scene to ensure the Demo UI remains interactive.
- Manual Input Migration: If you postpone the migration, you can trigger it manually at: Tools > Canley Utilities > Input > Migrate to Input System.
Note: This menu item will be greyed out if your scene is already configured correctly for your active Input System.