「街」とか「428」とかのTIP機能みたいなプラグイン。
メッセージレイヤのテキストをクリックして別窓を開きます。
TIP内容はCSVから読み込みますので、表計算やデーターベースソフト等で管理できます。
html、css、jsRender を理解してないと使いにくいかもです…。
主な機能
- テキストをクリックしてTIPを表示します。
- TIPデータは、csvファイルを読み込みます。複数読み込み対応。
- TIPテキストやホバー時の文字色・SE・マークの有無を指定できます。
- TIP詳細の内容をページ分けできます。
- TIP一覧を自動作成します。
- TIP表示フラグを保存します（TIPテキストを表示したかどうか）
- バックログからもTIP表示するかを指定できます。 (※4.01b以降、マークはCSS、カラーはバックログプラグインで対応お願いします）
- TIP詳細・TIP一覧のレイアウトはhtmlファイルで編集可能です。csv別に指定もできます。
- TIP詳細のテキストから別のTIP詳細を表示できます。
- ページを指定してTIP詳細を表示できます。
- 未読マークを表示できます。
- 縦書き対応。
サンプル画像
縦画面サンプル（600*900）
サンプルゲーム
利用規約
- 改造・再配布は自由です。ただし、有償での再配布は禁止します。改造後データの配布も同様にお願いします。
- 利用報告・クレジット表記は任意です。
- このプラグインはドネーションウェア（カンパウェア）です。もしよろしければ寄付をお願いいたします。（強制ではありません）
- 詳しくは利用規約をお読みください。
ダウンロード
※v4.07はサンプルゲーム未収録です。必要な方はBOOTHからv4.06をダウンロードしてください。
動作確認
ティラノスクリプト ver521e
注意点
メッセージレイヤーの表示順を変更しています。設定や環境によってはうまく動作しない可能性があります。
使い方
組み込み方法
data/others/pluginに 「tip」フォルダを保存してください。-
csvファイルを作成し、
data/others/plugin/tip/csv/に保存します。※作り方は後述 デフォルトのファイル名は「 tip_data.csv 」 -
first.ks （ビルダーは
scenario/system/plugin.ks
）など、ゲーム起動時に必ず読み込むksファイルでプラグインを呼び出してください。
[plugin name=tip][plugin] タグは1度だけ書けば大丈夫です。 -
フラグ保存を f変数 にする場合は、
make.ks ファイルに[tip_flag_reset]タグを記述します。 -
TIP表示ボタンにしたいテキスト（以下「TIPテキスト」）を
[tip]～[endtip]で囲みます。[tip]タグには、keyかidのどちらかを指定します。 例：[tip key=hoge]ほげ[endtip] -
TIPリストの表示は
[tip_list]タグを使います。[button]で呼び出す場合は、role=sleepgameを指定してください。 target 先に[tip_list]を書きます。例： [button x=0 y=0 fix=true role=sleepgame graphic=tiplist.gif target=*tiplist] *tiplist [tip_list] [s]
CSVファイルの作り方
- CSVデータは、1行で1件分となります。 改行コードで次のデータとして分割します。
- CSVの1行目は「見出し」にします。 見出しで使えるのは、半角英数のみです。
- 見出しに「key」項目を作ります。keyで対象データを参照します。 「key」で使えるのは、半角英数のみです。
- 「見出し」には、「id」「flag」は使えません（自動で追加されます） それ以外の見出し名は自由です。項目数にも制限はありません。
- CSVファイルの文字コードは「UTF-8」にしてください。
- CSVファイルは、tipフォルダ内の「csv」フォルダに保存してください。
-
テキスト内容が「カンマ区切りテキスト」であれば、拡張子は .csv 以外でも大丈夫です。
ファイル名を変更する場合は、ファイル名を指定してください。
[plugin name=tip file=***.txt]または、[tip_loadcsv file=***.txt] -
必ず行の最後は「_EOF」を付けてください。v4以降は不要ですが、最後の項目が表示されない場合は追記してください。 - htmlタグも記入できますが、「"」を使う場合は書出し後のデータチェックしてください。「'」推奨。
- ファイルが上手く読込めない場合は、一度テキストエディタで開き上書き保存してみてください。
詳しい使い方
その他
- マーク画像は、tip/image/tip_mark.png を差し替える事で変更可能です。 ※画像は正方形で作成してください。
- マーク画像の表示は、tip/js/tip.css にて変更可能です。
- 自動でのフラグ立ては、[tip] タグを表示した時点で true になります。TIPをクリックしたかは判断されません。
- リスト表示で pagenum=auto（初期値）を使う場合は、 #tip_list_container の width() height() 値を正確に設定してください。 上手く動かない場合は、1ページの表示件数を数値で入力してください。
- バックログのSEは「TIPからマウスカーソルが外れた時の音」には非対応です。
-
htmlの変更禁止id・class
- tip.html … #tip_container .tip_body
- tip_list.html … #tip_list_container .tip_list
- sampleフォルダのtip_sample.ks がサンプルゲームとなっていますので参照してください。 ※サンプルゲームは、ティラノビルダーには対応していません（画像が無いのでエラーが出ます） ※ゲーム制作時は、sampleフォルダは削除してください。
パラメータ
[plugin]タグ用
（※初期値の場合は省略可）
| パラメータ名 | 値 | 初期値 | 説明 |
|---|---|---|---|
| file | ファイル名 | tip_data.csv | TIPデータファイル名 |
| color | 0x000000形式 | defaultChColor | TIPテキストの色を変える |
| entercolor | 0x000000形式 | "" | TIPテキストにマウスカーソルが乗った時の色 |
| mark | true/false | false | TIPテキストにマークを付ける |
| flag | true/false | true | TIP表示をフラグ管理するか |
| flag_var | sf/f | sf | フラグ保存用変数の種類 |
| log | true/false | true | バックログからもTIP表示させるか |
| log_se | true/false | false | バックログのTIPテキストにSEを入れるか（※log=true時） |
| log_color | true/false | false | バックログのTIPテキストにcolorを付けるか（※log=true時） |
| all_clickse | oggファイル | none | 共通のクリック音 |
| all_enterse | oggファイル | none | 共通のマウスカーソルが乗った時の音 |
| all_leavese | oggファイル | none | 共通のマウスカーソルが外れた時の音 |
| tip_clickse | oggファイル | none | TIPテキストのクリック音 |
| tip_enterse | oggファイル | none | TIPテキストにマウスカーソルが乗った時の音 |
| tip_leavese | oggファイル | none | TIPテキストからマウスカーソルが外れた時の音 |
| list_clickse | oggファイル | none | TIPリストのクリック音 |
| list_enterse | oggファイル | none | TIPリストにマウスカーソルが乗った時の音 |
| list_leavese | oggファイル | none | TIPリストからマウスカーソルが外れた時の音 |
| close_clickse | oggファイル | none | 閉じるボタンのクリック音 |
| close_enterse | oggファイル | none | 閉じるボタンにマウスカーソルが乗った時の音 |
| close_leavese | oggファイル | none | 閉じるボタンからマウスカーソルが外れた時の音 |
| navi_clickse | oggファイル | none | ナビボタンのクリック音 |
| navi_enterse | oggファイル | none | ナビボタンにマウスカーソルが乗った時の音 |
| navi_leavese | oggファイル | none | ナビボタンからマウスカーソルが外れた時の音 |
| tip_html | htmlファイル | tip.html | TIP表示用テンプレート |
| tiplist_html | htmlファイル | tip_list.html | TIPリスト表示用テンプレート |
| pagefeed | auto/none/数値 | auto | TIPリストをページ分けするか。しない場合は none |
| fade_speed | 数値 | 300 | 各TIP画面のフェード時間 |
| vertical | true/false | config.vertical | 縦書きにするか |
[tip_loadcsv]タグ用
CSVファイルを読み込む為のタグです。 （※パラメータの指定が無い場合は、[plugin]の指定が反映されます。）
| パラメータ名 | 値 | 必須 | 説明 |
|---|---|---|---|
| file | csvファイル名 | × | 読み込みたいcsvファイル |
| flag | true/false | × | TIP表示をフラグ管理するか |
| flag_var | sf/f | × | フラグ保存用変数の種類 |
| tip_html | htmlファイル | × | TIP表示用テンプレート |
| tiplist_html | htmlファイル | × | TIPリスト表示用テンプレート |
[tip]タグ用
メッセージテキストをTIP表示ボタンにするタグです。 （※パラメータの指定が無い場合は、[plugin]の指定が反映されます。）
| パラメータ名 | 値 | 必須 | 説明 |
|---|---|---|---|
| key | 文字列 | 〇* | csvファイルで定義した「key」の値 |
| id | 数値 | 〇* | csvファイルの記述順（0からスタートです） |
| color | 0x000000形式 | × | TTIPテキストの色 |
| entercolor | 0x000000形式 | × | TIPテキストにマウスカーソルが乗った時の色 |
| mark | true/false | × | TIPテキストにマークを付けるか |
| clickse | oggファイル | × | TIPテキストのクリック音 |
| enterse | oggファイル | × | TIPテキストにマウスカーソルが乗った時の音 |
| leavese | oggファイル | × | TIPテキストからマウスカーソルが外れた時の音 |
| data_name | 文字列 | × | csvデータ名（※拡張子は無し） |
* key または id のどちらかは必須。両方記述がある場合は key が優先になります。
[tip_show]タグ用
tipを表示するタグです。 （※パラメータの指定が無い場合は、[plugin]の指定が反映されます。）
| パラメータ名 | 値 | 必須 | 説明 |
|---|---|---|---|
| key | 文字列 | 〇* | csvファイルで定義した「key」の値 |
| id | 数値 | 〇* | csvファイルの記述順（0からスタートです） |
| data_name | 文字列 | × | csvデータ名（※拡張子は無し） |
* key または id のどちらかは必須。両方記述がある場合は key が優先になります。
[tip_list]タグ用
TIPリストを表示するタグです。 （※パラメータの指定が無い場合は、[plugin]の指定が反映されます。）
| パラメータ名 | 値 | 必須 | 説明 |
|---|---|---|---|
| data_name | 文字列 | × | csvデータ名（※拡張子は無し） |
| sort_key | 文字列 | × | ソートしたいcsvデータの列の見出し |
| sort_reverse | true/false | × | 降順ソートする場合は true。省略時は昇順（false） |
[tip_flag]タグ用
フラグの値を追加したり変更したりするタグです。 （※パラメータの指定が無い場合は、[plugin]の指定が反映されます。）
| パラメータ名 | 値 | 初期値 | 必須 | 説明 |
|---|---|---|---|---|
| key | 文字列 | - | 〇* | csvファイルで定義した「key」の値 |
| id | 数値 | - | 〇* | csvファイルの記述順（0からスタートです） |
| data_name | 文字列 | - | × | csvデータ名（※拡張子は無し） |
| flag_name | 文字列 | flag | × | フラグの名前 |
| flag_val | true/false | true | × | フラグの値 |
* key または id のどちらかは必須。両方記述がある場合は key が優先になります。
[tip_btn] タグ用
button や glink にTIPリストの未読数を表示するタグです。 （※パラメータの指定が無い場合は、[plugin]の指定が反映されます。）
| パラメータ名 | 値 | 初期値 | 説明 |
|---|---|---|---|
| data_name | 文字列 | - | csvデータ名（※拡張子は無し） |
| pos | 文字列 | rt |
未読数の表示位置。 lt(左上)、rt(右上)、ct(中上)、lb(左下)、rb(右下)、cb(中下) ※left、right、center、top、bottom の頭文字です。 |
[tip_flag]タグ用
フラグの値を追加したり変更したりするタグです。
（※パラメータの指定が無い場合は、[plugin]の指定が反映されます。）
| パラメータ名 | 値 | 初期値 | 説明 |
|---|---|---|---|
| data_name | 文字列 | – | csvデータ名（※拡張子は無し） |
| tip_btn | true/false | false | リスト表示用ボタンに未読バッジを使う場合は true |
| clear | true/false | false | フラグ値を削除する場合は true |
Ver・更新履歴
- 2023/02/19 ver4.07c
- colorパラメータが動作しない不具合修正。パラメータlog_colorを追加。ティラノv521d/eにて動作確認。
- 2022/11/23 Ver4.07b
- 右クリックでcloseした場合の不具合修正。
- 2022/11/14 Ver4.07a
- 起動時の不具合対応。
- 2022/11/13 Ver4.07
- v520でロード時に動作しない不具合対応。
- 2022/04/30 Ver4.06
- [tip_flag_reset]タグ追加。[tip_flag]タグ使用時に未読バッジが反映してなかった不具合修正。
- 2021/09/30 Ver4.05
- [tip_show]タグ・idパラメータ追加。テンプレートでゲーム変数を使えるように。 他、CSS整理など微調整。ティラノv510hで動作確認。
- 2021/02/11 Ver4.04
- TIPリスト表示にソート機能を追加。ティラノv510aで動作確認。サンプルは追加なし。
- 2021/02/11 Ver4.03
- ボタン用未読数の位置指定パラメータを追加、位置ズレを修正。ティラノv506eで動作確認。 [endtip]タグで[font]の指定がクリアされる仕様を変更。 リストからの詳細を閉じる際のチラつきを修正。prev/nextボタンのカーソル画像を修正。
- 2021/01/04 Ver4.02a
- メニューの後にリストを開くと、メニューが残ってしまう不具合を修正。
- 2021/01/03 Ver4.02
- 未読マーク追加。セーブ・ロード画面からTIP詳細が開く不具合修正再び。ティラノv505eで動作確認。
- 2020/11/23 Ver4.01b
- パラメータの log_color、log_mark、log_plugin、pagenum を削除。 テンプレートを簡略化、CSSを微調整等。
- 2020/10/22 Ver4.01a
- csv読み込み、CSS間違い等不具合修正。ajax表記修正。
- 2020/10/19 Ver4.01
- リスト表示用タグを[tip_list]に変更。ナビにprev/nextを追加。tipのページ指定追加。 tip内tip表示、f変数を指定した時の挙動等、不具合修正。他CSSなど修正。
- 2020/09/21 Ver4.00
- CSV複数読み込み、テンプレート指定等機能追加。ティラノv504aで動作確認。
- Ver4.00以前省略
- 2016/04/14 Ver1.00
- 公開。
hororo
1年前
