魔法谷

configs:

• EnableMod : default true; if false, this MOD will not work any more;
• EnableFeatureList : 默认 true; 如果为 false, 无法使用快捷键打开主菜单;
• FeatureListKey : default Q; 快捷键用于打开主菜单;
• --- ForceUnlockSpecialOrder : 默认 false; 如果为 true，可以在秋季之前开启特别订单/齐先生的特别订单;
• --- ForceRefreshSpecialOrder : 默认 false; 如果为 true, 当打开 SpecialOrder/Mr.Qi'sSpecialOrder 时，订单将刷新;

configs:

• EnableFriendshipFeature : 默认 true; 在主菜单中添加 FriendshipData/FarmAnimals 项目;
• --- EnableNpcAllChat : 默认 true; 显示友谊数据时与所有NPC对话;
• --- EnableNpcGiveGift : 默认 true; 当显示友谊数据时，你可以向NPC赠送爱情礼物;
• --- EnablePetFeedAnimal : 默认 true; 宠物所有动物当显示农场动物时;

配置:

• EnableJunimoSkills : 默认 true; 在主菜单中添加JunimoSkills项目;
• --- InfiniteMagnetRange : 默认 true; 无限磁铁范围以吸引物品，可在游戏中配置;
• --- EnableSharedChest : 默认 true; 放置在共享箱子中的物品可以从所有存档中取出; （提示：放入祝尼魔共享箱的物品不会保存到游戏存档中，而是保存在"/Mods/MagicValley/Saves/__WorldChest.xml"文件中，删除该文件将导致物品丢失；多人游戏时祝尼魔共享箱不可用）
• --- ColourSharedChests : 默认 false; 每种颜色对应一个共享箱子;
• --- AllowMaxEnchantmentTimes : 默认 1; 工具可以施加多少附魔，如果为 0 将不显示附魔菜单项;
• --- EnchantmentToolPrice : 默认 5000; 附魔工具的价格;
• --- EnableAutoFishing : 默认 true; 当手持鱼竿且面向水域时，点击自动钓鱼物品即可开始自动钓鱼，按下移动键[A/S/D/W]可停止钓鱼;
• --- EnableAutomation : 默认开启；使用对应工具时自动收集物品，设有专属配置菜单；
• ------- automationConfig : 你可以在游戏中配置它;

按颜色标记的箱子用途：

• 在农场或建筑中放置一个箱子，并设置独特的颜色，它将自动添加到标记箱子中，然后你可以从菜单中远程访问这个箱子；（农场外的箱子不会被自动检测到，支持的位置：Farm/GingerIslandFarm,FarmBuildings,FarmCave,QiNutRoom,BusStop,MineTopFloor）
• 当你从菜单访问箱子（或默认快捷键"R"，可配置），你可以点击离散颜色选择器或滚动鼠标滚轮切换到另一个标记的箱子；
• 如果两个箱子颜色相同，只有最后标记的箱子可以远程访问，因此理论上最多可以标记21个箱子对应颜色；
• 在多人模式中，所有玩家都可以使用带有独特颜色的标记箱子，但只有主玩家可以手动标记相同颜色的箱子（这是由SMAPI的存储机制决定的）。
• 批量填充堆叠和身体移动： 当你从菜单访问箱子时，你可以点击[(Ctrl 或 Shift) + 填充堆叠按钮]来将背包中的堆叠物品填充到所有标记的箱子中；按下[Ctrl + Shift + 移动键]来将显示的标记箱子移动到你的身边（这通常在升级房屋后需要移动箱子时非常有用，仅在多人模式中对主玩家有效）；

configs:

• EnableRemoteChests : 默认开启; 在主菜单中添加标记箱子/祝尼魔箱子/出货箱物品, 在办公室菜单中添加梳妆台/标记箱子工作台物品;

configs:

• EnableRemoteShops : 默认 true; 在主菜单中添加 ShopList 项目;
• EnableRemoteOffice : 默认 true; 在主菜单中添加 OfficeList 项;
• --- 家具与壁纸 : 默认 true; 在办公室列表中显示家具 / 壁纸与地板物品;
• --- 裁缝与锻造 : 默认开启; 在办公列表中显示裁缝 / 染缸 / 染衣 / 巫师神龛 / 火山熔炉物品;
• --- 自定义商店办公室 : 默认开启; 在商店列表中显示自定义商店，在办公室列表中显示配方信息 / 怪物猎人 / 古董商人;
• --- EnableGoldenWalnutInfo : 默认 true; 在 OfficeList 中显示金色核桃信息;
• ------- EnableGoldenWalnutGain : 默认 true; 可以在金色核桃信息菜单中收集一些核桃或到达核桃位置;

配置：

• EnableMapTeleport : 默认 true; 点击游戏地图位置时传送或打开区域地图;
• --- MapTeleportKey : 默认 MouseLeft; 游戏地图中操作使用的按键;
• --- EnableMapPointUnreachable : 默认 false; 当解锁沙漠/姜岛等地点时是否可达;
• EnableMineElevator : 默认 true; 在主菜单中显示矿洞电梯;
• EnableDesertElevator : 默认 true; 在主菜单中显示骷髅电梯;
• --- DesertElevatorMaxLevel : 默认 100; 骷髅电梯的最大等级;
• EnableVolcanoElevator : 默认 true; 在主菜单中显示火山电梯;
• showGingerMap : 默认 true; 在主菜单中显示姜岛地图;
• --- EnableGingerMapTeleport : 默认 true; 在姜岛地图中，可以右键点击位置传送到那里;
• showFarmLocationMap : default true; 在主菜单中显示农场地图;
• showLocationMap : 默认 true; 在主菜单中显示当前位置地图（及SVE地图）;
• --- EnableLocationMapTeleport : 默认 true; 在地图位置界面，可以右键点击位置传送至该处;
• EnableTagPositionTeleport : 默认 false; 在主菜单中添加位置标记，您可以在菜单中标记当前位置并传送至此;
• --- TagPositionKey : default P; 标记当前位置的按键;

配置：

• showCustomPortraits : default true; 通过将图片(.png或.xnb)放入"Mods/MagicValley/Content/*"文件夹来替换肖像和角色显示;
• --- showPortraitsConjointCP : 默认 false; 如果为 false，当你使用 Content Patcher 加载内容包时，此功能将被关闭;

编辑 "config.json" 文件以更改配置。

在主菜单中创建菜单项的快捷方式，例如：

"MainDisplayMenuTypes": [
  "商店定制",
  "位置地图_城镇"
]

创建菜单项的快捷键，例如：

"菜单快捷键": [
  {
    "快捷键": "Z",
    "菜单类型": "朱尼莫技能"
  },
  {
    "快捷键": "H",
    "菜单类型": "自动钓鱼"
  },
  {
    "快捷键": "G",
    "菜单类型": "工具自动化"
  }
]

支持菜单类型（菜单项）：

• 打开翻译文件 "/Mods/MagicValley/i18n/*.json"，MenuTypes 始终匹配 "menutype.{{MenuType}}" 的模式；
• 或使用"LocationMap_{{GameLocationName}}"菜单项显示位置地图； 游戏地点名称：[农舍，农场洞穴，农场，海滩，树林，铁路，森林，公交车站，沙漠，山脉，小镇，岛屿西部，岛屿东部，岛屿南部，岛屿北部，岛屿东南部，等等。]

控制台命令：（不包含引号；SMAPI控制台是随游戏一同打开的窗口，以纯文本格式显示来自SMAPI和模组的消息。玩家可以直接在该窗口中输入命令来与模组交互。）

• "help -mv" : 显示MagicValley所有支持的命令;
• "-mv openModDir" : 打开MagicValley的模组目录。
• "-mv openMapCacheDir" : 打开MagicValley的位置地图截图缓存目录，当存储空间不足时，可以删除此缓存文件夹中的文件。
• (如果你使用了与"usePresetConfig"相关的命令，稍后需要重启SMAPI)
• "-mv usePresetConfig UIInfo" 或 "-mv usePresetConfig U" : 直接使用预设的UIInfo配置，仅显示部分信息且不改变游戏玩法。
• "-mv usePresetConfig Fishing" 或 "-mv usePresetConfig F" ：直接使用钓鱼的预设配置，仅显示用户界面信息并允许自动钓鱼功能。
• "-mv usePresetConfig default" 或 "-mv usePresetConfig" ：直接使用默认的预设配置。
• "-mv usePresetConfig Easier" 或 "-mv usePresetConfig E" : 直接使用预设配置"更简单"，比默认配置更容易游玩，并添加一些快捷键。
• "-mv usePresetConfig AllFeatures" 或 "-mv usePresetConfig A" : 直接使用 AllFeatures 的预设配置，开启 MagicValley Mod 的所有功能，并添加一些快捷键。

/*
itemName: 菜单项显示名称。
onHoverText: <int indexOfMenuItem, string menuItemName, string return_HoverTextToDisplay>
onItemClick: <int 菜单项索引, string 菜单项名称, bool 返回_是否重新打开菜单>
*/
公共接口 IMagicValleyApi
    {
        bool 注册菜单项(IManifest 模组, string 项目名称, Func<int, string, string> 悬停文本回调, Func<int, string, bool> 项目点击回调);
    }

//当 Events.GameLoop.GameLaunched时注册
var magicValleyApi = mod.Helper.ModRegistry.GetApi<IMagicValleyApi>("season.MagicValley");
如果(magicValleyApi != 空) magicValleyApi.注册菜单项(模组, 翻译项名称1, ...参数);
如果(magicValleyApi != null) magicValleyApi.注册菜单项(mod, 翻译项名称2, ...参数);