Skip to content

README.md

Latest commit

 

History

History
118 lines (94 loc) · 4.99 KB

README.md

File metadata and controls

118 lines (94 loc) · 4.99 KB
Raw

GroundCraft 地上合成

  • 作者: 愚蠢
  • 出处: 通用 TShock 插件，按 UnrealMultiple/TShockPlugin 仓库格式整理
  • 插件名/关键词: GroundCraft、DropCraft、Ground Item Craft、地上合成、掉落物合成
  • 功能: 玩家把掉落物丢在同一片位置，插件按 JSON 自定义配方自动合成新物品；不会读取或触发原版 Terraria 合成表

指令

语法 别名 权限 说明
/groundcraft /gc tshock.canchat 查看插件状态
/gcrecipes [页码/搜索] /gcr tshock.canchat 查看已启用配方
/gcenv 无 tshock.canchat 查看当前位置层级、生物群系、液体标签
/gcreload 无 groundcraft.admin 热重载配置和配方 JSON
/gcaudit 无 groundcraft.admin 查看配方审核结果和运行统计

配置

配置目录：tshock/GroundCraft/

  • config.json: 扫描间隔、合成半径、通知、残影清理、安全规则、权限
  • recipes.json: 自定义地上合成表

/gcreload 会热重载两个 JSON 文件，不需要重启服务器。

{
  "enabled": true,
  "scanIntervalTicks": 45,
  "requiredStableScans": 2,
  "clusterRadiusTiles": 3,
  "stillVelocitySquared": 0.02,
  "stationSearchRadiusTiles": 7,
  "environmentSearchRadiusTiles": 8,
  "biomePlayerProbeRadiusTiles": 40,
  "maxCraftsPerClusterPerScan": 25,
  "requireExactIngredientTypes": true,
  "animateConsumedItems": true,
  "notifyRadiusTiles": 24,
  "notifyPlayers": true,
  "notifyConsumedItems": true,
  "clearClientGhostItems": true,
  "allowSingleIngredientTypeRecipes": false,
  "allowCoinRecipes": false,
  "allowInputOutputSameItem": false,
  "playerPermission": "tshock.canchat",
  "adminPermission": "groundcraft.admin"
}

requireExactIngredientTypes 默认开启。材料堆中如果混入配方外物品，不会触发相似配方，避免掉落物合成错乱。animateConsumedItems 默认开启，被消耗的真实掉落物会在不可拾取状态下螺旋上升，动画完成后才生成产物；天顶剑配方会使用更高、更大的专属环绕动画。动画模式下每个材料堆每次扫描只会启动一个合成动画，maxCraftsPerClusterPerScan 表示该动画内同一配方最多批量合成多少批；关闭动画后会在同一次扫描中继续尝试其它可用配方。

配方 JSON

requiredTiles 使用 Terraria 图格 ID；空数组表示任意地点。conditions 可同时限制层级、生物群系、附近液体和 Boss 进度。

{
  "version": 1,
  "recipes": [
    {
      "id": "cloud_in_sky",
      "enabled": true,
      "output": { "id": 751, "stack": 8, "name": "Cloud" },
      "ingredients": [
        { "id": 1518, "stack": 1, "name": "Feather" },
        { "id": 126, "stack": 1, "name": "Bottled Water" }
      ],
      "requiredTiles": [],
      "conditions": {
        "layers": [ "Sky" ],
        "biomes": [],
        "liquids": [],
        "anyLiquids": [],
        "bossProgress": {}
      }
    }
  ]
}

支持的常用条件：

  • layers: Sky, Surface, Underground, Cavern, Underworld
  • biomes: Forest, Snow, Desert, Jungle, Corruption, Crimson, Hallow, Mushroom, Graveyard, Ocean, Shimmer, Dungeon, Hive, Temple
  • liquids / anyLiquids: Water, Lava, Honey, Shimmer
  • bossProgress.hardmode: true 或 false
  • bossProgress.allDowned / anyDowned / noneDowned: KingSlime, EyeOfCthulhu, EaterOfWorldsOrBrain, QueenBee, Deerclops, Skeletron, WallOfFlesh, QueenSlime, MechBossAny, Destroyer, Twins, SkeletronPrime, MechBossAll, Plantera, Golem, DukeFishron, EmpressOfLight, LunaticCultist, MoonLord

多数条件也支持中文别名，例如 天空、地表、雪原、微光、克苏鲁之眼、肉山、世纪之花。

安全规则

  • 默认至少需要两类材料。
  • 默认拒绝钱币配方。
  • 默认拒绝材料和产物相同的循环配方。
  • 同材料、同工作站、同条件但产物不同的配方会被拒绝，避免歧义。
  • 默认要求材料堆的物品种类与配方完全一致，避免相似配方误触发。
  • 合成时会清除被消耗的掉落物并同步消失包；若客户端仍短暂显示旧材料，会提示玩家那是残影，实际已不存在。

更新日志

v1.1.0

  • 新增螺旋融合动画：合成材料动画期间不可拾取，完成后生成产物并清理客户端残影。
  • 天顶剑默认配方使用秘银/山铜砧，并带有更高、更大的专属环绕动画和最终 Fairy 收束。
  • 默认配方补充水蜡烛、生命水晶、虫洞药水、血泪和天顶剑示例。
  • 默认开启精确材料种类匹配，减少相似配方导致的误合成。
  • 默认批量合成上限调整为每堆每轮 25 批。

v1.0.0

  • 初版：JSON 配方、JSON 条件、地形/环境判断、Boss 进度判断、热重载、配方审核、旧掉落物残影清理。

反馈