Skip to main content

Supported Versions

This page documents C4G version compatibility with Unity, .NET, and related dependencies.

Unity Compatibility

Supported Unity Versions

C4G officially supports:

Unity VersionSupport StatusNotes
2019.4 LTS✅ Full SupportMinimum required version
2020.3 LTS✅ Full SupportRecommended for stability
2021.3 LTS✅ Full SupportRecommended for new projects
2022.3 LTS✅ Full SupportLatest LTS, fully tested
2023.1+✅ Full SupportLatest versions supported
6000.0+⚠️ ExperimentalUnity 6 - testing in progress

Unity Version Selection

Recommended:

  • New Projects: Unity 2022.3 LTS or later
  • Existing Projects: Stay on your current LTS
  • Production: Use LTS versions for stability

Not Supported:

  • Unity 2018.x and earlier
  • Unity 2019.3 and earlier (non-LTS)

.NET Compatibility

Target Frameworks

C4G is built on .NET Standard 2.0, providing broad compatibility:

FrameworkSupport StatusC4G Package
.NET Standard 2.0✅ Full SupportUnity & Standalone
.NET Standard 2.1✅ Full SupportUnity & Standalone
.NET 4.x✅ Full SupportUnity only
.NET 5+✅ Full SupportStandalone only
.NET Core 3.1✅ Full SupportStandalone only
.NET Framework 4.7+✅ Full SupportStandalone only

Unity Scripting Backend

BackendSupport StatusNotes
Mono✅ Full SupportDefault for Unity Editor
IL2CPP⚠️ LimitedEditor-only tool

Note: C4G is an Editor-only tool. Generated configs work on all backends.

Platform Compatibility

Unity Editor Platforms

C4G runs in the Unity Editor on:

PlatformSupport StatusNotes
Windows✅ Full SupportTested on Windows 10/11
macOS✅ Full SupportTested on macOS 12+
Linux✅ Full SupportTested on Ubuntu 20.04+

Runtime Platforms (Generated Configs)

Generated configs can be used on all Unity platforms:

  • ✅ Windows (Standalone)
  • ✅ macOS (Standalone)
  • ✅ Linux (Standalone)
  • ✅ iOS
  • ✅ Android
  • ✅ WebGL
  • ✅ Console platforms (PlayStation, Xbox, Switch)

C4G itself doesn't run at runtime - only the generated JSON configs are loaded.

Dependency Versions

Google Sheets API

C4G bundles specific versions of Google APIs:

DependencyVersionLocation
Google.Apis.dllLatestAssets/C4G/Plugins/
Google.Apis.Core.dllLatestAssets/C4G/Plugins/
Google.Apis.Auth.dllLatestAssets/C4G/Plugins/
Google.Apis.Sheets.v4.dllv4Assets/C4G/Plugins/

Updating Google APIs:

  • Not recommended unless necessary
  • May cause compatibility issues
  • Test thoroughly if updating

Newtonsoft.Json

VersionSupport StatusNotes
12.0.3+✅ RecommendedBundled with C4G
11.0.0 - 12.x✅ CompatibleWorks but may have minor issues
13.0.0+✅ CompatibleLatest versions work

Conflicts:

  • If your project uses a different Newtonsoft.Json version, you may see warnings
  • Usually safe to ignore or use the latest version
  • Remove duplicate DLLs if issues occur

C4G Version History

Current Version: 0.0.4

Release Date: Check GitHub Releases

Features:

  • Google Sheets integration
  • Code generation for C# DTOs
  • JSON serialization
  • Custom type parsers
  • Enum support
  • List/array support

Previous Versions

VersionRelease DateStatusNotes
0.0.4Latest✅ CurrentStable release
0.0.3Previous⚠️ LegacyUpgrade recommended
0.0.2Older❌ DeprecatedNot supported
0.0.1Initial❌ DeprecatedNot supported

Upgrade Path:

  1. Backup your current project
  2. Delete Assets/C4G folder
  3. Import latest .unitypackage
  4. Reconfigure settings
  5. Test generation

Breaking Changes

Version 0.0.4

No breaking changes from 0.0.3.

Version 0.0.3

  • Introduced modular architecture
  • May require reconfiguration of custom type parsers

Upgrading from 0.0.2 or earlier

Breaking changes:

  • Settings structure changed
  • Custom parser registration changed
  • File output structure modified

Migration steps:

  1. Note current settings (spreadsheet ID, folders)
  2. Remove old C4G package
  3. Install new version
  4. Reconfigure settings from scratch
  5. Regenerate all configs

Unity Package Versions

C4G may interact with these common Unity packages:

PackageCompatibilityNotes
TextMesh Pro✅ CompatibleNo conflicts
Unity UI (uGUI)✅ CompatibleNo conflicts
Addressables✅ CompatibleUse for config loading
JSON .NET for Unity⚠️ ConflictRemove if using C4G's version

Checking Your Version

In Unity

  1. Select any C4G file in Project window
  2. Check Inspector for package version
  3. Or check Assets/C4G/package.json:
{
"version": "0.0.4",
"displayName": "C4G"
}

Via Package Manager

  1. Window → Package Manager
  2. Select C4G from list
  3. Version shown in details panel

Via Code

using C4G.Core;

Debug.Log($"C4G Version: {AssemblyReference.Version}");

Version Support Policy

Long-Term Support (LTS)

  • Current version (0.0.4+): Full support, active development
  • Previous minor version: Bug fixes only
  • Older versions: No support, upgrade recommended

Security Updates

  • Critical security issues: Fixed in all supported versions
  • Non-critical issues: Fixed in current version only

Bug Reports

When reporting bugs, please include:

  • C4G version
  • Unity version
  • Operating system
  • Google Sheets API version
  • Newtonsoft.Json version

Compatibility Testing

C4G is tested on:

EnvironmentStatus
Windows 11 + Unity 2022.3 LTS✅ Primary test
macOS 14 + Unity 2022.3 LTS✅ Regular test
Ubuntu 22.04 + Unity 2022.3✅ Regular test
Windows 10 + Unity 2021.3 LTS✅ Regular test
Windows 11 + Unity 2020.3 LTS✅ Regular test
Windows 11 + Unity 2019.4 LTS✅ Minimum test

Not tested:

  • Unity versions below 2019.4
  • Deprecated OS versions
  • Mobile OS for editor (not applicable)

Future Compatibility

Planned Support

  • Unity 6 LTS (when released)
  • .NET 8+ for standalone package
  • Google Sheets API v5 (when available)

Deprecation Timeline

No major features planned for deprecation. Any deprecations will be:

  • Announced in release notes
  • Supported for 2+ major versions
  • Provided with migration guides

Getting Help

Version-Specific Issues

  • Check GitHub Issues for known problems
  • Include version numbers in bug reports
  • Search for version-specific workarounds

Upgrade Assistance

Next Steps