查看“MisaMino”的源代码

{{Tetris Wiki搬运|MisaMino}}
{{mbox
|border=info
|type=help
|text=该页面介绍的是方块对战游戏 MisaMino，玩家可在游戏中对战同名 AI。下载地址在[[#外链|外链]]章节。}}
{{需要帮助|阅读游戏源代码，解决条目中诸如软降前摇等代码层面遗留问题。}}
{{Infobox game|title = MisaMino
|developer = misakamm
|individual = yes
|released = 2013年7与15日
|latestrelease = 1.4.5 / 2013年11月11日<ref name="harddrop forum">{{cite web |url=https://harddrop.com/forums/index.php?showtopic=5292 |title=The T-spin AI bot (MisaMino ver 1.4.5 1111), turn-based mode and normal mode Tetris |date=2013年7月15日 |website=Hard Drop Forums}}</ref>
|platform = Windows
|preview = 6
|playfield = 10 &times; 20<sup>(+20)</sup><ref group="注">特定规则：缓冲槽超过 100 行即死。</ref>
|hold = 有
|hard = 有
|system = SRS
|boxart = Misamino1.png
|title-scrn = Misamino2.png
|ingame-scrn = Misamino3.png
}}

'''MisaMino''' 是由社区玩家 misakamm（御坂美琴，中文社区编号TSSS<ref group="注">不要和另一名社区玩家“白给白给御坂御坂”混淆。</ref>） 于2013年中在 Hard Drop 论坛上发布的方块 AI <ref name="harddrop forum" />。AI 的代码同样也被 misakamm 上传至 GitHub<ref>{{cite web |url=https://github.com/misakamm/MisaMino |title=MisaMino's open source code repository |date=2015年7月15日 |website=GitHub}}</ref>。<br>

社区玩家赞誉 MisaMino 开创了现代对战方块 AI 的先河，之后的 [[Zetris]]、[[ColdClear]] 等 AI 都参考或借鉴了 MisaMino。MisaMino 本身也被移植到 [[Jstris]] 等非官方四连方块游戏平台上<ref>{{cite web |url=https://jstris.jezevec10.com/about/versions |title=Jstris's version history |date=2022年1月1日|website=Jstris}}</ref>。

== 配置 ==
MisaMino 有诸多供调节的选项，但它们大多需要玩家修改配置文件。以下给出能在游戏中直接通过按键实现的功能。
{| class="wikitable"
! 功能键 !! 功能
|-
| F2 || 重开（仅限20块前或终局后）
|-
| F3 || 是否预览垃圾行
|-
| F4 || 方格是否可见
|-
| F5 || 调高主音量（一次5%）
|-
| F6 || 调低主音量（一次5%）
|-
| F12 || 配置助手
|}

除了 .exe 可执行文件本身，你还能找到一份名为 misamino.ini 的文件。该文件共有六个部分，包含简单的 key=value 设置选项。
游戏还附带解释上述选项的 TetrisGameReadme.txt 说明书。

=== AI ===
* <code>delay</code> - 仅在<code>turnbased</code> 关闭下生效，控制 AI 的思考间隔，单位为帧<ref group="注" name="fps">MisaMino 以60fps运行。</ref>。
* <code>move</code> - 仅在<code>turnbased</code> 关闭下生效，控制 AI 每步操作后的延迟，因此该值对 AI 的实际速度影响更大，单位为帧<ref group="注" name="fps" />
* <code>4w</code> - 控制 MisaMino 是否考虑 [[4w]] 堆叠。根据说明书，游戏推荐玩家只在 [[TOJ]] 规则下开启 4w 思考。<ref group="注"><pre>combo_table_style=1;
style=1, 2, 3; //三者取一
GarbageCancel=1;
GarbageBuffer=1;
GarbageBlocking=1</pre></ref>

=== AI_P1/2 ===
* <code>style</code> - MisaMino 的思考策略，整数型。
{|class=wikitable
|-
! 值 !! 0 || 1 || 2 || 3 || 4 || 5 || -1 
|-
! AI类型 || 人类<ref group="注">若将 AI_P1 改为非零值，即可观看 AI 互搏。但 MisaMino 不支持人人对战（即使将这两个值都设为零）。</ref> || T-Spin+ || T-Spin || Ren || Non-Hold || Downstack || 载入指定 .dll 文件
|}
* <code>level</code> - AI 能“看”的预览数量，默认为4，可调0-8。数值越高，思考效率越高。
* <code>PieceMul</code> - 回合制中，玩家放一块，AI 放块的数量。只能是整型。非法数据类型将被 1 覆盖<ref group="注">也即不能玩家放 n 块，AI 放一块。</ref>
* <code>dllplugin</code> - 作用未知，似乎是为程序员准备。

=== Rule ===
* <code>turnbase</code> - 布尔值，是否开启回合制。
* <code>KOS_turnbase</code> - 布尔值，是否开启 [[King of Stackers]] 式回合制。
* <code>spin180</code> - 布尔值，是否允许 180 旋转。
* <code>GarbageStyle</code> - 整形值，影响垃圾行空洞的连续程度：
{|class=wikitable
|-
! 值 !! 0 || 1 || 2
|-
! 垃圾行规则 || [[TOJ]] || 两行变一次 || 一行变一次
|}
* <code>GarbageCancel</code> - 布尔值，是否允许[[相杀]]。
* <code>GarbageBuffer</code> - 布尔值，是否有垃圾缓冲槽。
* <code>GarbageBlocking</code> - 布尔值，是否允许垃圾行阻挡。
* <code>samesequence</code> - 布尔值，控制双方序列是否相同。
* <code>combo_table_style</code> - 连击表，默认使用 1。
{|class=wikitable
|-
! 值 !! 0 || 1 || 2
|-
! 连击表类型 || 0,0,1,1,2,2,... || [[TOJ]] || [[TF]]
|}

=== Player ===
* <code>das</code> - [[DAS]]，单位为帧（60fps，故与其他[[现代方块]]兼容）。
* <code>softdropdas</code> - 软降 '''ARR'''，单位为帧（60fps，0为[[瞬降]]）
* <code>softdropdelay</code> - 软降 '''DAS'''，单位为 1/10 帧<!--有待从代码层面解释， Zap 都吐槽这玩意了... -xb 22.9.18-->

=== Sound ===
* <code>p1sfx</code> - 布尔值，是否开启 P1 音效。
* <code>p2sfx</code> - 布尔值，是否开启 P2 音效。
* <code>bgm</code> - 布尔值，是否开启背景音乐。背景音乐似乎直接来自 TOJ 的拆包文件。

== 机能 ==
Misamino 可以提前思考多个操作，这点与其他方块 AI 不同。<br>
此外，机器人会考虑软降到底（瞬降）之后的移动和踢墙（包括 SRS 踢墙）。这让它能够打出 [[T-Spin Triple]]（虽然 AI 算法会尽可能避免无意义的 T3）。<br>
当然，计算一包方块内所有的摆放情况将花费大量时间。所以，即使考虑下一块，机器人在前往下一级前，只计算一部分可能的场地。下面给出无暂存环境下， 2 级 AI 的工作机制：

* 生成当前块所有的摆放情况（0 级场地）
* 为所有可能的场地情况打分（孔洞个数、场地的水平程度、消除和发送的行数），并对所有情况按分数进行排列。
* 为"最佳" 0 级场地（得分最高的场地）生成下一块的所有摆放情况，对次佳 0 级场地进行同样的操作，以此类推。在一段时间后停止（不生成较差场地的子场地）。所有生成的场地称作 1 级场地。
* 为所有 1 级场地打分并排序。
* 重复上述步骤：计算 1 级场地下，下一块的所有情况，在一段时间后停止，打分并为这些 2 级场地排序。
* 摆放当前块，这一摆块方法为 2 级场地下最优摆法。

== 注解与参考 ==
{{reflist|group=注}}
----
{{reflist}}

== 外链 ==
* [https://github.com/misakamm/MisaMino GitHub 仓库]
* [https://harddrop.com/forums/index.php?showtopic=5292 Hard Drop：misamino]
* [https://archive.org/details/misamino_V1.4.5_sfx Internet Archive mirror：the MisaMino 客户端]

[[Category:方块 AI]]
[[Category:非官方游戏]]