View source for Minecraft Dungeons:API

{{stub}}
{{cleanup|Please refer to [https://wiki.vg/Mojang_API Mojang API] and the [https://minecraft.fandom.com/zh/wiki/Minecraft_Dungeons:API 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 <code>api.minecraftservices.com</code>.

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

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

== Achievement ==
{{wip|Well Seasoned;Trendsetter;Tower Tourist;Tower Tourist;So Last Season;Tower Tourist;Goal Driven;Daily Destroyer}}


== Triva ==
* [[Minecraft Dungeons]], as a game owned by [[Mojang|Mojang Studios]], {{w|Xbox Game Studios}}, and [[Double Eleven]], the server and domain name of the above API are hosted by "Amazon Cloud".
* The adventure point mechanism shown in the [[Minecraft Live 2021]] live broadcast has the following footage: an online player defeats the incoming enchantment [[MCD:Royal Guard|Royal Guard]], the pass level is increased from 2 to 3 ; A player threw TNT in the [[MCD:Desert Temple|Desert Temple]] level to defeat a large number of undead mobs, and gained adventure points at the same time as the online player. In fact, after understanding the scoring rules, we can know that these can never happen in real games.
* 赛季一时完成赛季通行证最快需要三小时，由于Minecraft API的发现，这一时间在赛季二减少到了40分钟，最近已经降至4分钟，远低于官方Mojang设计的五个月。
* 高塔游戏随[[Minecraft Dungeons:1.12.0.0|1.12.0.0]]发布前，内部存在多种目前已经无从考证其内容的挑战生物群，他们包括：<code>tower_base_challenge</code>、<code>tower_live_challenge_easy</code>、<code>tower_live_challenge_hard</code>、<code>tower_live_challenge_hard_hh</code>等，很大概率最终被归入了对应群系的挑战生物群。
* 开发人员在[[Minecraft Live 2021]]及后续有关公开内容中多次表示高塔每赛段会持续两周，而事实是直至赛季二第五赛段这一承诺才被常态化，这导致了赛季一五个月时间内玩家正常情况下只体验到7种不同的高塔内容。虽然之后又经历了一系列反复，至少能保证在两周和三周之间。
* 一位玩家截获<code>/dungeons/seasons/ping</code>后将其重新发送（当时功能尚未分离），似乎成功地骗过了Mojang服务器，他的每周挑战对应任务增加了一次计数，但从此之后再也没有人成功过。这可能与后来加入的即时验证ID有关。
* 每次更新，游戏文件路径<code>Dungeons/Game/Content/data/lovika/configs/thetower.configuration.json</code>和<code>Dungeons/Game/Content/data/lovika/configs/thetower.configuration - Copy.json</code>会分别保存新一赛段高塔和上一赛段的<code>/dungeons/config/tower</code>未解析副本，目前功能尚不明确。旧副本甚至还额外标记了楼层数。
* 高塔赛季二第七赛段更新时，由于某些原因，游戏内高塔界面报错：“由于技术问题无法启动高塔”，相关请求返回了一段空的报错内容：“默认命名空间无活跃状态高塔”。随后才被修复。这段高塔创建时间为<code>2022-08-03T07:34:12.553Z</code>、开始时间为<code>2022-08-03T05:00:00Z</code>，是目前唯一一次赛程开始后才被创建的高塔。
* 由于某些原因，高塔赛季二第七赛段第17层调用了一个当时游戏文件内并不存在的机关挑战群<code>twr_ts_floor_03_balcony_click</code>，未对该楼层结构产生任何影响。
* [[MCD:深渊神殿|深渊神殿]]是高塔中结构最复杂、玩法最多样的群系，但是楼层结构数不及[[MCD:冰霜峡湾|冰霜峡湾]]。
* 在ID为<code>event-mobs-boss-mix-end-twr</code>的“末地混合小Boss”生物组中，由于某些原因，本属于[[MCD:虚空回响|末地]]的[[MCD:末影遣使|末影遣使]]被替换成了[[MCD:下界之焰|下界]]的[[MCD:野火|野火]]。
* 高塔生物生成时通常有这样的规律：只能少不能多，优先分散生成。无论如何，相同条件下两次生成均会得到相同的结果。
* 每周挑战、高塔和赛季内容均有一个创建时间的记录，而每日挑战唯独没有，这恰恰验证了每日挑战并非人工操作并分发的。

== Gallery ==
<gallery>
File:Minecraft api shut.png|Announcement that the Minecraft API will be offline before the update
File:McapiUpdating.jpg|English interface when Minecraft API is updated offline
File:1.14mcapi_fail.png|Although not announced in advance, the Minecraft API service was still suspended for a while before the 1.15.0.0 update
File:1.15mcapi_halffail.png|If the player loses connection after playing online for a while, the tower game will not be affected until the player quits the game
File:Year2eventmcapi_fail.png|Seasonal challenge rewards and progress are not visible when players are offline
File:MCD S1 Level.jpg|赛季一、二通行证等级-冒险点数对照图
File:MCD S1 Levels.jpg|赛季一、二升级所需冒险点数
</gallery>

[[zh:MCD:API]]