Troubleshooting problems when working with MPS

This chapter summarizes known problems and possible remedies for users working with MPS. If your issue is not listed here, please open a new issue on GitHub.

Symptom: exception “Wrong dependency type: class com.intellij.openapi.util.Key” while editing a document

This problem doesn’t appear in MPS 2020.3 anymore (at the time of writing it is available as EAP version). Please upgrade your IDE.

This is a known problem with MPS: MPS-30801.

No workaround is available as of today. See asciidoctor-intellij-plugin#502 for more details and a discussion.

Symptom: PluginException at IDE startup mentioning “RefactoringMenu”

This problem doesn’t appear in MPS 2020.2.2 anymore. It is no longer necessary to install the “AsciiDoc MPS add-on”.

This problem was first observed on MPS 2019.3.4. The assumed cause for this is MPS removing menu items compared to IntelliJ core. This leads to the exception at startup time. The rest of the plugin’s functionality is unaffected.

To work around the exception install an AsciiDoc MPS add-on in addition to the regular AsciiDoc plugin.

Follow these steps:

  1. Download the “AsciiDoc MPS add-on”: asciidoctor-intellij-plugin-mps.jar

  2. Go to File  Settings…​  Plugins  Gear Icon ()

  3. Choose Install plugin from disk…​

  4. Choose the downloaded file in the file selection dialogue

  5. Restart the IDE

You can read more about this in the related GitHub issue asciidoctor-intellij-plugin#502.