Paradox Language Support（PLS）是专为 Paradox 游戏模组开发者设计的 IntelliJ IDEA 插件，提供智能、高效且功能全面的开发体验，助你轻松实现创意。
核心特性：
- 多语言支持：完整支持模组开发所需的脚本语言、本地化语言与 CSV 语言，以及用于编写规则的 CWT 语言。
- 丰富的语言功能：提供代码高亮、代码导航、代码补全、代码检查、代码重构、快速文档、内嵌提示、动态模板、代码层级、图表和差异比较等多项功能。
- 图像处理：支持预览与渲染 DDS 和 TGA 图片，并可在不同图片格式（PNG、DDS、TAG）之间互相转换。
- 信息增强提示：通过快速文档和内嵌提示，直观展示本地化文本、图片、作用域和参数等关键信息。
- 高级语言特性支持：兼容脚本与本地化语言中的多种高级特性，包括参数、作用域、内联脚本及复杂表达式。
- 可扩展的规则系统：支持自定义和导入规则文件，强化代码导航、代码补全、文档提示等功能。
- 工具集成：集成 Image Magick、Translation Plugin、Tiger 等实用工具，提升开发效率。
- AI 辅助：初步集成 AI 技术，可用于本地化文本的翻译与润色。
- 目录检测：自动检测游戏目录与模组目录，减少手动配置。
PLS 基于自身的规则系统实现核心语言功能。其所使用的 CWT 规则文件与 CWTools 遵循一致的语法与格式，并进行了一定的改进与扩展。插件内置最新版本规则，开箱即用，同时也支持自定义与导入规则文件，满足个性化开发需求。
使用步骤：
- 在 IDE 中打开你的模组根目录。
- 打开模组描述符文件（
descriptor.mod，VIC3 中为.metadata/metadata.json）。 - 点击编辑器右上角的悬浮工具栏中的 模组配置 按钮。
- 配置模组的游戏类型、游戏目录及所需的模组依赖。
- 确认配置，等待 IDE 完成索引。
- 开始你的模组开发之旅吧！
实用技巧：
- 全局搜索：
- 使用
Ctrl + Shift + R或Ctrl + Shift + F在当前项目、目录或指定查询作用域中搜索。 - 使用
Shift + Shift快速查找文件、定义、封装变量及其他符号。
- 使用
- 代码导航：
- 使用
Ctrl + 点击跳转到目标的声明或使用位置。 - 使用
Ctrl + Shift + 点击跳转到目标的类型声明。 - 使用
Alt + 点击跳转到目标的相关规则的声明。 - 使用
Shift + Alt + 点击跳转到目标相关本地化的声明。 - 使用
Ctrl + Shift + Alt + 点击跳转到目标的相关图片的声明。 - 通过
Navigate菜单（或者编辑器右键菜单中的Go To选项）快速定位。 - 使用
Navigate > Definition Hierarchy打开定义的类型层级窗口，从而查看特定类型的定义。 - 使用
Navigate > Call Hierarchy打开定义的调用层级窗口，从而查看定义、本地化、封装变量等的调用关系。 - 在项目面板中选择
Paradox Files视图，浏览汇总后的游戏与模组文件。 - 在项目面板中选择
CWT Config Files视图，浏览汇总后的规则文件。
- 使用
- 代码检查：
- 在问题面板中查看当前文件的问题。
- 使用
Code > Inspect Code…执行全局代码检查，并在问题面板中查看详细报告。
- 设置修改：
- 可通过以下方式打开插件的全局设置页面：
- 点击设置页面中的
Languages & Frameworks > Paradox Language Support。
- 点击设置页面中的
- 可通过以下方式打开模组设置对话框：
- 点击编辑器右上角的悬浮工具栏中的蓝色齿轮图标。
- 点击编辑器右键菜单中的
Paradox Language Support > Open Mod Settings...。 - 点击主菜单中的
Tools > Paradox Language Support > Open Mod Settings...。
- 可在全局设置中修改偏好语言环境、默认游戏类型、默认游戏目录等配置，以及其他功能细节。
- 可在模组设置中调整游戏目录、模组依赖等配置。
- 可通过以下方式打开插件的全局设置页面：
- 问题排查：
- 确保 IDE 和插件均为最新版本。
- 如果问题可能与索引有关，可尝试清除缓存并重启 IDE。
- 如果问题可能与规则有关，可尝试编写自定义的规则文件。
- 如果问题可能与插件配置有关，可尝试删除插件的配置文件（
paradox-language-support.xml，推荐使用 Everything 搜索定位）。 - 欢迎通过 GitHub、Discord 等渠道反馈问题。
已知限制：
- 对 Stellaris 中的部分复杂语言特性的支持仍在完善中。
- 对非 Stellaris 游戏中的特有语言特性的支持尚不完整，欢迎反馈与贡献。
- 目前仅为 Stellaris 和 Victoria 3 提供了较为完善的内置规则文件，欢迎提交 Pull Request。
- 基于 IntelliJ Platform SDK 构建，采用 Kotlin 开发，基于 PSI（而非 LSP）实现深度的语言解析与操作。
- 使用 BNF 进行语法解析，JFlex 进行词法分析。
- 通过扩展点机制实现功能的动态扩展，便于插件自身及模组开发者定制与增强插件行为。
- 内置自定义的代码注入器，用于实现常规手段无法达成的 IDE 功能。
- 内置与图片处理、翻译和检查工具的集成，以优化和扩展插件能力。
- 初步集成 AI 技术，为本地化文本提供翻译和润色支持。
官方文档：
- Kotlin Docs | Kotlin Documentation
- Getting started | IntelliJ IDEA Documentation
- IntelliJ Platform SDK | IntelliJ Platform Plugin SDK
- LangChain4j | LangChain4j
工具与插件：
- YiiGuxing/TranslationPlugin: Translation plugin for IntelliJ-based IDEs/Android Studio.
- cwtools/cwtools: A library for parsing, editing, and validating Paradox Interactive script files.
- cwtools/cwtools-vscode: A VS Code extension providing language server support for paradox script files using cwtools
- bcssov/IronyModManager: Mod Manager for Paradox Games. Official Discord: https://discord.gg/t9JmY8KFrV
- amtep/tiger: Checks game mod files for common mistakes and warns about them. Supports Crusader Kings 3, Victoria 3, and Imperator: Rome.
- OldEnt/stellaris-triggers-modifiers-effects-list: List of Stellaris triggers, modifiers and effects for most game versions since launch.
游戏 Wiki：
我们欢迎任何形式的支持与贡献，包括但不限于：
- ⭐ 在 GitHub 上收藏项目。
- 🐛 提交问题反馈（通过 Discord、群聊 或 GitHub Issues）。
- 🔧 提交代码或规则文件 Pull Request（可提交至插件仓库（即此项目）或各规则仓库提交）。
- 📢 向朋友或社区推荐本插件。
- 💝 通过爱发电赞助项目。
如果你对提交 PR 感兴趣，但对插件开发或规则编写有任何疑问，欢迎通过邮件或 Discord 进行联系！