Troubleshooting

1. Type MNVERSION in AutoCAD and note what it prints.
2. Read the whole message on the command line. Most messages say what was not changed and what to do next.
3. If a message ends with Details: and a file path, that file explains what happened. Keep it for us.

Windows will not run Install.cmd

Windows is cautious with files that came from the internet or email and are not signed.

1. If you see Windows protected your PC, choose More info, then Run anyway.
2. If nothing happens, right-click the Setup zip, choose Properties, tick Unblock, choose OK, then extract it again and run Install.cmd from the new folder.
3. If your company blocks scripts altogether, ask IT to run Install.cmd for you once. It installs for the signed-in Windows user and needs no administrator rights.

“AutoCAD is running. Close every AutoCAD window”

The plug-in files cannot be replaced while AutoCAD has them open. Nothing was changed.

1. Save your work and close every AutoCAD window.
2. If the message stays, open Task Manager and end any remaining acad.exe (only after saving).
3. Run Install.cmd again.

“SHA-256 verification failed” or “The Setup package is missing …”

The package was damaged or incomplete when it was copied or downloaded. The installer refused it, and nothing was installed.

1. Delete the extracted folder and the zip.
2. Copy or download the Setup zip again, extract it, and run Install.cmd.
3. Never edit, rename or remove files inside the Setup folder.

“… has no release.json; it is not a Setup package”

The installer was started from inside the zip, or from a folder that is not the extracted Setup package.

1. Right-click the Setup zip and choose Extract All.
2. Open the extracted folder and double-click Install.cmd there.

“CMNUpdater was not installed” warning

The plug-in is installed and works. Only automatic updates are affected.

1. Run Install.cmd again from the same Setup folder.
2. If the warning repeats, send us the whole installer window text (see “What to send us”).

“Save your work and close AutoCAD before installing.”

The Manager will not replace plug-in files while AutoCAD has them open. Nothing was changed.

1. Save your work and close every AutoCAD window.
2. If the message stays, open Task Manager and end any remaining acad.exe (only after saving).
3. Click Install bundled version again.

“Bundled package checksum mismatch” or “Unexpected path in the setup package”

The EXE was damaged or altered when it was copied or downloaded. Nothing was installed.

1. Delete that CMNSetup.exe.
2. Get a fresh copy and run it again. Do not rename or edit it.

“This developer build has no installer payload”

This EXE was built without a package inside, so it cannot install. Updates and glossary tools still work.

1. Ask us for the packaged Setup EXE.

“GitHub update check/download failed”

There is no internet, the network blocks GitHub, the release repository is private and no read-only token is set up on this PC, or GitHub is limiting requests (HTTP 403). The installed version was not changed.

1. Check the network or VPN connection, then click Check for updates again.
2. On HTTP 403, wait an hour and try again.
3. If your updates come from a network share, click Choose update source… and pick the release.json IT gave you.
4. For a private repository, ask IT to set up the read-only token. Signing in to GitHub in a browser does not count.
5. Install bundled version needs no internet and still works.

“… is staged and installs after AutoCAD closes” or “Installation is pending”

The update is downloaded and checked. It waits because AutoCAD has the plug-in files open.

1. Save your work and close every AutoCAD window.
2. Open the Manager and click Finish pending install.
3. Start AutoCAD and type MNVERSION to confirm the new version.

“The separate command-line updater could not be replaced”

The plug-in is installed and works. Only the updater behind MNUPDATE and MNROLLBACK stayed on its older copy, usually because it was busy finishing an update.

1. Wait a minute, close the Manager, and run CMNSetup.exe again.
2. If the message mentions file permissions, contact us with a screenshot of the Manager window.

“An unrelated desktop shortcut already uses the name CMN Translator Manager”

Another shortcut on the desktop has the same name, and the Manager will not overwrite it.

1. Rename or delete that shortcut.
2. Click Create desktop shortcut.

“The glossary contains lost characters (?? or replacement symbols)”

The file was saved in a format that cannot hold Cyrillic or Chinese. Nothing was imported.

1. Open the original workbook, not the damaged file.
2. Save it as XLSX, or with File → Save As → CSV UTF-8 (Comma delimited).
3. Click Import glossary… again.

“No glossary rows found” or “This is already your active company glossary”

The first message means the file has no mongolian column, or no chinese or english column. The second means you picked the company glossary itself. Nothing was imported in either case.

1. Check the column headings in the file you want to add, then import again.
2. Pick the project term list you want to add, not the active company glossary.

The import reports “Conflicts not imported”

Those rows give a different Mongolian word for a term the company glossary has already approved. They were left out; everything else was imported, after a backup.

1. Read the listed rows and decide, row by row, which word is correct.
2. If the new word is correct, ask the glossary owner to change the company row, then import again.

Export fails: “No company glossary exists yet” or the file already exists

There is nothing to export until a glossary has been imported or merged; and an export never overwrites a file.

1. For the first message, import a glossary first.
2. Otherwise, export again with a new file name.

“Please wait for the current operation to finish.”

A download, install or import is still running, and stopping it halfway is not allowed.

1. Wait until the result appears in the window, then close it.

“Unknown command” for MNTRANSLATE, MNVERSION or any MN command

The plug-in did not load: the security prompt was answered with Do Not Load, AutoCAD was already open during installation, or the installation did not finish.

1. Close AutoCAD completely and start it again. When the security prompt appears, choose Always Load.
2. Type MNVERSION. If it works, you are done.
3. If there is no prompt and the command is still unknown, open the CMN Translator Manager and click Install bundled version (or run Install.cmd again), then restart AutoCAD.
4. Your AutoCAD must be version 2023 or newer.

I chose Do Not Load by mistake

AutoCAD only remembers the choice for this session.

1. Close AutoCAD and start it again. The prompt comes back; choose Always Load.

“The drawing has unsaved changes. Save it first”

The tool reads the saved file from disk, so unsaved edits would be missed.

1. Save the drawing (QSAVE) and run the command again.

“Save the drawing to a file first”

A new drawing that has never been saved has no file for the tool to read.

1. Use SAVEAS to save it in a project folder, then run the command again.

“Cannot start translation; … is already running”

Only one translation, review or merge runs on a drawing at a time.

1. Type MNSTATUS to see what is running and how far it has got.
2. Wait for it, or type MNCANCEL to stop it safely. A cancelled job changes no drawing.

Translation takes very long, or says it timed out

Very large drawings, or AI commands waiting on the provider. A timed-out run changes no drawing.

1. Type MNSTATUS to check it is still moving.
2. For a very large drawing, translate part of it first with MNTRANSLATESEL.
3. If it times out repeatedly, contact us with the drawing name and the log file.

Codes such as \f宋体|b0|i0|c204|p7; appear inside the Mongolian text

Older versions sometimes wrote a font code into the text itself instead of hiding it. Current versions do not.

1. Type MNVERSION. If a newer version is available, run MNUPDATE and close AutoCAD so it installs.
2. Open the original drawing and run MNTRANSLATE again. This creates a clean new _MN copy.
3. Do not try to fix the codes by hand in the old copy.

Mongolian shows as ???, boxes or wrong letters

The text uses a Chinese font (often an SHX font) that has no Cyrillic letters.

1. Open the translated _MN copy and type MNFORMAT, then choose All.
2. Text moves to layer CMN_MONGOLIAN_TEXT and style CMN_MONGOLIAN (Arial) without moving or resizing.
3. If letters are still wrong, check that the Arial font is installed in Windows.

Mongolian text is too long and runs over lines or borders

Mongolian is usually longer than the Chinese it replaces. Nothing measures the space for you.

1. Run MNREVIEW; it lists text that may be too long for its space.
2. Shorten the wording in the _MN copy, or adjust the width of that text object.
3. If a standard term is always too long, ask for a shorter approved form in the glossary.

A word is translated wrongly on every drawing

The wrong translation is approved in a glossary, so it is applied everywhere.

1. Tell the glossary owner which Chinese term, the wrong Mongolian and the correct Mongolian.
2. The fix is made once, in the company glossary. A company word always wins over the base glossary.
3. Then open the original drawing and run MNTRANSLATE again.

A term is in the glossary but is not used

Only rows with status approved are used. Rows marked needs_review or needs_chinese are waiting for a person, and a spaced label such as 图 号 must match exactly.

1. Type MNGLOSSARYSTATUS to see which glossary file is in use.
2. Ask the glossary owner to check the row's status and spacing, and to approve it if it is correct.

Chinese text is left in the translated copy

Neither glossary knows that text, and it was not filled in the worksheet.

1. Open <drawing>-to-translate.csv, fill the Mongolian column, save as CSV.
2. Type MNMERGE and pick the CSV, then MNTRANSLATE again.
3. Or use MNTRANSLATEAI for AI drafts, where your project allows it.

No output files appear, or “access denied”

The drawing's folder is read-only (often a network share), or a previous CSV is still open in Excel.

1. Close the CSV in Excel and run the command again.
2. If the drawing is on a share you cannot write to, copy it to a local project folder and translate the copy.

MNMERGE refuses the CSV

A column was deleted, renamed or moved, or the file was saved as an Excel workbook.

1. Keep every column exactly as it came. Fill only Mongolian (FILL IN) and Approved? (y).
2. Save with File → Save As → CSV UTF-8 (Comma delimited).
3. If the file is damaged, run MNTRANSLATE again to get a fresh worksheet and copy your answers across.

Mongolian letters turn into ? or strange symbols after saving in Excel

The CSV was saved in a format that cannot hold Cyrillic.

1. Save again with CSV UTF-8 (Comma delimited), not plain CSV (Comma delimited).

“The file is being used by another process” during merge or import

The company glossary is open in Excel, which locks it.

1. Close the glossary in Excel, then run the command again.

Wrong words were merged, and I want to undo it

Every change to the company glossary is preceded by a backup; the last 50 are kept.

1. Close AutoCAD.
2. Contact us with the drawing name and the approximate time of the merge. We restore the right backup for you.
3. Until then, do not merge or import anything else, and do not try to replace program files yourself.

MNGLOSSARYIMPORT reports conflicts

The workbook gives a different Mongolian word for a term the company glossary has already approved. Those rows were not imported; everything else was.

1. Read the listed rows. Decide per row which word is correct.
2. If the new word is correct, ask the glossary owner to change the company row, then import again.

The base glossary changed and translations got worse

A newer base glossary was installed with MNGLOSSARYUPDATE.

1. Type MNGLOSSARYROLLBACK to return to the previous base glossary. The company glossary is not affected.
2. Tell us which terms changed, so the next base release can be corrected.

“The AI was asked for but is unavailable”

No AI provider is configured on this computer, there is no internet, or the network blocks the provider.

1. MNTRANSLATE still works fully offline; use it and fill the worksheet by hand.
2. Ask us to configure the AI provider on this computer if your project allows sending text to it.

“429 … slow down” or a batch failed

The provider limits how fast it accepts requests. Batches that already succeeded are kept.

1. Wait a few minutes and run the same command again. Only what is still missing is sent.

MNVERSION says “Updater: not installed”

This computer was installed before the updater existed, or the updater step failed.

1. Close AutoCAD and run Install.cmd from the latest Setup package. Glossaries and settings are kept.

MNUPDATE says “Unable to check for updates”

The release location could not be reached: no internet, the file share is unavailable, or access was refused. The current installation has not been changed.

1. Check the network or VPN connection and try again later.
2. If it keeps failing, install the latest Setup package with Install.cmd and tell us the message shown.

“Installation is pending. Close AutoCAD to complete the update”

The update is downloaded and verified. It waits for AutoCAD to close, because files in use cannot be replaced.

1. Save your work and close every AutoCAD window. The update installs within a few seconds.
2. Start AutoCAD and type MNVERSION to confirm the new version.
3. If MNVERSION still shows Pending, close AutoCAD, open the CMN Translator Manager and click Finish pending install.

A new version misbehaves

The last three versions are kept for exactly this.

1. Type MNROLLBACK, choose the previous version, and close AutoCAD. It installs as soon as AutoCAD closes.
2. Tell us what went wrong, so it can be fixed in the next release.

Where is the downloaded update?

Updates are kept where you can find them.

1. Open Downloads\CmnCadTranslator\Updates, or type MNHELP and choose Folder. The last three packages are kept.

Nothing works any more

Reinstalling is safe: it keeps glossaries, settings and drawings.

1. Close AutoCAD.
2. Run Install.cmd from the latest Setup package.
3. Start AutoCAD, choose Always Load if asked, and type MNVERSION.
4. If that does not help, contact us (see below).

1. The text MNVERSION prints (a screenshot is fine).
2. The command you ran and the drawing name.
3. A screenshot of the message or the problem on the sheet.
4. The Details: log file, and for updates a screenshot of the CMN Translator Manager window.
5. Do not send the drawing itself unless we ask for it and your project allows it.

• Your original drawing is never modified. Translations are written to a separate _MN copy.
• The company glossary is backed up before every change and is never replaced by an update.
• An update never opens or changes a drawing, and a failed update leaves the previous version working.
• Reinstalling with Install.cmd keeps glossaries, settings and drawings.
• A glossary import in the Manager is preceded by a backup and never replaces approved wording.