服务端插件 KeyChangerSSC 2.0.1.2018

*此贴搬运自泰拉瑞亚中文论坛，已获原作者授权。

原帖地址：https://www.bbstr.net/r/72/

原作者：TheLastPrism

适用版本：1.4

前置Mod：TShockAPI

API版本：2.1

原帖地址：https://tshock.co/xf/index.php?threads/keychangerssc.2528/

开源地址：https://github.com/AxisKriel/KeyChanger

重置自@nnt的钥匙交换插件
本人仅作1.4兼容处理，并对部分无效汉化进行了修复
插件介绍(英文)

KeyChangerSSC
Changes special keys into their respective items
ApiVersion: v2.1
Terraria Version: 1.4.1.2
Plugin Version: 2.0.0.2018

Author: Enerdy,汉化by @nnt,重置by @棱镜
DISCLAIMER: This plugin requires ServerSideCharacters to be enabled on your server, or it won't be able to modify a player's inventory.

Features:

• Changes special dungeon chest keys into an item specified in the config file. Available keys:
  • Temple Key
  • Jungle Key
  • Corruption Key
  • Crimson Key
  • Hallowed Key
  • Frozen Key
  • Key of Light
  • Key of Night
  • Gold Key
  • Shadow Key
• Includes three main exchange modes:
  • Normal, which is the default mode, allowing the commands to be executed everywhere.
  • Region, which uses regions specified in the config file as exchange points.
  • Market, an extension of the Region mode, which automatically sets all keys' exchange regions to one single market region, defined in the config file.
• Multiple items can be assigned to one key, a list from which the plugin will select one at random when exchanging!
  • Default items are the same as the featured item found inside corresponding chests.
• No item dropping required - in collaboration with Terraria's SSC feature, the server can modify a player's inventory directly, allowing smooth trades between items.

Permissions:

• key - Gives access to the entire /key command branch.
• key.change - Allows the use of /key change.
• key.reload - Allows the use of /key reload.
• key.mode - Allows the use of /key mode.

Commands:

• /help key provides a list of every available command branching from /key.
• /key change <type> - Exchanges a key defined by the <type> parameter by one of its assigned items.
• /key reload - Reloads KeyChangerConfig.json. Useful for assigning new exchange regions as this cannot be done through a command in-game.
• /key mode <mode>- Changes the requirements to perform an exchange. Available modes:
  • normal - removes requirements;
  • market - requires the player to be inside a region to perform an exchange. This region can be defined in the config file at the "MarketRegion" setting.
  • region - same as market, but every key has its own region. Those regions can be defined in the config file at the "[KEYNAME]Region" setting, where [KEYNAME] is the name of the key.

Note: When modifying region names in the config for the first time, you will find that their parameter is set to null. In order to add a region name, you must use inverted commas surrounding the name. Ex: "JungleRegion": null -> "JungleRegion": "TestRegion".
Config:

• EnableRegionExchanges: <true/false>
  • Enables / disables region mode. Explanation above.
• MarketMode: <true/false>
  • Enables / disables market mode. Note that if this is manually set through the config, you must set EnableRegionExchanges to true as well, or it will not have any effect. The [I]/key mode market[/I] command does it all automatically.
• Enable[KEYNAME]: <true/false>
  • Enables / disables the key. A disabled key will return an error message when an user attempts to exchange it.
• [KEYNAME]Item:<list of item ids>
  • A list of item IDs from where the plugin can pick when returning the item to exchange for the key. Here's how to add more than one item:
    
    
    JSON：

    "JungleKeyItem": [1156,
    1200,
    1500
    ],

    
    
    
    
• MarketRegion: "<text>"
  • The name of the region to use as the general exchange point if MarketMode is in use.
• [KEYNAME]Region: "<text>"
  • The name of the region to use as the key's separate exchange region if EnableRegionExchanges is in use.

Changelog:
Not much to add here, since I lost the previous changelog.
2.0.0.2018

• Fixed a bug with the latest TShock build, which introduces a new SSC module and moves around the config options for it.

2.0.0.0

• /key mode now persists between sessions by writing the new value to the config.
• /help key brings up a list of every available command and their correspondent function.
• Added example KeyChangerConfig.json as a downloadable file.