feat: allow configurable addons path for non-VSCode editors

Author: IronBlood

changelog.md

@@ -3,6 +3,7 @@
 ## Unreleased
 <!-- Add all new changes here. They will be moved under a version at release -->
 * `FIX` cannot debug in Linux due to lua-debug expecting host process to have lua54 symbols available
+* `NEW` support custom addons path for enhanced editor flexibility
 
 ## 3.14.0
 `2025-4-7`

doc/en-us/config.md

@@ -14,6 +14,16 @@ boolean
 true
 ```
 
+# addonRepositoryPath
+
+Specifies the addon repository path (not related to the addon manager).
+
+## type
+
+```ts
+string
+```
+
 # codeLens.enable
 
 Enable code lens.
@@ -2320,4 +2330,4 @@ Array<string>
 
 ```jsonc
 []
-```
+```

doc/pt-br/config.md

@@ -14,6 +14,16 @@ boolean
 true
 ```
 
+# addonRepositoryPath
+
+Specifies the addon repository path (not related to the addon manager).
+
+## type
+
+```ts
+string
+```
+
 # codeLens.enable
 
 Enable code lens.
@@ -2320,4 +2330,4 @@ Array<string>
 
 ```jsonc
 []
-```
+```

doc/zh-cn/config.md

@@ -14,6 +14,16 @@ boolean
 true
 ```
 
+# addonRepositoryPath
+
+指定插件仓库的路径（与 Addon Manager 无关）。
+
+## type
+
+```ts
+string
+```
+
 # codeLens.enable
 
 启用代码度量。
@@ -2318,4 +2328,4 @@ Array<string>
 
 ```jsonc
 []
-```
+```

doc/zh-tw/config.md

@@ -14,6 +14,16 @@ boolean
 true
 ```
 
+# addonRepositoryPath
+
+Specifies the addon repository path (not related to the addon manager).
+
+## type
+
+```ts
+string
+```
+
 # codeLens.enable
 
 Enable code lens.
@@ -2318,4 +2328,4 @@ Array<string>
 
 ```jsonc
 []
-```
+```

locale/en-us/setting.lua

@@ -6,6 +6,8 @@ config.addonManager.repositoryBranch =
 "Specifies the git branch used by the addon manager."
 config.addonManager.repositoryPath =
 "Specifies the git path used by the addon manager."
+config.addonRepositoryPath        =
+"Specifies the addon repository path (not related to the addon manager)."
 config.runtime.version            =
 "Lua runtime version."
 config.runtime.path               =

locale/es-419/setting.lua

@@ -6,6 +6,8 @@ config.addonManager.repositoryBranch =
 "Especifica la rama de git usada por el manejador de extensiones."
 config.addonManager.repositoryPath =
 "Especifica la ruta git usada por el manejador de extensiones."
+config.addonRepositoryPath        = -- TODO: need translate!
+"Specifies the addon repository path (not related to the addon manager)."
 
 config.runtime.version            =
 "Versión de Lua que se ejecuta."

locale/ja-jp/setting.lua

@@ -6,6 +6,8 @@ config.addonManager.repositoryBranch = -- TODO: need translate!
 "Specifies the git branch used by the addon manager."
 config.addonManager.repositoryPath = -- TODO: need translate!
 "Specifies the git path used by the addon manager."
+config.addonRepositoryPath        = -- TODO: need translate!
+"Specifies the addon repository path (not related to the addon manager)."
 config.runtime.version            = -- TODO: need translate!
 "Lua runtime version."
 config.runtime.path               = -- TODO: need translate!

locale/pt-br/setting.lua

@@ -6,6 +6,8 @@ config.addonManager.repositoryBranch = -- TODO: need translate!
 "Specifies the git branch used by the addon manager."
 config.addonManager.repositoryPath = -- TODO: need translate!
 "Specifies the git path used by the addon manager."
+config.addonRepositoryPath        = -- TODO: need translate!
+"Specifies the addon repository path (not related to the addon manager)."
 config.runtime.version            = -- TODO: need translate!
 "Lua runtime version."
 config.runtime.path               = -- TODO: need translate!

locale/zh-cn/setting.lua

@@ -6,6 +6,8 @@ config.addonManager.repositoryBranch =
 "指定插件管理器(Addon Manager)使用的git仓库分支"
 config.addonManager.repositoryPath =
 "指定插件管理器(Addon Manager)使用的git仓库路径"
+config.addonRepositoryPath        =
+"指定插件仓库的路径（与 Addon Manager 无关）"
 config.runtime.version            =
 "Lua运行版本。"
 config.runtime.path               =

locale/zh-tw/setting.lua

@@ -6,6 +6,8 @@ config.addonManager.repositoryBranch = -- TODO: need translate!
 "Specifies the git branch used by the addon manager."
 config.addonManager.repositoryPath = -- TODO: need translate!
 "Specifies the git path used by the addon manager."
+config.addonRepositoryPath        = -- TODO: need translate!
+"Specifies the addon repository path (not related to the addon manager)."
 config.runtime.version            =
 "Lua執行版本。"
 config.runtime.path               =

script/config/template.lua

@@ -414,6 +414,7 @@ local template = {
                                             },
     --testma
     ["Lua.docScriptPath"]                   = Type.String,
+    ["Lua.addonRepositoryPath"]             = Type.String,
     -- VSCode
     ["Lua.addonManager.enable"]             = Type.Boolean >> true,
     ["Lua.addonManager.repositoryPath"]     = Type.String,

script/files.lua

@@ -908,6 +908,25 @@ end
 
 local addonsPath
 
+---Updates the variable 'addonsPath' with the user's configuration.
+---The path is only updated if 'addonsPath' is not set and the provided path is a valid string.
+---It first expands the input path and then verifies its existence via fs.exists.
+---@param path string
+function m.updateAddonsPath(path)
+    if addonsPath then
+        return
+    end
+    if not (path and type(path) == "string") then
+        return
+    end
+
+    path = util.expandPath(fs.path(path):string())
+    if fs.exists(fs.path(path)) then
+        addonsPath = path
+        log.info('Updating addon repository path to: ', path)
+    end
+end
+
 ---Resolve path variables/placeholders like ${3rd} and ${addons}
 ---@param path string
 ---@return string resolvedPath

script/workspace/workspace.lua

@@ -131,6 +131,7 @@ local globInteferFace = {
     end
 }
 
+local addonRepositoryPathUpdated = false
 --- 创建排除文件匹配器
 ---@param scp scope
 function m.getNativeMatcher(scp)
@@ -175,6 +176,11 @@ function m.getNativeMatcher(scp)
         end
     end
     for _, path in ipairs(config.get(scp.uri, 'Lua.workspace.library')) do
+        if not addonRepositoryPathUpdated then
+            addonRepositoryPathUpdated = true
+            local addonRepositoryPath = config.get(scp.uri, 'Lua.addonRepositoryPath')
+            files.updateAddonsPath(addonRepositoryPath)
+        end
         path = m.getAbsolutePath(scp.uri, path)
         if path then
             log.debug('Ignore by library:', path)