使用说明

一、平台简介

1. open_mahjong_unity 是一款基于 Unity / Python-FastAPI 的麻将平台项目，遵循 MIT 许可协议，免费、开源，支持 PC / 安卓 / iOS 三端互通；目标是支持所有麻将规则，并提供给玩家自定义规则的选项。欢迎加入 QQ 群 906497522 参与讨论、协助和测试。

2. Salasasa（salasasa.cn）是该项目的示例服务器，目前支持国标 / 立直 / 青雀 / 川麻 / 长麻以及一些子规则。

3. 可通过网页版「进入平台」、 Steam 商店 或 手机版 APK 开始对局。点此可进入Salasasa2D客户端，体验不同风格，2D客户端可以与3D客户端互通对局。

二、平台功能

1. 多规则对局：平台支持国标、立直、青雀、四川麻将、长沙麻将等多个规则。

2. 公平性承诺：平台承诺不会对特定的用户或ip针对性的使用控牌，优待等非公平性行为，并且保证自己的核心代码与开源项目open_mahjong_unity的行为一致，详情可见Salasasa-萨拉飒飒麻将平台账户规约

3. 自定义规则：平台提供自由模式，在自由模式中可以使用虚拟牌桌进行不受规则制约的对局；如果想提交自己的规则，也可以通过发起 Pull Request，提交核心代码或委托开发等形式在平台的下一个发行版中发布您的自定义规则，平台官方也会持续推进地方麻将规则的适配进程。具体详见下文「添加自定义规则」。

4. 辅助工具：平台提供 牌理、 国标计算器、 猜番对抗、 规则书 等麻将相关的必要工具。

5. 赛事与数据：平台支持申办赛事与赛事管理，并可查询玩家对局、平台统计、复式密钥查询等所有数据，平台的完整对局数据都公开展示并且支持被用作数据统计、ai训练、制作视频等任意用途，平台也授权任何人均可以使用这些公共领域的数据，任何人都可以随意打包，分发，学习salasasa的对局数据，并且用作商业目的。（玩家账户的段位信息、头像、签名；比赛、基地的公告等非对局数据不在此列）

6. 对局机制：平台致力于推广与发展竞技麻将的完整体验，国标等规则可选开启 鸣牌保护 与 战术鸣牌， 以在网麻中保留部分线下信息节奏与战术空间。日麻也支持流局听牌扣牌等还原真实场景的完整设计

三、开始游戏

1. 点击此处 注册 / 登录 账户，再进入平台对局。此处的账户面板可绑定邮箱、修改密码、申请或管理赛事。

2. 网页对战入口： https://salasasa.cn/game-unity

3. 手机端请下载Android APK；PC端点击此处进入 Steam 商店页，ios端稍缓适配

4. 如有规则方面的疑问，可在此处查询完整的规则书文本；如果在游戏过程中发现任何问题，可以到QQ群906497522反馈，也可以直接联系测试群群主及开发者Q1448826180。

四、鸣牌保护

1. 在玩家 A 出牌时，若玩家 B、C 可对该出牌进行操作，则 B、C 会提前看到这张出牌；玩家 D 则会延迟一个「鸣牌保护时间」才看到出牌。若在鸣牌保护时间内 B、C 对出牌进行了操作，玩家 D 会立刻看见出牌，并在「第一追赶时间」之后再看见 B、C 其一执行的鸣牌申请或鸣牌。

2. 由于玩家 D 必定延迟一个第一追赶时间才看见 B、C 其一的鸣牌，若 B、C 在吃碰后快速出牌，这张出牌在 D 的视角中会显得「即时」。因此平台在触发鸣牌保护后进行出牌时，会保证至少再经过「第二追赶时间」才播放动画，避免在 D 的视角中出牌紧贴在吃碰之后生效。

3. 当前默认配置：

   • 鸣牌保护时间：1.3s
   • 第一追赶时间：0.7s
   • 第二追赶时间：0.5s

五、战术鸣牌

1. 战术鸣牌的设计来源于雀渣：在其他家申请鸣牌以后，可用更高优先级的操作打断他家更低优先级的操作，以模拟线下刻意「碰断吃」等战术。

2. 示例一：玩家 A 出牌 T，玩家 B 可吃、玩家 C 可碰。此时 C 选择跳过，但 B 点击了吃牌；由于仍存在可执行的更高优先级操作，系统会再次询问 C 是否要碰，以模拟国标线下允许刻意用碰打断别人吃的情形。

3. 示例二：玩家 A 出牌 T，玩家 B 可吃或和牌，玩家 C 可碰。B 选择吃，C 用碰打断了 B 的吃；此时 B 不再能用和去打断 C 的碰。这符合国标不允许玩家在鸣牌发声后更改自己要执行动作的规则。

4. 房间配置中可开关战术鸣牌。关闭时走「等待最高优先级操作执行完成」的原始流程。开启时，首次询问仍使用房间步时加剩余局时；只有有效申请后的抢断再询问使用独立5秒，不扣普通局时。

   推倒和（MIL 2024）按规则书第六节允许升级申请：B 吃、C 碰后，B 仍可改报和牌；本张牌主动选择“放弃”则退出竞争。纯真人新房默认开启，有机器人时自动关闭；鸣牌保护是另一项功能。

六、随机种子

1. 为确保公平，每局开始时服务器生成主随机种子（master_seed，256 位）与盐值（salt）。对局进行中只公布承诺值（commitment），主种子在整局结束前不对外公开；结束后公布主种子，供玩家验证服务器未中途更换随机源。主种子贯穿所有小局，并用于开局随机座位分配。

2. 每个小局开始时，系统根据主种子与当前局序号派生局内随机种子（round_random_seed），用于打乱该局牌堆。

3. 对局中可在房间显示局数的左上角左键单击，查看本局承诺值与盐值，浮窗内可一键复制「承诺值：xxxx 盐值：xxxx」。结束后完整主种子会出现在结算界面，亦可在牌谱对局信息中查看，并使用网站 种子验证 （/seed-verify）本地复现随机座位与每局配牌、牌山。

4. 承诺值：将主种子格式化为 64 位十六进制字符串后与盐值拼接，再做 SHA-256。即 commitment = int(SHA256(format(master_seed, '064x') + salt).hexdigest(), 16)。 开局公布的承诺值应与结束后公布的主种子、盐值按上式一致。

5. 局内随机种子：同样将主种子格式化为 64 位十六进制后与局序号十进制字符串拼接，SHA-256 结果作为 random.seed() 输入。局序号因规则而异：立直、古典使用 round_index （从 1 递增，连庄 / 本场也占序号）；国标、青雀使用 current_round （风圈内局号，连庄不递增）。例如日麻东一局一本场， round_index 为 2 而非 1。

6. 开局时还会用主种子对入场顺序中的玩家列表洗牌，得到整局固定座位（牌谱 player_entry_order 记录 shuffle 前的 user_id 顺序）。青雀等规则在特定局数还会用派生局种子随机换位。

7. 牌堆打乱使用 Python random.shuffle() ：先 random.seed(round_random_seed) ，再做 Fisher-Yates 洗牌。相同种子产生相同牌序，过程完全可复现。示例代码：

   import hashlib
   import random
   
   master_seed = 0x1234567890abcdef01234567890abcdef01234567890abcdef01234567890abcdef
   salt = "0123456789abcdef0123456789abcdef"
   commitment = int(hashlib.sha256((format(master_seed, '064x') + salt).encode()).hexdigest(), 16)
   
   sth_tiles_set = {
       11, 12, 13, 14, 15, 16, 17, 18, 19,  # 万
       21, 22, 23, 24, 25, 26, 27, 28, 29,  # 饼
       31, 32, 33, 34, 35, 36, 37, 38, 39,  # 条
       41, 42, 43, 44,                      # 东南西北
       45, 46, 47,                          # 中白发
   }
   hua_tiles_set = {51, 52, 53, 54, 55, 56, 57, 58}  # 春夏秋冬 梅兰竹菊
   tiles_list = []
   for tile in sth_tiles_set:
       tiles_list.extend([tile] * 4)
   tiles_list.extend(hua_tiles_set)
   
   # 立直/古典用 round_index，国标/青雀用 current_round
   round_number = 1
   round_random_seed = int(
       hashlib.sha256((format(master_seed, '064x') + str(round_number)).encode()).hexdigest(),
       16,
   )
   random.seed(round_random_seed)
   random.shuffle(tiles_list)

七、猜番对抗

1. 请先使用 salasasa 游戏账号登录后再进入猜番对抗。

   猜番对抗

2. ■ 个人训练、创建房间、匹配

   • 个人训练

     开启单人猜番

   • 创建房间

     开设联机房间，不计统计数据

   • 规则集：立直、BO5、限时60s、8次猜番机会、计入排行
   • 规则集：国标+立直、BO5、限时60s、8次猜番机会、计入排行

3. 什么是关联提示

   黄色提示代表所猜番种的一列数据与正确答案的对应数据列存在以下任意一种关联：

   • 同义、同名关联：两个规则中的同名番，或共享同一种番型的同义番。例如答案是立直「一气通贯」，猜国标「清龙」，名字显示黄色；只有猜中题库中的那个具体番种才显示绿色。
     示例 1：答案一气通贯 [一气通贯、清龙]，猜出清龙 [清龙、一气通贯] 时名字一侧会显示关联的黄色提示。
     示例 2：答案平和 [国标]，猜测时选择平和 [日麻]，同名的平和一侧会显示关联的黄色提示。
     示例 3：答案全大 [全大，全中，全小]，猜出全中时名字一侧会显示关联的黄色提示；只有猜中全大本身才显示绿色。
   • 类型关联：在答案是多类型番时，猜测到该类型番的任意一个副类型时，则显示黄色；只有猜中具体番种的主类型时，才显示绿色。
     示例 1：答案组合龙 [顺子系、全不靠系]，猜出三色三步高 [顺子系] 时番种类型一侧会显示关联的黄色提示。
     示例 2：答案里宝牌 [条件系、偶然系]，猜出立直 [条件系] 时番种类型一侧会显示关联的黄色提示。
   • 浮动番数关联：同一立直役可能因门清、副露拥有两个番数。例如一气通贯为门清 2 番、副露 1 番；猜测命中该役的另一种合法番数时显示黄色，命中本题实际抽到的番数才绿色。
     示例：答案一气通贯 [2, 1]，猜出红宝牌 [1] 时番种番数一侧会显示关联的黄色提示。

   关闭关联提示：所有上述黄色提示都会变成灰色，只保留完全匹配的绿色和数值方向箭头，提升对局难度。

4. 同时拥有多个值的番种是如何标定的

   1. 出现概率原则：组合龙复合全不靠的概率为 29.3%（161/550），因此组合龙应当被优先计为顺子系、其次再被计为全不靠系，即 [顺子系、全不靠系]。
   2. 先置逻辑优先原则：在能够预测到导致和牌的行动的具体番数的情况下，优先记条件系，其次记偶然系。例如一发、里宝牌、抢杠、岭上开花、海底捞月应当记 [条件系、偶然系]；天和、地和应当记 [偶然系]；立直、双立直、和绝张应当记 [条件系]。
   3. 复计只计其一原则：在可以复计的番种当中，例如四归一、花牌、红宝牌，应当计单个番种的番值，例如四归一应当记 [2]。
   4. 食下役一律副值原则：涉及食下的番种，应当以番种门清状态下的原生番数为主番数，食下番数为副番数，例如纯全带幺九应当记 [3、2]。抽题时答案番数一律取主番数（门清原生番数），例如纯全带幺九抽 3 番、混全带幺九抽 2 番。
   5. 声明特殊番种原则：四归一的组数规定为 [4、3、2]；组合龙、九莲宝灯的组数规定为 [1]；全不靠、七星不靠与一色系番种的组数规定为 [全体]；对子系的组数规定为 [7]；流局满贯的番数为 [5]。
   6. 避免重复猜取原则：涉及番种意义相近但是需要重复猜取的番种将会开启关联提示或合并，例如答案「全大」的番名规定为 [全大，全中，全小]，答案「宝牌」的番名规定为[宝牌，赤宝牌，里宝牌]，答案「海底捞月」的番名规定为[海底捞月，河底捞鱼，妙手回春]；役牌·白、役牌·中、自风·南等番种合并为役牌、自风与场风。立直与双立直、混一色与清一色之类猜取较为简单的不设关联提示。

5. 番种如何归类

   • 顺子系：由特定顺子组合构成的番种，例如清龙、三色同顺、三色三步高等。
   • 刻子系：由刻子、雀头或杠构成的番种，例如小三元、三暗刻、三风刻等。
   • 对子系：由对子构成的番种，例如七对子、连七对、大七星等。
   • 全体系：满足整手牌固定特征的番种，例如清一色、断幺九、全带五、全带幺；组数显示「全体」。
   • 全不靠系：包括全不靠、七星不靠、组合龙（副归类）等。
   • 特殊系：由特殊规定的牌型和牌构成的番种，例如十三幺、九莲宝灯。
   • 条件系：满足特定条件构成的番种，例如立直、一发、门前清、不求人、岭上开花（副归类）、宝牌等。
   • 偶然系：满足偶然条件构成的番种，例如岭上开花、里宝牌、宝牌（副归类）等。

6. 对战与排行

   个人训练和自建房可选择 6、8、10 或 12 次猜测机会，以及 40、60、80 或 100 秒限时；系统匹配固定为 8 次、60 秒。有人猜中、次数用尽或时间结束后展示答案与双方猜测，6 秒后自动进入下一局。

   匹配分为「国标+立直」与「立直」两个池，各自独立排队与计分；排行榜默认展示国标+立直，可切换成立直查看。

   只有系统匹配计入排行榜。战胜高分对手获得更多积分，负于低分对手扣分更多。

7. Elo 积分规则
   初始 1000 分，仅系统匹配计分，自建房不计。
   K 值为 32：胜者加分与败者扣分数值相同。
   战胜高分玩家加分更多，战胜低分玩家加分更少；反之亦然。
   计算式：变化值 = 32 ×（实际结果 − 预期胜率），结果四舍五入。

八、申办赛事

1. 提交办赛申请

2. Salasasa 平台赛事规约

   1. 赛事的组织、奖金等各项成本开支不得低于报名费的 80%，如赛事奖励中提供更上级比赛名额或特殊奖励的，可以进行独立核算。
   2. 收取报名费的赛事必须明确规定赛事规则与奖励方式；该内容同样受赛事介绍中平台可能对赛制争端进行介入的声明约束。
   3. 涉及烟、酒、槟榔等成瘾品赞助的赛事，须提前联系平台管理员后再申报。

3. 赛事名称

   赛事名称必须提交中文、英文或其他语言的完整赛事全称，不得使用简写、表述不清或者有公共性质的赛事名称；错误案例：国标麻将比赛、FST杯；正确案例：第一届神秘嘉宾杯国标麻将比赛、咕咕嘎嘎国标麻将群内赛。

4. 拟定开始时间 / 拟定结束时间

   拟定开始时间和结束时间只是申请的开启赛事和关闭赛事的大致时间范围，赛事的开启与关闭将由比赛管理员自行决定； 如果是长期的月赛或者季度赛，可以不设截止时间或连续申报比赛，在确定拟定日期以后也可以随时进行更改。

5. 赛事介绍

   赛事介绍中必须包含明确的报名联系方式，对于实际赛程这里可以不予规定、即使予以规定，后期也可以进行更改。但是，如果赛事在实际赛程中规定了某些赛事规则或者奖励方式但未达成，或者在临时更改赛制以后出现了争议或争端，平台也会一定程度上对赛事进行一些介入监管；包括且不限于，批评、取消办赛资格、封禁个别账户等惩罚，请务必注意这一点。

6. 赛事负责人

   请填写真实姓名与24小时内能够联系上的联系方式，手机号仅作为实名验证使用，如果不希望平台使用手机号进行联系，可以在备注内填写偏好的联系方式，平台绝不会通过偏好联系方式以外的方式联系您；如果不希望暴露真实姓名，可以填写惯用id，只需要手机号是实名的即可。

7. 备注

   给予管理员的说明，或不希望在公开介绍中展示、但需预先告知的特殊声明。修改申请、保存修改、重新提交时填写的内容会按时间追加到双方往来备注栏。

8. 赛事管理

   查看办赛申请与已注册赛事；点击「管理」在下方展开管理面板。

九、添加自定义规则

1. 平台会逐步添加现存的地方麻将规则。若有想添加的自制规则，可咨询管理员 Xe，或阅读本节说明。添加自定义麻将规则有三种方式：① 提供核心逻辑文件，由项目组简单适配；② 发起 Pull Request，将新规则合并到 GitHub 仓库；③ 提供规则文件，委托项目开发人员开发。

2. 委托开发的规则会上传到公共代码仓库。若使用 PR，最好先在测试群沟通。提交到 git 时若无特殊声明，默认接受本项目 MIT 协议。公共平台不保证持续服务；若关停，规则制定者可自行部署服务器。

3. 一条规则的执行逻辑由三部分组成：

   • 麻将游戏服务器：匹配玩家状态与操作（切牌、吃碰杠、自摸、荣和等；以及补花、九种九牌、四风连打、换三张等特殊操作）
   • 听牌检查脚本：判断手牌是否符合合法听牌形状
   • 和牌检查脚本：结算和牌组合的牌型与分数

4. 若自定义规则只含基础操作，或可复用已有规则的操作，可不提供服务器脚本；若听牌仅含一般形、七对、十三幺、全不靠等常见牌型，可复用现有听牌检测；多数规则变化集中在和牌番役，一般只需提供完整和牌检查脚本。

5. 小贴士：服务器为 py-fastapi，服务器脚本需为 py 文件；听牌 / 和牌脚本可为 py、so 或其他语言编译产物。若需在客户端切牌后提示番数，因在 Unity 中执行，需提供 C# 源文件或编译后的 dll。开发文档见 开发手册。

十、赋分

1. 持有国标业余或职业段位证书者，可通过证书认证获得不大于 1 级的段位赋分，或申请 MCRPL 资格。

2. 申请时请附上：

   • 数字 UID
   • 段位（及证书）
   • 网麻战绩（可选）

3. 具体认证可在测试群联系群主 Xe 办理。

十一、参与项目

1. 若想对项目本身提出意见、提交美术 / 音频资源或 Pull Request，或希望私有部署、关注项目进展，可加入 OMU 平台开发群 1084537740。

2. 代码仓库见 GitHub； 开发文档见 开发手册 。日常游玩与 bug 反馈请优先使用交流测试群。

十二、赞助

赞助可联系群主Xe，赞助者在数据站可以额外获得下载牌谱的限额，也可以提前准入中级场，赞助100元添加鸣谢名单

十三、鸣谢

• 开发团队Xelnaga(主程) 雪枫XueFun9(牌面提供者) Zoe(随机种子设计) Natsuki(新编MCR编著者) 坏狗影子(表情包提供者) GitHub/baisebaoma(高性能罗伯特设计) troooobot(长沙麻将实现) Zoe(台湾麻将实现) 二階堂 ヒロ(中心盘设计) 莫莫柴(青雀、2D桌面) Shq、Zoe(bug修复) salasasasa数据bot(PCX1078) 插件开发(新手求教)
• 自定义规则设计莫莫柴(青雀) 关兆豪先生(中庸麻将) Null(虹雀) K神传说(K神麻将) 恋绘色(香港清章恋绘色魔改) 小林(国标小林改) 蓝十(国标蓝十改) 自恧(浪涌麻将) 南瓜饼(南雀)
• 地方规则考据上海清混碰(何苏) 古典麻将(莫莫柴、何苏、古明地梦) 宜兴麻将(苦鱼) Mil推广规则(MIL国际麻将联盟)
• 直播宣传Cloud980Ti 轻轻的飘 等候1234 立直喵 Ce/Est1al 鬼头刀鱼fish 神源之心 方片杰克 Ni9e_9 大柠劳斯
• 赞助九曜、kiki、健哥、何苏、Null、莫莫柴、恋绘色、Zazaka、中山大学国标麻将同好会、东西喵、山东大学老年人活动中心、Sw123
• 特别感谢莫莫柴、码龙、Null、坏狗影子、何苏、FFMJ法国麻将协会(翻译支持)
• 支持社团棋牌游戏研究院、立直麻雀研习社、柴の麻将群、雀渣玩家群、中山大学国标麻将同好会
• 早期测试夜色祢 chlorine 陪练的命运

以及游玩salasasa平台的所有玩家！

十四、相关链接

• 官方服务器：salasasa.cn
• GitHub：github.com/xelnagamiao/open_mahjong_unity
• 语雀文档：开发手册
• 交流测试群：906497522
• OMU 开发群：1084537740
• 语音聊天室：oopz.cn/i/zzCOJF
• Steam：Salasasa 商店页

十五、萨拉飒飒平台规约