General

• Restored file upload/download functionality inside the Unreal Engine CEF window. This re-enables the feature in UE versions after 5.2, where it was disabled by Epic Games.
• Corrected a typo in the C++ code generator affecting the property decorator: UPROPERTY(BlueprintReadOnly, VisibleAnywhere).
• Updated the Terms of Service for the online application to clarify data ownership and reduce the scope of platform control.

Game Data Editing

• Updated the RPG Game Project example to include new features such as custom layouts and templated display text for schemas.
• Improved overflow detection to correctly handle integers larger than 2^53 without reporting false overflows.

Code Generation

• Updated copyright notices to dynamically use the current year instead of a fixed year.

User Interface

• Added an option to specify languages when publishing data in Unreal Engine.
• Introduced a new window for previewing publication issues.

Unreal Engine

[Charon Plugin 2025.1.2]

Improvements

• Ensured the content root directory is set for the dotnet-charon tool and verified its existence before use.
• Made the game data C++ code generation process configurable via GameDataBase::AssetImportData.
• Added an option to trim translation languages during the import/reimport of game data into .uasset files.
• Added usage examples for CharonCli, available in the FCharonPluginGameEditorModule module.

API Changes

• Modified FCharonCli::Import/I18NImport to return an FImportReport instance, providing details on the import process.
• Introduced new methods in FCharonCli:
  
  • InitGameData
  • I18NImport
  • I18NImportFromFile
  • I18NExport
  • I18NExportToFile
  • I18NAddLanguage
  • CreatePatchToFile
  • ApplyPatchFromFile
  • RunCharon
  • RunT4
  • PreprocessT4

Unity

[OpenUPM Package 2025.1.2][Unity Asset]

Improvements

• Enhanced example code with additional comments for better clarity.
• Improved documentation for the CharonCli class and reorganized CharonCliExamples into multiple files for better readability.
• Updated line endings in generated code to match the default OS format, with customization options available in the .asset Inspector window.

API Changes

• Updated CharonCli.Import/I18NImport to return an ImportReport instance, providing detailed results of the import process.
• Refactored CharonCli.RunT4Async, splitting it into two separate methods: RunT4Async and PreprocessT4Async, improving usability and reducing confusion.

Examples

• Added a BulkDelete example in CharonCliExamples.

‍

• Fixed compilation errors on macOS by removing #pragma once in .cpp files.
• Resolved an issue in FCharonEditorModule::GetGameDataEditorMenuExtensibilityManager to correctly pass delegate extenders along with FExtender instances.
• Fixed an issue in bootstrap .bat/.sh scripts where exit codes of invoked tools were not properly checked, causing failures on the first run.
• Fixed an issue with GitHub authentication caused by a JSON parsing error.
• Fixed a potential hang when multiple save calls were made concurrently, preventing race conditions under high CPU load.
• Fixed an issue where overflow error messages displayed [object Object] placeholders instead of actual min/max values.

‍

Breaking Changes

• EXPORT: XML format has been discontinued.
• EXPORT: Export no longer auto-includes containing schemas for the selected schema list. If a schema is embedded in another, you must explicitly specify the root schema for export.
• EXPORT: Export no longer auto-exclude system schemas for empty or '*' schema list. Use explicit exclusion token * ![system] for same purpose.
• EXPORT: The primary translation language text is now always the first member in JSON, MessagePack, and XLSX data formats, with the remaining languages sorted alphabetically. Previously, languages were sorted alphabetically by their BCP-47 language IDs.
• EXPORT: The order of collections in the Collections field has changed. Project Settings and Schemas now appear first, followed by all other collections in alphabetical order.
• CLI: The DATA LIST command now returns a standard game data document structure, similar to the DATA EXPORT command, instead of an array of documents.
• CLI: The built-in T4 transformation tool has been removed from the GENERATE TEXT command. Use the external dotnet-t4 tool instead.

General Improvements

• The default deployment has switched from a .NET Framework tool package to a dotnet tool NuGet package.
• Installing and running Charon CLI now requires only two commands:

dotnet tool install -g dotnet-charon
dotnet charon ...

• New JSON, BSON, and MessagePack formatters generate less memory garbage and offer better performance.
• The switch to the .NET Core runtime improves memory usage and overall performance compared to .NET Framework.

User Interface

• Added language IDs (BCP-47) alongside language names in Project → Internationalization.
• Added an option to hide schemas from the left-side menu, accessible via Actions → Advanced Options.
• Added Next/Previous navigation buttons in the document form UI, allowing users to browse documents without returning to the document list.
• Added a Create button in the document form UI under Actions → Create, allowing document creation without navigating back to the document list.
• Introduced a Form/Layout/JSON view switch in the bottom-right corner of the document form. Layout view is only available for schemas.
• Added options to rearrange and group schema properties within the form editor.
• Refactored the Formula Type lookup to display all supported public types when running inside Unity or Unreal Engine editors. Otherwise, it defaults to a subset of supported types (e.g., primitives, Math, etc.).

Game Data Editing

• The Extraction export mode now behaves the same as Normal, ensuring a valid document graph without broken references.
• The Id column in exported XLSX spreadsheets is no longer hidden when values are auto-generated.
• Added document count validation for Component and Settings schema types, warning when the incorrect number of documents are present.
• The schema name SchemaPropertyType is now reserved and cannot be used for custom schemas.
• Deprecated the C# 4.3 language target—avoid using it in new projects.
• Added schema and property specification keys for code generation:
  • csAttribute, uecppAttribute, haxeAttribute, tsAttribute – allows adding arbitrary attributes to generated classes and properties.
  • csBaseType, uecppBaseType, haxeBaseType, tsBaseType – allows changing the base type of generated classes.
• Added SchemaId and SchemaName static fields to each generated class in all source code languages.

Command-Line Interface (CLI)

• Added a shortcut command:

dotnet charon <filename>

• This starts the application with the specified file, launches an HTTP server with default parameters, and opens the UI in the default browser.
• Added a command to initialize an empty game data file:‍

dotnet charon INIT <filename>

• The CLI now reuses an existing HTTP server instance when reopening the same game data file with dotnet charon [filename], using an implicit lock file in %AppData%\Charon\.
• Configured appsettings.json to be loaded from the base application directory, with overrides from %APPDATA%\Charon\appsettings.json.
• Logs, preferences, and lock files are now stored in %APPDATA%\Charon\.
• Added a new command to add a translation language:

dotnet charon DATA I18N ADDLANGUAGE

• Modified dotnet charon DATA IMPORT and dotnet charon DATA I18N IMPORT to output import report in specified format. By default, it output to nul.

‍

• Fixed an issue where limited resource allowances (AI Tokens, Machine Translation) were not rolling over at the end of the month.

‍

General

• Added Haxe source code generator.
• Changed patching logic to skip 'notes' while merging localization texts.

User Interface

• Added explanation for 'stale' text.
• Added Haxe generation target in CLI and UI.

Code Generation

• Added auto-cleanup of output directory option when generating code from CLI.
• Added disable Document Id enum switch to code generation optimizations.
• Added special merging logic for ProjectSettings.Languages field during applying patches. This will allow patch-in multiple localizations without breaking previous ones.
• Reduced generated file overwrite by skipping rewriting same files while re-generating source code.
• Implemented UE C++ patch applying logic in MergeGameData() method.
• Changed name of file in single file deployment for TypeScript code.

Web Application

• Added strict check for image format while uploading user/project/workspace pictures.

Breaking Changes

• Name collisions are possible due to the fact that classes with identifiers of known documents have been added.
• The LocalizedString class has been renamed to LocalizedText.
• Settings schema accessors are no longer named in singular form. This is break some code accessing them. Sorry

General

• Changed patching logic to skip 'notes' while merging localization texts.

Game Data Editing

• Fixed error while trying to add new Unique Time/Date properties to existing Schema.
• Fixed automatic Id property data type update when IdGenerator of parent schema is changed.

Code Generation

• Fixed C# document id with Date key compilation error.
• Fixed error with possible empty language in GameData.SupportedLanguage in all generation targets.
• Modified patch merge behavior to prevent merging partial document into a deleted one in Document typed field. The same behavior for document collections was already present.

‍

Game Data Editing

• Expanded the scope of generated ID (e.g., ID<Random-Numbers>) substitution from document-level to operation-level. This allows multiple documents with generated IDs to reference each other during Import, Update, or Create operations.
• Enabled storage of ambient information in the 'notes' field of the LocalizedText data type, facilitating the tracking of stale localizations and other i18n data.
• Added support for Schema->Name and Schema->Id lookups in imported 'Collections' data, not just by schema name.

Code Generation

• Replaced C++ exceptions with log error messages in generated UE C++ code.

User Interface

• Added a 'Translate' button to the document form for performing machine translations on the entire document.
• Added support for 'Yes'/'No' as valid values for the logical data type, including filters.
• Improved progress indicators for background processes.
• Added CTRL+S/CMD+S shortcut support for the document edit form.
• Added icons to wizard actions and options.
• Added numerous tooltips for buttons throughout the project.
• Enhanced control over processes (Export/Import/Generate/Load/Backup/Restore) with the ability to stop them from the notification menu, and indicated fault states in the progress bar.
• Added a project-wide machine translation wizard.
• Added a schema AI icon picker.
• Introduced a schema creation wizard with AI suggestions.
• Added a 'Tags' field to Project -> General settings.
• Implemented a token limit warning message for when AI tokens or translation word limits are reached.
• Added a tooltip about free subscription packages.
• Made the AI-based schema creation wizard dependent on workspace AI token usage capabilities.
• Updated all wizard UIs for a better look and feel.
• Added summary pages for all export/publish/generate wizards that produce files.
• Provided explanations for 'stale' text.
• Added Unreal Engine-related download handlers to allow a native Save File Dialog experience.

‍

Game Data Editing

• Fixed an error occurring when importing documents with duplicate unique values in properties.
• Resolved an issue where the XLIFF formatter would hang due to a missing FlushAsync() call.

User Interface

• Fixed an error with the metadata selection tree.
• Enabled grid auto-refresh after document deletion.
• Fixed broken document/metadata change notifications, which caused all reactive UI functionality to fail.

‍

‍

General

• Updated CLI documentation for clarity.
• Added auto-login query parameter and new authentication flow with API Key for embedded editors.

Code Generation

Updated UE C++ templates to remove the "#pragma once" directive from .cpp files.

Game Data Editing

Fixed NRE in ImportAsync when schemas are not provided in the request.

‍

Game Data Editing

• Added ChangeNumber and ToolsVersion fields to exported data when mode = Publication.
• Added better messages for unexpected errors. Changed logging to include errorId and other contextual properties.

Code Generation

• (UE C++) Added generation of GetXXX blueprint functions for resolving FGameDataDocumentReference in UE C++ code generator.
• (UE C++) Added ProjectSettings class rename to prevent name collision with multiple game data modules in the same project.
• (UE C++) Updated code generator to refer to the actual 'Charon' module instead of the old 'UeCharon'.

User Interface

• Added custom Publish and Generate C++ Code buttons when Charon is embedded in UE Editor.
• Added an error count indicator to the dashboard (on Publish button).
• Added a search field Clear button.
• Styled filters and search fields with better spacing.

Game Data Editing

• Fixed Export->Publication causing all languages to be selected in ProjectSettings->Languages. Now it is limited to original languages.
• Fixed reference names not being updated after the original document changed.
• Fixed error when renaming schema.

User Interface

• Fixed the New XXX button cannot be pressed around the icon area.

‍

Game Data Editing

• Added language list trimming in Collections/ProjectSettings/0/Languages when publishing with a limited language list. This will be reflected in runtime in the GameData.SupportedLanguages property.

Code Generation

• Added FallbackOption for the SetLanguage() method for better fallback control for C# 7.3, TypeScript, and Unreal Engine C++.

User Interface

• Added XLSX and JSON localization export with multiple target language selection options.

Game Data Editing

• Fixed an error in IdentityChecker/IdentityRepairer when it addressed a non-existing unique property in the document.
• Fixed an error in the REST client and string[] query parameters formatting (affected the /validate/ endpoint).

Code Generation

• Renamed `disableStringOptimization` to `disableStringPooling` for clarity.

‍

Web Application

update: Changed prices in all payed plans to zero for whole '24.

Game Data Editing

fix: fixed None and null values in filter in Document Collection and Reference Collection.

Code Generation

fix: fixed NRE in generator when ProjectSettings.PrimaryLanguage is null.
fix: fixed SetLanguage with fallback language for C# 4.0 code generation. fix: changed TypeScript Formatters/Formulas module type re-export trick to simple export class.

Major Feature: preview of Unreal Engine C++ code generation support

Code Generation

feature: derive DocumentReference type name from specified Document type name in C# and TypeScript generated code.
feature: ensure enum/formula custom names are always formatted according to target language.

User Interface

feature: added C++ (Unreal Engine) generation option.
feature: added support for filtering for 'None' and 'null' values.

Code Generation

fix: fixed C# 7.3 game data read error if null is met instead of document/reference collection after patching game data.
fix: fixed default language for TypeScript and C# GameData.
fix: fixed TypeScript game data read error if null is met instead of document/reference collection after patching game data.

User Interface

fix: added Metadata Load Error message instead of "Generic Error" message.
fix: fixed invalid documentation links in wizards.

Game Data Editing

feature: added reference lookup inside imported data while importing documents. This will reduce false-positive Broken Reference errors.

Code Generation

BREAKING CHANGE: TypeScript: renamed DocumentCollection.withOtherKey -> byKey, old method exists and marked as obsolete.
BREAKING CHANGE: C# 7.3: renamed DocumentCollection.WithOtherKey -> ByKey, old method exists and marked as obsolete.

User Interface

feature: added option to create document right from reference field

‍

Game Data Editing

fix: fixed reference DisplayTextTemplate update in related documents https://github.com/gamedevware/charon/issues/1

Code Generation

fix: fixed duplicate using System.Globalization in C# 7.3.
fix: fixed in TypeScript generated code not reusing collections in DocumentCollection.byKey.

User Interface

fix: fixed excessive reference querying for open documents.fix: relaxed Invoke, Lambda, New expression argument requirement.
fix: added Display Text limit for document form title, and reference chip to prevent text overflow.
fix: fixed excessive reference querying for open documents.
fix: fixed behavior of Push branch dialog when source branch is changed from default.
fix: mention .gdjs, .gdmp files in restore window.

‍

Web Application

fix: fixed Welcome Email discord link.

Major Feature: TypeScript code generation

‍

General

feature(cli): Added GENERATE TYPESCRIPTCODE command to CLI feature(rest): Added TypeScript target for '/datasource/{dataSourceId}/source-code/' endpoint.

Game Data Editing

feature(ds): added ProjectSettings delete/create protection. Batch updates are redirected to one existing instance of project settings.
feature(ds): When changing primary language it is saved to translation language to prevent data loss.

User Interface

feature(ui): added to Workspace -> Member link to documentation #CHAR-217
feature(ui): updated Project Settings -> Translation Language selection box. #CHAR-216

Game Data Editing

fix(ds): fixed Display Text on documents not being refreshed when Display Name Template is updated. gamedevware/charon#1

User Interface

fix(ui): blocked 'Create Project' for non workspace administrator users in Workspace -> Projects pages #CHAR-218
fix(ui): disabled Project Settings -> Backup any operations for non-administrator members #CHAR-219
fix(ui): disabled Project Settings -> General transfer and deletion of project for non-administrative workspace members #CHAR-221
fix(ui): fixed problem with external user pictures fix(ui): fix PickList and MultiPickList edge values handling for Int64
fix(ui): relaxed pick list and formula parameters name requirement to allow one symbol names.

Code Generation

fix(gen): removed unused DocumentReference.SetFindFunc method
fix(gen): removed DocumentCollection.GetAt method, use DocumentCollection.AsList[] instead.
fix(gen): fixed invalid reference resolution for C# 7.3 when Schema.Name and generated class name are not match. fix(gen): renamed Formatters.Format -> Formatters.GameDataFormat to reduce type name collision chance.
fix(gen): added back Formatters.Format for backward compatibility with older versions of generated code. It will be removed soon.

Web Application

fix(web): added sending welcome email for OAuth2 authenticated users.
fix(web): fixed staging membership package override logic been broken. Updated exception logging to expand inner exceptions.

‍

General

• feature: added C# 7.3 code generation option with build-in formula support

CLI

• feature(cli): added 'defineConstants' to GENERATE CSHARPCODE command
• feature(cli): added option to generate C# 7.3 code with --languageVersion option
  

Game Data Editing

• feature(ds): added disableFormulaCompilation optimization for C# 4.0 code generation. This is remove requirement for GameDevWare.Dynamic.Expressions dependency from generated code

Code Generation

• feature(gen): added .Parent property for all documents
• feature(gen): updated Json and MessagePack readers code with more checks
• chore(gen): old C# 4.0 code templates moved to /LegacyCSharp directory in exported templates.

User Interface

• feature(ui): added c# 7.3 source code generation option in source code generation wizard
• feature(ui): added C# Eval warning to C# 4.0 source code generation option

‍

CLI

• fix(cli): updated dependencies to fix Linux related bug with command line

Code Generation

• fix(gen): renamed .t4 files to .ttinclude
• fix(gen): fixed code generation to erase #pragma move to if file is split=false.

‍

General

• feature: added C# 7.3 code generation option with build-in formula support

User Interface

• New Angular-based user interface

CLI

• feature(cli): added 'defineConstants' to GENERATE CSHARPCODE command

Game Data Editing

BREAKING CHANGE: renaming Entity -> Schema, EntityAttribute -> SchemaProperty

• feature(ds): added disableFormulaCompilation optimization for C# 4.0 code generation. This is remove requirement for GameDevWare.Dynamic.Expressions dependency from generated code
• feature: added full XLIFF(1/2) support to all ExportResult responses which has 2 language selected.
• feature: added game data document conversion from any format to json for client side
• feature: added new Examine method to data source which returns statistics
• feature: changed error/document paths to Json Pointer (RFC 6901) standard.
• feature: DataSource.FindAsync now accepts additional parameter 'uniqueSchemaPropertyNameOrId' to lookup unique properties instead of Id
• feature: DataSource.FindAsync now returns not-null FindResult with nullable Document property.
• feature: added metadata specification validation on server-side
• feature: more fine-grained do document validation in server code
• feature: removed Requirement = NotDefault, renamed Requirement NotEmpty to NotNull
• feature: added collection statistics with published/errored document count
• feature: new validation invalidRequirementForDataType for collections
• feature: added background validation after changes in datasource
• feature: added error statistics to /examine
• feature: added meta-properties support to server-side
• feature: added more information into server thrown errors especially in ValidationException
• feature: updated XLSX formatting to use formulas to hide paths and data types
• feature: API key based authentication
• feature: enchanted check to detect invalid Dates and Numbers: enchanted check to detect invalid Dates and Numbers(NaN, Infinity)
• refactor: renamed Specifications to Specification everywhere

Code Generation

• feature(gen): added .Parent property for all documents
• feature(gen): updated Json and MessagePack readers code with more checks
• chore: removed Unity C# code generation (it is same as C# 4.0) fix: added ToolsVersion to published game data, fixed publication stripping of Id fields and metadata

Command Line

BREAKING CHANGE: SERVE renamed to SERVER START, signature changed
BREAKING CHANGE: GENERATE CSHARPCODE - signature changed
BREAKING CHANGE: DATA - signature changed for most commands

• feature: added CLI DATA LIST command
  

‍

‍

CLI

• fix(cli): updated dependencies to fix Linux related bug with command line

Game Data Editing

• fix: added reload/restart notification for datasource
• fix: fix Schema.Id, SchemaProperty.Id size values
• fix: fix local referencing within document
• fix: fix various ValidationError path issues
• fix: fixed saving/updating documents with diffs instead of full documents
• fix: fixed system/reserved/invalid name usage in schema/attribute documents #CHAR-50 #CHAR-54
• fix: fixed value clean on attribute removal #CHAR-53
• fix: fixed multi-picklist formatting for pick values intersection
• fix: fixed sorting issuees with Document/Reference/Formula/LocalizedText (#CHAR-101)
• fix: Validation/Repair now check and convert formulas from legacy format to modern one
• fix: add pick list names/values validation on save (#CHAR-111)
• fix: adding attribute with same name silently succeed (#CHAR-80)
• fix: error using numeric values where PickList value is expected (#CHAR-106)
• fix: fixed display name rendering in case of numeric values in name
• fix: number parsing restrictions, including overflow and thousands separators (#CHAR-107)
• fix: added new level of Requirement - NotEmpty for collections and texts.
• fix: changed back behavior of collections to be not-null by default.
• fix: bulk operations fix in metadata changes (prevent secondary metadata changes)
• fix: refactored Flag types to signed integers instead of unsigned
• fix: migration - changed all text Id properties to NotEmpty
• fix: fixed allowing empty values for Schema.Name and SchemaAttribute.Name #CHAR-125
• fix: renamed UniqueInContrainer to UniqueInCollection
• fix: setting default value for existing document when Requirement changed #CHAR-51
• fix: fixed null-ing field on Schema update
• fix: disabled deleting Schema/SchemaProperty/ProjectSettings via bulk operations
• fix: fix bulk update marking unchanged documents as changed
• fix: migration/metadata change cause enum values leak into documents
• fix: fixed sizes and invalid Id properties during migration
• fix: fixed xliff version.1 output format to conform standard
• fix: fixed sorting to be non case-sensitive #CHAR-137
• fix: added mandatory number precision trimming for Number data type
• fix: renamed Unique to GloballyUnique #CHAR-158
• fix: updated limits for schema/attribute properties #CHAR-157
• fix: fixed date time conversion TZ issue #CHAR-168
• fix: fixed Schema creation and editing validation
• fix: fixed error due invalid Size for data type #CHAR-162
• fix: replaced AuthorizationError for read-only data source with custom error.

Code Generation

• fix: fixed generated localized text class not falling back to primary language if translation is empty #CHAR-8 chore: removed ability to publish or backup in BSON and XML formats.
• fix(gen): renamed .t4 files to .ttinclude

Command Line

• fix: removed DATA DELETE input parameter, set DATA VALIDATE exit code to 1 in case of error

‍

‍