全站通知：

模组:统计数据

来自站务
跳到导航 跳到搜索

← 目录

此页面解释了统计数据(stats)，它们用于记录有关游戏状态的纯数值。每个玩家独享一组统计数据，尽管某些统计数据表示的是全局性数值。

概览

格式

每个统计数据都有独一无二的统计数据键。这些键对大小写不敏感，因此 stepsTaken 和 STEPSTAKEN 等价。

统计数值是从 0 到 42 亿的正整数（默认为 0）。

在模组代码中引用统计数据

可以通过如下方法检查统计数据：

  • 使用游戏状态查询，例如 PLAYER_STAT Current stepsTaken 500（即，当前玩家走了 500+ 步）；
  • 使用调试命令，例如 debug getStat stepsTaken ；
  • 使用 C# 代码，例如 uint stepsTaken = Game1.player.stats.Get(StatKeys.StepsTaken)（其中 StatKeys 记录了游戏本体所有统计数据对应的常量）。

模组可以通过如下方法设置统计数据：

  • 在 Content Patcher 内容包中，使用 IncrementStat 触发动作或数据字段，例如 Data/Machines 中的 StatsToIncrementWhenLoaded ；
  • 在 C# 中使用 Game1.player.stats API（例如 Game1.player.stats.Increment($"{this.ModManifest.UniqueID}_ExampleStat")）。

统计数据可以具有任意键名，它们由游戏自动管理。例如：

  • 获取不存在的统计数据会返回 0 ；
  • 设置不存在的统计数据，例如 IncrementStat {{ModId}}_CustomStat ，会将该统计数据设为指定值；
  • 将某个统计数据减为 0 会移除该统计数据（因为不存在的统计数据的值为 0）。

陷阱

统计数据在合作模式中不会被同步，因此农场帮手只能获取自己的统计数据（而不能获取房主或其他农场帮手的数据）。

内建统计数据

此节列出了游戏本体记录的统计数据。

货币和分数

统计数据键 内容
SpecialOrderPrizeTickets 玩家当前兑奖券数量。
SquidFestScore_<day>_<year> 玩家在指定日期的鱿鱼节分数。

玩家活动

统计数据键 内容
ArtifactSpotsDug 玩家使用锄头挖开的远古斑点数量。
AverageBedTime 自存档开始以来，玩家平均的入睡时刻。
BillboardQuestsDone 玩家完成的“需要帮助”布告栏任务数。
BoatRidesToIsland 玩家乘坐威利的船前往姜岛的次数。
ChildrenTurnedToDoves 玩家使用私欲之黑暗神殿献祭的孩子数。
CompletedJunimoKart 玩家通关祝尼魔赛车的次数。

⚠ 加入于 1.6.9 ，因此旧版存档中的此数据默认为 1 。

CompletedPrairieKing 玩家通关草原王者大冒险的次数。

⚠ 加入于 1.6.9 ，因此旧版存档中的此数据默认为 1 。

CompletedPrairieKingWithoutDying 玩家无伤通关草原王者大冒险的次数。

⚠ 加入于 1.6.9 ，因此旧版存档中的此数据默认为 1 。

DirtHoed 玩家使用锄头耕开的地块数。
ExMemoriesWiped 玩家使用记忆之黑暗神殿抹去配偶记忆的次数。
FishCaught
PreciseFishCaught 		玩家钓鱼时抓到的鱼数。

PreciseFishCaught 是 FishCaught 的子集。前者忽略了某些不能算作“鱼”的物品（即，不属于“鱼”类别、且不具有 counts_as_fish_catch 上下文标签的物品）。例如，海草计入 FishCaught 但不计入 PreciseFishCaught 。

FishingTreasures 玩家钓鱼时打开的宝箱数。
GeodesCracked 玩家在克林特的铁匠铺或使用晶球破开器破开的晶球和谜之盒总数。另见 MysteryBoxesOpened 。
GiftsGiven 玩家送给 NPC 的礼物数（这不计入送给 NPC 的非礼物，例如事件物品或任务物品）。
GoldenTagsTurnedIn 玩家在鳟鱼大赛兑换的黄金标签数。
GoodFriends 与玩家有 8+ 心友谊的 NPC 数。
hardModeMonstersKilled 玩家击杀的“危险”怪物数。
IndividualMoneyEarned 玩家赚取的总钱数。在多人游戏中，此数据不记录通过金钱共享获取的金额。
ItemsCooked 玩家使用烹饪菜谱制作的菜品数。
ItemsCrafted 玩家使用打造配方制造的物品数。
ItemsForaged 玩家采集的物品数（包括产出采集品的作物）。
MonstersKilled 玩家击杀的怪物数。
MossHarvested 玩家从树上收集的苔藓数。
MysteryBoxesOpened 玩家在克林特的铁匠铺或使用晶球破开器破开的谜之盒数。另见 GeodesCracked 。
MysticStonesCrushed 玩家打碎的神秘矿石数。
OtherPreciousGemsFound 玩家打碎的宝石矿石数。
PiecesOfTrashRecycled 玩家放入回收机的物品书。
PreservesMade 玩家从罐头瓶收集的物品数。
QuestsCompleted 玩家完成的任务和特别任务数。

农场帮手在特别任务完成时必须在线才能将此特别任务计入统计数据。

RocksCrushed 玩家使用十字镐打碎石头数。
SeedsSown 玩家种下的农作物种子数（包括花盆和土地中的）。
SlimesKilled 玩家击杀的史莱姆数。这包括史莱姆、巨型史莱姆以及玩家繁育的史莱姆（例如，通过史莱姆屋）。
StepsTaken 玩家走过的总步数。
StumpsChopped 玩家打碎的大树桩和大圆木数。
TicketPrizesClaimed 玩家兑换的兑奖券数。
TimesEnchanted 玩家在锻造台附魔工具或武器的次数。
TimesFished 玩家将鱼竿抛入水中的次数（无论是否钓上鱼）。
TimesPanned 玩家使用淘盘找到东西的次数。
TimesTossedBaby 玩家将孩子抛起来的次数。
TimesUnconscious 玩家因生命值归零而晕倒的次数。
TotalMoneyGifted 玩家通过鹈鹕镇账目表送给其他玩家的总金额。
TrashCansChecked 玩家翻垃圾桶的次数。
TreesChopped 玩家砍倒的野树数。
WeedsEliminated 玩家摧毁的杂草数（也计入使用炸弹或镰刀）。
WildTreesPlanted 玩家种植的野树种子数。

收集的物品

如下统计数据记录了玩家收集的物品本身。而玩家活动小节记录的是玩家执行相关操作的次数（例如，ItemsForaged 记录玩家收获采集品的次数）。

统计数据键 内容
BeveragesMade 玩家从小桶中收集的物品书。
CaveCarrotsFound 玩家通过挖掘找到的山洞萝卜数（其他方式找到的萝卜不计入在内）。
CheeseMade
GoatCheeseMade 		玩家通过压酪机收获的物品数。山羊奶酪会增加 GoatCheeseMade 的统计值（而不会增加 CheeseMade 的统计值），除此之外的任何物品都会增加 CheeseMade 的统计值。
CopperFound
DiamondsFound
GoldFound
IridiumFound
IronFound
NotesFound
PrismaticShardsFound
StoneGathered 		玩家收获的相应物品数，但先前出现在任何玩家背包中的物品不会被计入。

例如：通过打碎铜矿点收获的铜矿石会计入在内，但把铜矿石扔在地上再捡起来，或从其他玩家处受到的铜矿石不会计入。

对应的物品是：

效果和技能

统计数据键 内容
BlessingOfWaters 当前的水域祝福计数。刚获得祝福时，计数为 3，随后每抓一条鱼计数减少一，直至为零。
Book_<book ID> 玩家是否阅读了对应的技能书，其中 0 代表未阅读，1（或更高数值）代表已阅读。其中 <book ID> 是技能书物体的非限定性物品 ID。

对应的书是：

MasteryExp 玩家获得的精通总经验数。
MasteryLevelsSpent 玩家获得的精通级数。
Mastery_<skill ID> 玩家是否解锁了某一技能的精通等级。其中 <skill ID> 取 0（耕种）、1（钓鱼）、2（采集）、3（采矿）或 4（战斗）。
TrinketSlots 玩家解锁的饰品槽数。

取值应为 0 或 1；任何超过 1 的值等价于 1。

世界活动

⚠ 在合作模式中，这些数据主要取决于房主。在对农场帮手使用这些数据前，请确保充分阅读了描述。

统计数据键 内容
BeachFarmSpawns 生成在海滩农场上的海滩采集物总数。

⚠ 对于农场帮手，此数据恒为零。

ChickenEggsLayed 鸡产蛋数。

⚠ 对于农场帮手，此数据恒为零。

CowMilkProduced 牛产奶数。

⚠ 对于农场帮手，此数据恒为零。

CropsShipped 玩家售出的，具有水果或蔬菜类别的物品数。另见 ItemsShipped。

⚠ 对于农场帮手，此数据为在线时看到的过夜结算界面中的数值。

DuckEggsLayed 鸭产蛋数。

⚠ 对于农场帮手，此数据恒为零。

DaysPlayed 玩家完成的天数（即，睡觉次数），新游戏开始时的那次睡觉也计入在内（无论是否跳过）。

⚠ 对于农场帮手，此数据为其最近一次在线、全员入睡时，从房主处接收到的数值。

GoatMilkProduced 山羊产奶数。

⚠ 对于农场帮手，此数据恒为零。

SheepWoolProduced 绵羊产毛数。

⚠ 对于农场帮手，此数据恒为零。

RabbitWoolProduced 兔子产毛数。

⚠ 对于农场帮手，此数据恒为零。

ItemsShipped 任一玩家售出的物品数。另见 CropsShipped。

⚠ 对于农场帮手，此数据为在线时看到的过夜结算界面中的数值。

TrufflesFound 猪产松露数。

⚠ 对于农场帮手，此数据恒为零。

取自“https://wiki.biligame.com/stardewvalley/index.php?title=模组:统计数据&oldid=135961”