INI Parser For Unity

Configuration you can read and control

uINI brings INI configuration into your Unity project with a strict parser, typed reads and an Editor workflow. Keep readable settings in plain files, combine defaults with overrides, and make targeted changes without losing the comments that explain your configuration.

Read typed values

Read strings, integers, floating-point values and booleans by section and key. Choose fallback-based reads, TryGet methods, or required-value reads. Register converters for additional types; Unity converters cover vectors and colors.

Layer settings without copying every key

Combine default, platform and user documents with key-by-key precedence. Ask which layer supplied a value when you need to understand an override.

Edit while preserving context

Use the builder to change values and produce a new immutable document. Preserve comments, ordering and newline style while the original document remains unchanged. File-store APIs support bounded loading and saves with an optional content-hash conflict check.

Check configuration and generate typed settings

Define schemas with required values and constraints, then inspect structured diagnostics with source locations. Generate plain C# settings from INI files in the Editor and read named properties through a binder.

Work inside the Editor

Import .ini and .uini files as IniAsset objects. Browse sections and keys, inspect raw text, and apply value edits through the Inspector. Four included samples cover Quick Start, Runtime Overrides, Validation and Binding, and Typed Settings.

Requirements and scope

Requires Unity 2022.3.57f1 or newer in the 2022.3 baseline. This preparation verified Windows Editor behavior with Unity 2022.3.57f1. Unity 6 and player builds on other platforms have not been verified here. The package is managed C# with no declared UPM runtime dependencies. Obtain StreamingAssets text using the loading mechanism appropriate to your target platform.

Known limitation

With writer generation enabled, a key named WithLives can conflict with the WithLives method generated for a key named Lives. Use non-conflicting property names or disable writer generation for that configuration. This naming collision remains present in the reviewed version.

About the listing images

Marketing images use original decorative illustrations and externally typeset code examples. The displayed values and diagnostic results were produced by executing uINI. These compositions are not Unity Editor screenshots.