Dagor 2 Fixing Illegal Characters Tool

Installation

Install the script following the provided instructions.

Important

This script requires 3ds Max 2013 or newer version to run.

Accessing the Fixing Illegal Characters Tool

  1. Navigate to Gaijin Tools 1 > Fix Illegal Characters…. This will open the main window of the Dagor 2 Fix Illegal Characters script.

  2. To verify the version of the script, go to Gaijin Tools 1 > About 2. The About window will display the current version. It’s important to check this regularly to ensure your script is up to date.

    Fixing Illegal Characters Tool

Note

Make sure that the plugin version is at least 1.4.

Using the Fixing Illegal Characters Tool

To begin, run the script from the Gaijin Tools 1 > Fix Illegal Characters… menu. The following window will appear:

Fixing Illegal Characters Tool

Tool Options

  • Illegal Characters List 2: enter or delete illegal characters in this field.

  • Replace with Characters 3: specifies characters to replace the illegal ones. If left blank, illegal characters will be removed. This option supports UTF-8, including hieroglyphs, Slavic languages, and Arabic characters, etc.

  • Latinization of the Russian 4: converts all Russian characters to Latin according to standard Latinization rules. If unchecked, Russian characters will be replaced with the characters specified in the Replace with Characters 3 field.

  • Log Warning Bitmap Path Name 5: logs warnings for file paths containing illegal characters to the log window 17.

    Note

    No substitutions are made; this only outputs warnings.

  • Log Warning Texture Maps Names 6: logs warnings for texture names containing illegal characters to the log window 17.

    Note

    No substitutions are made; this only outputs warnings.

  • Fix Layers Names 7: replaces illegal characters in layer names with the specified replacement characters.

    Note

    Layer 0 (default) cannot be renamed.

    There cannot be layers with the same name. If naming conflicts occur or renaming fails, a warning is displayed in the log window 17:

    Fixing Illegal Characters Tool

  • Fix Objects Names 8: replaces illegal characters in object names with the specified replacement characters. For check naming it’s necessary to select objects.

    Note

    This may result in objects having identical names.

  • Fix Materials Names 9: replaces illegal characters in material names with the specified replacement characters.

    Note

    This may result in materials having identical names.

  • All Changes to Lower Case 10: converts all names to lower case and performs checks in lower case.

  • DAG Export After Fixing Illegal Characters 11: opens the .dag format export window after all checks are complete.

    Note

    Ensure you are familiar with how Dagor 2 plugins work before enabling this option.

  • Save Current Settings 12: saves the current settings.

  • Load Default Settings 13: loads the default settings.

  • FIX ILLEGAL CHARACTERS FROM SELECTION 14: executes the script to fix illegal characters in the selected objects.

  • Visit to Learning Website 15: links to this documentation.

  • Get in Touch with the Author 16: provides contact information for the developer if assistance is needed.

  • Errors Log 17: displays information about the results of the checks and any changes made.

If the scene contains no errors, you will see a window like this:

Fixing Illegal Characters Tool

Any errors will be highlighted in red and labeled as ERROR! or WARNING!:

Fixing Illegal Characters Tool

A scene containing multiple errors may produce results like this:

Fixing Illegal Characters Tool