Minecraft Dungeons:API

This Minecraft Dungeons article is a stub.

You can help by expanding it.

This article needs cleanup to comply with the style guide. ^[discuss^]

Please help improve this page. The talk page may contain suggestions.
Reason: Please refer to Mojang API and the Chinese Minecraft_Dungeons:API page.

Minecraft Dungeons uses some private API methods to record player's game activity and distribute game online content, these APIs are called Minecraft API in the game. Both have the domain name api.minecraftservices.com.

<--!

特殊场景使用情况

高塔

游戏启动，请求/dungeons/config/tower、 /dungeons/config/tower/mobgroups并写入存档。
玩家打开高塔准备页面，验证上述两连接。
1. 在线：重新请求并验证赛段有效性，核对存档内容。
2. 离线：阻止玩家进入高塔，若存档有副本则调用并启动。
按照创建时间计算赛段剩余时间。
缓存塔内容。
玩家启动高塔。
游戏根据/dungeons/config/tower中种子码调用结果文件生成楼层地形。
根据/dungeons/config/tower/mobgroups调用挑战生物群生成楼层生物。
根据给出的种类与性质分配楼层奖励。
游戏过程中实时发送/dungeons/progress记录游戏关键事件所加冒险点数。
游戏结束。
本地计算高塔任务总冒险点数。
最终通过/dungeons/progress上传。

冒险中心

玩家打开冒险中心页面。
显示“方块翻滚”动画等待内容生成。
游戏请求/dungeons/config/seasons、/dungeons/challenges、/dungeons/progress。
根据/config/seasons调用游戏文件，安排页面元素。
根据/challenges生成每周挑战栏内容。
将/dungeons/progress中数值与/dungeons/config/seasons、/dungeons/challenges比较，判定玩家等级、完成情况。
根据/dungeons/rewards判定各项奖励玩家解锁领取情况。
页面生成。

成就

Achievement	In-game description	Actual requirements (if different)	Gamerscore earned	Trophy type (PS)
Trendsetter	Reach seasonal adventure rank 25.	—	10G	Bronze
Well Seasoned	Reach seasonal adventure rank 10.	—	10G	Bronze
So Last Season	Complete a mission with a full set of cosmetics (cape, pet, emote, flairs) from a previous season.	Complete a mission while equipped with a cape, pet, emote, and flair that had been acquired from season 1.	50G	Silver
Tower Tourist	Encounter 15 different biomes in your Tower adventures.	—	20G	Bronze
Goal Driven	Complete 10 weekly challenges.	—	50G	Silver
Daily Destroyer	Complete 3 daily trials in 1 day.	—	10G	Bronze

你知道吗

Minecraft Dungeons作为Mojang Studios、Xbox Game Studios和Double Eleven旗下的游戏，上述API的服务器及其域名却从一开始就托管给了”亚马逊云“。
在Minecraft Live 2021直播中展示的冒险点数机制有如下镜头：一位联机玩家击败了前来的附魔皇家守卫，通行证等级从2级升至3级；一位玩家在沙漠神殿关卡中抛出TNT击败了大量亡灵生物，与联机的玩家同时获得了冒险点数。事实上，了解计分规则后我们可以知道这些都是永远无法发生在真实游戏中的。
赛季一时完成赛季通行证最快需要三小时，由于Minecraft API的发现，这一时间在赛季二减少到了40分钟，最近已经降至4分钟，远低于官方Mojang设计的五个月。
高塔游戏随1.12.0.0发布前，内部存在多种目前已经无从考证其内容的挑战生物群，他们包括：tower_base_challenge、tower_live_challenge_easy、tower_live_challenge_hard、tower_live_challenge_hard_hh等，很大概率最终被归入了对应群系的挑战生物群。
开发人员在Minecraft Live 2021及后续有关公开内容中多次表示高塔每赛段会持续两周，而事实是直至赛季二第五赛段这一承诺才被常态化，这导致了赛季一五个月时间内玩家正常情况下只体验到7种不同的高塔内容。虽然之后又经历了一系列反复，至少能保证在两周和三周之间。
一位玩家截获/dungeons/seasons/ping后将其重新发送（当时功能尚未分离），似乎成功地骗过了Mojang服务器，他的每周挑战对应任务增加了一次计数，但从此之后再也没有人成功过。这可能与后来加入的即时验证ID有关。
每次更新，游戏文件路径Dungeons/Game/Content/data/lovika/configs/thetower.configuration.json和Dungeons/Game/Content/data/lovika/configs/thetower.configuration - Copy.json会分别保存新一赛段高塔和上一赛段的/dungeons/config/tower未解析副本，目前功能尚不明确。旧副本甚至还额外标记了楼层数。
高塔赛季二第七赛段更新时，由于某些原因，游戏内高塔界面报错：“由于技术问题无法启动高塔”，相关请求返回了一段空的报错内容：“默认命名空间无活跃状态高塔”。随后才被修复。这段高塔创建时间为2022-08-03T07:34:12.553Z、开始时间为2022-08-03T05:00:00Z，是目前唯一一次赛程开始后才被创建的高塔。
由于某些原因，高塔赛季二第七赛段第17层调用了一个当时游戏文件内并不存在的机关挑战群twr_ts_floor_03_balcony_click，未对该楼层结构产生任何影响。
深渊神殿是高塔中结构最复杂、玩法最多样的群系，但是楼层结构数不及冰霜峡湾。
在ID为event-mobs-boss-mix-end-twr的“末地混合小Boss”生物组中，由于某些原因，本属于末地的末影遣使被替换成了下界的野火。
高塔生物生成时通常有这样的规律：只能少不能多，优先分散生成。无论如何，相同条件下两次生成均会得到相同的结果。
每周挑战、高塔和赛季内容均有一个创建时间的记录，而每日挑战唯独没有，这恰恰验证了每日挑战并非人工操作并分发的。