利用者:Chirimen/TS3プラグイン作成

TS3 プラグイン作成のための覚え書き

プラグイン作成の参考情報リンク

メモ

プラグインパッケージの拡張子は .ts3_plugin となる
パッケージの正体は ZIP アーカイブファイル
インストールされる相対位置は ZIP アーカイブ内部の構成による
ZIP アーカイブのルートにパッケージの情報を記述した package.ini が必要
TS3のインストールディレクトリをルートとしてインストールされる (package.ini はインストールされない)
32bit版、64bit版が存在する場合は、32bit版は _win32、64bit版は _win64 をファイル名につける

プラグインの構成例　[my_plugin.ts3_plugin]

package.ini
plugins
  my_plugin_win32.dll
  my_plugin_win64.dll
  my_plugin_data
    data1.dat
    data2.dat

package.ini

Name = my_plugin
Type = Plugin
Author = myname
Version = 1.0
Platforms = win32, win64
Description = "This is a test plugin."

Name はプラグイン DLL の名前と一致させる。この例では my_plugin.dll や my_plugin_win64.dll といった名前になる。

ビルドについて

必要なもの (作者の環境)

Windows 10 Home / Pro 64bit版
Visual Studio Community 2019
Qt 5.12.8 msvc2017-64bit

パッケージの作成方法

ソース一式は GitHub https://github.com/chirimenmonster/ts3plugins からダウンロードできる。サブモジュールの ts3client-pluginsdk も取得・展開しておく。

Developer Command Prompt for VS2019 から以下のコマンドを実行する。

> cd (ソースツリー展開場所)\ts3plugins\nyushitsu
> msbuild nyushitsu_plugin.msbuild

output フォルダに nyushitsu_plugin.ts3_plugin と nyushitsu_plugin-0.6.3.zip ができる (ほかにもいろいろ)。 nyushitsu_plugin-0.6.3.zip は配布用のパッケージで nyushitsu_plugin.ts3_plugin と README.md, BUILD.md をまとめたもの。 nyushitsu_plugin.ts3_plugin を実行すると TS3 にプラグインがインストールされる。