samp-kook-connector 插件 Wiki

将 Kook 机器人集成到你的 SA-MP / open.mp 服务器游戏模式中。

1. 安装
   
2. 重要说明
   
3. Natives（原生函数）
   • 频道
     
   • 消息
     
   • 用户
     
   • 身份组
     
   • 服务器
     
   • 机器人
     
   • 嵌入消息
     
   • 表情
     
   • 反应
     
   • 其他
     
4. Callbacks（回调函数）
   • 频道回调
     
   • 消息回调
     
   • 用户回调
     
   • 服务器回调
     

1. 访问 https://developer.kookapp.cn/
   
2. 创建一个新的应用 / 机器人
   
3. 输入机器人名称并完成创建
   
4. 从机器人设置页面获取你的 机器人令牌（Bot Token）
   
5. 通过开发者门户或邀请链接，将机器人邀请到你的服务器
   

引用:注意事项：

• 永远不要将机器人令牌分享给任何人
  
• 确保服务器时钟定期同步，否则速率限制器将无法正常工作，机器人可能会被封禁
  
• 此插件专为 open.mp (OMP) 服务器设计
  

引用:关于 Kook ID 与内部 ID：
Kook ID 是一个很大的数字，无法放入 PAWN 的 32 位整数中。因此插件采用两套 ID 体系：

• Kook ID：Kook 平台使用的真实 ID，必须以字符串形式传递
  
• 内部 ID：插件内部使用的整数索引，通过 KCC_Find* / KCC_Get* 系列函数获取
  

你的脚本只需持有内部 ID（索引），插件会在内部维护与真实 ID 的映射关系。

引用:关于发送私信：
向用户发送私信需要两步：

1. 调用 KCC_CreatePrivateChannel(user, "回调函数名") 打开私信频道
   
2. 在回调函数中调用 KCC_GetCreatedPrivateChannel() 获取频道 ID
   
3. 使用该频道 ID 调用 KCC_SendChannelMessage 等频道函数发送消息
   

引用:用户的 discriminator 是附加在 Kook 用户名后的 4 位数字标识。

引用:dest 字符串大小必须为 DCC_ID_SIZE。

引用:dest 字符串大小必须为 DCC_ID_SIZE。

引用:dest 字符串大小必须为 DCC_EMOJI_NAME_SIZE。

• message：消息内部 ID
  
• reaction_user：操作反应的用户内部 ID
  
• emoji：使用的表情内部 ID
  
• reaction_type：反应事件类型（添加 / 移除等）
  

• channel：语音频道内部 ID，用户离开语音时该值可能无效
  

圣安地列斯联机二十年：SA:MP 与 open.mp 历史

前言

引用:本文以客观事实为准绳。所有关键事件、人物声明、原始帖文，均完整收录于正文之中，不以外部链接替代实质内容。链接仅作考证索引，供读者溯源查验，不构成叙述本身的一部分。

凡引用原文处，均以引用块标注，并注明来源与时间。凡转述处，均忠实于原意，不加渲染，不作价值评判。

这是一部关于热爱、控制、背叛与重建的故事，也是一个游戏社区在二十年间走过的记录。

卷首语：一个不该有多人模式的游戏

第一卷：诞生（2004–2006）

第一章　从 Vice City 到 San Andreas

引用:"[WIP] SA-MP: Multiplayer for San Andreas PC"
——kyeman，GTAForums，2005年4月3日

第二章　合作模式的争议与团队第一次动荡

第三章　2006 年：第一个可玩版本

第二卷：黄金时代与暗流（2006–2009）

第四章　版本迭代与社区的兴盛

第五章　Y_Less 的双重身份与 YSI 的诞生

引用:"加入开发团队之后，我开始开发 Pawn，但我发现自己能做的事被 Kye 严重限制。我们之间存在重大的意见分歧：他认为 90% 的开发精力应该投入同步（sync）工作，Pawn 几乎只是顺手提供一点额外功能的附属品。而我认为，虽然同步很重要，但他已经把同步覆盖得很好了，我更想专注于 Pawn 的功能与函数。然而他是老板，说了算，严重限制了我被允许做的事。此外，他有个坏习惯——每次版本迭代之后，只要在某个细枝末节的测试中有任何不稳定，就要来指责我，尽管测试本来就是我们有 beta 测试团队的原因。不用说，这不是一个好的工作环境，但我仍然喜欢 SA:MP 这个产品本身。"

引用:"2007 年，我开始开发 YSI。这部分是对若干早期工具的更新与整合，部分也是在 Kye 的控制之外，以 Pawn 能力范围内的方式带来我认为 Pawn 所需的扩展功能——尽管以纯 Pawn 来做，能实现的事情自然有其上限。YSI 成为我的主要项目这一事实惹恼了 Kye，因为他认为这说明我没有把时间花在 SA:MP 上，尽管我实际上一直都在。"

引用:"最初的想法是'Y[i]Less' Server Includes'，但 Server 和 Script 经常被混用，而且现在参与的开发者不止 YLess 一人，所以'Y'就变成了一个递归缩写，代表'YSI'本身。"[/i]

第六章　2008 年底：GTANet 风波与团队大出走

引用:"2008 年底，GTANet 风波爆发，Mike、aru 和 Peter 因此离开，我也因为团队氛围实在太差，加之大家都在走，便也一同离开了。"

引用:"不知为何，真的记不清了，我之后又重新加入了团队。那时候 Kye 想要关闭 SA:MP，我提出愿意接手，他拒绝了。然后我再次退出——不是因为我没接手到，这一点需要说明——于是 Kye 决定封禁我的论坛账号，而且不只是封号，而是彻底抹除——删掉了我所有的帖子。这意味着原版《实用函数》帖没了，旧版 FAQ 帖没了，大量迷你教程没了，《Pawn 关键词》帖也没了——我只有在非常必要的时候才发帖，那些帖子都有其存在的价值，它们的消失被大量用户注意到并提出了强烈抗议。"

第七章　2009 年 1 月：YSF 封号事件

引用:"YSF 是我最成功的项目，因为它做到了所有人都想要的事。它本质上是一个更新版的服务端——人们总是渴望新版本带来修复和新功能，功能方面已经有其他插件（包括 YSI 插件）覆盖了，所以我选择了修复这条路（以及一些小功能——显然正是这些小功能引发了麻烦）。"

引用:"这实际上并非盗用，但我承认看起来非常相似，因为它做的事情完全一样，而且也不是什么复杂的函数，我懒得争，就直接把它彻底重写了。"

引用:"就在我们讨论同意 YSF 可以继续存在，之后，他发现了 SetServerRule，并意识到它可以用来修改只读控制台变量——比如服务器版本号——从而让人们能够违反 SA:MP 服务条款第（g）条：'你不得人为地增加玩家数量，或向 SA:MP 查询机制提供虚假信息。'"

引用:*"抱歉 ssǝן‾ʎ，你已被禁止使用本论坛！
滥用前开发者身份。入侵服务器，并为他人违反服务条款提供手段。"*

引用:"基本上，我因为 YSF 被 SA:MP 官方论坛封号了！

历史：

200x 年（实在记不清了），在与 Spookie 讨论之后，我以 beta 测试员的身份加入了 SA:MP 团队——那还是第一次公开 beta 之前的事——并开始编写 Pawn 相关的代码。

没过多久，我正式加入了开发团队，专注于 Pawn 的开发，但我很快发现自己受到 Kye 的诸多限制，做不了想做的事。我们之间存在重大分歧：他认为 90% 的开发精力应该用于同步（sync），Pawn 只是顺手提供一点额外功能的附属品；而我认为，虽然同步很重要，但他已经把同步做得很好了，我更想把时间花在 Pawn 的功能扩展上。然而他是老板，说了算，严重限制了我能做的事。更让人受不了的是，他有个习惯——每次版本迭代后，只要在某个犄角旮旯的测试里出了任何小问题，就要来责怪我，哪怕我们有 beta 测试团队本来就是为了发现这些问题的。说实话那不是一个好的工作环境，但我还是喜欢 SA:MP 这个产品本身。

2007 年，我开始开发 YSI。这一方面是对此前一批旧项目的整合升级，另一方面也是想在 Kye 的管控之外，以纯 Pawn 脚本的方式实现我认为 Pawn 所需要的扩展功能——尽管能做到的事情有限，毕竟纯 Pawn 本身有其局限（我确实额外添加了一些辅助函数，比如 player objects 功能完全是为了写我最初的对象流式传输器 e\_objects 而专门实现的）。YSI 成为我的主要项目这件事惹恼了 Kye，因为他觉得我没有把时间花在 SA:MP 上——尽管我实际上一直都在。

2008 年底，GTANet 社区风波爆发，Mike、aru 和 Peter 因此离队。我也因为团队氛围实在太差，加上大家都在走，便也跟着离开了。

不知为何（真的记不清了），我之后又重新回归了团队。那时候 Kye 想要关闭 SA:MP，我主动提出愿意接手，他拒绝了。然后我再次退出——不是因为没接手到，这一点需要说清楚——于是 Kye 决定封禁我的论坛账号，而且不只是封号，而是彻底抹除，删掉了我所有的帖子。这意味着原版《实用函数》帖没了，旧版 FAQ 帖没了，大量迷你教程没了，《Pawn 关键词》帖也没了——我只有在非常必要的时候才会发帖，那些帖子都有其价值，它们的消失被大量用户注意到并提出了抗议。

不管怎样，我还是喜欢 SA:MP 和这个社区本身（至少喜欢其中的一部分），所以我还是留了下来（现在回想起来真不知道当时为什么，深感后悔），并继续努力让 SA:MP 变得更好——尽管 Kye 的存在让这件事很难。我继续开发 YSI、写教程和帮助帖，后来又创作了 YSF。YSF 大概是我最成功的项目了，因为它做到了所有人都想要的事。它本质上就是一个改进版的服务端——人们总是渴望新版本带来修复和新功能，功能方面已经有其他插件（包括 YSI 插件）覆盖了，所以我选择了专注于修复这条路（以及一些小功能——显然正是这些小功能引发了这次麻烦）。

总之，Kye 和我一般都各自行事、互不干扰（至少我是这么以为的），有一段时间相安无事。直到 2009 年 1 月 19 日，我收到了 Kye 的消息，说他不太喜欢我在 YSF 里做的事。经过一番交涉，才明白他的顾虑在于：YSF 可能与未来版本的脚本产生兼容性问题（这话从他嘴里说出来真是讽刺——我当初就反对过他把默认运行方式改掉，以及 0.3 版本里删除对象的决定，但他否决了我；对象最后是改成了 IPL 文件的形式，而非完全删除，但也没有了 per-player objects，至少我最后听到的消息是这样）。此外，他还质疑 YSF 里有 SA:MP 服务端的源代码——他举的例子是 functions.cpp 里的 IsNickInvalid 函数。这个函数其实不是照抄的，但我承认看起来确实很像，毕竟它做的事完全一样，而且也不是什么复杂的函数，我懒得争，就直接把它彻底重写了。在我指出 YSF 并不会造成兼容性问题（恰恰相反，它让脚本对未来版本的兼容性更好），并同意日后不再使用 SA:MP 源代码（尽管我此前一直在刻意避免这样做）之后，他让步了。

第二天我上论坛，发现自己已经被封了……

原来在我们达成共识之后，他又发现了 SetServerRule 这个功能，意识到它可以用来修改只读控制台变量（比如服务器版本号），从而让人能够违反 SA:MP 服务条款第（g）条：'你不得人为地增加玩家数量，或向 SA:MP 查询机制提供虚假信息。'

我解释说，我本人根本没有这样做，这个功能的设计初衷是好的，只是不幸被人滥用了。我甚至想过反问他：他提供论坛和 IRC 频道，同样也给人们提供了违反条款（c）（d）条的方式，按他的逻辑，他也应该被封号——但我懒得说了。封号通知的原文是：

'抱歉 ssǝן‾ʎ，你已被禁止使用本论坛！滥用前开发者身份。入侵服务器，并为他人违反服务条款提供手段。'

所谓'滥用'，是指我用它改善了所有人的游戏体验；所谓'入侵服务器'，是指我修复了它；所谓'提供手段'，意思是人们可以拿我提供的工具做坏事——但这不代表我支持或认可这种行为，这只是一个有用工具所带来的无奈副作用。

Kye 说 YSF 的事已经覆水难收，他只能发布新版本来屏蔽它，伤害已经造成，它已经广泛传播，人们正在用它黑自己的服务器，没有人能阻止，所以我必须被封。我回应说，如果我没被封，我本来可以发布最新版本，在修复拾取物 bug 的同时，加入对规则的只读标志检查——虽然这无法彻底解决问题，但能大幅减少滥用，因为几乎没有人会主动把它改回旧方式，大多数人会为了这个重要修复而升级。说到这里，他就不再回复我了（我觉得他是意识到自己断掉了快速、高效解决这件事的唯一合理途径，然后不想认账了——如果不是这样，我欢迎他来回应）。

总之，我决定把当时正在写的那段代码（YSI 的示例脚本）收个尾，毕竟我还是喜欢使用 YSI 的那些人，上传最终版本，然后就此结束。

所以，截至目前：YSI 1.0、YSF 1.0、YSI2 1.0、YPI 1.0，到此为止，我不干了。

附言：Kye 正在研究一种过滤"修改版本服务端"并将其列入黑名单的机制——我可能会发布一个不自动修改版本号的 YSF 版本，这样用它的人就不会因为我的失误被连坐；请留意这里的动态（我可能也会顺带加入拾取物修复，但不会保留只读变量相关的功能）。

附言二：IRC 才是王道，我还活跃在 GTANet 的大量频道里，包括 #YSI 和 #Y_Less，欢迎来找我。

附言三：不知道 MTA 的源代码长什么样……"

第三卷：停滞、管控与分歧（2014–2019）

第八章　0.3.7 之后的沉寂（含源码泄漏事件）

源码泄漏事件（2010 年起源，2018 年爆发）

引用:"SA:MP 的源代码于 2010 年被一名法国人从我们的服务器上黑掉，目的是为 IV:MP 这个 mod 服务。我记录并上报了这次入侵。

GitHub 上大约有十个副本。我一直没有把它们下架，是因为提交 DMCA 申诉需要将我的真实姓名录入 GitHub 的公开 DMCA 数据库，否则就得花钱请律师。"

引用:"0.2.5 的源代码是通过计算机入侵从我们的服务器上盗取的。任何基于该代码发布软件的人，都涉嫌与我们作对的刑事共谋。

SA:MP 所使用的 RakNet 版本并非开源，而是通过付费许可证使用的。BASS 音频库同样是付费许可证使用的。整个游戏 mod 社区正在被那些删除原始版权信息、将他人成果冒充自己作品重新发布的蠢货所伤害。

我给他们几天时间关闭并停止任何与 SA:MP 相关的活动。"

第九章 Kalcor 眼中的历史：MTA 的旧账、R\* 的源码，与闭源的真实理由

引用:那么，请允许我给你们讲一段历史。结论由你们自己得出。

2003 年，在 MTA 的 IRC 频道上待了一周之后，我被邀请加入 MTA:VC（Vice City Multiplayer）的开发。几个月后，我晋升为 MTA 的首席开发者。以下是一张截图，记录了我和 Si|ent 一起尝试让 MTA:VC 中的船只同步正常工作的画面，日期是 2003年12月31日。

我是 MTA:Blue 的少数开发者之一——这是 MTA 针对罪恶都市的新版本。那时候除我之外，大多数人都被现实生活拖住了。我开发了玩家上下文切换同步系统，并引入了 RakNet 库。同样的系统至今仍被 SA-MP 和 MTA:SA 所使用。

这种处境让我感到沮丧——一周又一周过去，只有我一个人在提交代码，而论坛上却有一堆"开发者"在大谈特谈一切将会如何运作。

于是我离开了 MTA 的开发。在我离开期间，另一个叫 eAi 的人加入了项目，开始研究我的代码，试图弄清楚它是怎么工作的。至少有人在做事了——他的方式是去主动联系各方，于是他通过 ICQ 找到了我，还找到了 R（Rockstar Games）开发者的电子邮件地址，并与他们取得了联系。*

那时候我对 GTA 多人联机并不感兴趣。我有一个乐队，还参与了 ipodlinux 等项目，但 eAi 似乎非常热衷于推动 MTA:Blue 取得进展。于是我重新加入了项目，持续了几个月。

以下是 2004年底 MTA:Blue 的公开宣传页面存档。

正是这件事导致了我和 MTA 其他开发者之间的决裂：我想要构建一个服务端系统——就像 VC-MP 的 ini 脚本系统，以及 SA-MP 中基于 Pawn 脚本的服务端系统；而 MTA 的开发者们则想要客户端扩展，就像那个宣传页面上描述的那样。

2005年初，我再次离开了 MTA。就在那段时间，R North 在 PS2 上发布了 GTA:SA，并正在开发 PC 版本。eAi 与 R 的技术总监有联系，还通过 ICQ 向我炫耀说，他拿到了大量 GTA:SA 源代码的头文件。我注意到，MTA 的开发者们似乎打算放弃罪恶都市版的 MTA:Blue，转战 GTA:SA。

不相信 MTA 及其开发能力，2005年中，我开始独立开发自己的多人联机。我发布了 VC-MP，基于玩家上下文切换和 RakNet。

随后，我与 jax、spooky 以及其他一些人一起开发了 SA-MP。它远比之前的 mod 庞大得多。我们与 GTANet/GTAForums——最大的 GTA 非官方粉丝站——有着较为密切的联系，这使我们获得了更大的知名度。

到 2008 年，SA-MP 的玩家数量是 MTA 的 10 到 20 倍。MTA 的开发者们感到在这种竞争环境下已无法与之抗衡，于是他们公开了自己的源代码。MTA 的开发者们从未询问过我或任何前任开发者，是否可以公开这些源代码。他们声称所有东西都已经被重写了，但事实并非完全如此。时至今日，MTA:SA 中仍然有我的代码。我没有费心去追究他们，因为他们看起来太蠢了——但我猜，这里那些呼吁公开 SA-MP 源代码的人，很可能是受到了 MTA 的启发，尽管他们或许不应该这样。

而这就是现在正在发生的事：我为 MTA 开发的"游戏"代码，以及 R\ 给 MTA 的源代码，正在被移植进 mod\so\beit——一款流行的 SA-MP 外挂工具。*

你们知道这意味着什么吗？R\ 给 MTA 的那部分源代码，有相当大一部分被用来——攻击 SA-MP！*

从一小批相当专业的 MTA 开发者起步，这件事已经演变成了极度肮脏的东西。那些想要摧毁 SA-MP 的人，对于是否违法毫不在意。

看起来，任何被公开的源代码都可能被用来攻击 SA-MP——尽管它本可以被用于提供有价值的更新。

公开 SA-MP 源代码这个决定，归根结底取决于：我们是否仍然处于这种充满敌意的环境中——人们在攻击我、想要攻击 SA-MP——还是这一切已经成为过去。我想说，这取决于 mod 的规模以及对外挂工具的需求程度。封闭源代码让我可以在每次发布时重新洗牌所有内部结构，使大量外挂工具失效。SA-MP 的许多"安全"更新，实质上就是我在重新排列数据，以清除现有的外挂工具。

最终，SA-MP 将会走到这样一个时刻：所有人都彼此友善和尊重，外挂与欺诈变得罕见——但届时玩家数量将极为稀少，我们中的大多数人也已不在了。

引用:BloodMaster 写道：「SA-MP 保留了圣安地列斯原汁原味的氛围和外观，而 MTA 则是一个可以高度自定义的引擎——这正是 SA-MP 吸引更多玩家的根本原因。」

引用:iReal Worlds 写道：「Lua……认真的吗？」

引用:michael@belgium 写道：「想象一下所有人都切换到 Lua……」

• SA-MP → 轻量、易上手，但在某些方面存在局限；
  
• MTA:SA → 体量较重，但功能全面，有时略显复杂，稳定性却强于 SA-MP（玩家们甚至会利用 MTA:SA 的崩溃报告来排查问题——这本身就说明很多问题）。
  

工具

• Community Compiler - 一个大幅更新的编译器版本，包含众多修复和增强功能。
  
• sampctl - 用于安装库和运行服务器的包管理器。
  
• Plugin Runner - 用于直接从命令行运行轻量级服务器版本（无需 server.cfg）以测试插件的工具。
  
• Plugin Boilerplate - 通过样板代码简化插件的创建。
  
• SA:MP Plugin Template Library - 使用此模板库，可以非常轻松快速地制作自己的插件。
  
• SA-MP Fiddle - 一个测试脚本（代码片段、概念验证、调试等）并分享给其他人的地方。
  
• Pawn Syntax - Sublime - 为 Sublime Text 提供的 Pawn 自动补全。
  
• Pawn Syntax - Visual Marketplace - 为 Visual Studio Code 提供的 Pawn 自动补全。
  
• SA-MP Zone Editor - 用于制作区域等的区域编辑器。
  
• SA-MP Map Editor - 流行的 SA:MP 地图编辑器。
  

库

• samp-stdlib - 默认包含文件的更新版本。const 正确、文档齐全且完整。
  
• fixes.inc - 针对大量 SA:MP 服务器错误的高度优化修复。即插即用。
  
• YSI-Includes - 为 SA:MP/pawn 开发的最古老、最大、经过最充分测试且支持最完善的库，提供了大量新的游戏和语言特性。
  
• foreach - 独立的 foreach 包含文件（非 y_iterate 版本）。
  
• amx_assembly - 对 pawn 脚本本身的底层访问。
  
• md-sort - 在 Pawn 中对多维数组进行排序。修改数组的内部指针，而不是复制数据。
  
• indirection - 用于传递指针和间接调用函数的系统，并提供了自定义调用的抽象方法。
  
• code-parse.inc - 在编译时解析和自定义 pawn 代码。
  
• Extended Vehicle Information - 将单人游戏中的大量车辆标志导入 SQLite 数据库。
  
• sqlitei - 为 SA-MP SQLite 函数提供的高级 API。
  
• weapon-config - 更一致、响应更快的伤害系统，并包含许多新特性。
  
• samp-geoip - 基于 IP 地址的地理位置信息。
  
• progress2 - 将时间、生命值、车辆燃料等内容显示为进度条。
  
• GameText+ - 一个为 SA-MP 和 open.mp 改进原生 GameText 的包含文件。
  
• weapon-data - 精细调校、可自定义的武器数据。
  
• MV_Youtube - 用于音频流的 YouTube 转换器 API。
  
• MySQL Prepared Statements - 为 PAWN MySQL 插件模拟预处理语句。
  
• samp-server-weapons - 完全由服务器控制的武器。
  
• actor_robbery - 灵感来自 GTA V 的商店抢劫。actor_robbery.inc 模仿了该功能！
  
• samp-aviation - 一个基于俯仰角的高度自动控制和基于横滚角的航向自动控制的基础系统。
  
• samp-logger - 简单的结构化日志记录器，提供了一组简单的日志记录和调试函数。
  
• TDW Recursion Scanner - 一个查找代码中递归的库。
  
• easyDialog - 简化对话框的通用使用方法。
  
• mdialog - 现代化的对话框系统，类似于 easyDialog。
  
• Model Sizes Plus - 更新、更高级、更精确的旧版 modelsizes 包含文件版本。
  
• physics.inc - 模拟 2D 和 3D 物理效果（真实运动、碰撞等）。
  
• samp-async-dialogs - 使用 PawnPlus 任务的异步对话框处理。
  
• speedcap.inc - 一个控制车辆速度的包含文件。
  
• SA:MP Command Guess - 使用莱文斯坦距离函数为 SA:MP 实现的命令猜测器。
  
• vending - SA-MP 的服务器端自动售货机。
  
• strlib - 一系列实用的字符串函数。
  
• mathutil - 一系列实用的数学函数。
  
• rotations.inc - 一系列实用的旋转函数，来源于 Nero_3D 的 rotations.inc。
  
• SA-MP Distance Functions - 一系列实用的距离检测函数。
  
• New SA-MP callbacks - 一系列实用的新回调函数。
  
• Alternative Dialogs - 具有全新设计的文本绘图对话框。
  
• eSelection - 增加在 SA-MP 游戏模式中创建动态模型选择菜单的功能。
  
• mSelection - 与 eSelection 类似，但风格不同。
  
• RGB-Textdraw - 为文本绘图添加 RGB 颜色支持。
  
• LangPlus - 为 open.mp 服务器提供的多语言库。
  
• beckzy's mod shops - 一个用于服务器端改装店的包含文件。
  

命令处理器

• I-ZCMD - ZCMD 的改进版本。
  
• Pawn.CMD - 比任何其他命令处理器都快。
  
• y_commands - 来自 YSI Includes 的命令处理器。
  

插件

• JIT - 代码稳定后，使用此插件可以显著提高速度。
  
• CrashDetect - 在测试期间用于查找错误的开发工具。
  
• Profiler - SA-MP 服务器的性能分析器插件。
  
• sscanf - 将字符串转换为多个值、整数、浮点数、玩家等。
  
• MySQL Plugin - 将服务器连接到 MySQL 数据库。
  
• Streamer Plugin - 绕过许多 SA:MP 限制，例如物体和拾取物的数量限制。
  
• nativechecker - 在服务器启动时检查原生函数。在 open.mp 中不需要，因为 open.mp 自带原生函数检查机制。
  
• FCNPC - 一个为 SA-MP 服务器添加大量功能给现有标准 NPC 的插件。它在 open.mp 中无法使用，但你可以改用官方的 NPC 组件。
  
• FileManager - 允许你管理根文件夹中的文件和文件夹（通过此插件，不局限于 scriptfiles 服务器目录）。
  
• Pawn.Raknet - 允许你分析 RakNet 流量。
  
• samp-precise-timers - 一个用 Rust 编写的 SA-MP 插件，提供精确计时器。在 open.mp 中不需要，因为 open.mp 自带精确计时器。
  
• PawnPlus - 通过新的结构、数据类型和编程技术扩展 Pawn 脚本语言的可能性。
  
• PAWN memory access - 允许在 PAWN 中从堆中分配和释放内存。
  
• Native Fallback - SA-MP 插件，为未注册的原生函数提供回退实现。
  
• YSF - 一个旨在从服务器中挖掘最大可能性的插件，主要通过内存编辑和钩子实现。它的许多功能现在已经内置在 open.mp 中。请参阅 这个 github issue 了解功能列表。
  
• SKY - 该插件提供底层函数，让 Pawn 脚本能够执行强大的操作。
  
• Pawn.Regex - 为 Pawn 添加正则表达式支持。
  
• pawn-scraper - 一个强大的爬虫插件，提供了在 pawn 中使用 html 解析器和 css 选择器的接口。
  
• TOTP - 允许在 sa-mp 游戏模式中使用 TOTP 身份验证。
  
• DNS Plugin - 该插件提供 DNS 查找和反向 DNS 查找的功能。
  
• MapAndreas - 允许你加载不同的高度图并检查 x, y 坐标处的最低高度。
  
• ColAndreas - 创建一个圣安地列斯世界的模拟。使用 Bullet Physics 库。
  
• PathFinder - 允许你计算圣安地列斯地图上从 A 点到 B 点的路线。
  
• Custom Query Flood Check - 编写针对查询洪水攻击的自定义保护措施。
  
• sampml - 简化的机器学习工具包及相关 SAMP 项目（如自瞄检测）。
  
• TgConnector - 一个电报连接器插件，帮助通过 SA-MP 与电报机器人交互。
  
• Discord connector - 允许你从 PAWN 脚本中控制 Discord 机器人。
  
• TSConnector - 允许你从 PAWN 脚本中控制 Teamspeak3 服务器。
  
• IRC Plugin - 允许通过 SA-MP 服务器创建和管理 IRC 机器人。
  
• pawn-requests - 提供了一个与 HTTP(S) API 交互的 API，支持文本和 JSON 数据类型。
  
• pawn-redis - 授予对快速内存数据库的访问权限，以及与其他程序之间的异步消息通道。
  
• Chrono - 一个用于处理日期和时间的现代 Pawn 库。
  
• rustext - SA-MP 的俄文文本修复插件：修复 GameText、TextDraw 和 Menu。
  
• Advanced SA NickName - 支持昵称中的任何符号。
  
• SAMPSON - 一个 SA-MP 的 JSON 插件。
  
• samp-chatbot - 一个用于在游戏内进行 AI 聊天机器人通信的 GTA SAMP 插件。
  
• SAMP BitStream Crash Fix - 修复了 BitStream 读取溢出的问题。
  
• pawn-json - 为 Pawn 提供的 JSON 支持。
  

客户端-服务器插件

• SA-MP+ - 一个客户端修改，利用 SA-MP 的插件 SDK 与服务器交互并添加新功能。
  
• CHandling - 通过修改游戏的默认行为，为单个车辆分配车辆操控数据的功能。
  
• SAMPVOICE - 在 SA:MP 服务器的 Pawn 语言中实现语音通信系统。
  
• KeyListener - 用于跟踪任何按键的客户端-服务器插件。
  
• SAMP CEF - 为 SA:MP 嵌入 CEF 的客户端和服务器插件。
  
• SAMP_AC_v2 - SA:MP 客户端反作弊。
  

加密插件

• whirlpool - SA:MP 的 Whirlpool 加密插件。
  
• SyS' bcrypt Plugin - 由 Sreyas Sreelal 为 SA:MP 制作的 Bcrypt 加密插件。
  
• lassir's bcrypt Plugin - 由 lassir 为 SA:MP 制作的 Bcrypt 加密插件。
  
• samp-crypto - 为 SA:MP 提供的一系列加密函数，如 Argon2、Scrypt 和 Bcrypt。
  
• SHA512 - SA:MP 的 SHA512 加密插件。
  

GDK/SDK

• sampsdk - 这是开发插件所需的最基本内容。
  
• sampgdk - 为 SA:MP 编写游戏模式的 C/C++ 语言支持。
  
• SampSharp - 为 SA:MP 编写游戏模式的 C# 语言支持。
  
• .NET Plugin - 为 SA:MP 编写插件的 C# 语言支持。
  
• sampgo - 为 SA:MP 编写游戏模式/插件的 Go 语言支持。
  
• samp-node - 为 SA:MP 编写游戏模式的 Javascript/Typescript 语言支持。
  
• Shoebill Project - 为 SA:MP 编写游戏模式的 Java 语言支持。
  
• pySAMP - 为 SA:MP 编写游戏模式的 Python 语言支持。
  
• samp-rs - 为 SA:MP 编写插件的 Rust 语言支持。
  
• Yet Another Lua Plugin - 为 SA:MP 编写游戏模式的 Lua 语言支持。
  
• SAMPHP - 为 SA:MP 编写游戏模式的 PHP 语言支持。
  
• [SA-MP S[D]K](https://github.com/Hual/SA-MP-S-D-K) - 为 SA:MP 编写游戏模式的 D 语言支持。
  
• Kamp - 为 SA:MP 编写游戏模式的 Kotlin 语言支持。
  

游戏模式

• Simple base script - 一个帮助初学者入门的简单基础脚本。
  
• ScavengeSurvive - 基于 PvP 的生存游戏模式。
  
• gta-open - 一个以洛圣都为背景的警察与匪徒模式。
  
• SF-CnR - 为 SA-MP 开发的圣费耶罗警察与匪徒游戏模式。
  
• Next Generation Roleplay - Next Generation Gaming, LLC 的 SA:MP 游戏模式。
  
• SC-RP - 一个支持 MySQL 的角色扮演游戏模式。
  

滤镜脚本

• MapFix - 修复 GTA 圣安地列斯地图的纹理错误。
  
• SA:MP Animbrowse - SA:MP 的动画浏览器工具。
  
• IsPlayerUsingAndroid - 检查玩家是否为安卓用户。
  
• Nickk's TextDraw Editor - 一个具有丰富功能的文本绘图编辑器。
  
• Nexor's Textdraw Editor - 此编辑器提供许多功能，如分组、恢复删除的文本、撤销更改、从文件导入文本绘图等。
  
• Ultimate Creator - 具有众多功能的高级地图编辑器。
  
• Fusez's Map Editor - SA:MP 的游戏内地图编辑器。
  
• Texture Studio - 这是一个游戏内地图编辑器，允许你为物体贴图，最多支持材质索引 15（16 种材质），并可为该材质索引设置颜色。
  

枚举器

• INT：索引 0
  
• STRING：索引 1 到 10
  
• INT2：索引 11
  
• STRING2：索引 12 到 21
  

另一个例子

1. 储存的值: 1337, 常量: 124
   
2. 储存的值: Hey!, 常量: 125
   
3. 储存的值: 2054.124023, 常量: 137
   

一些额外的重要信息

Pawn 中的压缩字符串

引言

什么是压缩字符串？

适用场景

稀疏数组

不常使用的字符串

大量数据存储

内存节省！

SA-MP 中的不支持情况

格式化字符串

支持压缩字符串的函数

访问数据

AMX 汇编

目录

• 先决条件
  
• 术语
  
• 抽象机执行器 (AMX)
  
• AMX 汇编
  
• AMX 二进制
  
• AMX 实例
  
• 宿主程序
  
• 扩展模块
  
• 基本概念
  
• 单元格概念
  
• 内存地址
  
• 栈与堆
  
• 指令
  
• 存储程序概念与冯·诺依曼体系结构
  
• 头、数据段、代码段
  
• 寄存器
  
• 文件与内存布局
  
• 指令集
  
• Pawn 内联汇编语法
  
• 指令表
  
• 加载/存储指令
  
• 索引指令
  
• 算术指令
  
• 逻辑指令
  
• 关系指令
  
• 栈操作指令
  
• 堆指令
  
• 控制寄存器操作指令
  
• 控制流指令
  
• Switch-case 指令
  
• 调用栈与调用约定
  
• 局部变量与函数帧
  
• 调用约定
  
• 参数传递方法
  
• 系统请求
  
• 多维数组
  

先决条件

• Pawn 脚本语言
  
• 二进制数制
  
• 十六进制数制
  
• 内存地址（理解指针更佳）
  
• 栈（作为抽象数据类型）
  

术语

基本概念

• ## <a name="concept-cell"></a> 单元格概念
  

• ## <a name="concept-memory-addresses"></a> 内存地址
  

• ## <a name="concept-stack-heap"></a> 栈和堆
  

• 存储局部变量
  
• 存储函数参数
  
• 存储函数调用信息（例如参数个数）
  
• 提供临时存储
  

• 为动态分配提供内存
  
• 存储作为引用/数组传递的默认参数
  
• 存储不是左值且作为可变参数传递的常量和表达式
  

• ## <a name="concept-instructions"></a> 指令
  

• ## <a name="concept-spc-vna"></a> 存储程序概念与冯·诺依曼体系结构
  

• ## <a name="concept-hdc"></a> 头、数据段、代码段
  

• ## <a name="concept-registers"></a> 寄存器
  

1. 从内存中取出 x 的值（即从 x 的地址读取）并将其存储在一个寄存器中，比如 R1
   
2. 从内存中取出 y 的值（即从 y 的地址读取）并将其存储在一个寄存器中，比如 R2
   
3. 将 R1 和 R2 的内容相加，并将结果存储在某寄存器中，比如 R3
   
4. 将 R3 的内容存储到 z 中（写入 z 的地址）
   

• 主寄存器 (PRI)：通用寄存器（常用作累加器寄存器）
  
• 辅助寄存器 (ALT)：通用寄存器（常用作地址寄存器）
  
• 代码段寄存器 (COD)：内存中代码段起始的绝对地址
  
• 数据段寄存器 (DAT)：内存中数据段起始的绝对地址
  
• 当前指令指针 (CIP)：下一条要执行指令的地址（相对于 COD 寄存器）
  
• 栈顶寄存器 (STP)：栈顶的地址（相对于 DAT 寄存器）
  
• 栈指针寄存器 (STK)：栈上当前位置的地址（相对于 DAT 寄存器）
  
• 帧指针寄存器 (FRM)：栈中当前函数帧起始的地址（相对于 DAT 寄存器）（稍后解释）
  
• 堆指针 (HEA)：堆顶的地址（相对于 DAT 寄存器）
  

文件与内存布局

• 前缀：包含程序的基本信息
  
• 代码：包含代码
  
• 数据：包含数据
  

前缀部分的字段

指令集

• .C = 常量
  
• .S = 栈
  
• .I = 间接寻址
  
• .B = 无 B 变体的变体^{\[需要更好的描述\]}
  
• .ADR = 地址
  
• .R = 重复
  

• .pri = 主寄存器
  
• .alt = 辅助寄存器
  

1. [address] 指的是存储在位置 DAT + address 的值
   
2. 语义列中使用的运算符执行与 Pawn 中相同的操作
   

加载/存储指令

索引指令

算术指令

逻辑指令

关系指令

栈操作指令

堆指令

控制寄存器操作指令

控制流指令

Switch case 指令

[wiki系列] openmp/samp 关键字：指令

目录

• 1 #assert
  
• 2 #define
  
• 3 #else
  
• 4 #elseif
  
• 5 #emit
  
• 6 #endif
  
• 7 #endinput , #endscript
  
• 8 #error
  
• 9 #if
  
• 10 #include
  
• 11 #pragma
  
• 11.1 说明
  
• 11.2 列表
  
• 11.3 示例
  
• 11.3.1 已弃用（Deprecated）
  
• 12 #tryinclude
  
• 13 #undef
  

#assert

#define

#else

#elseif

#emit

#endif

#endinput , #endscript

#error

#if

#include

#pragma

说明

列表

示例

已弃用（Deprecated）

#tryinclude

#undef

[wiki系列] openmp/samp 关键字：运算符

目录

• 1 char
  
• 2 defined
  
• 3 sizeof
  
• 4 state
  
• 5 tagof
  

char

defined

sizeof

state

tagof

实际应用：检查变量是否为 Float