Paradox Language Support

概述

中文文档 | English Documentation

GitHub | Reference Documentation | Plugin Marketplace Page | Discord | QQ群：653824651

用于编写群星模组（也支持其他P社游戏）的Intellij IDEA插件，智能、便捷且更具潜力。

特性：

• 支持脚本语言与本地化语言，以及规则文件所使用的CWT语言。
• 为脚本语言与本地化语言提供诸多较为完备的语言功能，包括代码高亮、代码导航、代码补全、代码检查、代码重构、快速文档、内嵌提示、动态模版、代码层级、图表、差异比较等。
• 为CWT语言提供基础的语言功能，包括代码高亮、代码导航、快速文档等。
• 支持通过快速文档与内嵌提示等方式，渲染作用域上下文、本地化文本、DDS图片以及其他有用的信息。
• 支持脚本语言与本地化语言的多数高级特性（例如参数、作用域、内联脚本和各种复杂表达式）。
• 支持自定义扩展的规则文件，从而允许插件提供更加完善的语言功能（例如代码导航、代码补全、快速文档和内嵌提示）。
• 自动识别游戏目录和模组目录。

此插件基于由CWT规则文件组成的规则分组，实现了诸多语言功能。 插件已经内置了最新版本的规则文件，以便开箱即用。 除此之外，插件也支持自定义与导入本地的规则文件。

如果同时安装了 Translation ，此插件可以提供一些额外的功能。

快速开始

使用：

• 通过IDE打开你的模组根目录。（需要直接包含模组描述符文件descriptor.mod）
• 打开模组描述符文件，点击位于编辑器右上角的悬浮工具栏中的模组配置按钮。
• 配置模组的游戏类型、游戏目录以及额外的模组依赖。
• 点击确定按钮完成配置，然后等待IDE索引完成。
• 开始你的模组编程之旅吧！

提示：

• 如果需要进行全局搜索，请参考以下方式：
  • 点击Ctrl Shift R或者Ctrl Shift F在当前项目、目录或者指定作用域中搜索。
  • 点击Shift Shift查找文件、定义、封装变量以及其他各种符号。
• 如果需要进行代码导航，请参考以下方式：
  • 按住Ctrl并点击目标位置，从而导航到目标的声明或使用处。
  • 按住Ctrl Shift并点击目标位置，从而导航到目标的类型声明处。
  • 按住Alt并点击目标位置，从而导航到目标对应的CWT规则的声明处。
  • 按住Shift Alt并点击目标位置，从而导航到目标定义的相关本地化的声明处。
  • 按住Ctrl Shift Alt并点击目标位置，从而导航到目标定义的相关图片的声明处。
  • 点击Navigate或者编辑器右键菜单中的Go To，选择要导航到的目标。
  • 点击Navigate > Definition Hierarchy，打开定义层级窗口，从而查看某一类型的定义的实现关系。
  • 点击Navigate > Call Hierarchy，打开调用层级窗口，从而查看定义、本地化、封装变量等的调用关系。
  • 点击Alt 1或者Project工具窗口，打开项目视图面板，然后点击左上角的Project > Paradox Files，从而查看汇总后的游戏与模组文件。
  • 点击Alt 1或者Project工具窗口，打开项目视图面板，然后点击左上角的Project > CWT Config Files，从而查看汇总后的CWT规则文件。
• 如果需要进行全局代码检查，请参考以下方式：
  • 点击Alt 6或者Problems工具窗口，打开问题面板，然后查看当前文件存在的问题，或者进行整个项目的全局代码检查。
  • 点击Code > Inspect Code...，进行整个项目的全局代码检查。
  • 完成代码检查后，IDE将会在问题面板中显示详细的检查结果。
• 如果需要更改模组类型、游戏目录、模组依赖等设置，请通过以下方式之一打开模组设置对话框：
  • 点击Settings > Languages & Frameworks > Paradox Language Support，可配置默认的游戏目录。
  • 点击位于页面右上方的编辑器悬浮工具栏中的蓝色齿轮图标。
  • 在编辑器中打开右键菜单，点击Paradox Language Support > Open Mod Settings...。
  • 点击Tools > Paradox Language Support > Open Mod Settings...。
• 如果需要更改插件的全局设置，请参考以下方式：
  • 点击Settings > Languages & Frameworks > Paradox Language Support，打开插件的设置页面。
• 如果在使用过程中遇到意外问题，请尝试通过以下方式解决：
  • 更新IDE和插件到最新版本。
  • 如果可能与IDE索引有关，请尝试重建索引并重启IDE。（点击File -> Invalidate Caches... -> Invalidate and Restart）
  • 如果可能与插件内置的规则有关，请尝试编写自定义的规则文件。
  • 如果可能与插件的配置有关，请尝试删除插件的配置文件。（paradox-language-support.xml，如果不知道具体位置，请使用Everything）
  • 通过GitHub、Discord等渠道进行反馈。

已知问题：

• 对Stellaris的某些黑魔法般的语言特性的支持尚不完善。
• 对Stellaris以外的游戏的支持尚不完善。

参考

参考手册：

• Kotlin Docs | Kotlin Documentation
• IntelliJ Platform SDK | IntelliJ Platform Plugin SDK

插件：

• YiiGuxing/TranslationPlugin

工具：

• cwtools/cwtools
• cwtools/cwtools-vscode
• bcssov/IronyModManager
• amtep/ck3-tiger
• OldEnt/stellaris-triggers-modifiers-effects-list

Wikis：

• Stellaris Wiki
• 群星中文维基 | Stellaris 攻略资料指南 - 灰机wiki

贡献

你可以通过下面这些方式支持与赞助这个项目：

• 在GitHub上收藏此项目
• 提交反馈（通过Discord与QQ群，或者直接在GitHub上提交Issue）
• 提交PR（向插件仓库即此项目，或是各个规则仓库）
• 向朋友或者在相关社区中推荐这个插件
• 如果你喜欢这个插件，也可以考虑通过爱发电提供赞助

另外，如果你有意愿提交PR，而就插件代码与规则文件有任何问题的话，欢迎通过邮件与Discord等方式询问。