NekoGakuen GamePad

================================

作者：貓咪學園 NekoGakuen

版本：1.0.2

聯絡推特：https://twitter.com/NekoGakuen

================================

─ 插件簡介 ─

在RPG Maker MV/MZ中也能使用遊戲手把的震動功能。

─ 更新履歷 ─

V1.0.2 新增英文翻譯版本的支援 (DeepL翻譯)。

V1.0.1 更新插件使用條款，以及新增關於「支援平台」資訊。 

V1.0.0 初次版本的插件發佈。

─ 注意事項 ─

本插件在RPG Maker MV版本使用時，需要將NWjs更新到0.32版本以上才能使用。

─ 使用說明 ─

1.在RPG Maker MV/MZ的「插件管理器」之中載入本插件，

  並在本插件的「參數」區塊設定即可。

2.在事件頁中高級區塊選擇「插件命令...」，

  並設定選擇要執行的插件命令及參數即可。

─ 插件命令/腳本 ─

【呼叫遊戲手把震動】

--說明：在遊戲中呼叫遊戲手把的震動功能。

--插件命令 NekoCommands GamePad Vibration <震動時間>, <震動強度>, <震動幅度>

--腳本 $gameSystem.callGamepadVibration(<震動時間>, <震動強度>, <震動幅度>);

【判斷遊戲手把類型】

--說明：在遊戲中判斷所使用的遊戲手把類型，

  目前支援的遊戲手把類型為 Switch/Xbox/PlayStation/Steam/Universal。

>>參數01：可輸入的手把類型為 Switch/Xbox/PlayStation/Steam/Universal。

>>參數02：你的「變數 ID」。

--插件命令 NekoCommands GamePad CheckType <參數01> <參數02>

--條件分歧 Input.checkGamePad() == '<條件參數>'

>>條件參數：可輸入的手把類型為 Switch/Xbox/PlayStation/Steam/Universal。

【判斷遊戲手把按鈕】

--說明：在遊戲中判斷使用遊戲手把按下的按鈕，對應的<條件參數>參照「遊戲手把對應按鈕」的內容。

>>參數01：參照「遊戲手把對應按鈕」的內容。

>>參數02：你的「開關 ID」。

--插件命令 NekoCommands GamePad IsTrigger <參數01> <參數02>

--條件分歧 Input.isTriggered('<參數01>') == <條件參數>;

>>條件參數：輸入「true」或「false」。

【遊戲手把對應按鈕】

                [Switch]    [PS4]   [Xbox One]

'ok'      --> | 按鈕 B   | 按鈕 ×  | 按鈕 A  | 

'cancel'  --> | 按鈕 A   | 按鈕 ○ | 按鈕 B  | 

'shift'   --> | 按鈕 Y   | 按鈕 □ | 按鈕 X  | 

'menu'    --> | 按鈕 X   | 按鈕 △ | 按鈕 Y  | 

'pageup'  --> | 按鈕 L   | 按鈕 L1 | 按鈕 LB | 

'pagedown'--> | 按鈕 R   | 按鈕 R1 | 按鈕 RB | 

'zl'      --> | 按鈕 ZL  | 按鈕 L2 | 按鈕 LT | 

'zr'      --> | 按鈕 ZR  | 按鈕 R2 | 按鈕 RT | 

'-'       --> | 按鈕 -   | Share   | View    | 

'+'       --> | 按鈕 +   | Options | Menu    | 

'home'    --> | Home     | PS      | Guide   | 

─ 支援平台 ─

- NWjs：

 【√ 支援(Windows、macOS)】

- Electron：

 【√ 支援(Windows、macOS)】

- Google Chrome：

 【√ 支援(Windows、macOS、Android)】

- Mozilla Firefox：

 【√ 支援(Windows、macOS、Android)】

- Microsoft Edge：

 【√ 支援(Windows、macOS、Android)】

- Apple Safari：

 【√ 支援(macOS)】

- Android：

 【√ 支援】

- iOS：

 【? 未知】

─ 著作聲明 ─

修改或翻譯本插件無需事前告知，如果插件有BUG可以回報。

本插件著作權為貓咪學園(NekoGakuen)所有。

並且保留對插件使用規則的修改與更動之權利。

-來源標示：【△ 不需要，但有的話會很感謝。 (註1)】

-商業營利：【√ 允許】

-成人用途：【√ 允許】

※註1：但如有註明的話，可以註明「NekoGakuen」即可。

※如有法律問題，後果自行負責。

================================

Author: NekoGakuen

Version: 1.0.2

Twitter: https://twitter.com/NekoGakuen

================================

-- Plugin Information --

Let RPG Maker MV/MZ to can use gamePad vibration features.

-- Update Information --

V1.0.2 Added support for English language version (DeepL Translator).

V1.0.1 Update plugin terms of use, and add information about "Supported Platforms".

V1.0.0 Release plugin.

-- Important Notes --

To use this plugin in RPG Maker MV version, 

you need to update NWjs to version 0.32 or higher to use it.

-- Use Description --

1.Load the plugin in the "Plugin Manager" of RPG Maker MV/MZ.

2.Select the Advanced section of Event Commands "Plugin Command..." or "Script...", 

  and set the parameters of the "Plugin Command" or "Script" to be executed.

-- Plugin Command / Script --

[ Call GamePad Vibration ]

-- Description: 

   Call the gamepad vibrate function in the game.

-- Plugin Command: 

   NekoCommands GamePad Vibration <Duration> <Strong Magnitude> <Weak Magnitude>

-- Script: 

   $gameSystem.callGamepadVibration(<Duration>, <Strong Magnitude>, <Weak Magnitude>);

[ Get GamePad Type ]

-- Description: 

   Get the type of gamepad being used in the game.

   Currently supported gamepad types are Switch/Xbox/PlayStation/Steam/Universal.

>> Parameter01: 

   Currently supported gamepad types are Switch/Xbox/PlayStation/Steam/Universal.

>> Parameter02: 

   Variable ID.

-- Plugin Command: 

   NekoCommands GamePad CheckType <Parameter01> <Parameter02>

-- Conditional Branch: 

   Input.checkGamePad() == '<Conditional Args>'

>> Conditional Args: 

   Currently supported gamepad types are Switch/Xbox/PlayStation/Steam/Universal.

[ Get Gamepad Button ]

-- Description: 

   Get the button pressed by the gamepad being used in the game.

   The mapped <Conditional Args> can be found in the "GamePad Mapping Button".

>> Parameter01: 

   Refer to the contents of "GamePad Mapping Button".

>> Parameter02: 

   Switch ID.

-- Plugin Command: 

   NekoCommands GamePad IsTrigger <Parameter01> <Parameter02>

-- Conditional Branch: 

   Input.isTriggered('<Parameter01>') == '<Conditional Args>'

>> Conditional Args: 

   Enter "true" or "false".

[ GamePad Mapping Button ]

                 [Switch]      [PS4]     [Xbox One]

'ok'      --> | Button B   | Button ×  | Button A  | 

'cancel'  --> | Button A   | Button ○ | Button B  | 

'shift'   --> | Button Y   | Button □ | Button X  | 

'menu'    --> | Button X   | Button △ | Button Y  | 

'pageup'  --> | Button L   | Button L1 | Button LB | 

'pagedown'--> | Button R   | Button R1 | Button RB | 

'zl'      --> | Button ZL  | Button L2 | Button LT | 

'zr'      --> | Button ZR  | Button R2 | Button RT | 

'-'       --> | Button -   | Share     | View      | 

'+'       --> | Button +   | Options   | Menu      | 

'home'    --> | Home       | PS        | Guide     | 

 --Supported Platforms --

- NWjs:

  [√ Yes(Windows、macOS)]

- Electron:

  [√ Yes(Windows、macOS)]

- Google Chrome:

  [√ Yes(Windows、macOS、Android)]

- Mozilla Firefox:

  [√ Yes(Windows、macOS、Android)]

- Microsoft Edge:

  [√ Yes(Windows、macOS、Android)]

- Apple Safari:

  [√ Yes(macOS)]

- Android:

  [√ Yes]

- iOS:

  [? Unknown]

-- Terms of Use --

No prior notice is required to modify or translate this plugin, and if the plugin has bugs you can report them.

The copyright of this plug-in is owned by NekoGakuen.

We also reserve the right to modify and change the rules of use of the plugin.

- Credit: 

  [△ Not required, but appreciated if you have one. (#1)]

- Commercial: 

  [√ OK]

- Adults:

  [√ OK]

#1：If you want to attach it, you can mark it with "NekoGakuen".

＊In case of legal problems, you are responsible for the consequences.