跳至主要內容

介绍

DragonKnightOfBreeze2026/7/23约 2079 字大约 7 分钟

介绍

GitHub | Plugin Home | Discord | 群聊 | By me a coffee ☕

概述

Paradox Chronicle（曾用名：Paradox Language Support）是为 Paradox Interactive 游戏模组开发者设计的 IntelliJ IDEA 插件，提供智能、高效且功能丰富的开发体验，助力轻松实现创意。

插件会自动检测游戏目录和模组目录，分析其中的文件以构建缓存与索引。 完成必要的配置工作（如游戏类型、游戏目录、模组依赖）以及项目分析（扫描文件、构建索引）后，即可启用并体验完整语言功能。

插件基于自身的规则系统实现核心语言功能。 其使用的 CWT 规则文件与 CWTools 遵循基本一致的语法与格式，并进行了一定的改进与扩展。 插件内置最新版本的规则，开箱即用，同时也支持自定义与导入规则文件，满足个性化开发需求。

核心特性：

  • 多语言支持：支持用于开发模组的脚本语言、本地化语言和 CSV 语言，以及用于编写规则的 CWT 语言。
  • 高级语言构造支持：支持参数、作用域、复杂表达式、内联脚本和定义注入等多种高级语言构造。
  • 丰富的语言功能：支持代码高亮、代码导航、代码补全、代码重构、意向动作、代码检查、快速文档、内嵌提示、装订线图标、代码层级、差异比较和图表等多种语言功能。
  • 灵活的代码导航：通过导航动作、快速文档、内嵌提示、装订线图标、代码层级、随处搜索等方式，快速导航到各种目标位置，包括文件、定义、本地化、相关本地化、相关图片、相关规则等。
  • 增强的信息提示：通过快速文档、内嵌提示、装订线图标等方式，直观显示各类关键信息，包括本地化文本、图片、作用域和参数等。
  • 可扩展的规则系统：支持自定义和导入规则文件，从而改进和强化高亮、导航、补全、检查、信息提示等功能。
  • 图像处理：支持预览和渲染 DDS 和 TGA 图片，并可在不同图片格式（PNG、DDS、TGA）之间互相转换。
  • 工具集成：集成 Image Magick、Translation Plugin、Tiger 等实用工具，提升开发效率。
  • AI 辅助：初步集成 AI 技术，适用于本地化文本的翻译和润色。

技术信息

技术细节

  • 主要采用 Kotlin 编程语言开发。
  • 基于 IntelliJ Platform SDK 构建，基于 PSI（而非 LSP）实现深度的语义分析与丰富的语言功能。
  • 使用 JFlex 进行词法分析，使用 BNF 进行语法分析。
  • 内置丰富的自定义扩展点，提供功能的灵活扩展，便于定制与增强插件行为。
  • 内置代码注入系统，用于实现常规手段无法达成的功能、修复与优化。
  • 内置图像处理模块（DDS、TGA），用于预览、渲染和处理额外的图片格式。
  • 内置工具集成模块（图片处理、翻译、检查工具），用于优化和扩展插件能力。
  • 内置 AI 集成模块（初步，MVP 状态），用于翻译和润色本地化文本。

已知限制

  • 插件是为 IntelliJ IDEA（以及其他 JetBrains IDE，例如 PyCharm）准备的，不适用于 VSCode 或其他文本编辑器，也没有相关的开发计划。
  • 插件对脚本文件和本地化文件的部分复杂的高级语言构造的支持尚不完善，仍在持续完善中。
  • 例如，插件目前暂不支持 Stellaris 中在内联脚本中声明的定义，以及 Jomini 中复杂的本地化命令。
  • 插件的核心语言功能（如代码补全、代码检查和快速文档）的质量很大程度上取决于规则文件的完整性和时效性，不完整或过失的规则可能会导致功能的缺失和误报。
  • 目前，Stellaris、Victoria 3、Europa Universalis V 和 Hearts of Iron IV 的规则正在积极维护中，而其他游戏的规则可能相当不完整或已过时。
  • 关于规则文件的详细维护情况，可参见 CONTRIBUTORS.md。

贡献与支持

我们欢迎各种形式的贡献与支持，包括但不限于：

  • 向朋友或社区推荐此插件。
  • 在 GitHub 上收藏此项目。
  • 通过[爱发电][url:afdian] 赞助此项目。
  • 提交问题反馈（通过 [GitHub Issues][url:issues]、[Discord][url:discord]、[群聊][url:qq-group] 或 [邮件][mailto]）。
  • 提交 Pull Request（提交至[插件仓库][url:github]（即此项目），或者各个规则仓库）。

关于具体的贡献指南，请参见 CONTRIBUTING.md。

关于具体的贡献者名单，请参见 CONTRIBUTORS.md。

贡献代码

鉴于插件同时拥有相当庞大的代码规模与相当高的复杂度，贡献核心代码是非常有挑战性的。 尽管如此，通过参考已有的文档、代码、配置文件和规则文件，AI 协助以及自行探索，考虑与实践部分代码上的贡献仍然是可能的。

例如，通过浏览参考文档和配置文件（如 plugin.xml 以及其中引入的 XML 配置文件），结合关键词搜索，你可以尝试新增与完善各种语言功能，或是增强插件的能力和兼容性。

贡献规则文件

鉴于插件的规则驱动架构，贡献规则文件是改善特定游戏支持的最有效方式之一。 规则文件定义了驱动代码补全、代码检查和文档提示的语义信息（定义、修正、作用域、效果、触发器等），保持其更新将直接改善该游戏所有用户的使用体验。

作为参考，请阅读规则系统的文档、语法的参考手册和规则格式的参考手册。

贡献文档

项目的文档主要分为普通文档（如 README.md）、维护者文档（位于 documents 目录中）和参考文档（位于 docs 目录中）。 这些文档中难免存在错误和不足之处、遗漏的细节以及待补充的内容，欢迎贡献以改善文档质量，尤其是项目的参考文档。

参考链接

官方文档

插件开发

工具与插件

图像处理

社区 & 模组资源

教程 & 百科