diff --git a/frontend/docusaurus.config.ts b/frontend/docusaurus.config.ts index 01320e9f9ad..2ada18406a1 100644 --- a/frontend/docusaurus.config.ts +++ b/frontend/docusaurus.config.ts @@ -76,6 +76,14 @@ const config: Config = { "zh-CN", "zh-TW", ], + localeConfigs: { + "zh-CN": { + label: "简体中文", + }, + "zh-TW": { + label: "繁體中文", + }, + }, }, staticDirectories: ["public"], diff --git a/frontend/i18n/zh-CN/code.json b/frontend/i18n/zh-CN/code.json new file mode 100644 index 00000000000..21636e301aa --- /dev/null +++ b/frontend/i18n/zh-CN/code.json @@ -0,0 +1,337 @@ +{ + "feature.fullyBackwardsCompatible.title": { + "message": "完全向后兼容现有脚本与客户端" + }, + "feature.fullyBackwardsCompatible.description": { + "message": "手头有旧的AMX文件？直接将其载入open.mp服务器，即可与使用SA:MP客户端的友人同游。待你欲升级代码时，敬请参阅我们的技术文档。" + }, + "feature.fullyBackwardsCompatible.linkText": { + "message": "新手指南" + }, + "feature.newScriptingSystem.title": { + "message": "全新升级的脚本系统" + }, + "feature.newScriptingSystem.description": { + "message": "open.mp不仅兼容所有现有SA-MP脚本与插件，更提供现代化的新API以编写更优质的游戏模式。内含数据结构、异步I/O例程等丰富功能！" + }, + "feature.newScriptingSystem.linkText": { + "message": "了解更多" + }, + "feature.developerFriendly.title": { + "message": "开发者友好型设计" + }, + "feature.developerFriendly.description": { + "message": "我们以开发者体验为核心打造open.mp：提供一致的API接口、实时更新的文档、互助社区及完全开源的代码库！欢迎随时贡献智慧。" + }, + "feature.developerFriendly.linkText": { + "message": "参与贡献" + }, + "feature.scriptingSystem.title": { + "message": "全新升级的脚本系统" + }, + "feature.scriptingSystem.description": { + "message": "我们延续Pawn语言支持，并采用全新编译器提升代码健壮性，同时增加更多服务端与客户端操控功能。" + }, + "feature.scriptingSystem.linkText": { + "message": "查看改进详情" + }, + "feature.communityDevelopment.title": { + "message": "社区驱动的开发模式" + }, + "feature.communityDevelopment.description": { + "message": "服务器完全开源，我们珍视所有规模的贡献。无论是参与新版本开发，还是反馈使用问题（纵使我们追求代码完美，漏洞仍在所难免），你的意见皆具价值。" + }, + "feature.communityDevelopment.linkText": { + "message": "访问GitHub组织" + }, + "feature.cppApi.title": { + "message": "可扩展的C++ API" + }, + "feature.cppApi.description": { + "message": "除Pawn语言原有功能外，更可调用C++生态的海量库与框架。精通此后，何不通过GitHub开放贡献流程助力服务器进化？" + }, + "feature.cppApi.linkText": { + "message": "查看SDK代码库" + }, + "partners.server.stats": { + "message": "{servers}台服务器共有{players}名玩家，平均每台服务器{average}人。" + }, + "servers.sort.relevance": { + "message": "相关度" + }, + "servers.sort.players": { + "message": "玩家数量" + }, + "servers.search.placeholder": { + "message": "按IP或名称搜索" + }, + "partners.note": { + "message": "注：如约暂停合作伙伴计划。已预定席位的服务器仍可加入，但目前不接受新申请。如有疑问欢迎通过Discord咨询，但若涉及新加入方式，我们暂无相关计划。" + }, + "announcement.title": { + "message": "新版open.mp服务器与启动器现已发布！" + }, + "announcement.link": { + "message": "查看详情" + }, + "theme.ErrorPageContent.title": { + "message": "页面加载异常", + "description": "页面崩溃时显示的备用页面标题" + }, + "theme.NotFound.title": { + "message": "页面未找到", + "description": "404页面的标题" + }, + "theme.NotFound.p1": { + "message": "未能检索到目标内容", + "description": "404页面的第一段文字" + }, + "theme.NotFound.p2": { + "message": "请联系引荐你访问此链接的站点管理员，告知该链接已失效", + "description": "404页面的第二段文字" + }, + "theme.admonition.note": { + "message": "备注", + "description": "Note提示框（:::note）的默认标签" + }, + "theme.admonition.tip": { + "message": "技巧", + "description": "Tip提示框（:::tip）的默认标签" + }, + "theme.admonition.danger": { + "message": "危险", + "description": "Danger提示框（:::danger）的默认标签" + }, + "theme.admonition.info": { + "message": "信息", + "description": "Info提示框（:::info）的默认标签" + }, + "theme.admonition.caution": { + "message": "注意", + "description": "Caution提示框（:::caution）的默认标签" + }, + "theme.BackToTopButton.buttonAriaLabel": { + "message": "返回顶部", + "description": "返回顶部按钮的ARIA标签" + }, + "theme.blog.archive.title": { + "message": "归档", + "description": "博客归档页面的页面标题和主标题" + }, + "theme.blog.archive.description": { + "message": "归档", + "description": "博客归档页面的页面描述和主描述" + }, + "theme.blog.paginator.navAriaLabel": { + "message": "博客列表分页导航", + "description": "博客分页的ARIA标签" + }, + "theme.blog.paginator.newerEntries": { + "message": "更新的文章", + "description": "用于导航到较新博客文章页面（上一页）的标签" + }, + "theme.blog.paginator.olderEntries": { + "message": "更早的文章", + "description": "用于导航到较早博客文章页面（下一页）的标签" + }, + "theme.blog.post.readingTime.plurals": { + "message": "阅读时间约{readingTime}分钟", + "description": "\"{readingTime}分钟阅读\"的复数化标签。根据语言支持使用尽可能多的复数形式（用\"|\"分隔）" + }, + "theme.tags.tagsPageTitle": { + "message": "标签", + "description": "标签列表页面的标题" + }, + "announcement.serverVersion": { + "message": "open.mp服务器{version}版本已发布！包含多项修复、性能优化及新功能！" + }, + "announcement.changelog": { + "message": "更新日志" + }, + "announcement.download": { + "message": "下载" + }, + "announcement.launcherUpdate": { + "message": "启动器同步更新！" + }, + "announcement.seeWhatsNew": { + "message": "查看新特性" + }, + "announcement.dismiss": { + "message": "忽略此消息" + }, + "homepage.heroDescription": { + "message": "为《侠盗猎车手：圣安地列斯》打造的全新多人模式模组，与{samp}实现{compatibility}。" + }, + "homepage.heroDescription.compatibility": { + "message": "完全向后兼容" + }, + "homepage.downloadLauncher": { + "message": "下载启动器 🎮" + }, + "homepage.downloadServer": { + "message": "下载服务器 🖥️" + }, + "homepage.documentation": { + "message": "技术文档 📜" + }, + "animations.title": { + "message": "open.mp动画预览器" + }, + "animations.library": { + "message": "动作库：" + }, + "animations.selectLibrary": { + "message": "选择动作库..." + }, + "animations.animation": { + "message": "动画：" + }, + "animations.selectAnimation": { + "message": "选择动画..." + }, + "animations.index": { + "message": "索引：" + }, + "animations.frames": { + "message": "帧数：" + }, + "animations.duration": { + "message": "时长：" + }, + "animations.seconds": { + "message": "秒" + }, + "animations.description": { + "message": "描述：" + }, + "animations.notes": { + "message": "备注：" + }, + "animations.videoCredits": { + "message": "视频致谢：" + }, + "animations.usageExamples": { + "message": "使用示例：" + }, + "animations.selectAnimationPrompt": { + "message": "从上方下拉菜单选择动画即可预览" + }, + "animations.browsePrompt": { + "message": "浏览查看所有可用动画" + }, + "animations.usedByFunctions": { + "message": "这些动画通过ApplyAnimation/ApplyActorAnimation函数调用" + }, + "loadingBanner.followingTrain": { + "message": "正在追赶那辆该死的火车..." + }, + "serverRow.copied": { + "message": "已复制" + }, + "serverRow.copy": { + "message": "复制" + }, + "serverRow.partnerTitle": { + "message": "合作认证！" + }, + "serverRow.ompTitle": { + "message": "open.mp服务器" + }, + "serverRow.players": { + "message": "名玩家" + }, + "serverInfo.backToServers": { + "message": "← 返回服务器列表" + }, + "serverInfo.quickJoin": { + "message": "快速加入" + }, + "serverInfo.noDescription": { + "message": "该服务器暂无描述" + }, + "serverInfo.playersOnline": { + "message": "在线玩家" + }, + "serverInfo.modVersion": { + "message": "模组版本" + }, + "serverInfo.language": { + "message": "语言" + }, + "serverInfo.rule": { + "message": "规则" + }, + "serverInfo.value": { + "message": "数值" + }, + "serverInfo.lastUpdated": { + "message": "{time}前更新" + }, + "theme.footer.title.Documentations": { + "message": "文档" + }, + "theme.footer.title.Community": { + "message": "社区" + }, + "theme.footer.title.More": { + "message": "更多" + }, + "theme.footer.link.Introduction": { + "message": "入门指南" + }, + "theme.footer.link.open.mp Migration": { + "message": "迁移至open.mp" + }, + "theme.footer.link.Discord": { + "message": "Discord" + }, + "theme.footer.link.GitHub": { + "message": "GitHub" + }, + "theme.footer.link.Donate": { + "message": "捐赠" + }, + "theme.footer.link.YouTube": { + "message": "YouTube" + }, + "theme.footer.link.X": { + "message": "X" + }, + "theme.footer.link.Servers": { + "message": "服务器" + }, + "theme.footer.link.Blog": { + "message": "博客" + }, + "theme.footer.link.Animations": { + "message": "动画" + }, + "theme.footer.link.UID Generator": { + "message": "UID生成器" + }, + "theme.footer.link.SA-MP": { + "message": "SA-MP" + }, + "theme.footer.copyright": { + "message": "版权所有 © {year} open.mp。基于Docusaurus构建" + }, + "navbar.item.Docs": { + "message": "文档" + }, + "navbar.item.Blog": { + "message": "博客" + }, + "navbar.item.Forums": { + "message": "论坛" + }, + "navbar.item.Servers": { + "message": "服务器" + }, + "navbar.item.Partners": { + "message": "合作伙伴" + }, + "navbar.item.Donate": { + "message": "捐赠" + } +} diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/changelog.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/changelog.md index c4b2b31f19e..d9e516b8afd 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/changelog.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/changelog.md @@ -124,7 +124,7 @@ description: open.mp开发进度与更新日志。 open.mp 现已结束 RC 阶段，正式进入稳定开发周期。v1.1.0.2612 修复了大量问题并统一了多项行为差异，建议及时更新以获得最佳体验。 -open.mp 官方启动器正式发布！您现在可以： +open.mp 官方启动器正式发布！你现在可以： - 可靠地浏览服务器列表 - 选择心仪服务器 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/client/ClientCommands.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/client/ClientCommands.md index b94bdb64dc5..98e34dc12ed 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/client/ClientCommands.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/client/ClientCommands.md @@ -8,11 +8,11 @@ description: 所有客户端命令列表。 | 命令 | 说明 | | -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| /quit (/q) | 该命令的功能不言自明，用于退出游戏。您也可以使用更简短的 /q 命令，其功能完全相同。 | -| /save | /save 可能是最常用的默认命令，也是最实用的命令。输入该命令后，您当前的位置会被保存到用户文件目录下的 savedpositions.txt 文件中，可在脚本中使用这些坐标。 | +| /quit (/q) | 该命令的功能不言自明，用于退出游戏。你也可以使用更简短的 /q 命令，其功能完全相同。 | +| /save | /save 可能是最常用的默认命令，也是最实用的命令。输入该命令后，你当前的位置会被保存到用户文件目录下的 savedpositions.txt 文件中，可在脚本中使用这些坐标。 | | /rs | /rs（原始保存）与 /save 类似，但仅保存当前位置和朝向角度到用户文件目录下的 rawpositions.txt 文件中。不会保存职业和武器等额外信息。 | -| /interior | 与 /save 同等重要的命令，直接在聊天框显示您当前所处的室内场景编号。 | -| /vw | 与 /save 同等重要的命令，直接在聊天框显示您当前所在的虚拟世界编号。 | +| /interior | 与 /save 同等重要的命令，直接在聊天框显示你当前所处的室内场景编号。 | +| /vw | 与 /save 同等重要的命令，直接在聊天框显示你当前所在的虚拟世界编号。 | | /fpslimit | 设置游戏帧率上限（FPS）。数值越高游戏越流畅。若在图形选项中关闭帧率限制则此命令无效。可设置范围 20-90，默认 50。对应 sa-mp.cfg 文件的 'fpslimit' 选项。 | | /pagesize | 设置聊天窗口显示的行数（10-20 行），默认显示 10 行。对应 sa-mp.cfg 文件的 'pagesize' 选项。 | | /headmove | 控制玩家头部是否随视角转动（本地生效，其他玩家仍会看到头部转动）。对应 sa-mp.cfg 文件的 'disableheadmove' 选项。 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/client/sa-mp.cfg.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/client/sa-mp.cfg.md index ed23b24f157..ac399775ad1 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/client/sa-mp.cfg.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/client/sa-mp.cfg.md @@ -10,17 +10,17 @@ description: SA-MP客户端配置文件 ## 配置选项 -| 选项 | 说明 | -| ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| **pagesize** | 设置聊天窗口显示的行数（10-20 行），默认显示 10 行。可通过游戏内命令 `/pagesize` 实时调整。 | -| **fpslimit** | 设置帧率上限（需在 GTA:SA 菜单中启用帧率限制器）。有效值 20-90，默认 50。对应游戏内命令 `/fpslimit`。[帧率说明](https://en.wikipedia.org/wiki/Frame_rate) | -| **disableheadmove** | 控制玩家头部是否随视角转动（1=禁用 0=启用）。可通过 `/headmove` 命令切换。 | -| **timestamp** | 在聊天消息旁显示本地时间戳（1=启用 0=禁用）。使用 `/timestamp` 命令切换。 | -| **ime** | 控制聊天窗口是否支持输入法文本编辑和语言切换（1=启用 0=禁用）。 | -| **multicore** | 多核 CPU 支持开关（默认 1=启用）。若出现鼠标问题可设为 0。 | -| **directmode** | 为存在聊天文本显示问题的玩家启用直接屏幕渲染模式（0=禁用 1=启用）。 | -| **audiomsgoff** | 禁用音频流 URL 加载提示（1=不显示提示）。对应 `/audiomsg` 命令。 | -| **audioproxyoff** | 禁用 Windows 代理服务器进行音频流传输（1=绕过代理）。 | -| **nonametagstatus** | 暂停玩家昵称标签旁显示沙漏图标（默认 0=启用）。使用 `/nametagstatus` 命令调整。 | -| **fontface** | 自定义 UI 字体（示例：`fontface="Comic Sans MS"`）。非官方支持功能，可能导致异常。 | -| **fontweight** | 字体粗细设置（0=粗体[默认] 1=正常）。 | +| 选项 | 说明 | +| ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | +| **pagesize** | 设置聊天窗口显示的行数（10-20 行），默认显示 10 行。可通过游戏内命令 `/pagesize` 实时调整。 | +| **fpslimit** | 设置帧率上限（需在 GTA:SA 菜单中启用帧率限制器）。有效值 20-90，默认 50。对应游戏内命令 `/fpslimit`。[帧率说明](https://en.wikipedia.org/wiki/Frame_rate) | +| **disableheadmove** | 控制玩家头部是否随视角转动（1=禁用 0=启用）。可通过 `/headmove` 命令切换。 | +| **timestamp** | 在聊天消息旁显示本地时间戳（1=启用 0=禁用）。使用 `/timestamp` 命令切换。 | +| **ime** | 控制聊天窗口是否支持输入法文本编辑和语言切换（1=启用 0=禁用）。 | +| **multicore** | 多核 CPU 支持开关（默认 1=启用）。若出现鼠标问题可设为 0。 | +| **directmode** | 为存在聊天文本显示问题的玩家启用直接屏幕渲染模式（0=禁用 1=启用）。 | +| **audiomsgoff** | 禁用音频流 URL 加载提示（1=不显示提示）。对应 `/audiomsg` 命令。 | +| **audioproxyoff** | 禁用 Windows 代理服务器进行音频流传输（1=绕过代理）。 | +| **nonametagstatus** | 暂停玩家昵称标签旁显示沙漏图标（默认 0=启用）。使用 `/nametagstatus` 命令调整。 | +| **fontface** | 自定义 UI 字体（示例：`fontface="Comic Sans MS"`）。非官方支持功能，可能导致异常。 | +| **fontweight** | 字体粗细设置（0=粗体[默认] 1=正常）。 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/index.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/index.md index 25966796040..7fec8d5f65c 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/index.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/index.md @@ -15,17 +15,17 @@ sidebar_position: 1 遗憾的是，原 SA-MP Wiki 已于 2020 年 9 月下旬下线，后以不可编辑的存档形式恢复。 -我们需要社区的力量将原 Wiki 内容迁移至这个新家！若您有意参与，请查阅[贡献指南](/docs/meta/Contributing)了解详情。 +我们需要社区的力量将原 Wiki 内容迁移至这个新家！若你有意参与，请查阅[贡献指南](/docs/meta/Contributing)了解详情。 -如果您不熟悉 GitHub 使用或 HTML 转换也无需担心！您可以通过以下方式提供帮助： +如果你不熟悉 GitHub 使用或 HTML 转换也无需担心！你可以通过以下方式提供帮助： - 通过 [Discord](https://discord.gg/samp)、[论坛](https://forum.open.mp) 或社交媒体反馈问题 - 最重要的事：_广而告之！_ 欢迎收藏本站并分享给所有寻找 SA-MP Wiki 下落的开发者 -我们诚邀您参与以下内容的完善： +我们诚邀你参与以下内容的完善： - 文档改进 - 常见任务教程（如构建基础游戏模式） - 常用库与插件使用指南 -若您有意贡献，请访问 [GitHub 项目页](https://github.com/openmultiplayer/web)。 +若你有意贡献，请访问 [GitHub 项目页](https://github.com/openmultiplayer/web)。 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/meta/Contributing.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/meta/Contributing.md index 11e57bb2d82..6add8b0710a 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/meta/Contributing.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/meta/Contributing.md @@ -4,9 +4,9 @@ sidebar_label: 贡献指南 description: 参与SA-MP Wiki与open.mp文档贡献的完整指南 --- -本文档源码向所有人开放贡献！您只需拥有[GitHub](https://github.com)账号即可参与，无需掌握 Git 技术，所有操作均可通过网页界面完成！ +本文档源码向所有人开放贡献！你只需拥有[GitHub](https://github.com)账号即可参与，无需掌握 Git 技术，所有操作均可通过网页界面完成！ -如需维护特定语言版本，请向[`CODEOWNERS`](https://github.com/openmultiplayer/web/blob/master/CODEOWNERS)文件提交 PR，在对应语言目录添加您的 GitHub 用户名。 +如需维护特定语言版本，请向[`CODEOWNERS`](https://github.com/openmultiplayer/web/blob/master/CODEOWNERS)文件提交 PR，在对应语言目录添加你的 GitHub 用户名。 ## 内容编辑 @@ -16,7 +16,7 @@ description: 参与SA-MP Wiki与open.mp文档贡献的完整指南 以[SetVehicleAngularVelocity](../scripting/functions/SetVehicleAngularVelocity)页面为例，点击编辑按钮将跳转至[GitHub 编辑界面](https://github.com/openmultiplayer/web/edit/master/frontend/docs/scripting/functions/SetVehicleAngularVelocity.md)，登录后可直接在线修改内容。 -提交修改后创建"Pull Request"，Wiki 维护者与社区成员将审核您的变更，经讨论确认后合并至主分支。 +提交修改后创建"Pull Request"，Wiki 维护者与社区成员将审核你的变更，经讨论确认后合并至主分支。 ## 新增内容 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnActorStreamIn.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnActorStreamIn.md index 91be7aa404e..aa816de5fa4 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnActorStreamIn.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnActorStreamIn.md @@ -1,7 +1,7 @@ --- title: OnActorStreamIn sidebar_label: OnActorStreamIn -description: 当角色被玩家客户端流加载时触发该回调。 +description: 当角色被玩家客户端流加载时触发此回调。 tags: ["角色"] --- @@ -9,7 +9,7 @@ tags: ["角色"] ## 描述 -当角色被玩家客户端流加载时触发该回调。 +当角色被玩家客户端流加载时触发此回调。 | 参数 | 说明 | | ----------- | ---------------------- | @@ -26,7 +26,7 @@ tags: ["角色"] public OnActorStreamIn(actorid, forplayerid) { new string[48]; - format(string, sizeof(string), "角色 %d 已为您完成流加载。", actorid); + format(string, sizeof(string), "角色 %d 已为你完成流加载。", actorid); SendClientMessage(forplayerid, 0xFFFFFFFF, string); return 1; } diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnActorStreamOut.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnActorStreamOut.md index 038f5b02d49..65b146a29fc 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnActorStreamOut.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnActorStreamOut.md @@ -1,7 +1,7 @@ --- title: OnActorStreamOut sidebar_label: OnActorStreamOut -description: 当角色被玩家客户端流卸载时触发该回调。 +description: 当角色被玩家客户端流卸载时触发此回调。 tags: ["角色"] --- @@ -9,7 +9,7 @@ tags: ["角色"] ## 描述 -当角色被玩家客户端流卸载时触发该回调。 +当角色被玩家客户端流卸载时触发此回调。 | 参数 | 说明 | | ----------- | ---------------------- | @@ -26,7 +26,7 @@ tags: ["角色"] public OnActorStreamOut(actorid, forplayerid) { new string[48]; - format(string, sizeof(string), "角色 %d 已为您完成流卸载。", actorid); + format(string, sizeof(string), "角色 %d 已为你完成流卸载。", actorid); SendClientMessage(forplayerid, 0xFFFFFFFF, string); return 1; } diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnClientCheckResponse.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnClientCheckResponse.md index be7172adf23..53c7168d8f7 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnClientCheckResponse.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnClientCheckResponse.md @@ -1,13 +1,13 @@ --- title: OnClientCheckResponse sidebar_label: OnClientCheckResponse -description: 当SendClientCheck请求完成时触发该回调 +description: 当SendClientCheck请求完成时触发此回调 tags: [] --- ## 描述 -当SendClientCheck请求完成时触发该回调。 +当SendClientCheck请求完成时触发此回调。 | 参数 | 说明 | | -------- | -------------- | @@ -43,9 +43,9 @@ public OnClientCheckResponse(playerid, actionid, memaddr, retndata) :::warning -**SA:MP 服务端**：该回调仅在滤镜脚本中触发 +**SA:MP 服务端**：此回调仅在滤镜脚本中触发 -**Open Multiplayer 服务端**：该回调在游戏模式/滤镜脚本中均可正常触发 +**Open Multiplayer 服务端**：此回调在游戏模式/滤镜脚本中均可正常触发 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnClientMessage.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnClientMessage.md index f3f18f984d9..ef29b7a3b50 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnClientMessage.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnClientMessage.md @@ -1,18 +1,24 @@ --- title: OnClientMessage sidebar_label: OnClientMessage -description: 当NPC接收到客户端消息时触发该回调 +description: 当NPC接收到客户端消息时触发此回调 tags: [] --- +:::warning + +此函数已弃用。 + +::: + ## 描述 -当NPC检测到客户端消息时触发该回调。以下情况均会触发： +当 NPC 检测到客户端消息时触发此回调。以下情况均会触发： - 使用[SendClientMessageToAll](../functions/SendClientMessageToAll)函数时 -- 向NPC发送[SendClientMessage](../functions/SendClientMessage)函数时 +- 向 NPC 发送[SendClientMessage](../functions/SendClientMessage)函数时 -该回调不会在玩家发送聊天消息时触发，相关功能请参阅[NPC:OnPlayerText](OnPlayerText)。 +此回调不会在玩家发送聊天消息时触发，相关功能请参阅[NPC:OnPlayerText](OnPlayerText)。 | 参数 | 说明 | | ------ | ------------------ | @@ -21,7 +27,7 @@ tags: [] ## 返回值 -本回调不处理返回值。 +此回调不处理返回值。 ## 示例 @@ -39,4 +45,4 @@ public OnClientMessage(color, text[]) 以下回调可能与当前回调存在关联： -- [OnPlayerText](OnPlayerText)：当任意实体（玩家、其他NPC或当前NPC自身）发送聊天消息时触发 +- [OnPlayerText](OnPlayerText)：当任意实体（玩家、其他 NPC 或当前 NPC 自身）发送聊天消息时触发 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnDialogResponse.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnDialogResponse.md index 0982df170fc..69c5c941e50 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnDialogResponse.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnDialogResponse.md @@ -1,13 +1,13 @@ --- title: OnDialogResponse sidebar_label: OnDialogResponse -description: 当玩家响应通过ShowPlayerDialog显示的对话框时触发该回调。响应方式包括点击按钮、按下ENTER/ESC键或双击列表项（列表式对话框）。 +description: 当玩家响应通过ShowPlayerDialog显示的对话框时触发此回调。响应方式包括点击按钮、按下ENTER/ESC键或双击列表项（列表式对话框）。 tags: ["对话框"] --- ## 描述 -当玩家响应通过ShowPlayerDialog显示的对话框时触发该回调。响应方式包括： +当玩家响应通过ShowPlayerDialog显示的对话框时触发此回调。响应方式包括： - 点击按钮 - 按下ENTER/ESC键 @@ -23,7 +23,7 @@ tags: ["对话框"] ## 返回值 -该回调在滤镜脚本中总是优先触发。返回1将阻止其他滤镜脚本处理该回调。 +此回调在滤镜脚本中总是优先触发。返回1将阻止其他滤镜脚本处理此回调。 ## 示例 @@ -35,7 +35,7 @@ tags: ["对话框"] // 在某个指令中 ShowPlayerDialog(playerid, DIALOG_RULES, DIALOG_STYLE_MSGBOX, "服务器规则", -"- 禁止作弊\n- 禁止刷屏\n- 尊重管理员\n\n您是否同意遵守这些规则？", "同意", "拒绝"); +"- 禁止作弊\n- 禁止刷屏\n- 尊重管理员\n\n你是否同意遵守这些规则？", "同意", "拒绝"); public OnDialogResponse(playerid, dialogid, response, listitem, inputtext[]) { @@ -43,7 +43,7 @@ public OnDialogResponse(playerid, dialogid, response, listitem, inputtext[]) { if (response) // 点击左按钮或按下ENTER { - SendClientMessage(playerid, COLOR_GREEN, "感谢您同意遵守服务器规则！"); + SendClientMessage(playerid, COLOR_GREEN, "感谢你同意遵守服务器规则！"); } else // 按下ESC或点击右按钮 { @@ -63,7 +63,7 @@ public OnDialogResponse(playerid, dialogid, response, listitem, inputtext[]) // 在某个指令中 ShowPlayerDialog(playerid, DIALOG_LOGIN, DIALOG_STYLE_INPUT, "登录", -"请输入您的密码：", "登录", "取消"); +"请输入你的密码：", "登录", "取消"); public OnDialogResponse(playerid, dialogid, response, listitem, inputtext[]) { @@ -85,7 +85,7 @@ public OnDialogResponse(playerid, dialogid, response, listitem, inputtext[]) // 重新显示登录对话框 ShowPlayerDialog(playerid, DIALOG_LOGIN, DIALOG_STYLE_INPUT, - "登录", "请输入您的密码：", "登录", "取消"); + "登录", "请输入你的密码：", "登录", "取消"); } } return 1; diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnEnterExitModShop.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnEnterExitModShop.md index 2b7422f344e..3fd8f0f7bea 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnEnterExitModShop.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnEnterExitModShop.md @@ -1,13 +1,13 @@ --- title: OnEnterExitModShop sidebar_label: OnEnterExitModShop -description: 当玩家进入或离开改装店时触发该回调 +description: 当玩家进入或离开改装店时触发此回调 tags: ["玩家"] --- ## 描述 -当玩家进入或离开车辆改装店时触发该回调。 +当玩家进入或离开车辆改装店时触发此回调。 | 参数 | 说明 | | ---------- | ----------------------------------------- | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnFilterScriptExit.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnFilterScriptExit.md index d3e17bf299c..09a16d8897e 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnFilterScriptExit.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnFilterScriptExit.md @@ -1,13 +1,13 @@ --- title: OnFilterScriptExit sidebar_label: OnFilterScriptExit -description: 当滤镜脚本卸载时触发该回调 +description: 当滤镜脚本卸载时触发此回调 tags: [] --- ## 描述 -当滤镜脚本被卸载时触发该回调。该回调仅在当前被卸载的滤镜脚本内部触发。 +当滤镜脚本被卸载时触发此回调。此回调仅在当前被卸载的滤镜脚本内部触发。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnFilterScriptInit.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnFilterScriptInit.md index ee266179885..6615868a845 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnFilterScriptInit.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnFilterScriptInit.md @@ -1,13 +1,13 @@ --- title: OnFilterScriptInit sidebar_label: OnFilterScriptInit -description: 当滤镜脚本初始化（加载）时触发该回调 +description: 当滤镜脚本初始化（加载）时触发此回调 tags: [] --- ## 描述 -当滤镜脚本初始化（加载）时触发该回调。该回调仅在当前启动的滤镜脚本内部触发。 +当滤镜脚本初始化（加载）时触发此回调。此回调仅在当前启动的滤镜脚本内部触发。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnGameModeExit.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnGameModeExit.md index e99a4dcd3f9..87e0934cba3 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnGameModeExit.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnGameModeExit.md @@ -1,13 +1,13 @@ --- title: OnGameModeExit sidebar_label: OnGameModeExit -description: 当游戏模式结束时触发该回调（可能由'gmx'指令、服务器关闭或GameModeExit函数触发） +description: 当游戏模式结束时触发此回调（可能由'gmx'指令、服务器关闭或GameModeExit函数触发） tags: [] --- ## 描述 -当游戏模式结束时触发该回调。触发条件包括： +当游戏模式结束时触发此回调。触发条件包括： - 执行'gmx'指令 - 服务器关闭 @@ -27,7 +27,7 @@ public OnGameModeExit() :::tip -该回调也可用于滤镜脚本中，通过RCON指令（如changemode或gmx）检测游戏模式变更，因为更换游戏模式不会重新加载滤镜脚本 +此回调也可用于滤镜脚本中，通过RCON指令（如changemode或gmx）检测游戏模式变更，因为更换游戏模式不会重新加载滤镜脚本 ::: @@ -37,7 +37,7 @@ public OnGameModeExit() - 配合`rcon gmx`指令使用时可能导致客户端异常 - 在[OnGameModeInit](OnGameModeInit)中过度调用[RemoveBuildingForPlayer](../functions/RemoveBuildingForPlayer)可能引发客户端崩溃 -- 服务器崩溃或进程被强制终止（如Linux kill命令/Windows控制台关闭按钮）不会触发本回调 +- 服务器崩溃或进程被强制终止（如Linux kill命令/Windows控制台关闭按钮）不会触发此回调 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnGameModeInit.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnGameModeInit.md index dee86aef248..69037a4a9c1 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnGameModeInit.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnGameModeInit.md @@ -1,13 +1,13 @@ --- title: OnGameModeInit sidebar_label: OnGameModeInit -description: 当游戏模式启动时触发该回调 +description: 当游戏模式启动时触发此回调 tags: [] --- ## 描述 -当游戏模式启动时触发该回调。 +当游戏模式启动时触发此回调。 ## 示例 @@ -23,7 +23,7 @@ public OnGameModeInit() :::tip -该回调也可用于滤镜脚本中，通过RCON指令（如changemode或gmx）检测游戏模式变更，因为更换游戏模式不会重新加载滤镜脚本 +此回调也可用于滤镜脚本中，通过RCON指令（如changemode或gmx）检测游戏模式变更，因为更换游戏模式不会重新加载滤镜脚本 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnIncomingConnection.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnIncomingConnection.md index 7fd7a4bf6c8..bedd910ba43 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnIncomingConnection.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnIncomingConnection.md @@ -1,13 +1,13 @@ --- title: OnIncomingConnection sidebar_label: OnIncomingConnection -description: 当IP地址尝试连接服务器时触发该回调 +description: 当IP地址尝试连接服务器时触发此回调 tags: [] --- ## 描述 -当IP地址尝试连接服务器时触发该回调。如需阻止连接，请使用BlockIpAddress函数。 +当IP地址尝试连接服务器时触发此回调。如需阻止连接，请使用BlockIpAddress函数。 | 参数 | 说明 | | ------------ | -------------------- | @@ -20,7 +20,7 @@ tags: [] 1 - 阻止其他滤镜脚本接收此回调 0 - 允许传递给后续滤镜脚本 -该回调在滤镜脚本中总是优先触发。 +此回调在滤镜脚本中总是优先触发。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCChangeNode.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCChangeNode.md new file mode 100644 index 00000000000..826f3d43259 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCChangeNode.md @@ -0,0 +1,64 @@ +--- +title: OnNPCChangeNode +sidebar_label: OnNPCChangeNode +description: 当 NPC 在基于节点的移动过程中尝试从一个导航节点切换到另一个节点时调用此回调。 +tags: ["npc", "节点", "导航"] +--- + + + +## 描述 + +当 NPC 在基于节点的移动过程中尝试从一个导航节点切换到另一个节点时调用此回调。这允许你控制是否应允许或拒绝节点切换。 + +| 参数 | 说明 | +| --------- | --------------------------- | +| npcid | 尝试切换节点的 NPC 的 ID | +| newnodeid | NPC 想要移动到的新节点的 ID | +| oldnodeid | NPC 当前所在节点的 ID | + +## 返回值 + +返回 `true` 允许节点切换，或返回 `false` 拒绝切换。 + +## 示例 + +```c +public OnNPCChangeNode(npcid, newnodeid, oldnodeid) +{ + printf("[NPC] NPC %d 正在从节点 %d 切换到节点 %d", npcid, oldnodeid, newnodeid); + + // 通知跟踪此NPC的玩家 + for (new playerid = 0; playerid < MAX_PLAYERS; playerid++) + { + if (!IsPlayerConnected(playerid)) + continue; + + if (PlayerNPC[playerid] == npcid) + { + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 正在从节点 %d 切换到节点 %d", npcid, oldnodeid, newnodeid); + } + } + return 1; +} +``` + +## 注意事项 + +- 此回调仅在 NPC 通过 `NPC_PlayNode` 使用基于节点的导航时调用 +- 返回 `false` 将阻止 NPC 切换节点，并可能导致其停止导航 +- NPC 必须先使用 `NPC_OpenNode` 加载节点文件，才能在节点之间导航 + +## 相关函数 + +以下函数可能有用，因为它们与此回调以某种方式相关。 + +- [NPC_PlayNode](../functions/NPC_PlayNode): 开始 NPC 基于节点的导航 +- [NPC_OpenNode](../functions/NPC_OpenNode): 打开导航节点文件 +- [NPC_CloseNode](../functions/NPC_CloseNode): 关闭导航节点文件 +- [NPC_StopPlayingNode](../functions/NPC_StopPlayingNode): 停止 NPC 节点导航 + +## 相关回调 + +- [OnNPCFinishNode](OnNPCFinishNode): 当 NPC 完成导航完整节点时调用 +- [OnNPCFinishNodePoint](OnNPCFinishNodePoint): 当 NPC 到达节点中的特定点时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCConnect.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCConnect.md deleted file mode 100644 index 496e53e986f..00000000000 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCConnect.md +++ /dev/null @@ -1,31 +0,0 @@ ---- -title: OnNPCConnect -sidebar_label: OnNPCConnect -description: 当NPC成功连接服务器时触发该回调 -tags: ["npc"] ---- - -## 描述 - -当NPC成功连接至服务器时触发该回调。 - -| 参数 | 说明 | -| ---------- | ----------------- | -| myplayerid | NPC被分配的玩家ID | - -## 示例 - -```c -public OnNPCConnect(myplayerid) -{ - printf("已成功连接服务器，分配ID为 %i！", myplayerid); -} -``` - -## 相关回调 - -以下回调可能与当前回调存在关联： - -- [OnNPCDisconnect](OnNPCDisconnect)：当NPC断开服务器连接时触发 -- [OnPlayerConnect](OnPlayerConnect)：当玩家连接服务器时触发 -- [OnPlayerDisconnect](OnPlayerDisconnect)：当玩家断开服务器连接时触发 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCCreate.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCCreate.md new file mode 100644 index 00000000000..62f7ceaca03 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCCreate.md @@ -0,0 +1,53 @@ +--- +title: OnNPCCreate +sidebar_label: OnNPCCreate +description: 当 NPC 成功创建时调用此回调。 +tags: ["npc"] +--- + + + +## 描述 + +当 NPC 成功创建并添加到服务器时调用此回调。 + +| 参数 | 说明 | +| ----- | ------------------ | +| npcid | 已创建的 NPC 的 ID | + +## 示例 + +```c +public OnNPCCreate(npcid) +{ + printf("[NPC] NPC %d 已创建", npcid); + + // 通知所有已连接的玩家 + for (new playerid = 0; playerid < MAX_PLAYERS; playerid++) + { + if (!IsPlayerConnected(playerid)) + continue; + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 已创建", npcid); + } + return 1; +} +``` + +## 注意事项 + +- 此回调在 NPC 创建后立即调用，但在其生成之前 +- NPC 需要使用 `NPC_Spawn` 生成才能在游戏世界中可见 + +## 相关函数 + +以下函数可能有用，因为它们与此回调以某种方式相关。 + +- [NPC_Create](../functions/NPC_Create): 创建新的 NPC +- [NPC_Destroy](../functions/NPC_Destroy): 销毁现有的 NPC +- [NPC_Spawn](../functions/NPC_Spawn): 在游戏世界中生成 NPC + +## 相关回调 + +- [OnNPCDestroy](OnNPCDestroy): 当 NPC 被销毁时调用 +- [OnNPCSpawn](OnNPCSpawn): 当 NPC 被生成时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCDeath.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCDeath.md new file mode 100644 index 00000000000..fe56adce43c --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCDeath.md @@ -0,0 +1,68 @@ +--- +title: OnNPCDeath +sidebar_label: OnNPCDeath +description: 当 NPC 死亡时调用此回调。 +tags: ["npc"] +--- + + + +## 描述 + +当 NPC 死亡时调用此回调。 + +| 参数 | 说明 | +| -------- | ----------------------------------------------------------- | +| npcid | 死亡的 NPC 的 ID | +| killerid | 击杀 NPC 的玩家/NPC 的 ID（如果没有则为 INVALID_PLAYER_ID） | +| reason | 死亡原因（武器 ID 或死亡原因） | + +## 示例 + +```c +public OnNPCDeath(npcid, killerid, WEAPON:reason) +{ + printf("[NPC] NPC %d 死亡（击杀者：%d，武器：%d）", npcid, killerid, _:reason); + + // 通知追踪此 NPC 的玩家 + for (new playerid = 0; playerid < MAX_PLAYERS; playerid++) + { + if (!IsPlayerConnected(playerid)) + continue; + + if (PlayerNPC[playerid] == npcid) + { + if (killerid == INVALID_PLAYER_ID) + { + SendClientMessage(playerid, 0xFF0000FF, "你追踪的 NPC %d 已死亡（武器：%d）", npcid, _:reason); + } + else + { + SendClientMessage(playerid, 0xFF0000FF, "你追踪的 NPC %d 被玩家 %d 击杀（武器：%d）", npcid, killerid, _:reason); + } + } + } + return 1; +} +``` + +## 注意事项 + +- 如果 NPC 死亡不是由玩家造成的，`killerid` 参数将为 `INVALID_PLAYER_ID` +- `reason` 参数包含导致死亡的武器 ID（未知/其他原因为 255） + +## 相关函数 + +以下函数可能有用，因为它们与此回调以某种方式相关。 + +- [NPC_Kill](../functions/NPC_Kill): 击杀 NPC +- [NPC_Respawn](../functions/NPC_Respawn): 重生死亡的 NPC +- [NPC_GetHealth](../functions/NPC_GetHealth): 获取 NPC 的生命值 +- [NPC_SetHealth](../functions/NPC_SetHealth): 设置 NPC 的生命值 + +## 相关回调 + +- [OnNPCSpawn](OnNPCSpawn): 当 NPC 生成时调用 +- [OnNPCRespawn](OnNPCRespawn): 当 NPC 重生时调用 +- [OnNPCTakeDamage](OnNPCTakeDamage): 当 NPC 受到伤害时调用 +- [OnPlayerDeath](OnPlayerDeath): 当玩家死亡时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCDestroy.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCDestroy.md new file mode 100644 index 00000000000..262c096f047 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCDestroy.md @@ -0,0 +1,60 @@ +--- +title: OnNPCDestroy +sidebar_label: OnNPCDestroy +description: 当 NPC 被销毁时调用此回调。 +tags: ["npc"] +--- + + + +## 描述 + +当 NPC 被销毁并从服务器移除时调用此回调。 + +| 参数 | 说明 | +| ----- | ------------------ | +| npcid | 被销毁的 NPC 的 ID | + +## 示例 + +```c +public OnNPCDestroy(npcid) +{ + printf("[NPC] NPC %d 已被销毁", npcid); + + // 清除追踪此 NPC 的玩家并通知 + for (new playerid = 0; playerid < MAX_PLAYERS; playerid++) + { + if (!IsPlayerConnected(playerid)) + continue; + + if (PlayerNPC[playerid] == npcid) + { + PlayerNPC[playerid] = INVALID_NPC_ID; + SendClientMessage(playerid, 0xFF0000FF, "你追踪的 NPC %d 已被销毁", npcid); + } + else + { + SendClientMessage(playerid, 0xFFFF00FF, "NPC %d 已被销毁", npcid); + } + } + return 1; +} +``` + +## 注意事项 + +- 此回调在 NPC 从服务器移除之前立即调用 +- 在此回调之后，NPC 将断开连接并释放其玩家槽位 + +## 相关函数 + +以下函数可能有用，因为它们与此回调以某种方式相关。 + +- [NPC_Create](../functions/NPC_Create): 创建新的 NPC +- [NPC_Destroy](../functions/NPC_Destroy): 销毁现有的 NPC +- [NPC_IsValid](../functions/NPC_IsValid): 检查 NPC ID 是否有效 + +## 相关回调 + +- [OnNPCCreate](OnNPCCreate): 当 NPC 被创建时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCDisconnect.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCDisconnect.md deleted file mode 100644 index 74941a05031..00000000000 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCDisconnect.md +++ /dev/null @@ -1,31 +0,0 @@ ---- -title: OnNPCDisconnect -sidebar_label: OnNPCDisconnect -description: 当NPC断开服务器连接时触发该回调 -tags: ["npc"] ---- - -## 描述 - -当NPC与服务器断开连接时触发该回调。 - -| 参数 | 说明 | -| -------- | ------------------------ | -| reason[] | 断开连接的原因描述字符串 | - -## 示例 - -```c -public OnNPCDisconnect(reason[]) -{ - printf("已从服务器断开连接。原因：%s", reason); -} -``` - -## 相关回调 - -以下回调可能与当前回调存在关联： - -- [OnNPCConnect](OnNPCConnect)：当NPC成功连接服务器时触发 -- [OnPlayerDisconnect](OnPlayerDisconnect)：当玩家断开服务器连接时触发 -- [OnPlayerConnect](OnPlayerConnect)：当玩家连接服务器时触发 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCEnterVehicle.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCEnterVehicle.md deleted file mode 100644 index d179540ca29..00000000000 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCEnterVehicle.md +++ /dev/null @@ -1,31 +0,0 @@ ---- -title: OnNPCEnterVehicle -sidebar_label: OnNPCEnterVehicle -description: 当NPC进入车辆时触发该回调 -tags: ["npc"] ---- - -## 描述 - -当NPC进入车辆时触发该回调。 - -| 参数 | 说明 | -| --------- | --------------- | -| vehicleid | NPC进入的车辆ID | -| seatid | NPC使用的座位ID | - -## 示例 - -```c -public OnNPCEnterVehicle(vehicleid, seatid) -{ - printf("NPC进入车辆事件 - 车辆ID: %d 座位ID: %d", vehicleid, seatid); - return 1; -} -``` - -## 相关回调 - -以下回调可能与当前回调存在关联： - -- [OnNPCExitVehicle](OnNPCExitVehicle)：当NPC离开车辆时触发 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCExitVehicle.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCExitVehicle.md deleted file mode 100644 index eed983e230e..00000000000 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCExitVehicle.md +++ /dev/null @@ -1,26 +0,0 @@ ---- -title: OnNPCExitVehicle -sidebar_label: OnNPCExitVehicle -description: 当NPC离开车辆时触发该回调 -tags: ["npc"] ---- - -## 描述 - -当NPC离开车辆时触发该回调。 - -## 示例 - -```c -public OnNPCExitVehicle() -{ - print("NPC已离开车辆"); - return 1; -} -``` - -## 相关回调 - -以下回调可能与当前回调存在关联： - -- [OnNPCEnterVehicle](OnNPCEnterVehicle)：当NPC进入车辆时触发 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCFinishMove.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCFinishMove.md new file mode 100644 index 00000000000..718fe0eae33 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCFinishMove.md @@ -0,0 +1,60 @@ +--- +title: OnNPCFinishMove +sidebar_label: OnNPCFinishMove +description: 当 NPC 完成移动到目标位置时调用此回调。 +tags: ["npc", "移动"] +--- + + + +## 描述 + +当 NPC 完成移动到目标位置时调用此回调。 + +| 参数 | 说明 | +| ----- | -------------------- | +| npcid | 完成移动的 NPC 的 ID | + +## 示例 + +```c +public OnNPCFinishMove(npcid) +{ + // 查找所有追踪此 NPC 的玩家 + for (new playerid = 0; playerid < MAX_PLAYERS; playerid++) + { + if (!IsPlayerConnected(playerid)) + continue; + + if (PlayerNPC[playerid] == npcid) + { + new Float:x, Float:y, Float:z; + NPC_GetPos(npcid, x, y, z); + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 完成移动到位置 (%.2f, %.2f, %.2f)", npcid, x, y, z); + } + } + return 1; +} +``` + +## 注意事项 + +- 此回调适用于所有类型的 NPC 移动（步行、跑步、冲刺、驾驶） +- 当 NPC 到达移动函数设置的目标位置时调用此回调 +- 对于基于路径的移动，当整个路径完成时调用此回调（路径特定的回调请参见 `OnNPCFinishMovePath`） +- 对于跟随玩家，当 NPC 停止跟随时调用此回调（如果禁用了自动重启） + +## 相关函数 + +以下函数可能有用，因为它们与此回调以某种方式相关。 + +- [NPC_Move](../functions/NPC_Move): 使 NPC 移动到位置 +- [NPC_MoveToPlayer](../functions/NPC_MoveToPlayer): 使 NPC 跟随玩家 +- [NPC_StopMove](../functions/NPC_StopMove): 停止 NPC 移动 +- [NPC_IsMoving](../functions/NPC_IsMoving): 检查 NPC 是否正在移动 + +## 相关回调 + +- [OnNPCFinishNodePoint](OnNPCFinishNodePoint): 当 NPC 到达节点点时调用 +- [OnNPCFinishNode](OnNPCFinishNode): 当 NPC 完成节点导航时调用 +- [OnNPCFinishMovePath](OnNPCFinishMovePath): 当 NPC 完成沿路径移动时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCFinishMovePath.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCFinishMovePath.md new file mode 100644 index 00000000000..07dfc35e9bf --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCFinishMovePath.md @@ -0,0 +1,54 @@ +--- +title: OnNPCFinishMovePath +sidebar_label: OnNPCFinishMovePath +description: 当 NPC 完成沿预定路径移动时调用此回调。 +tags: ["npc", "移动", "路径"] +--- + + + +## 描述 + +当 NPC 完成沿预定路径移动时调用此回调。 + +| 参数 | 说明 | +| ------ | -------------------- | +| npcid | 完成路径的 NPC 的 ID | +| pathid | 已完成的路径的 ID | + +## 示例 + +```c +public OnNPCFinishMovePath(npcid, pathid) +{ + // 查找所有追踪此 NPC 的玩家 + for (new playerid = 0; playerid < MAX_PLAYERS; playerid++) + { + if (!IsPlayerConnected(playerid)) + continue; + + if (PlayerNPC[playerid] == npcid) + { + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 完成沿路径 %d 移动", npcid, pathid); + } + } + return 1; +} +``` + +## 注意事项 + +- 当 NPC 到达路径的最终点时触发此回调 +- 当调用此回调时，NPC 会自动停止移动 + +## 相关函数 + +- [NPC_MoveByPath](../functions/NPC_MoveByPath): 使 NPC 沿路径移动 +- [NPC_CreatePath](../functions/NPC_CreatePath): 创建新的移动路径 +- [NPC_IsValidPath](../functions/NPC_IsValidPath): 检查路径是否有效 + +## 相关回调 + +- [OnNPCFinishMove](OnNPCFinishMove): 当 NPC 完成任何移动时调用 +- [OnNPCFinishNode](OnNPCFinishNode): 当 NPC 完成节点导航时调用 +- [OnNPCFinishNodePoint](OnNPCFinishNodePoint): 当 NPC 到达节点点时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCFinishMovePathPoint.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCFinishMovePathPoint.md new file mode 100644 index 00000000000..dbb2fdfae21 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCFinishMovePathPoint.md @@ -0,0 +1,56 @@ +--- +title: OnNPCFinishMovePathPoint +sidebar_label: OnNPCFinishMovePathPoint +description: 当NPC完成路径中特定点的移动时被调用 +tags: ["npc", "移动", "路径"] +--- + + + +## 描述 + +此回调函数在 NPC 完成路径中特定点的移动时被调用。 + +| 参数 | 说明 | +| ------- | -------------------------- | +| npcid | 完成路径点移动的 NPC 的 ID | +| pathid | 正在遵循的路径的 ID | +| pointid | 已到达的路径点的索引 | + +## 示例 + +```c +public OnNPCFinishMovePathPoint(npcid, pathid, pointid) +{ + // 查找所有追踪此 NPC 的玩家 + for (new playerid = 0; playerid < MAX_PLAYERS; playerid++) + { + if (!IsPlayerConnected(playerid)) + continue; + + if (PlayerNPC[playerid] == npcid) + { + SendClientMessage(playerid, 0xFFFF00FF, "NPC %d 到达路径 %d 上的点 %d", npcid, pointid, pathid); + } + } + return 1; +} +``` + +## 注意事项 + +- 此回调函数会为路径中的每个点触发 +- 使用 [OnNPCFinishMovePath](OnNPCFinishMovePath) 来检测整个路径何时完成 +- NPC 必须使用 [NPC_MoveByPath](../functions/NPC_MoveByPath) 沿路径移动 + +## 相关函数 + +- [NPC_MoveByPath](../functions/NPC_MoveByPath): 使 NPC 遵循路径移动 +- [NPC_CreatePath](../functions/NPC_CreatePath): 创建新路径 +- [NPC_AddPointToPath](../functions/NPC_AddPointToPath): 向路径添加点 +- [NPC_GetCurrentPathPointIndex](../functions/NPC_GetCurrentPathPointIndex): 获取当前路径点 + +## 相关回调 + +- [OnNPCFinishMovePath](OnNPCFinishMovePath): 当 NPC 完成整个路径时被调用 +- [OnNPCFinishMove](OnNPCFinishMove): 当 NPC 完成任何移动时被调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCFinishNode.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCFinishNode.md new file mode 100644 index 00000000000..3e1f2b94d02 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCFinishNode.md @@ -0,0 +1,60 @@ +--- +title: OnNPCFinishNode +sidebar_label: OnNPCFinishNode +description: 当 NPC 完成导航一个完整节点时调用此回调。 +tags: ["npc", "节点", "导航"] +--- + + + +## 描述 + +当 NPC 在基于节点的移动过程中完成导航一个完整节点时调用此回调。 + +| 参数 | 说明 | +| ------ | -------------------- | +| npcid | 完成节点的 NPC 的 ID | +| nodeid | 已完成的节点的 ID | + +## 示例 + +```c +public OnNPCFinishNode(npcid, nodeid) +{ + printf("[NPC] NPC %d 完成节点 %d", npcid, nodeid); + + // 通知追踪此 NPC 的玩家 + for (new playerid = 0; playerid < MAX_PLAYERS; playerid++) + { + if (!IsPlayerConnected(playerid)) + continue; + + if (PlayerNPC[playerid] == npcid) + { + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 完成节点 %d", npcid, nodeid); + } + } + return 1; +} +``` + +## 注意事项 + +- 此回调仅在 NPC 通过 `NPC_PlayNode` 使用基于节点的导航时调用 +- 当 NPC 完成节点中所有点的导航时调用此回调 +- 当此回调触发时，节点导航会自动停止 + +## 相关函数 + +以下函数可能有用，因为它们与此回调以某种方式相关。 + +- [NPC_PlayNode](../functions/NPC_PlayNode): 开始 NPC 基于节点的导航 +- [NPC_StopPlayingNode](../functions/NPC_StopPlayingNode): 停止 NPC 节点导航 +- [NPC_IsPlayingNode](../functions/NPC_IsPlayingNode): 检查 NPC 是否正在导航节点 +- [NPC_OpenNode](../functions/NPC_OpenNode): 打开导航节点文件 + +## 相关回调 + +- [OnNPCFinishNodePoint](OnNPCFinishNodePoint): 当 NPC 到达节点中的特定点时调用 +- [OnNPCChangeNode](OnNPCChangeNode): 当 NPC 尝试切换节点时调用 +- [OnNPCFinishMove](OnNPCFinishMove): 当 NPC 完成任何类型的移动时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCFinishNodePoint.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCFinishNodePoint.md new file mode 100644 index 00000000000..16a0a3ad156 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCFinishNodePoint.md @@ -0,0 +1,59 @@ +--- +title: OnNPCFinishNodePoint +sidebar_label: OnNPCFinishNodePoint +description: 当 NPC 在基于节点的导航过程中到达特定点时调用此回调。 +tags: ["npc", "节点", "导航"] +--- + + + +## 描述 + +当 NPC 在基于节点的导航过程中到达特定点时调用此回调。 + +| 参数 | 说明 | +| ------- | ---------------------- | +| npcid | 到达节点点的 NPC 的 ID | +| nodeid | 正在导航的节点的 ID | +| pointid | 到达的特定点的 ID | + +## 示例 + +```c +public OnNPCFinishNodePoint(npcid, nodeid, pointid) +{ + // 通知追踪此 NPC 的玩家 + for (new playerid = 0; playerid < MAX_PLAYERS; playerid++) + { + if (!IsPlayerConnected(playerid)) + continue; + + if (PlayerNPC[playerid] == npcid) + { + SendClientMessage(playerid, 0xFFFF00FF, "NPC %d 到达节点 %d 的点 %d", npcid, nodeid, pointid); + } + } + return 1; +} +``` + +## 注意事项 + +- 此回调仅在 NPC 通过 `NPC_PlayNode` 使用基于节点的导航时调用 +- 每次 NPC 到达节点内的路径点时都会调用此回调 +- `pointid` 对应节点文件中特定路径点的索引 + +## 相关函数 + +以下函数可能有用，因为它们与此回调以某种方式相关。 + +- [NPC_PlayNode](../functions/NPC_PlayNode): 开始 NPC 基于节点的导航 +- [NPC_PausePlayingNode](../functions/NPC_PausePlayingNode): 暂停 NPC 节点导航 +- [NPC_ResumePlayingNode](../functions/NPC_ResumePlayingNode): 恢复暂停的节点导航 +- [NPC_StopPlayingNode](../functions/NPC_StopPlayingNode): 停止 NPC 节点导航 + +## 相关回调 + +- [OnNPCFinishNode](OnNPCFinishNode): 当 NPC 完成导航完整节点时调用 +- [OnNPCChangeNode](OnNPCChangeNode): 当 NPC 尝试切换节点时调用 +- [OnNPCFinishMove](OnNPCFinishMove): 当 NPC 完成任何类型的移动时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCGiveDamage.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCGiveDamage.md new file mode 100644 index 00000000000..5cbed464a5a --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCGiveDamage.md @@ -0,0 +1,66 @@ +--- +title: OnNPCGiveDamage +sidebar_label: OnNPCGiveDamage +description: 当 NPC 对玩家造成伤害时调用此回调。 +tags: ["npc", "伤害"] +--- + + + +## 描述 + +当 NPC 对玩家造成伤害时调用此回调。 + +| 参数 | 说明 | +| --------- | ------------------------------------------ | +| npcid | 造成伤害的 NPC 的 ID | +| damagedid | 受到伤害的玩家的 ID | +| damage | 造成的伤害数量 | +| weaponid | 用于造成伤害的武器 ID | +| bodypart | 被击中的[身体部位](../resources/bodyparts) | + +## 返回值 + +返回 `false` 阻止伤害生效，或返回 `true` 允许伤害。 + +## 示例 + +```c +public OnNPCGiveDamage(npcid, damagedid, Float:damage, WEAPON:weaponid, bodypart) +{ + // 仅通知追踪此 NPC 的玩家 + for (new playerid = 0; playerid < MAX_PLAYERS; playerid++) + { + if (!IsPlayerConnected(playerid)) + continue; + + if (PlayerNPC[playerid] == npcid) + { + SendClientMessage(playerid, 0xFF8800FF, "NPC %d 对玩家 %d 造成了 %.1f 点伤害（武器：%d，身体部位：%d）", + npcid, damage, damagedid, _:weaponid, bodypart); + } + } + return 1; +} +``` + +## 注意事项 + +- 此回调在伤害实际应用到玩家之前调用 +- 返回 `false` 将阻止伤害生效 +- `bodypart` 参数使用与 `OnPlayerTakeDamage` 相同的值 + +## 相关函数 + +以下函数可能有用，因为它们与此回调以某种方式相关。 + +- [NPC_AimAt](../functions/NPC_AimAt): 使 NPC 瞄准位置 +- [NPC_AimAtPlayer](../functions/NPC_AimAtPlayer): 使 NPC 瞄准玩家 +- [NPC_Shoot](../functions/NPC_Shoot): 使 NPC 射击 +- [NPC_SetWeapon](../functions/NPC_SetWeapon): 设置 NPC 的武器 + +## 相关回调 + +- [OnNPCTakeDamage](OnNPCTakeDamage): 当 NPC 受到伤害时调用 +- [OnPlayerTakeDamage](OnPlayerTakeDamage): 当玩家受到伤害时调用 +- [OnPlayerGiveDamage](OnPlayerGiveDamage): 当玩家造成伤害时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCModeExit.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCModeExit.md deleted file mode 100644 index 13f85630f7c..00000000000 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCModeExit.md +++ /dev/null @@ -1,26 +0,0 @@ ---- -title: OnNPCModeExit -sidebar_label: OnNPCModeExit -description: 当NPC脚本卸载时触发该回调 -tags: ["npc"] ---- - -## 描述 - -当NPC脚本卸载时触发该回调。 - -## 示例 - -```c -public OnNPCModeExit() -{ - print("NPC脚本已卸载"); - return 1; -} -``` - -## 相关回调 - -以下回调可能与当前回调存在关联： - -- [OnNPCModeInit](OnNPCModeInit)：当NPC脚本加载时触发 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCModeInit.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCModeInit.md deleted file mode 100644 index fb8932bba93..00000000000 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCModeInit.md +++ /dev/null @@ -1,26 +0,0 @@ ---- -title: OnNPCModeInit -sidebar_label: OnNPCModeInit -description: 当NPC脚本加载时会调用此回调函数。 -tags: ["npc"] ---- - -## 说明 - -当 NPC 脚本加载时会调用此回调函数。 - -## 示例 - -```c -public OnNPCModeInit() -{ - print("NPC脚本已加载"); - return 1; -} -``` - -## 相关回调 - -以下回调函数可能与当前回调存在关联，可提供额外功能参考： - -- [OnNPCModeExit](OnNPCModeExit): 当 NPC 脚本卸载时会调用此回调函数 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCPlaybackEnd.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCPlaybackEnd.md new file mode 100644 index 00000000000..a5d7241bcd8 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCPlaybackEnd.md @@ -0,0 +1,58 @@ +--- +title: OnNPCPlaybackEnd +sidebar_label: OnNPCPlaybackEnd +description: 当 NPC 完成录制文件的回放时调用此回调。 +tags: ["npc", "回放", "录制"] +--- + + + +## 描述 + +当 NPC 完成录制文件的回放时调用此回调。 + +| 参数 | 说明 | +| -------- | ----------------------- | +| npcid | 完成回放的 NPC 的 ID | +| recordid | 完成回放的录制文件的 ID | + +## 示例 + +```c +public OnNPCPlaybackEnd(npcid, recordid) +{ + printf("[NPC] NPC %d 完成回放（录制：%d）", npcid, recordid); + + // 通知追踪此 NPC 的玩家 + for (new playerid = 0; playerid < MAX_PLAYERS; playerid++) + { + if (!IsPlayerConnected(playerid)) + continue; + + if (PlayerNPC[playerid] == npcid) + { + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 完成回放（录制 ID：%d）", npcid, recordid); + } + } + return 1; +} +``` + +## 注意事项 + +- 当录制自然到达结尾时调用此回调 +- 当使用 `NPC_StopPlayback` 手动停止回放时也会调用此回调 +- `recordid` 对应已加载的录制文件 + +## 相关函数 + +以下函数可能有用，因为它们与此回调以某种方式相关。 + +- [NPC_StartPlayback](../functions/NPC_StartPlayback): 开始 NPC 录制回放 +- [NPC_StopPlayback](../functions/NPC_StopPlayback): 停止 NPC 回放 +- [NPC_PausePlayback](../functions/NPC_PausePlayback): 暂停/恢复 NPC 回放 +- [NPC_IsPlayingPlayback](../functions/NPC_IsPlayingPlayback): 检查 NPC 是否正在回放录制 + +## 相关回调 + +- [OnNPCPlaybackStart](OnNPCPlaybackStart): 当 NPC 开始回放录制时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCPlaybackStart.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCPlaybackStart.md new file mode 100644 index 00000000000..ad5c3b4997c --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCPlaybackStart.md @@ -0,0 +1,58 @@ +--- +title: OnNPCPlaybackStart +sidebar_label: OnNPCPlaybackStart +description: 当 NPC 开始回放录制文件时调用此回调。 +tags: ["npc", "回放", "录制"] +--- + + + +## 描述 + +当 NPC 开始回放录制文件时调用此回调。 + +| 参数 | 说明 | +| -------- | ----------------------- | +| npcid | 开始回放的 NPC 的 ID | +| recordid | 开始回放的录制文件的 ID | + +## 示例 + +```c +public OnNPCPlaybackStart(npcid, recordid) +{ + printf("[NPC] NPC %d 开始回放（录制：%d）", npcid, recordid); + + // 通知追踪此 NPC 的玩家 + for (new playerid = 0; playerid < MAX_PLAYERS; playerid++) + { + if (!IsPlayerConnected(playerid)) + continue; + + if (PlayerNPC[playerid] == npcid) + { + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 开始回放（录制 ID：%d）", npcid, recordid); + } + } + return 1; +} +``` + +## 注意事项 + +- 当 `NPC_StartPlayback` 成功执行时立即调用此回调 +- `recordid` 对应已加载的录制文件 +- NPC 将遵循文件中录制的移动 + +## 相关函数 + +以下函数可能有用，因为它们与此回调以某种方式相关。 + +- [NPC_StartPlayback](../functions/NPC_StartPlayback): 开始 NPC 录制回放 +- [NPC_StopPlayback](../functions/NPC_StopPlayback): 停止 NPC 回放 +- [NPC_PausePlayback](../functions/NPC_PausePlayback): 暂停/恢复 NPC 回放 +- [NPC_IsPlayingPlayback](../functions/NPC_IsPlayingPlayback): 检查 NPC 是否正在回放录制 + +## 相关回调 + +- [OnNPCPlaybackEnd](OnNPCPlaybackEnd): 当 NPC 完成回放录制时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCRespawn.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCRespawn.md new file mode 100644 index 00000000000..f0effc3d7ef --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCRespawn.md @@ -0,0 +1,59 @@ +--- +title: OnNPCRespawn +sidebar_label: OnNPCRespawn +description: 当 NPC 重生时调用此回调。 +tags: ["npc"] +--- + + + +## 描述 + +当 NPC 重生时调用此回调。 + +| 参数 | 说明 | +| ----- | ---------------- | +| npcid | 重生的 NPC 的 ID | + +## 示例 + +```c +public OnNPCRespawn(npcid) +{ + printf("[NPC] NPC %d 已重生", npcid); + + // 通知追踪此 NPC 的玩家 + for (new playerid = 0; playerid < MAX_PLAYERS; playerid++) + { + if (!IsPlayerConnected(playerid)) + continue; + + if (PlayerNPC[playerid] == npcid) + { + SendClientMessage(playerid, 0x00FF00FF, "你追踪的 NPC %d 已重生", npcid); + } + } + return 1; +} +``` + +## 注意事项 + +- 当 NPC 使用 `NPC_Respawn` 重生后调用此回调 +- NPC 的生命值和护甲在重生期间会自动恢复 +- 重生时任何正在进行的移动、回放等都会停止 + +## 相关函数 + +以下函数可能有用，因为它们与此回调以某种方式相关。 + +- [NPC_Respawn](../functions/NPC_Respawn): 重生 NPC +- [NPC_Spawn](../functions/NPC_Spawn): 首次生成 NPC +- [NPC_SetHealth](../functions/NPC_SetHealth): 设置 NPC 的生命值 +- [NPC_SetPosition](../functions/NPC_SetPosition): 设置 NPC 的位置 + +## 相关回调 + +- [OnNPCSpawn](OnNPCSpawn): 当 NPC 首次生成时调用 +- [OnNPCDeath](OnNPCDeath): 当 NPC 死亡时调用 +- [OnPlayerSpawn](OnPlayerSpawn): 当玩家生成时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCSpawn.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCSpawn.md index afd6ca727ab..e607e1b61c4 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCSpawn.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCSpawn.md @@ -1,21 +1,59 @@ --- title: OnNPCSpawn sidebar_label: OnNPCSpawn -description: 当NPC生成时触发该回调 +description: 当 NPC 生成时调用此回调。 tags: ["npc"] --- ## 描述 -当NPC生成时触发该回调。 +当 NPC 生成时调用此回调。 + +| 参数 | 说明 | +| ----- | ---------------- | +| npcid | 生成的 NPC 的 ID | ## 示例 ```c -public OnNPCSpawn() +public OnNPCSpawn(npcid) { - print("NPC已生成"); - SendChat("大家好，我是一个机器人。"); + printf("[NPC] NPC %d 已生成", npcid); + + // 通知追踪此 NPC 的玩家 + for (new playerid = 0; playerid < MAX_PLAYERS; playerid++) + { + if (!IsPlayerConnected(playerid)) + continue; + + if (PlayerNPC[playerid] == npcid) + { + new Float:x, Float:y, Float:z; + NPC_GetPos(npcid, x, y, z); + SendClientMessage(playerid, 0x00FF00FF, "你追踪的 NPC %d 已在 (%.2f, %.2f, %.2f) 生成", npcid, x, y, z); + } + } return 1; } ``` + +## 注意事项 + +- 当 `NPC_Spawn` 成功执行时调用此回调 +- NPC 在游戏世界中变得可见和可交互 +- 你可以在此回调中设置 NPC 的初始属性和行为 +- NPC 的状态会自动设置为默认值（100 生命值，0 护甲，拳头武器） + +## 相关函数 + +- [NPC_Spawn](../functions/NPC_Spawn): 在游戏世界中生成 NPC +- [NPC_Respawn](../functions/NPC_Respawn): 重生死亡的 NPC +- [NPC_SetHealth](../functions/NPC_SetHealth): 设置 NPC 的生命值 +- [NPC_SetWeapon](../functions/NPC_SetWeapon): 设置 NPC 的武器 + +## 相关回调 + +- [OnNPCCreate](OnNPCCreate): 当 NPC 被创建时调用 +- [OnNPCRespawn](OnNPCRespawn): 当 NPC 重生时调用 +- [OnNPCDeath](OnNPCDeath): 当 NPC 死亡时调用 +- [OnPlayerSpawn](OnPlayerSpawn): 当玩家生成时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCTakeDamage.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCTakeDamage.md new file mode 100644 index 00000000000..15ec1a9ce09 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCTakeDamage.md @@ -0,0 +1,75 @@ +--- +title: OnNPCTakeDamage +sidebar_label: OnNPCTakeDamage +description: 当 NPC 受到伤害时调用此回调。 +tags: ["npc", "伤害"] +--- + + + +## 描述 + +当 NPC 受到来自玩家或其他 NPC 的伤害时调用此回调。 + +| 参数 | 说明 | +| -------- | ------------------------------------------ | +| npcid | 受到伤害的 NPC 的 ID | +| issuerid | 造成伤害的玩家/NPC 的 ID | +| damage | 受到的伤害数量 | +| weaponid | 用于造成伤害的武器 ID | +| bodypart | 被击中的[身体部位](../resources/bodyparts) | + +## 返回值 + +返回 `false` 阻止伤害生效，或返回 `true` 允许伤害。 + +## 示例 + +```c +public OnNPCTakeDamage(npcid, issuerid, Float:damage, WEAPON:weaponid, bodypart) +{ + // 仅通知追踪此 NPC 的玩家 + for (new playerid = 0; playerid < MAX_PLAYERS; playerid++) + { + if (!IsPlayerConnected(playerid)) + continue; + + if (PlayerNPC[playerid] == npcid) + { + if (issuerid == INVALID_PLAYER_ID) + { + SendClientMessage(playerid, 0xFF8800FF, "NPC %d 受到 %.1f 点伤害（武器：%d，身体部位：%d）", + npcid, damage, _:weaponid, bodypart); + } + else + { + SendClientMessage(playerid, 0xFF8800FF, "NPC %d 受到玩家 %d 造成的 %.1f 点伤害（武器：%d，身体部位：%d）", + npcid, damage, issuerid, _:weaponid, bodypart); + } + } + } + return 1; +} +``` + +## 注意事项 + +- 此回调在伤害实际应用到 NPC 之前调用 +- 返回 `false` 将阻止伤害生效 +- 如果伤害不是由玩家造成的，`issuerid` 参数将为 `INVALID_PLAYER_ID` +- 身体部位使用与 `OnPlayerTakeDamage` 相同的常量 + +## 相关函数 + +以下函数可能有用，因为它们与此回调以某种方式相关。 + +- [NPC_GetHealth](../functions/NPC_GetHealth): 获取 NPC 的当前生命值 +- [NPC_SetHealth](../functions/NPC_SetHealth): 设置 NPC 的生命值 +- [NPC_GetArmour](../functions/NPC_GetArmour): 获取 NPC 的护甲 +- [NPC_SetArmour](../functions/NPC_SetArmour): 设置 NPC 的护甲 + +## 相关回调 + +- [OnNPCGiveDamage](OnNPCGiveDamage): 当 NPC 对玩家造成伤害时调用 +- [OnNPCDeath](OnNPCDeath): 当 NPC 死亡时调用 +- [OnPlayerTakeDamage](OnPlayerTakeDamage): 当玩家受到伤害时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCWeaponShot.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCWeaponShot.md new file mode 100644 index 00000000000..65dea532e9b --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCWeaponShot.md @@ -0,0 +1,78 @@ +--- +title: OnNPCWeaponShot +sidebar_label: OnNPCWeaponShot +description: 当 NPC 开火时调用此回调。 +tags: ["npc", "武器", "射击"] +--- + + + +## 描述 + +当 NPC 开火时调用此回调。 + +| 参数 | 说明 | +| -------- | ------------------------ | +| npcid | 开火的 NPC 的 ID | +| weaponid | 开火的武器 ID | +| hittype | 命中的实体类型（如果有） | +| hitid | 命中的实体 ID（如果有） | +| fX | 子弹击中的 X 坐标 | +| fY | 子弹击中的 Y 坐标 | +| fZ | 子弹击中的 Z 坐标 | + +## 返回值 + +返回 `false` 阻止射击被处理，或返回 `true` 允许射击。 + +## 示例 + +```c +public OnNPCWeaponShot(npcid, WEAPON:weaponid, BULLET_HIT_TYPE:hittype, hitid, Float:fX, Float:fY, Float:fZ) +{ + // 仅通知追踪此 NPC 的玩家 + for (new playerid = 0; playerid < MAX_PLAYERS; playerid++) + { + if (!IsPlayerConnected(playerid)) + continue; + + if (PlayerNPC[playerid] == npcid) + { + static hitTypeNames[5][32] = { + "无", + "玩家", + "车辆", + "物体", + "玩家物体" + }; + + SendClientMessage(playerid, 0xFFFF00FF, "NPC %d 使用武器 %d 射击 %s %d（%.2f, %.2f, %.2f）", + npcid, _:weaponid, hitTypeNames[_:hittype], hitid, fX, fY, fZ); + } + } + return 1; +} +``` + +## 注意事项 + +- NPC 每次射击都会调用此回调 +- `hittype` 参数指示命中的内容（无、玩家、车辆、物体等） +- `hitid` 参数包含命中实体的 ID（玩家 ID、车辆 ID 等） +- 命中坐标显示子弹撞击的位置 +- 返回 `false` 会阻止服务器处理此次射击 + +## 相关函数 + +以下函数可能有用，因为它们与此回调以某种方式相关。 + +- [NPC_AimAt](../functions/NPC_AimAt): 使 NPC 瞄准位置 +- [NPC_AimAtPlayer](../functions/NPC_AimAtPlayer): 使 NPC 瞄准玩家 +- [NPC_StopAim](../functions/NPC_StopAim): 停止 NPC 瞄准 +- [NPC_SetWeapon](../functions/NPC_SetWeapon): 设置 NPC 的武器 +- [NPC_GetAmmo](../functions/NPC_GetAmmo): 获取 NPC 的弹药数量 + +## 相关回调 + +- [OnNPCGiveDamage](OnNPCGiveDamage): 当 NPC 对玩家造成伤害时调用 +- [OnPlayerWeaponShot](OnPlayerWeaponShot): 当玩家开火时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCWeaponStateChange.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCWeaponStateChange.md new file mode 100644 index 00000000000..1963194aaef --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCWeaponStateChange.md @@ -0,0 +1,66 @@ +--- +title: OnNPCWeaponStateChange +sidebar_label: OnNPCWeaponStateChange +description: 当 NPC 的武器状态改变时调用此回调。 +tags: ["npc", "武器"] +--- + + + +## 描述 + +当 NPC 的武器状态改变时（例如，重新装弹、弹药耗尽等）调用此回调。 + +| 参数 | 说明 | +| -------- | -------------- | +| npcid | NPC 的 ID | +| newstate | 新的武器状态 | +| oldstate | 之前的武器状态 | + +## 示例 + +```c +public OnNPCWeaponStateChange(npcid, newState, oldState) +{ + static weaponStates[5][64] = { + "未知", + "弹药耗尽", + "仅剩一发子弹", + "剩余多发子弹", + "重新装弹中" + }; + + // 仅通知追踪此 NPC 的玩家 + for (new playerid = 0; playerid < MAX_PLAYERS; playerid++) + { + if (!IsPlayerConnected(playerid)) + continue; + + if (PlayerNPC[playerid] == npcid) + { + SendClientMessage(playerid, 0xFFFF00FF, "NPC %d 武器状态：%s -> %s", + npcid, weaponStates[oldState], weaponStates[newState]); + } + } + return 1; +} +``` + +## 注意事项 + +- 此回调基于 NPC 的弹药数量和武器动作自动触发 +- 武器状态包括：无子弹、重新装弹、有更多子弹、最后一发子弹、未知 + +## 相关函数 + +以下函数可能有用，因为它们与此回调以某种方式相关。 + +- [NPC_GetWeaponState](../functions/NPC_GetWeaponState): 获取 NPC 的当前武器状态 +- [NPC_GetAmmo](../functions/NPC_GetAmmo): 获取 NPC 的弹药数量 +- [NPC_SetAmmo](../functions/NPC_SetAmmo): 设置 NPC 的弹药数量 +- [NPC_GetAmmoInClip](../functions/NPC_GetAmmoInClip): 获取当前弹夹中的弹药 +- [NPC_EnableReloading](../functions/NPC_EnableReloading): 启用/禁用自动重新装弹 + +## 相关回调 + +- [OnNPCWeaponShot](OnNPCWeaponShot): 当 NPC 开火时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnObjectMoved.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnObjectMoved.md index 7b911f88b72..b58a596b538 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnObjectMoved.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnObjectMoved.md @@ -1,13 +1,13 @@ --- title: OnObjectMoved sidebar_label: OnObjectMoved -description: 当物体通过MoveObject移动并停止时触发该回调 +description: 当物体通过MoveObject移动并停止时触发此回调 tags: ["物体"] --- ## 描述 -当物体通过MoveObject函数移动并停止时触发该回调。 +当物体通过MoveObject函数移动并停止时触发此回调。 | 参数 | 说明 | | -------- | ------------------ | @@ -15,7 +15,7 @@ tags: ["物体"] ## 返回值 -该回调在滤镜脚本中总是优先触发。 +此回调在滤镜脚本中总是优先触发。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPickupStreamIn.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPickupStreamIn.md index de032b6bf71..3511d763139 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPickupStreamIn.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPickupStreamIn.md @@ -1,7 +1,7 @@ --- title: OnPickupStreamIn sidebar_label: OnPickupStreamIn -description: 当拾取物进入玩家的可视范围时触发该回调 +description: 当拾取物进入玩家的可视范围时触发此回调 tags: ["玩家"] --- @@ -9,7 +9,7 @@ tags: ["玩家"] ## 描述 -当拾取物进入玩家的可视范围时触发该回调。 +当拾取物进入玩家的可视范围时触发此回调。 | 参数 | 说明 | | -------- | --------------------------------------------------------------- | @@ -18,7 +18,7 @@ tags: ["玩家"] ## 返回值 -该回调在游戏模式中总是优先触发。 +此回调在游戏模式中总是优先触发。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPickupStreamOut.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPickupStreamOut.md index de032b6bf71..3511d763139 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPickupStreamOut.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPickupStreamOut.md @@ -1,7 +1,7 @@ --- title: OnPickupStreamIn sidebar_label: OnPickupStreamIn -description: 当拾取物进入玩家的可视范围时触发该回调 +description: 当拾取物进入玩家的可视范围时触发此回调 tags: ["玩家"] --- @@ -9,7 +9,7 @@ tags: ["玩家"] ## 描述 -当拾取物进入玩家的可视范围时触发该回调。 +当拾取物进入玩家的可视范围时触发此回调。 | 参数 | 说明 | | -------- | --------------------------------------------------------------- | @@ -18,7 +18,7 @@ tags: ["玩家"] ## 返回值 -该回调在游戏模式中总是优先触发。 +此回调在游戏模式中总是优先触发。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerClickGangZone.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerClickGangZone.md index b84f97d5a83..0be20d5d5d5 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerClickGangZone.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerClickGangZone.md @@ -1,7 +1,7 @@ --- title: OnPlayerClickGangZone sidebar_label: OnPlayerClickGangZone -description: 当玩家在暂停菜单地图上右键点击帮派区域时触发该回调 +description: 当玩家在暂停菜单地图上右键点击帮派区域时触发此回调 tags: ["玩家", "帮派区域"] --- @@ -9,7 +9,7 @@ tags: ["玩家", "帮派区域"] ## 描述 -当玩家在暂停菜单地图上右键点击帮派区域时触发该回调。 +当玩家在暂停菜单地图上右键点击帮派区域时触发此回调。 | 参数 | 说明 | | -------- | -------------------- | @@ -18,9 +18,9 @@ tags: ["玩家", "帮派区域"] ## 返回值 -本回调不处理返回值。 +此回调不处理返回值。 -该回调在游戏模式中总是优先触发。 +此回调在游戏模式中总是优先触发。 ## 示例 @@ -28,7 +28,7 @@ tags: ["玩家", "帮派区域"] public OnPlayerClickGangZone(playerid, zoneid) { new string[128]; - format(string, sizeof(string), "您点击了帮派区域 %i", zoneid); + format(string, sizeof(string), "你点击了帮派区域 %i", zoneid); SendClientMessage(playerid, 0xFFFFFFFF, string); return 1; } diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerClickMap.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerClickMap.md index d910180eec0..be755c235a1 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerClickMap.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerClickMap.md @@ -1,13 +1,13 @@ --- title: OnPlayerClickMap sidebar_label: OnPlayerClickMap -description: 当玩家在暂停菜单地图上右键点击放置目标/路径点时触发该回调 +description: 当玩家在暂停菜单地图上右键点击放置目标/路径点时触发此回调 tags: ["玩家"] --- ## 描述 -当玩家在暂停菜单地图上右键点击放置目标/路径点时触发该回调。 +当玩家在暂停菜单地图上右键点击放置目标/路径点时触发此回调。 | 参数 | 说明 | | -------- | ------------------------------------- | @@ -21,7 +21,7 @@ tags: ["玩家"] 1 - 阻止其他滤镜脚本接收此回调 0 - 允许传递给后续滤镜脚本 -该回调在游戏模式中总是优先触发。 +此回调在游戏模式中总是优先触发。 ## 示例 @@ -37,7 +37,7 @@ public OnPlayerClickMap(playerid, Float:fX, Float:fY, Float:fZ) :::tip -本回调仅在玩家通过点击地图标记目标时触发，按键操作不会触发。若点击位置距离玩家过远，返回的Z坐标将为0（无效值），建议使用[MapAndreas](https://github.com/philip1337/samp-plugin-mapandreas)或[ColAndreas](https://github.com/Pottus/ColAndreas)插件获取精确Z坐标 +此回调仅在玩家通过点击地图标记目标时触发，按键操作不会触发。若点击位置距离玩家过远，返回的Z坐标将为0（无效值），建议使用[MapAndreas](https://github.com/philip1337/samp-plugin-mapandreas)或[ColAndreas](https://github.com/Pottus/ColAndreas)插件获取精确Z坐标 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerClickPlayer.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerClickPlayer.md index ad448bd015b..242f62ee30d 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerClickPlayer.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerClickPlayer.md @@ -1,13 +1,13 @@ --- title: OnPlayerClickPlayer sidebar_label: OnPlayerClickPlayer -description: 当玩家在记分牌上双击其他玩家时触发该回调 +description: 当玩家在记分牌上双击其他玩家时触发此回调 tags: ["玩家"] --- ## 描述 -当玩家在记分牌上双击其他玩家时触发该回调。 +当玩家在记分牌上双击其他玩家时触发此回调。 | 参数 | 说明 | | --------------- | --------------------------------------------------------- | @@ -20,7 +20,7 @@ tags: ["玩家"] 1 - 阻止其他滤镜脚本接收此回调 0 - 允许传递给后续滤镜脚本 -该回调在滤镜脚本中总是优先触发。 +此回调在滤镜脚本中总是优先触发。 ## 示例 @@ -28,7 +28,7 @@ tags: ["玩家"] public OnPlayerClickPlayer(playerid, clickedplayerid, CLICK_SOURCE:source) { new string[32]; - format(string, sizeof(string), "您点击了玩家 %d", clickedplayerid); + format(string, sizeof(string), "你点击了玩家 %d", clickedplayerid); SendClientMessage(playerid, 0xFFFFFFFF, string); return 1; } diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerClickPlayerGangZone.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerClickPlayerGangZone.md index 5a0f29a7bf1..fd4d5a158bd 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerClickPlayerGangZone.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerClickPlayerGangZone.md @@ -1,7 +1,7 @@ --- title: OnPlayerClickPlayerGangZone sidebar_label: OnPlayerClickPlayerGangZone -description: 当玩家在暂停菜单地图上右键点击个人帮派区域时触发该回调 +description: 当玩家在暂停菜单地图上右键点击个人帮派区域时触发此回调 tags: ["玩家", "帮派区域"] --- @@ -9,7 +9,7 @@ tags: ["玩家", "帮派区域"] ## 描述 -当玩家在暂停菜单地图上右键点击个人帮派区域时触发该回调。 +当玩家在暂停菜单地图上右键点击个人帮派区域时触发此回调。 | 参数 | 说明 | | -------- | ---------------------- | @@ -18,9 +18,9 @@ tags: ["玩家", "帮派区域"] ## 返回值 -本回调不处理返回值。 +此回调不处理返回值。 -该回调在游戏模式中总是优先触发。 +此回调在游戏模式中总是优先触发。 ## 示例 @@ -28,7 +28,7 @@ tags: ["玩家", "帮派区域"] public OnPlayerClickPlayerGangZone(playerid, zoneid) { new string[128]; - format(string, sizeof(string), "您点击了个人帮派区域 %i", zoneid); + format(string, sizeof(string), "你点击了个人帮派区域 %i", zoneid); SendClientMessage(playerid, 0xFFFFFFFF, string); return 1; } diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerClickPlayerTextDraw.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerClickPlayerTextDraw.md index 9596075f465..b09835b278d 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerClickPlayerTextDraw.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerClickPlayerTextDraw.md @@ -1,13 +1,13 @@ --- title: OnPlayerClickPlayerTextDraw sidebar_label: OnPlayerClickPlayerTextDraw -description: 当玩家点击个人文本绘图时触发该回调 +description: 当玩家点击个人文本绘图时触发此回调 tags: ["玩家", "文本绘图", "玩家文本绘图"] --- ## 描述 -当玩家点击个人文本绘图（player-textdraw）时触发该回调。注意：玩家按ESC取消选择模式时会触发[OnPlayerClickTextDraw](OnPlayerClickTextDraw)而非本回调。 +当玩家点击个人文本绘图（player-textdraw）时触发此回调。注意：玩家按ESC取消选择模式时会触发[OnPlayerClickTextDraw](OnPlayerClickTextDraw)而非此回调。 | 参数 | 说明 | | ----------------------- | ---------------------- | @@ -16,7 +16,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] ## 返回值 -该回调在滤镜脚本中总是优先触发，返回1将阻止其他脚本处理此事件。 +此回调在滤镜脚本中总是优先触发，返回1将阻止其他脚本处理此事件。 ## 示例 @@ -57,7 +57,7 @@ public OnPlayerClickPlayerTextDraw(playerid, PlayerText:playertextid) { if (playertextid == gPlayerTextDraw[playerid]) { - SendClientMessage(playerid, 0xFFFFFFAA, "您点击了个人文本绘图"); + SendClientMessage(playerid, 0xFFFFFFAA, "你点击了个人文本绘图"); CancelSelectTextDraw(playerid); return 1; } @@ -72,7 +72,7 @@ public OnPlayerClickPlayerTextDraw(playerid, PlayerText:playertextid) 当玩家按ESC取消选择时： - 会触发[OnPlayerClickTextDraw](OnPlayerClickTextDraw)并返回`INVALID_TEXT_DRAW` -- 本回调不会被触发 +- 此回调不会被触发 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerClickTextDraw.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerClickTextDraw.md index b94cee378d8..8415e18aa67 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerClickTextDraw.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerClickTextDraw.md @@ -1,13 +1,13 @@ --- title: OnPlayerClickTextDraw sidebar_label: OnPlayerClickTextDraw -description: 当玩家点击文本绘图或按ESC键取消选择模式时触发该回调 +description: 当玩家点击文本绘图或按ESC键取消选择模式时触发此回调 tags: ["玩家", "文本绘图"] --- ## 描述 -当玩家点击文本绘图或按ESC键取消选择模式时触发该回调。 +当玩家点击文本绘图或按ESC键取消选择模式时触发此回调。 | 参数 | 说明 | | -------------- | ----------------------------------------------------- | @@ -16,7 +16,7 @@ tags: ["玩家", "文本绘图"] ## 返回值 -该回调在滤镜脚本中总是优先触发，返回1将阻止其他脚本处理此事件。 +此回调在滤镜脚本中总是优先触发，返回1将阻止其他脚本处理此事件。 ## 示例 @@ -52,7 +52,7 @@ public OnPlayerClickTextDraw(playerid, Text:clickedid) { if (clickedid == gTextDraw) { - SendClientMessage(playerid, 0xFFFFFFAA, "您点击了文本绘图"); + SendClientMessage(playerid, 0xFFFFFFAA, "你点击了文本绘图"); CancelSelectTextDraw(playerid); return 1; } @@ -65,7 +65,7 @@ public OnPlayerClickTextDraw(playerid, Text:clickedid) :::warning - 点击区域由[TextDrawTextSize](../functions/TextDrawTextSize)定义 -- 该函数的x/y参数值不可为零或负数 +- 此函数的x/y参数值不可为零或负数 - 禁止无条件调用[CancelSelectTextDraw](../functions/CancelSelectTextDraw)，否则会导致无限循环 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerCommandText.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerCommandText.md index 77f2e876b36..f72593fc6fb 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerCommandText.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerCommandText.md @@ -1,13 +1,13 @@ --- title: OnPlayerCommandText sidebar_label: OnPlayerCommandText -description: 当玩家在聊天窗口输入命令时触发该回调 +description: 当玩家在聊天窗口输入命令时触发此回调 tags: ["玩家"] --- ## 描述 -当玩家在客户端聊天窗口输入命令时触发该回调。命令需以斜杠`/`开头，例如`/help`。 +当玩家在客户端聊天窗口输入命令时触发此回调。命令需以斜杠`/`开头，例如`/help`。 | 参数 | 说明 | | --------- | -------------------------------- | @@ -16,7 +16,7 @@ tags: ["玩家"] ## 返回值 -该回调在滤镜脚本中总是优先触发，返回1将阻止其他脚本处理此命令。 +此回调在滤镜脚本中总是优先触发，返回1将阻止其他脚本处理此命令。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerConnect.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerConnect.md index 0ff0afb9d8d..49f89807f60 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerConnect.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerConnect.md @@ -1,13 +1,13 @@ --- title: OnPlayerConnect sidebar_label: OnPlayerConnect -description: 当玩家连接到服务器时触发该回调 +description: 当玩家连接到服务器时触发此回调 tags: ["玩家"] --- ## 描述 -当玩家成功连接到服务器时触发该回调。 +当玩家成功连接到服务器时触发此回调。 | 参数 | 说明 | | -------- | ------------ | @@ -18,7 +18,7 @@ tags: ["玩家"] 0 - 阻止其他滤镜脚本接收此回调 1 - 允许传递给后续滤镜脚本 -该回调在滤镜脚本中总是优先触发。 +此回调在滤镜脚本中总是优先触发。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerDeath.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerDeath.md index ed6b5d2c46b..799d77256f3 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerDeath.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerDeath.md @@ -1,13 +1,13 @@ --- title: OnPlayerDeath sidebar_label: OnPlayerDeath -description: 当玩家死亡时触发该回调（自杀或被其他玩家击杀） +description: 当玩家死亡时触发此回调（自杀或被其他玩家击杀） tags: ["玩家"] --- ## 描述 -当玩家死亡时触发该回调，包括以下情况： +当玩家死亡时触发此回调，包括以下情况： - 自杀 - 被其他玩家击杀 @@ -23,7 +23,7 @@ tags: ["玩家"] 0 - 阻止其他滤镜脚本接收此回调 1 - 允许传递给后续滤镜脚本 -该回调在滤镜脚本中总是优先触发。 +此回调在滤镜脚本中总是优先触发。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerDisconnect.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerDisconnect.md index c4bb5f8b0f7..341120fd0c4 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerDisconnect.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerDisconnect.md @@ -1,13 +1,13 @@ --- title: OnPlayerDisconnect sidebar_label: OnPlayerDisconnect -description: 当玩家与服务器断开连接时触发该回调 +description: 当玩家与服务器断开连接时触发此回调 tags: ["玩家"] --- ## 描述 -当玩家与服务器断开连接时触发该回调。 +当玩家与服务器断开连接时触发此回调。 | 参数 | 说明 | | -------- | ------------------ | @@ -19,15 +19,15 @@ tags: ["玩家"] 0 - 阻止其他滤镜脚本接收此回调 1 - 允许传递给后续滤镜脚本 -该回调在滤镜脚本中总是优先触发。 +此回调在滤镜脚本中总是优先触发。 ## 断开原因 -| ID | 原因类型 | 详细说明 | -| --- | ---------- | ------------------------------------------ | -| 0 | 超时/崩溃 | 玩家连接丢失（游戏崩溃或网络故障） | -| 1 | 主动退出 | 玩家通过/quit命令或暂停菜单主动退出 | -| 2 | 踢出/封禁 | 被服务器踢出或封禁 | +| ID | 原因类型 | 详细说明 | +| --- | --------- | ----------------------------------- | +| 0 | 超时/崩溃 | 玩家连接丢失（游戏崩溃或网络故障） | +| 1 | 主动退出 | 玩家通过/quit命令或暂停菜单主动退出 | +| 2 | 踢出/封禁 | 被服务器踢出或封禁 | ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerEditAttachedObject.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerEditAttachedObject.md index 42796369001..abb4d84c480 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerEditAttachedObject.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerEditAttachedObject.md @@ -1,13 +1,13 @@ --- title: OnPlayerEditAttachedObject sidebar_label: OnPlayerEditAttachedObject -description: 当玩家结束附加物体编辑模式时触发该回调 -tags: ["玩家", "物体", "附加物体"] +description: 当玩家结束附加物体编辑模式时触发此回调 +tags: ["玩家", "物体", "附加"] --- ## 描述 -当玩家结束附加物体编辑模式时触发该回调。 +当玩家结束附加物体编辑模式时触发此回调。 | 参数 | 说明 | | ---------------------- | ----------------------------------------------- | @@ -31,7 +31,7 @@ tags: ["玩家", "物体", "附加物体"] 1 - 阻止其他脚本接收此回调 0 - 允许传递给后续脚本 -该回调在滤镜脚本中总是优先触发。 +此回调在滤镜脚本中总是优先触发。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerEditObject.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerEditObject.md index 908f16d422b..939e5d0c5bd 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerEditObject.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerEditObject.md @@ -1,15 +1,15 @@ --- title: OnPlayerEditObject sidebar_label: OnPlayerEditObject -description: 当玩家完成物体编辑时（通过BeginObjectEditing/BeginPlayerObjectEditing）会触发该回调函数。 +description: 当玩家完成物体编辑时（通过BeginObjectEditing/BeginPlayerObjectEditing）会触发此回调函数。 tags: ["玩家", "物体"] --- ## 描述 -当玩家完成物体编辑（[BeginObjectEditing](../functions/BeginObjectEditing)/[BeginPlayerObjectEditing](../functions/BeginPlayerObjectEditing)）时触发该回调函数。 +当玩家完成物体编辑（[BeginObjectEditing](../functions/BeginObjectEditing)/[BeginPlayerObjectEditing](../functions/BeginPlayerObjectEditing)）时触发此回调函数。 -| 参数名 | 说明 | +| 参数 | 说明 | | ---------------------- | ------------------------------------------------------- | | playerid | 进行物体编辑的玩家ID | | playerobject | 0表示全局物体，1表示玩家物体 | @@ -28,7 +28,7 @@ tags: ["玩家", "物体"] 0 - 允许将此回调传递给下一个脚本 -该回调始终在滤镜脚本中优先触发 +此回调始终在滤镜脚本中优先触发 ## 示例 @@ -93,7 +93,7 @@ public OnPlayerEditObject(playerid, playerobject, objectid, EDIT_RESPONSE:respon ## 相关函数 -以下函数可能与本回调函数相关： +以下函数可能与此回调函数相关： - [BeginPlayerObjectEditing](../functions/BeginPlayerObjectEditing): 开始编辑玩家物体 - [BeginObjectEditing](../functions/BeginObjectEditing): 开始编辑物体 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerEnterCheckpoint.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerEnterCheckpoint.md index 13b36c106b7..0aea60dcda7 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerEnterCheckpoint.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerEnterCheckpoint.md @@ -1,21 +1,21 @@ --- title: OnPlayerEnterCheckpoint sidebar_label: OnPlayerEnterCheckpoint -description: 当玩家进入为其设置的检查点时触发该回调函数。 +description: 当玩家进入为其设置的检查点时触发此回调函数。 tags: ["玩家", "检查点"] --- ## 描述 -当玩家进入为其设置的检查点时触发该回调函数。 +当玩家进入为其设置的检查点时触发此回调函数。 -| 参数名 | 说明 | +| 参数 | 说明 | | -------- | ------------------ | | playerid | 进入检查点的玩家ID | ## 返回值 -该回调始终在滤镜脚本中优先触发 +此回调始终在滤镜脚本中优先触发 ## 示例 @@ -42,7 +42,7 @@ public OnPlayerEnterCheckpoint(playerid) ## 相关回调 -以下回调函数可能与本回调相关： +以下回调函数可能与此回调相关： - [OnPlayerLeaveCheckpoint](OnPlayerLeaveCheckpoint): 当玩家离开检查点时触发 - [OnPlayerEnterRaceCheckpoint](OnPlayerEnterRaceCheckpoint): 当玩家进入竞速检查点时触发 @@ -50,7 +50,7 @@ public OnPlayerEnterCheckpoint(playerid) ## 相关函数 -以下函数可能与本回调函数相关： +以下函数可能与此回调函数相关： - [SetPlayerCheckpoint](../functions/SetPlayerCheckpoint): 为玩家创建检查点 - [DisablePlayerCheckpoint](../functions/DisablePlayerCheckpoint): 禁用玩家的当前检查点 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerEnterGangZone.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerEnterGangZone.md index 959affa6502..95c6851e208 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerEnterGangZone.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerEnterGangZone.md @@ -1,7 +1,7 @@ --- title: OnPlayerEnterGangZone sidebar_label: OnPlayerEnterGangZone -description: 当玩家进入帮派区域时触发该回调函数 +description: 当玩家进入帮派区域时触发此回调函数 tags: ["玩家", "帮派区域"] --- @@ -9,16 +9,16 @@ tags: ["玩家", "帮派区域"] ## 描述 -当玩家进入帮派区域时触发该回调函数 +当玩家进入帮派区域时触发此回调函数 -| 参数名 | 说明 | +| 参数 | 说明 | | -------- | -------------------- | | playerid | 进入帮派区域的玩家ID | | zoneid | 玩家进入的帮派区域ID | ## 返回值 -该回调始终在游戏模式中优先触发 +此回调始终在游戏模式中优先触发 ## 示例 @@ -34,13 +34,13 @@ public OnPlayerEnterGangZone(playerid, zoneid) ## 相关回调 -以下回调函数可能与本回调相关： +以下回调函数可能与此回调相关： - [OnPlayerLeaveGangZone](OnPlayerLeaveGangZone): 当玩家离开帮派区域时触发 ## 相关函数 -以下函数可能与本回调函数相关： +以下函数可能与此回调函数相关： - [GangZoneCreate](../functions/GangZoneCreate): 创建帮派区域（彩色雷达区域） - [GangZoneDestroy](../functions/GangZoneDestroy): 销毁帮派区域 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerEnterPlayerGangZone.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerEnterPlayerGangZone.md index aa91c67f4da..2f8ae287948 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerEnterPlayerGangZone.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerEnterPlayerGangZone.md @@ -1,7 +1,7 @@ --- title: OnPlayerEnterPlayerGangZone sidebar_label: OnPlayerEnterPlayerGangZone -description: 当玩家进入玩家帮派区域时触发该回调函数 +description: 当玩家进入玩家帮派区域时触发此回调函数 tags: ["玩家", "帮派区域"] --- @@ -9,16 +9,16 @@ tags: ["玩家", "帮派区域"] ## 描述 -当玩家进入玩家帮派区域时触发该回调函数 +当玩家进入玩家帮派区域时触发此回调函数 -| 参数名 | 说明 | +| 参数 | 说明 | | -------- | ------------------------ | | playerid | 进入玩家帮派区域的玩家ID | | zoneid | 玩家进入的玩家帮派区域ID | ## 返回值 -该回调始终在游戏模式中优先触发 +此回调始终在游戏模式中优先触发 ## 示例 @@ -34,13 +34,13 @@ public OnPlayerEnterPlayerGangZone(playerid, zoneid) ## 相关回调 -以下回调函数可能与本回调相关： +以下回调函数可能与此回调相关： - [OnPlayerLeavePlayerGangZone](OnPlayerLeavePlayerGangZone): 当玩家离开玩家帮派区域时触发 ## 相关函数 -以下函数可能与本回调函数相关： +以下函数可能与此回调函数相关： - [CreatePlayerGangZone](../functions/CreatePlayerGangZone): 创建玩家帮派区域 - [PlayerGangZoneDestroy](../functions/PlayerGangZoneDestroy): 销毁玩家帮派区域 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerEnterRaceCheckpoint.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerEnterRaceCheckpoint.md index 6d3a08a68ce..665b19f1673 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerEnterRaceCheckpoint.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerEnterRaceCheckpoint.md @@ -1,21 +1,21 @@ --- title: OnPlayerEnterRaceCheckpoint sidebar_label: OnPlayerEnterRaceCheckpoint -description: 当玩家进入竞速检查点时触发该回调函数。 +description: 当玩家进入竞速检查点时触发此回调函数。 tags: ["玩家", "检查点", "竞速检查点"] --- ## 描述 -当玩家进入竞速检查点时触发该回调函数。 +当玩家进入竞速检查点时触发此回调函数。 -| 参数名 | 说明 | +| 参数 | 说明 | | -------- | ---------------------- | | playerid | 进入竞速检查点的玩家ID | ## 返回值 -该回调始终在滤镜脚本中优先触发 +此回调始终在滤镜脚本中优先触发 ## 示例 @@ -33,7 +33,7 @@ public OnPlayerEnterRaceCheckpoint(playerid) ## 相关回调 -以下回调函数可能与本回调相关： +以下回调函数可能与此回调相关： - [OnPlayerEnterCheckpoint](OnPlayerEnterCheckpoint): 当玩家进入检查点时触发 - [OnPlayerLeaveCheckpoint](OnPlayerLeaveCheckpoint): 当玩家离开检查点时触发 @@ -41,7 +41,7 @@ public OnPlayerEnterRaceCheckpoint(playerid) ## 相关函数 -以下函数可能与本回调函数相关： +以下函数可能与此回调函数相关： - [SetPlayerCheckpoint](../functions/SetPlayerCheckpoint): 为玩家创建检查点 - [DisablePlayerCheckpoint](../functions/DisablePlayerCheckpoint): 禁用玩家的当前检查点 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerEnterVehicle.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerEnterVehicle.md index e587ad9490f..419bc884f8a 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerEnterVehicle.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerEnterVehicle.md @@ -1,15 +1,15 @@ --- title: OnPlayerEnterVehicle sidebar_label: OnPlayerEnterVehicle -description: 当玩家开始进入车辆时触发该回调函数（此时玩家尚未完全进入车辆）。 +description: 当玩家开始进入车辆时触发此回调函数（此时玩家尚未完全进入车辆）。 tags: ["玩家", "车辆"] --- ## 描述 -当玩家开始进入车辆时触发该回调函数（此时玩家尚未完全进入车辆）。 +当玩家开始进入车辆时触发此回调函数（此时玩家尚未完全进入车辆）。 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------- | -------------------------------------- | | playerid | 尝试进入车辆的玩家ID | | vehicleid | 玩家尝试进入的车辆ID | @@ -17,7 +17,7 @@ tags: ["玩家", "车辆"] ## 返回值 -该回调始终在滤镜脚本中优先触发 +此回调始终在滤镜脚本中优先触发 ## 示例 @@ -35,21 +35,21 @@ public OnPlayerEnterVehicle(playerid, vehicleid, ispassenger) :::tip -- 该回调在玩家开始进入车辆时触发，而非完全进入后触发。详见 [OnPlayerStateChange](OnPlayerStateChange) -- 即使玩家被拒绝进入车辆（例如车辆已上锁或满员），该回调仍会被触发（但仅限作为乘客的情况） +- 此回调在玩家开始进入车辆时触发，而非完全进入后触发。详见 [OnPlayerStateChange](OnPlayerStateChange) +- 即使玩家被拒绝进入车辆（例如车辆已上锁或满员），此回调仍会被触发（但仅限作为乘客的情况） ::: ## 相关回调 -以下回调函数可能与本回调相关： +以下回调函数可能与此回调相关： - [OnPlayerExitVehicle](OnPlayerExitVehicle): 当玩家离开车辆时触发 - [OnPlayerStateChange](OnPlayerStateChange): 当玩家状态改变时触发 ## 相关函数 -以下函数可能与本回调函数相关： +以下函数可能与此回调函数相关： - [PutPlayerInVehicle](../functions/PutPlayerInVehicle): 将玩家放入车辆中 - [GetPlayerVehicleSeat](../functions/GetPlayerVehicleSeat): 获取玩家所在车辆座位 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerExitVehicle.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerExitVehicle.md index caa2c1a813f..505f567c8f3 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerExitVehicle.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerExitVehicle.md @@ -1,22 +1,22 @@ --- title: OnPlayerExitVehicle sidebar_label: OnPlayerExitVehicle -description: 当玩家开始退出车辆时触发该回调函数。 +description: 当玩家开始退出车辆时触发此回调函数。 tags: ["玩家", "车辆"] --- ## 描述 -当玩家开始退出车辆时触发该回调函数。 +当玩家开始退出车辆时触发此回调函数。 -| 参数名 | 说明 | +| 参数 | 说明 | | --------- | -------------------- | | playerid | 正在退出车辆的玩家ID | | vehicleid | 玩家正在退出的车辆ID | ## 返回值 -该回调始终在滤镜脚本中优先触发 +此回调始终在滤镜脚本中优先触发 ## 示例 @@ -34,7 +34,7 @@ public OnPlayerExitVehicle(playerid, vehicleid) :::warning -- 以下情况不会触发该回调： +- 以下情况不会触发此回调： - 玩家从摩托车上摔落 - 使用[SetPlayerPos](../functions/SetPlayerPos)等函数强制移出玩家 - 如需检测这些情况，请使用[OnPlayerStateChange](OnPlayerStateChange)回调： @@ -45,14 +45,14 @@ public OnPlayerExitVehicle(playerid, vehicleid) ## 相关回调 -以下回调函数可能与本回调相关： +以下回调函数可能与此回调相关： - [OnPlayerEnterVehicle](OnPlayerEnterVehicle): 当玩家开始进入车辆时触发 - [OnPlayerStateChange](OnPlayerStateChange): 当玩家状态改变时触发 ## 相关函数 -以下函数可能与本回调函数相关： +以下函数可能与此回调函数相关： - [RemovePlayerFromVehicle](../functions/RemovePlayerFromVehicle): 强制将玩家移出车辆 - [GetPlayerVehicleSeat](../functions/GetPlayerVehicleSeat): 获取玩家所在车辆座位 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerExitedMenu.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerExitedMenu.md index 5a5cc939e6f..a57d7b568e9 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerExitedMenu.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerExitedMenu.md @@ -1,21 +1,21 @@ --- title: OnPlayerExitedMenu sidebar_label: OnPlayerExitedMenu -description: 当玩家退出菜单时触发该回调函数。 +description: 当玩家退出菜单时触发此回调函数。 tags: ["玩家", "菜单"] --- ## 描述 -当玩家退出菜单时触发该回调函数。 +当玩家退出菜单时触发此回调函数。 -| 参数名 | 说明 | +| 参数 | 说明 | | -------- | ---------------- | | playerid | 退出菜单的玩家ID | ## 返回值 -该回调始终在游戏模式中优先触发 +此回调始终在游戏模式中优先触发 ## 示例 @@ -29,13 +29,13 @@ public OnPlayerExitedMenu(playerid) ## 相关回调 -以下回调函数可能与本回调相关： +以下回调函数可能与此回调相关： - [OnPlayerSelectedMenuRow](OnPlayerSelectedMenuRow): 当玩家选择菜单中的某行时触发 ## 相关函数 -以下函数可能与本回调函数相关： +以下函数可能与此回调函数相关： - [CreateMenu](../functions/CreateMenu): 创建菜单 - [DestroyMenu](../functions/DestroyMenu): 销毁菜单 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerFinishedDownloading.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerFinishedDownloading.md index 0bd0d88d5f2..6435464b81f 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerFinishedDownloading.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerFinishedDownloading.md @@ -1,7 +1,7 @@ --- title: OnPlayerFinishedDownloading sidebar_label: OnPlayerFinishedDownloading -description: 当玩家完成自定义模型下载时触发该回调函数。 +description: 当玩家完成自定义模型下载时触发此回调函数。 tags: ["玩家"] --- @@ -9,16 +9,16 @@ tags: ["玩家"] ## 描述 -当玩家完成自定义模型下载时触发该回调函数。关于如何添加自定义模型的详细信息，请参考[发布帖](https://sampforum.blast.hk/showthread.php?tid=644105)和[教程](https://sampforum.blast.hk/showthread.php?tid=644123)。 +当玩家完成自定义模型下载时触发此回调函数。关于如何添加自定义模型的详细信息，请参考[发布帖](https://sampforum.blast.hk/showthread.php?tid=644105)和[教程](https://sampforum.blast.hk/showthread.php?tid=644123)。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------ | ---------------------------- | | playerid | 完成自定义模型下载的玩家ID | | virtualworld | 玩家完成下载的所属虚拟世界ID | ## 返回值 -本回调函数不处理返回值 +此回调函数不处理返回值 ## 示例 @@ -34,13 +34,13 @@ public OnPlayerFinishedDownloading(playerid, virtualworld) :::tip -每次玩家切换虚拟世界时都会触发该回调，即使该世界中没有自定义模型。 +每次玩家切换虚拟世界时都会触发此回调，即使该世界中没有自定义模型。 ::: ## 相关回调 -以下回调函数可能与本回调相关： +以下回调函数可能与此回调相关： - [OnPlayerConnect](OnPlayerConnect): 当玩家连接服务器时触发 - [OnPlayerDisconnect](OnPlayerDisconnect): 当玩家断开连接时触发 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerGiveDamage.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerGiveDamage.md index d7bdd5516bb..534159801c5 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerGiveDamage.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerGiveDamage.md @@ -1,15 +1,15 @@ --- title: OnPlayerGiveDamage sidebar_label: OnPlayerGiveDamage -description: 当玩家对另一名玩家造成伤害时触发该回调函数。 +description: 当玩家对另一名玩家造成伤害时触发此回调函数。 tags: ["玩家"] --- ## 描述 -当玩家对另一名玩家造成伤害时触发该回调函数。 +当玩家对另一名玩家造成伤害时触发此回调函数。 -| 参数名 | 说明 | +| 参数 | 说明 | | --------------- | ------------------------------------------ | | playerid | 造成伤害的玩家ID | | damagedid | 受到伤害的玩家ID | @@ -23,7 +23,7 @@ tags: ["玩家"] 0 - 允许将此回调传递给其他滤镜脚本 -该回调始终在滤镜脚本中优先触发，返回1将阻止其他滤镜脚本处理 +此回调始终在滤镜脚本中优先触发，返回1将阻止其他滤镜脚本处理 ## 示例 @@ -46,7 +46,7 @@ public OnPlayerGiveDamage(playerid, damagedid, Float:amount, WEAPON:weaponid, bo :::tip -- 请注意本函数在某些情况下可能不够精确 +- 请注意此函数在某些情况下可能不够精确 - 如需阻止特定玩家互相伤害，请使用[SetPlayerTeam](../functions/SetPlayerTeam) - 火焰类武器（如燃烧瓶/18号武器）会返回37号武器ID（火焰喷射器） - 爆炸类武器（如RPG、手雷）会返回51号武器ID @@ -60,7 +60,7 @@ public OnPlayerGiveDamage(playerid, damagedid, Float:amount, WEAPON:weaponid, bo ## 相关回调 -以下回调函数可能与本回调相关： +以下回调函数可能与此回调相关： - [OnPlayerTakeDamage](OnPlayerTakeDamage): 当玩家受到伤害时触发 - [OnPlayerWeaponShot](OnPlayerWeaponShot): 当玩家开火时触发 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerGiveDamageActor.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerGiveDamageActor.md index 25f31b5daf1..92c9edb8b60 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerGiveDamageActor.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerGiveDamageActor.md @@ -1,7 +1,7 @@ --- title: OnPlayerGiveDamageActor sidebar_label: OnPlayerGiveDamageActor -description: 当玩家对角色造成伤害时触发该回调函数。 +description: 当玩家对角色造成伤害时触发此回调函数。 tags: ["玩家", 角色] --- @@ -9,9 +9,9 @@ tags: ["玩家", 角色] ## 描述 -当玩家对角色造成伤害时触发该回调函数。 +当玩家对角色造成伤害时触发此回调函数。 -| 参数名 | 说明 | +| 参数 | 说明 | | --------------- | ------------------------------------------ | | playerid | 造成伤害的玩家ID | | damaged_actorid | 受到伤害的角色ID | @@ -25,7 +25,7 @@ tags: ["玩家", 角色] 0 - 允许将此回调传递给其他滤镜脚本 -该回调始终在滤镜脚本中优先触发，返回1将阻止其他滤镜脚本处理 +此回调始终在滤镜脚本中优先触发，返回1将阻止其他滤镜脚本处理 ## 示例 @@ -55,14 +55,14 @@ public OnPlayerGiveDamageActor(playerid, damaged_actorid, Float:amount, WEAPON:w ## 相关回调 -以下回调函数可能与本回调相关： +以下回调函数可能与此回调相关： - [OnActorStreamOut](OnActorStreamOut): 当角色被玩家客户端流卸载时触发 - [OnActorStreamIn](OnActorStreamOut): 当角色被玩家客户端流加载时触发 ## 相关函数 -以下函数可能与本回调函数相关： +以下函数可能与此回调函数相关： - [CreateActor](../functions/CreateActor): 创建角色（静态NPC） - [SetActorInvulnerable](../functions/SetActorInvulnerable): 设置角色无敌状态 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerInteriorChange.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerInteriorChange.md index e4f5873bbd1..df36d592849 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerInteriorChange.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerInteriorChange.md @@ -1,15 +1,15 @@ --- title: OnPlayerInteriorChange sidebar_label: OnPlayerInteriorChange -description: 当玩家切换室内区域时触发该回调函数。 +description: 当玩家切换室内区域时触发此回调函数。 tags: ["玩家"] --- ## 描述 -当玩家切换室内区域时触发该回调函数。可能由[SetPlayerInterior](../functions/SetPlayerInterior)触发，或当玩家进入/离开建筑物时触发。 +当玩家切换室内区域时触发此回调函数。可能由[SetPlayerInterior](../functions/SetPlayerInterior)触发，或当玩家进入/离开建筑物时触发。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------- | ------------------------ | | playerid | 切换室内区域的玩家ID | | newinteriorid | 玩家当前所在室内区域ID | @@ -17,7 +17,7 @@ tags: ["玩家"] ## 返回值 -该回调始终在游戏模式中优先触发 +此回调始终在游戏模式中优先触发 ## 示例 @@ -33,13 +33,13 @@ public OnPlayerInteriorChange(playerid, newinteriorid, oldinteriorid) ## 相关回调 -以下回调函数可能与本回调相关： +以下回调函数可能与此回调相关： - [OnPlayerStateChange](OnPlayerStateChange): 当玩家状态改变时触发 ## 相关函数 -以下函数可能与本回调函数相关： +以下函数可能与此回调函数相关： - [SetPlayerInterior](../functions/SetPlayerInterior): 设置玩家室内区域 - [GetPlayerInterior](../functions/GetPlayerInterior): 获取玩家当前室内区域 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerKeyStateChange.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerKeyStateChange.md index 7f3039df123..dd5a0583e50 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerKeyStateChange.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerKeyStateChange.md @@ -9,7 +9,7 @@ tags: ["玩家"] 当玩家操作任何[受支持按键](../resources/keys)的状态发生改变（按下/释放）时触发此回调。
方向键（上/下/左/右）不会触发 OnPlayerKeyStateChange。 -| 参数名 | 说明 | +| 参数 | 说明 | | -------- | ---------------------------------------------------------- | | playerid | 操作按键的玩家 ID | | newkeys | 当前按下的按键位掩码 - [详见此处](../resources/keys) | @@ -17,7 +17,7 @@ tags: ["玩家"] ## 返回值 -- 本回调不处理返回值 +- 此回调不处理返回值 - 始终在游戏模式脚本中优先触发 ## 注意事项 @@ -36,7 +36,7 @@ NPC 也会触发此回调 ## 相关函数 -以下函数可能与本回调有关联： +以下函数可能与此回调有关联： - [GetPlayerKeys](../functions/GetPlayerKeys): 检测玩家当前按下的按键 @@ -44,7 +44,7 @@ NPC 也会触发此回调 ### 基本原理 -本回调在玩家按下或释放任何受支持按键时触发（参见[按键列表](../resources/keys)）。
这些"按键"并非真实键盘映射，而是《圣安地列斯》的功能键绑定。例如无法直接检测空格键，但可以检测"冲刺"功能键（默认绑定为空格）。 +此回调在玩家按下或释放任何受支持按键时触发（参见[按键列表](../resources/keys)）。
这些"按键"并非真实键盘映射，而是《圣安地列斯》的功能键绑定。例如无法直接检测空格键，但可以检测"冲刺"功能键（默认绑定为空格）。 ### 参数解析 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerLeaveCheckpoint.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerLeaveCheckpoint.md index 47fa87d7506..9c17f57ebcf 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerLeaveCheckpoint.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerLeaveCheckpoint.md @@ -1,21 +1,21 @@ --- title: OnPlayerLeaveCheckpoint sidebar_label: OnPlayerLeaveCheckpoint -description: 当玩家离开通过SetPlayerCheckpoint设置的检查点时触发该回调函数。 +description: 当玩家离开通过SetPlayerCheckpoint设置的检查点时触发此回调函数。 tags: ["玩家", "检查点"] --- ## 描述 -当玩家离开通过[SetPlayerCheckpoint](../functions/SetPlayerCheckpoint)设置的检查点时触发该回调函数。同一时间只能设置一个检查点。 +当玩家离开通过[SetPlayerCheckpoint](../functions/SetPlayerCheckpoint)设置的检查点时触发此回调函数。同一时间只能设置一个检查点。 -| 参数名 | 说明 | +| 参数 | 说明 | | -------- | ------------------ | | playerid | 离开检查点的玩家ID | ## 返回值 -该回调始终在滤镜脚本中优先触发 +此回调始终在滤镜脚本中优先触发 ## 示例 @@ -33,7 +33,7 @@ public OnPlayerLeaveCheckpoint(playerid) ## 相关回调 -以下回调函数可能与本回调相关： +以下回调函数可能与此回调相关： - [OnPlayerEnterCheckpoint](OnPlayerEnterCheckpoint): 当玩家进入检查点时触发 - [OnPlayerEnterRaceCheckpoint](OnPlayerEnterRaceCheckpoint): 当玩家进入竞速检查点时触发 @@ -41,7 +41,7 @@ public OnPlayerLeaveCheckpoint(playerid) ## 相关函数 -以下函数可能与本回调函数相关： +以下函数可能与此回调函数相关： - [SetPlayerCheckpoint](../functions/SetPlayerCheckpoint): 为玩家创建检查点 - [DisablePlayerCheckpoint](../functions/DisablePlayerCheckpoint): 禁用玩家的当前检查点 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerLeaveGangZone.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerLeaveGangZone.md index a7523e34623..4f31ac0cbc7 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerLeaveGangZone.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerLeaveGangZone.md @@ -1,7 +1,7 @@ --- title: OnPlayerLeaveGangZone sidebar_label: OnPlayerLeaveGangZone -description: 当玩家离开帮派区域时触发该回调函数 +description: 当玩家离开帮派区域时触发此回调函数 tags: ["玩家", "帮派区域"] --- @@ -9,16 +9,16 @@ tags: ["玩家", "帮派区域"] ## 描述 -当玩家离开帮派区域时触发该回调函数 +当玩家离开帮派区域时触发此回调函数 -| 参数名 | 说明 | +| 参数 | 说明 | | -------- | -------------------- | | playerid | 离开帮派区域的玩家ID | | zoneid | 玩家离开的帮派区域ID | ## 返回值 -该回调始终在游戏模式中优先触发 +此回调始终在游戏模式中优先触发 ## 示例 @@ -34,13 +34,13 @@ public OnPlayerLeaveGangZone(playerid, zoneid) ## 相关回调 -以下回调函数可能与本回调相关： +以下回调函数可能与此回调相关： - [OnPlayerEnterGangZone](OnPlayerEnterGangZone): 当玩家进入帮派区域时触发 ## 相关函数 -以下函数可能与本回调函数相关： +以下函数可能与此回调函数相关： - [GangZoneCreate](../functions/GangZoneCreate): 创建帮派区域（彩色雷达区域） - [GangZoneDestroy](../functions/GangZoneDestroy): 销毁帮派区域 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerLeavePlayerGangZone.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerLeavePlayerGangZone.md index bef9788fa8f..024a61cdfb2 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerLeavePlayerGangZone.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerLeavePlayerGangZone.md @@ -1,7 +1,7 @@ --- title: OnPlayerLeavePlayerGangZone sidebar_label: OnPlayerLeavePlayerGangZone -description: 当玩家退出玩家帮派区域时触发该回调函数 +description: 当玩家退出玩家帮派区域时触发此回调函数 tags: ["玩家", "帮派区域"] --- @@ -9,16 +9,16 @@ tags: ["玩家", "帮派区域"] ## 描述 -当玩家退出玩家帮派区域时触发该回调函数 +当玩家退出玩家帮派区域时触发此回调函数 -| 参数名 | 说明 | +| 参数 | 说明 | | -------- | ------------------------ | | playerid | 退出玩家帮派区域的玩家ID | | zoneid | 玩家退出的玩家帮派区域ID | ## 返回值 -该回调始终在游戏模式中优先触发 +此回调始终在游戏模式中优先触发 ## 示例 @@ -34,13 +34,13 @@ public OnPlayerLeavePlayerGangZone(playerid, zoneid) ## 相关回调 -以下回调函数可能与本回调相关： +以下回调函数可能与此回调相关： - [OnPlayerEnterPlayerGangZone](OnPlayerEnterPlayerGangZone): 当玩家进入玩家帮派区域时触发 ## 相关函数 -以下函数可能与本回调函数相关： +以下函数可能与此回调函数相关： - [CreatePlayerGangZone](../functions/CreatePlayerGangZone): 创建玩家帮派区域 - [PlayerGangZoneDestroy](../functions/PlayerGangZoneDestroy): 销毁玩家帮派区域 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerLeaveRaceCheckpoint.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerLeaveRaceCheckpoint.md index c77c3b90987..a4d23eaddab 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerLeaveRaceCheckpoint.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerLeaveRaceCheckpoint.md @@ -1,21 +1,21 @@ --- title: OnPlayerLeaveRaceCheckpoint sidebar_label: OnPlayerLeaveRaceCheckpoint -description: 当玩家离开竞速检查点时触发该回调函数。 +description: 当玩家离开竞速检查点时触发此回调函数。 tags: ["玩家", "检查点", "竞速检查点"] --- ## 描述 -当玩家离开竞速检查点时触发该回调函数。 +当玩家离开竞速检查点时触发此回调函数。 -| 参数名 | 说明 | +| 参数 | 说明 | | -------- | ---------------------- | | playerid | 离开竞速检查点的玩家ID | ## 返回值 -该回调始终在滤镜脚本中优先触发 +此回调始终在滤镜脚本中优先触发 ## 示例 @@ -33,7 +33,7 @@ public OnPlayerLeaveRaceCheckpoint(playerid) ## 相关回调 -以下回调函数可能与本回调相关： +以下回调函数可能与此回调相关： - [OnPlayerEnterCheckpoint](OnPlayerEnterCheckpoint): 当玩家进入检查点时触发 - [OnPlayerLeaveCheckpoint](OnPlayerLeaveCheckpoint): 当玩家离开检查点时触发 @@ -41,7 +41,7 @@ public OnPlayerLeaveRaceCheckpoint(playerid) ## 相关函数 -以下函数可能与本回调函数相关： +以下函数可能与此回调函数相关： - [SetPlayerCheckpoint](../functions/SetPlayerCheckpoint): 为玩家创建检查点 - [DisablePlayerCheckpoint](../functions/DisablePlayerCheckpoint): 禁用玩家的当前检查点 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerObjectMoved.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerObjectMoved.md index 99f2be34569..b1c200141c4 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerObjectMoved.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerObjectMoved.md @@ -1,22 +1,22 @@ --- title: OnPlayerObjectMoved sidebar_label: OnPlayerObjectMoved -description: 当玩家物体通过MovePlayerObject移动完成后触发该回调函数。 +description: 当玩家物体通过MovePlayerObject移动完成后触发此回调函数。 tags: ["玩家", "物体", "玩家物体"] --- ## 描述 -当玩家物体通过[MovePlayerObject](../functions/MovePlayerObject)移动并停止时触发该回调函数。 +当玩家物体通过[MovePlayerObject](../functions/MovePlayerObject)移动并停止时触发此回调函数。 -| 参数名 | 说明 | +| 参数 | 说明 | | -------- | ---------------------- | | playerid | 该玩家物体所属的玩家ID | | objectid | 被移动的玩家物体ID | ## 返回值 -该回调始终在滤镜脚本中优先触发 +此回调始终在滤镜脚本中优先触发 ## 示例 @@ -34,13 +34,13 @@ public OnPlayerObjectMoved(playerid, objectid) ## 相关回调 -以下回调函数可能与本回调相关： +以下回调函数可能与此回调相关： - [OnObjectMoved](OnObjectMoved): 当全局物体停止移动时触发 ## 相关函数 -以下函数可能与本回调函数相关： +以下函数可能与此回调函数相关： - [MovePlayerObject](../functions/MovePlayerObject): 移动玩家物体 - [IsPlayerObjectMoving](../functions/IsPlayerObjectMoving): 检测玩家物体是否在移动中 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerPickUpPickup.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerPickUpPickup.md index 42af008f326..e367225f675 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerPickUpPickup.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerPickUpPickup.md @@ -1,22 +1,22 @@ --- title: OnPlayerPickUpPickup sidebar_label: OnPlayerPickUpPickup -description: 当玩家拾取通过CreatePickup创建的拾取物时触发该回调函数。 +description: 当玩家拾取通过CreatePickup创建的拾取物时触发此回调函数。 tags: ["玩家"] --- ## 描述 -当玩家拾取通过[CreatePickup](../functions/CreatePickup)创建的拾取物时触发该回调函数。 +当玩家拾取通过[CreatePickup](../functions/CreatePickup)创建的拾取物时触发此回调函数。 -| 参数名 | 说明 | +| 参数 | 说明 | | -------- | ----------------------------------------------------------- | | playerid | 拾取拾取物的玩家ID | | pickupid | 拾取物ID（由[CreatePickup](../functions/CreatePickup)返回） | ## 返回值 -该回调始终在游戏模式中优先触发 +此回调始终在游戏模式中优先触发 ## 示例 @@ -58,14 +58,14 @@ public OnPlayerPickUpPickup(playerid, pickupid) ## 相关回调 -以下回调函数可能与本回调相关： +以下回调函数可能与此回调相关： - [OnPickupStreamIn](OnPickupStreamIn): 当拾取物进入玩家可视范围时触发 - [OnPickupStreamOut](OnPickupStreamOut): 当拾取物离开玩家可视范围时触发 ## 相关函数 -以下函数可能与本回调函数相关： +以下函数可能与此回调函数相关： - [CreatePickup](../functions/CreatePickup): 创建常规拾取物 - [DestroyPickup](../functions/DestroyPickup): 销毁拾取物 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerPickUpPlayerPickup.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerPickUpPlayerPickup.md index ea78ff6d9fd..1699d9ad6a7 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerPickUpPlayerPickup.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerPickUpPlayerPickup.md @@ -1,7 +1,7 @@ --- title: OnPlayerPickUpPlayerPickup sidebar_label: OnPlayerPickUpPlayerPickup -description: 当玩家拾取通过CreatePlayerPickup创建的玩家拾取物时触发该回调函数 +description: 当玩家拾取通过CreatePlayerPickup创建的玩家拾取物时触发此回调函数 tags: ["玩家", "拾取物", "玩家拾取物"] --- @@ -9,16 +9,16 @@ tags: ["玩家", "拾取物", "玩家拾取物"] ## 描述 -当玩家拾取通过[CreatePlayerPickup](../functions/CreatePlayerPickup)创建的玩家专属拾取物时触发该回调函数。 +当玩家拾取通过[CreatePlayerPickup](../functions/CreatePlayerPickup)创建的玩家专属拾取物时触发此回调函数。 -| 参数名 | 说明 | +| 参数 | 说明 | | -------- | ------------------------------------------------------------------------------- | | playerid | 拾取玩家专属拾取物的玩家ID | | pickupid | 玩家专属拾取物ID（由[CreatePlayerPickup](../functions/CreatePlayerPickup)返回） | ## 返回值 -该回调始终在游戏模式中优先触发 +此回调始终在游戏模式中优先触发 ## 示例 @@ -60,14 +60,14 @@ public OnPlayerPickUpPlayerPickup(playerid, pickupid) ## 相关回调 -以下回调函数可能与本回调相关： +以下回调函数可能与此回调相关： - [OnPlayerPickupStreamIn](OnPlayerPickupStreamIn): 当玩家专属拾取物流加载时触发 - [OnPlayerPickupStreamOut](OnPlayerPickupStreamOut): 当玩家专属拾取物流卸载时触发 ## 相关函数 -以下函数可能与本回调函数相关： +以下函数可能与此回调函数相关： - [CreatePlayerPickup](../functions/CreatePlayerPickup): 创建玩家专属拾取物 - [DestroyPlayerPickup](../functions/DestroyPlayerPickup): 销毁玩家专属拾取物 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerPickupStreamIn.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerPickupStreamIn.md index aa94c6f204d..1c5af1e4116 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerPickupStreamIn.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerPickupStreamIn.md @@ -1,7 +1,7 @@ --- title: OnPlayerPickupStreamIn sidebar_label: OnPlayerPickupStreamIn -description: 当玩家拾取物流加载时触发该回调函数 +description: 当玩家拾取物流加载时触发此回调函数 tags: ["玩家", "拾取物", "玩家拾取物"] --- @@ -9,16 +9,16 @@ tags: ["玩家", "拾取物", "玩家拾取物"] ## 描述 -当玩家专属拾取物进入玩家可视范围时触发该回调函数 +当玩家专属拾取物进入玩家可视范围时触发此回调函数 -| 参数名 | 说明 | +| 参数 | 说明 | | -------- | ------------------------------------------------------------------------------- | | pickupid | 玩家专属拾取物ID（由[CreatePlayerPickup](../functions/CreatePlayerPickup)返回） | | playerid | 所属玩家ID | ## 返回值 -该回调始终在游戏模式中优先触发 +此回调始终在游戏模式中优先触发 ## 示例 @@ -54,14 +54,14 @@ public OnPlayerPickupStreamIn(pickupid, playerid) ## 相关回调 -以下回调函数可能与本回调相关： +以下回调函数可能与此回调相关： - [OnPlayerPickUpPlayerPickup](OnPlayerPickUpPlayerPickup): 当玩家拾取专属拾取物时触发 - [OnPlayerPickupStreamOut](OnPlayerPickupStreamOut): 当玩家专属拾取物流卸载时触发 ## 相关函数 -以下函数可能与本回调函数相关： +以下函数可能与此回调函数相关： - [CreatePlayerPickup](../functions/CreatePlayerPickup): 创建玩家专属拾取物 - [DestroyPlayerPickup](../functions/DestroyPlayerPickup): 销毁玩家专属拾取物 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerPickupStreamOut.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerPickupStreamOut.md index 02536f5472a..18710066e1e 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerPickupStreamOut.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerPickupStreamOut.md @@ -1,7 +1,7 @@ --- title: OnPlayerPickupStreamOut sidebar_label: OnPlayerPickupStreamOut -description: 当玩家专属拾取物流卸载时触发该回调函数 +description: 当玩家专属拾取物流卸载时触发此回调函数 tags: ["玩家", "拾取物", "玩家拾取物"] --- @@ -9,16 +9,16 @@ tags: ["玩家", "拾取物", "玩家拾取物"] ## 描述 -当玩家专属拾取物离开玩家可视范围时触发该回调函数 +当玩家专属拾取物离开玩家可视范围时触发此回调函数 -| 参数名 | 说明 | +| 参数 | 说明 | | -------- | ------------------------------------------------------------------------------- | | pickupid | 玩家专属拾取物ID（由[CreatePlayerPickup](../functions/CreatePlayerPickup)返回） | | playerid | 所属玩家ID | ## 返回值 -该回调始终在游戏模式中优先触发 +此回调始终在游戏模式中优先触发 ## 示例 @@ -54,14 +54,14 @@ public OnPlayerPickupStreamOut(pickupid, playerid) ## 相关回调 -以下回调函数可能与本回调相关： +以下回调函数可能与此回调相关： - [OnPlayerPickUpPlayerPickup](OnPlayerPickUpPlayerPickup): 当玩家拾取专属拾取物时触发 - [OnPlayerPickupStreamIn](OnPlayerPickupStreamIn): 当玩家专属拾取物流加载时触发 ## 相关函数 -以下函数可能与本回调函数相关： +以下函数可能与此回调函数相关： - [CreatePlayerPickup](../functions/CreatePlayerPickup): 创建玩家专属拾取物 - [DestroyPlayerPickup](../functions/DestroyPlayerPickup): 销毁玩家专属拾取物 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerRequestClass.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerRequestClass.md index 09c2f789347..6750e054980 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerRequestClass.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerRequestClass.md @@ -1,22 +1,22 @@ --- title: OnPlayerRequestClass sidebar_label: OnPlayerRequestClass -description: 当玩家在职业选择界面切换职业类别（或首次进入选择界面）时触发该回调函数。 -tags: ["玩家", "class"] +description: 当玩家在职业选择界面切换职业类别（或首次进入选择界面）时触发此回调函数。 +tags: ["玩家", "职业"] --- ## 描述 -当玩家在职业选择界面切换职业类别（或首次进入选择界面）时触发该回调函数。 +当玩家在职业选择界面切换职业类别（或首次进入选择界面）时触发此回调函数。 -| 参数名 | 说明 | -| -------- | --------------------------------------------------------------------------- | -| playerid | 切换职业类别的玩家ID | -| classid | 当前查看的职业类别ID（由[AddPlayerClass](../functions/AddPlayerClass)返回） | +| 参数 | 说明 | +| -------- | ---------------------------------------------------------------------------- | +| playerid | 切换职业类别的玩家 ID | +| classid | 当前查看的职业类别 ID（由[AddPlayerClass](../functions/AddPlayerClass)返回） | ## 返回值 -该回调始终在滤镜脚本中优先触发 +此回调始终在滤镜脚本中优先触发 ## 示例 @@ -37,19 +37,19 @@ public OnPlayerRequestClass(playerid, classid) :::tip -当玩家按下F4键时也会触发此回调 +当玩家按下 F4 键时也会触发此回调 ::: ## 相关回调 -以下回调函数可能与本回调相关： +以下回调函数可能与此回调相关： - [OnPlayerRequestSpawn](OnPlayerRequestSpawn): 当玩家尝试通过职业选择界面生成时触发 ## 相关函数 -以下函数可能与本回调函数相关： +以下函数可能与此回调函数相关： - [AddPlayerClass](../functions/AddPlayerClass): 添加职业类别 - [SetSpawnInfo](../functions/SetSpawnInfo): 设置玩家生成信息 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerRequestDownload.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerRequestDownload.md index 1a8c95bf89c..e5b96034953 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerRequestDownload.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerRequestDownload.md @@ -1,7 +1,7 @@ --- title: OnPlayerRequestDownload sidebar_label: OnPlayerRequestDownload -description: 当玩家请求下载自定义模型时触发该回调函数 +description: 当玩家请求下载自定义模型时触发此回调函数 tags: ["玩家"] --- @@ -9,9 +9,9 @@ tags: ["玩家"] ## 描述 -当玩家请求下载自定义模型资源时触发该回调函数 +当玩家请求下载自定义模型资源时触发此回调函数 -| 参数名 | 说明 | +| 参数 | 说明 | | --------------------- | ---------------------------------------------- | | playerid | 发起下载请求的玩家ID | | DOWNLOAD_REQUEST:type | [下载请求类型](../resources/download-requests) | @@ -76,7 +76,7 @@ public OnPlayerRequestDownload(playerid, DOWNLOAD_REQUEST:type, crc) ## 相关回调 -以下回调函数可能与本回调相关： +以下回调函数可能与此回调相关： - [OnPlayerFinishedDownloading](OnPlayerFinishedDownloading): 当玩家完成下载时触发 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerRequestSpawn.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerRequestSpawn.md index 9a1405a20c7..2cac3a7e727 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerRequestSpawn.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerRequestSpawn.md @@ -1,21 +1,21 @@ --- title: OnPlayerRequestSpawn sidebar_label: OnPlayerRequestSpawn -description: 当玩家通过职业选择界面尝试生成角色时触发该回调函数（按下SHIFT或点击生成按钮）。 -tags: ["玩家", "class"] +description: 当玩家通过职业选择界面尝试生成角色时触发此回调函数（按下SHIFT或点击生成按钮）。 +tags: ["玩家", "职业"] --- ## 描述 -当玩家通过职业选择界面尝试生成角色时触发该回调函数（按下SHIFT或点击生成按钮）。 +当玩家通过职业选择界面尝试生成角色时触发此回调函数（按下 SHIFT 或点击生成按钮）。 -| 参数名 | 说明 | -| -------- | -------------------- | -| playerid | 请求生成角色的玩家ID | +| 参数 | 说明 | +| -------- | --------------------- | +| playerid | 请求生成角色的玩家 ID | ## 返回值 -该回调始终在滤镜脚本中优先触发，返回0将阻止其他脚本处理 +此回调始终在滤镜脚本中优先触发，返回 0 将阻止其他脚本处理 ## 示例 @@ -24,7 +24,7 @@ public OnPlayerRequestSpawn(playerid) { if (!IsPlayerAdmin(playerid)) // 非管理员玩家 { - SendClientMessage(playerid, -1, "您无权生成角色。"); + SendClientMessage(playerid, -1, "你无权生成角色。"); return 0; // 阻止生成 } return 1; // 允许生成 @@ -37,20 +37,20 @@ public OnPlayerRequestSpawn(playerid) :::tip -如需限制玩家使用特定职业生成，需在OnPlayerRequestClass回调中保存最后查看的职业类别 +如需限制玩家使用特定职业生成，需在 OnPlayerRequestClass 回调中保存最后查看的职业类别 ::: ## 相关回调 -以下回调函数可能与本回调相关： +以下回调函数可能与此回调相关： - [OnPlayerSpawn](OnPlayerSpawn): 当玩家成功生成时触发 - [OnPlayerRequestClass](OnPlayerRequestClass): 当玩家切换职业类别时触发 ## 相关函数 -以下函数可能与本回调函数相关： +以下函数可能与此回调函数相关： - [SpawnPlayer](../functions/SpawnPlayer): 强制生成玩家角色 - [SetSpawnInfo](../functions/SetSpawnInfo): 设置玩家生成信息 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerSelectObject.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerSelectObject.md index 34f50d4d716..d21f092d62c 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerSelectObject.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerSelectObject.md @@ -1,15 +1,15 @@ --- title: OnPlayerSelectObject sidebar_label: OnPlayerSelectObject -description: 当玩家使用BeginObjectSelecting后选择物体时触发该回调函数。 +description: 当玩家使用BeginObjectSelecting后选择物体时触发此回调函数。 tags: ["玩家", "物体"] --- ## 描述 -当玩家使用 [BeginObjectSelecting](../functions/BeginObjectSelecting) 后选择物体时触发该回调函数。 +当玩家使用 [BeginObjectSelecting](../functions/BeginObjectSelecting) 后选择物体时触发此回调函数。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------------ | -------------------------------------------- | | playerid | 选择物体的玩家ID | | SELECT_OBJECT:type | 选择的[类型](../resources/selectobjecttypes) | @@ -25,7 +25,7 @@ tags: ["玩家", "物体"] 0 - 表示此回调将继续传递给下一个脚本。 -该回调始终在滤镜脚本中优先触发。 +此回调始终在滤镜脚本中优先触发。 ## 示例 @@ -43,14 +43,14 @@ public OnPlayerSelectObject(playerid, SELECT_OBJECT:type, objectid, modelid, Flo BeginPlayerObjectEditing(playerid, objectid); } - SendClientMessage(playerid, 0xFFFFFFFF, "您现在可以编辑您的物体了！"); + SendClientMessage(playerid, 0xFFFFFFFF, "你现在可以编辑你的物体了！"); return 1; } ``` ## 相关函数 -以下函数可能与该回调存在关联： +以下函数可能与此回调存在关联： - [BeginObjectSelecting](../functions/BeginObjectSelecting): 开始物体选择流程 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerSelectedMenuRow.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerSelectedMenuRow.md index f36ffbf0896..6883e2ae235 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerSelectedMenuRow.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerSelectedMenuRow.md @@ -1,22 +1,22 @@ --- title: OnPlayerSelectedMenuRow sidebar_label: OnPlayerSelectedMenuRow -description: 当玩家从菜单中选择项目时触发该回调函数（通过ShowMenuForPlayer显示菜单）。 +description: 当玩家从菜单中选择项目时触发此回调函数（通过ShowMenuForPlayer显示菜单）。 tags: ["玩家", "菜单"] --- ## 描述 -当玩家从菜单（通过[ShowMenuForPlayer](../functions/ShowMenuForPlayer)显示）中选择项目时触发该回调函数。 +当玩家从菜单（通过[ShowMenuForPlayer](../functions/ShowMenuForPlayer)显示）中选择项目时触发此回调函数。 -| 参数名 | 说明 | +| 参数 | 说明 | | -------- | ------------------------- | | playerid | 选择菜单项的玩家ID | | row | 被选中的行号（首行ID为0） | ## 返回值 -该回调始终在游戏模式中优先触发 +此回调始终在游戏模式中优先触发 ## 示例 @@ -64,14 +64,14 @@ public OnPlayerSelectedMenuRow(playerid, row) ## 相关回调 -以下回调函数可能与本回调相关： +以下回调函数可能与此回调相关： - [OnPlayerExitedMenu](OnPlayerExitedMenu): 当玩家退出菜单时触发 - [OnDialogResponse](OnDialogResponse): 当玩家响应对话框时触发 ## 相关函数 -以下函数可能与本回调函数相关： +以下函数可能与此回调函数相关： - [CreateMenu](../functions/CreateMenu): 创建菜单 - [DestroyMenu](../functions/DestroyMenu): 销毁菜单 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerSpawn.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerSpawn.md index 2bb11a88dfe..051b63b2759 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerSpawn.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerSpawn.md @@ -1,15 +1,15 @@ --- title: OnPlayerSpawn sidebar_label: OnPlayerSpawn -description: 当玩家生成时触发该回调函数。 +description: 当玩家生成时触发此回调函数。 tags: ["玩家"] --- ## 描述 -当玩家生成时触发该回调函数（例如调用 [SpawnPlayer](../functions/SpawnPlayer) 函数之后）。 +当玩家生成时触发此回调函数（例如调用 [SpawnPlayer](../functions/SpawnPlayer) 函数之后）。 -| 参数名 | 说明 | +| 参数 | 说明 | | -------- | -------------- | | playerid | 已生成玩家的ID | @@ -19,7 +19,7 @@ tags: ["玩家"] 1 - 表示此回调将继续传递给下一个滤镜脚本。 -该回调始终在滤镜脚本中优先触发。 +此回调始终在滤镜脚本中优先触发。 ## 示例 @@ -41,7 +41,7 @@ public OnPlayerSpawn(playerid) :::tip -在圣安地列斯原版中，玩家死亡时会自动扣除$100作为医院费用。SA:MP 保留了这个机制，但 open.mp 移除了该功能以便脚本自主管理金钱。许多脚本通过在玩家死亡后或生成时添加$100来修复这个问题。如果这是您的脚本，建议删除额外的修复代码（尽管 open.mp 的代码已尝试兼容这类脚本）。如果您的脚本依赖此功能，请在 [OnPlayerDeath](OnPlayerDeath) 中添加以下代码： +在圣安地列斯原版中，玩家死亡时会自动扣除$100作为医院费用。SA:MP 保留了这个机制，但 open.mp 移除了该功能以便脚本自主管理金钱。许多脚本通过在玩家死亡后或生成时添加$100来修复这个问题。如果这是你的脚本，建议删除额外的修复代码（尽管 open.mp 的代码已尝试兼容这类脚本）。如果你的脚本依赖此功能，请在 [OnPlayerDeath](OnPlayerDeath) 中添加以下代码： ```c GivePlayerMoney(playerid, -100); @@ -51,14 +51,14 @@ GivePlayerMoney(playerid, -100); ## 相关回调 -以下回调可能与该回调存在关联： +以下回调可能与此回调存在关联： - [OnPlayerDeath](OnPlayerDeath): 当玩家死亡时触发 - [OnVehicleSpawn](OnVehicleSpawn): 当车辆重新生成时触发 ## 相关函数 -以下函数可能与该回调存在关联： +以下函数可能与此回调存在关联： - [SpawnPlayer](../functions/SpawnPlayer): 强制玩家生成 - [AddPlayerClass](../functions/AddPlayerClass): 添加玩家职业 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerStateChange.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerStateChange.md index 96664bb2579..cd11ab50367 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerStateChange.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerStateChange.md @@ -1,15 +1,15 @@ --- title: OnPlayerStateChange sidebar_label: OnPlayerStateChange -description: 当玩家状态发生改变时触发该回调函数。 +description: 当玩家状态发生改变时触发此回调函数。 tags: ["玩家"] --- ## 描述 -当玩家状态发生改变时触发该回调函数。例如：当玩家从车辆驾驶员状态切换为步行状态时。 +当玩家状态发生改变时触发此回调函数。例如：当玩家从车辆驾驶员状态切换为步行状态时。 -| 参数名 | 说明 | +| 参数 | 说明 | | --------------------- | -------------------- | | playerid | 状态发生改变的玩家ID | | PLAYER_STATE:newstate | 玩家当前的新状态 | @@ -19,7 +19,7 @@ tags: ["玩家"] ## 返回值 -该回调始终在滤镜脚本中优先触发。 +此回调始终在滤镜脚本中优先触发。 ## 示例 @@ -41,13 +41,13 @@ public OnPlayerStateChange(playerid, PLAYER_STATE:newstate, PLAYER_STATE:oldstat ## 相关回调 -以下回调可能与该回调存在关联： +以下回调可能与此回调存在关联： - [OnPlayerInteriorChange](OnPlayerInteriorChange): 当玩家切换室内场景时触发 ## 相关函数 -以下函数可能与该回调存在关联： +以下函数可能与此回调存在关联： - [GetPlayerState](../functions/GetPlayerState): 获取玩家当前状态 - [GetPlayerSpecialAction](../functions/GetPlayerSpecialAction): 获取玩家特殊动作 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerStreamIn.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerStreamIn.md index 250f9e827be..4a4fb651405 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerStreamIn.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerStreamIn.md @@ -1,22 +1,22 @@ --- title: OnPlayerStreamIn sidebar_label: OnPlayerStreamIn -description: 当某个玩家的客户端流加载其他玩家时触发该回调函数。 +description: 当某个玩家的客户端流加载其他玩家时触发此回调函数。 tags: ["玩家"] --- ## 描述 -当某个玩家的客户端流加载其他玩家时触发该回调函数。 +当某个玩家的客户端流加载其他玩家时触发此回调函数。 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------- | ------------------ | | playerid | 被流加载的玩家ID | | forplayerid | 发起流加载的玩家ID | ## 返回值 -该回调始终在滤镜脚本中优先触发。 +此回调始终在滤镜脚本中优先触发。 ## 示例 @@ -24,7 +24,7 @@ tags: ["玩家"] public OnPlayerStreamIn(playerid, forplayerid) { new string[40]; - format(string, sizeof(string), "玩家 %d 现在已被流加载到您的客户端。", playerid); + format(string, sizeof(string), "玩家 %d 现在已被流加载到你的客户端。", playerid); SendClientMessage(forplayerid, 0xFFFFFFFF, string); return 1; } @@ -36,7 +36,7 @@ public OnPlayerStreamIn(playerid, forplayerid) ## 相关回调 -以下回调可能与该回调存在关联： +以下回调可能与此回调存在关联： - [OnPlayerStreamOut](OnPlayerStreamOut): 当玩家被其他客户端流卸载时触发 - [OnActorStreamIn](OnPlayerStreamOut): 当角色被玩家客户端流加载时触发 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerStreamOut.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerStreamOut.md index 565d9de7aaa..f926f62f4b9 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerStreamOut.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerStreamOut.md @@ -1,22 +1,22 @@ --- title: OnPlayerStreamOut sidebar_label: OnPlayerStreamOut -description: 当某个玩家的客户端流卸载其他玩家时触发该回调函数。 +description: 当某个玩家的客户端流卸载其他玩家时触发此回调函数。 tags: ["玩家"] --- ## 描述 -当某个玩家的客户端流卸载其他玩家时触发该回调函数。 +当某个玩家的客户端流卸载其他玩家时触发此回调函数。 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------- | ------------------ | | playerid | 被流卸载的玩家ID | | forplayerid | 发起流卸载的玩家ID | ## 返回值 -该回调始终在滤镜脚本中优先触发。 +此回调始终在滤镜脚本中优先触发。 ## 示例 @@ -24,7 +24,7 @@ tags: ["玩家"] public OnPlayerStreamOut(playerid, forplayerid) { new string[80]; - format(string, sizeof(string), "您的计算机刚刚卸载了玩家ID %d", playerid); + format(string, sizeof(string), "你的计算机刚刚卸载了玩家ID %d", playerid); SendClientMessage(forplayerid, 0xFF0000FF, string); return 1; } @@ -42,7 +42,7 @@ public OnPlayerStreamOut(playerid, forplayerid) ## 相关回调 -以下回调可能与该回调存在关联： +以下回调可能与此回调存在关联： - [OnPlayerStreamIn](OnPlayerStreamIn): 当玩家被其他客户端流加载时触发 - [OnActorStreamIn](OnPlayerStreamOut): 当角色被玩家客户端流加载时触发 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerTakeDamage.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerTakeDamage.md index 6101e0251d0..d230050eff2 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerTakeDamage.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerTakeDamage.md @@ -1,15 +1,15 @@ --- title: OnPlayerTakeDamage sidebar_label: OnPlayerTakeDamage -description: 当玩家受到伤害时触发该回调函数。 +description: 当玩家受到伤害时触发此回调函数。 tags: ["玩家"] --- ## 描述 -当玩家受到伤害时触发该回调函数。 +当玩家受到伤害时触发此回调函数。 -| 参数名 | 说明 | +| 参数 | 说明 | | --------------- | --------------------------------------------------- | | playerid | 受到伤害的玩家ID | | issuerid | 造成伤害的玩家ID（若为自伤则返回INVALID_PLAYER_ID） | @@ -23,7 +23,7 @@ tags: ["玩家"] 0 - 允许此回调传递给其他滤镜脚本。 -该回调始终在滤镜脚本中优先触发，返回1将阻止其他滤镜脚本处理该事件。 +此回调始终在滤镜脚本中优先触发，返回1将阻止其他滤镜脚本处理该事件。 ## 示例 @@ -84,10 +84,10 @@ public OnPlayerTakeDamage(playerid, issuerid, Float:amount, WEAPON:weaponid, bod ## 相关回调 -以下回调可能与该回调存在关联： +以下回调可能与此回调存在关联： - [OnPlayerGiveDamage](OnPlayerGiveDamage): 当玩家造成伤害时触发 -- [OnPlayerWeaponShot](OnPlayerWeaponShot): 当玩家发射武器时触发 +- [OnPlayerWeaponShot](OnPlayerWeaponShot): 当玩家开火时触发 ## 相关资源 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerText.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerText.md index 5149d0602bf..9d3303ec62b 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerText.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerText.md @@ -1,22 +1,22 @@ --- title: OnPlayerText sidebar_label: OnPlayerText -description: 当玩家发送聊天消息时触发该回调函数。 +description: 当玩家发送聊天消息时触发此回调函数。 tags: ["玩家"] --- ## 描述 -当玩家在聊天框发送消息时触发该回调函数。 +当玩家在聊天框发送消息时触发此回调函数。 -| 参数名 | 说明 | +| 参数 | 说明 | | -------- | ------------------ | | playerid | 发送消息的玩家ID | | text[] | 玩家发送的消息内容 | ## 返回值 -该回调始终在滤镜脚本中优先触发，返回0将阻止其他脚本处理此消息。 +此回调始终在滤镜脚本中优先触发，返回0将阻止其他脚本处理此消息。 ## 示例 @@ -45,13 +45,13 @@ public OnPlayerText(playerid, text[]) ## 相关回调 -以下回调可能与该回调存在关联： +以下回调可能与此回调存在关联： - [OnPlayerCommandText](OnPlayerCommandText): 当玩家输入指令时触发 ## 相关函数 -以下函数可能与该回调存在关联： +以下函数可能与此回调存在关联： - [SendPlayerMessageToPlayer](../functions/SendPlayerMessageToPlayer): 向指定玩家发送玩家消息 - [SendPlayerMessageToAll](../functions/SendPlayerMessageToAll): 向全体玩家发送玩家消息 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerUpdate.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerUpdate.md index 2cbdaf3e32b..13df18d70a1 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerUpdate.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerUpdate.md @@ -1,15 +1,15 @@ --- title: OnPlayerUpdate sidebar_label: OnPlayerUpdate -description: 当客户端/玩家向服务器发送状态更新时触发该回调函数。 +description: 当客户端/玩家向服务器发送状态更新时触发此回调函数。 tags: ["玩家"] --- ## 描述 -每当客户端/玩家向服务器发送状态更新时触发该回调函数。常用于创建服务器未主动追踪的客户端状态更新回调，例如生命值/护甲更新或武器切换。 +每当客户端/玩家向服务器发送状态更新时触发此回调函数。常用于创建服务器未主动追踪的客户端状态更新回调，例如生命值/护甲更新或武器切换。 -| 参数名 | 说明 | +| 参数 | 说明 | | -------- | ---------------------- | | playerid | 发送更新数据包的玩家ID | @@ -19,7 +19,7 @@ tags: ["玩家"] 1 - 表示该更新可正常处理并发送给其他玩家 -该回调始终在滤镜脚本中优先触发。 +此回调始终在滤镜脚本中优先触发。 ## 示例 @@ -51,7 +51,7 @@ public OnPlayerWeaponChange(playerid, WEAPON:oldWeapon, WEAPON:newWeapon) GetWeaponName(oldWeapon, oldWeaponName, sizeof(oldWeaponName)); GetWeaponName(newWeapon, newWeaponName, sizeof(newWeaponName)); - format(string, sizeof(string), "您已将武器从 %s 切换为 %s！", oldWeaponName, newWeaponName); + format(string, sizeof(string), "你已将武器从 %s 切换为 %s！", oldWeaponName, newWeaponName); SendClientMessage(playerid, 0xFFFFFFFF, string); return 1; } @@ -88,19 +88,19 @@ public OnPlayerUpdate(playerid) :::warning -本回调函数平均每秒触发30次/玩家，请谨慎使用。触发频率会根据玩家行为变化：驾驶或射击时更新频率远高于静止状态。 +此回调函数平均每秒触发30次/玩家，请谨慎使用。触发频率会根据玩家行为变化：驾驶或射击时更新频率远高于静止状态。 ::: ## 相关回调 -以下回调可能与该回调存在关联： +以下回调可能与此回调存在关联： -- [OnPlayerWeaponShot](OnPlayerWeaponShot): 当玩家发射武器时触发 +- [OnPlayerWeaponShot](OnPlayerWeaponShot): 当玩家开火时触发 ## 相关函数 -以下函数可能与该回调存在关联： +以下函数可能与此回调存在关联： - [GetPlayerWeapon](../functions/GetPlayerWeapon): 获取玩家当前武器 - [GetPlayerHealth](../functions/GetPlayerHealth): 获取玩家生命值 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerWeaponShot.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerWeaponShot.md index ecda6b7bd8d..aca1d57ad0c 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerWeaponShot.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnPlayerWeaponShot.md @@ -1,15 +1,15 @@ --- title: OnPlayerWeaponShot sidebar_label: OnPlayerWeaponShot -description: 当玩家射击时触发该回调函数。 +description: 当玩家射击时触发此回调函数。 tags: ["玩家"] --- ## 描述 -当玩家射击时触发该回调函数（仅支持枪械类武器）。 +当玩家射击时触发此回调函数（仅支持枪械类武器）。 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------------------- | ------------------------------------------------- | | playerid | 射击的玩家ID | | WEAPON:weaponid | 使用的[武器ID](../resources/weaponids) | @@ -25,7 +25,7 @@ tags: ["玩家"] 1 - 允许子弹造成伤害 -该回调始终在滤镜脚本中优先触发，返回0将阻止其他脚本处理此事件。 +此回调始终在滤镜脚本中优先触发，返回0将阻止其他脚本处理此事件。 ## 示例 @@ -64,13 +64,13 @@ public OnPlayerWeaponShot(playerid, WEAPON:weaponid, BULLET_HIT_TYPE:hittype, hi ## 相关回调 -以下回调可能与该回调存在关联： +以下回调可能与此回调存在关联： - [OnPlayerGiveDamage](OnPlayerGiveDamage): 当玩家造成伤害时触发 ## 相关函数 -以下函数可能与该回调存在关联： +以下函数可能与此回调存在关联： - [GetPlayerLastShotVectors](../functions/GetPlayerLastShotVectors): 获取玩家最后发射的子弹向量 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnRconCommand.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnRconCommand.md index e690aeeb321..11e03cfb5e2 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnRconCommand.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnRconCommand.md @@ -1,32 +1,32 @@ --- title: OnRconCommand sidebar_label: OnRconCommand -description: 当通过服务器控制台、RCON或游戏内"/rcon command"发送命令时触发该回调函数。 -tags: ["rcon", "管理"] +description: 当通过服务器控制台、RCON或游戏内"/rcon command"发送命令时触发此回调函数。 +tags: ["远程控制台", "管理"] --- ## 描述 -当通过以下方式发送命令时触发该回调函数： +当通过以下方式发送命令时触发此回调函数： - 服务器控制台 - RCON远程控制台 - 游戏内指令`/rcon command` -| 参数名 | 说明 | -| ------ | -------------------------- | -| cmd[] | 包含完整命令及参数的字符串 | +| 参数 | 说明 | +| ----- | -------------------------- | +| cmd[] | 包含完整命令及参数的字符串 | ## 返回值 -该回调始终在滤镜脚本中优先触发，返回1将阻止主脚本处理该命令。 +此回调始终在滤镜脚本中优先触发，返回1将阻止主脚本处理该命令。 ## 示例 ```c public OnRconCommand(cmd[]) { - printf("[RCON]: 您输入了 '/rcon %s'!", cmd); + printf("[RCON]: 你输入了 '/rcon %s'!", cmd); return 0; } @@ -35,7 +35,7 @@ public OnRconCommand(cmd[]) if (!strcmp(cmd, "hello", true)) { SendClientMessageToAll(0xFFFFFFAA, "Hello World!"); - print("您向世界打了招呼"); // 该消息会显示在输入者的聊天框（白色文字） + print("你向世界打了招呼"); // 该消息会显示在输入者的聊天框（白色文字） return 1; } return 0; @@ -49,7 +49,7 @@ public OnRconCommand(cmd[]) - 当玩家输入指令时，`/rcon`前缀不会包含在cmd参数中 - 在此回调中使用`print`函数会同时向玩家聊天框和服务器日志输出信息 - 仅当玩家已登录RCON管理员时才会触发此回调 -- 玩家使用`/rcon login`登录时会触发[OnRconLoginAttempt](OnRconLoginAttempt)而非本回调 +- 玩家使用`/rcon login`登录时会触发[OnRconLoginAttempt](OnRconLoginAttempt)而非此回调 ::: @@ -62,13 +62,13 @@ SA-MP需在滤镜脚本中实现此回调才能生效，该问题已在open.mp ## 相关回调 -以下回调可能与该回调存在关联： +以下回调可能与此回调存在关联： - [OnRconLoginAttempt](OnRconLoginAttempt): 当尝试登录RCON时触发 ## 相关函数 -以下函数可能与该回调存在关联： +以下函数可能与此回调存在关联： - [IsPlayerAdmin](../functions/IsPlayerAdmin): 检测玩家是否为RCON管理员 - [SetPlayerAdmin](../functions/SetPlayerAdmin): 设置玩家为RCON管理员 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnRconLoginAttempt.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnRconLoginAttempt.md index ffce8f6e6d0..f597536dd38 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnRconLoginAttempt.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnRconLoginAttempt.md @@ -1,15 +1,15 @@ --- title: OnRconLoginAttempt sidebar_label: OnRconLoginAttempt -description: 当玩家尝试在游戏中登录RCON时触发该回调函数（无论成功与否）。 -tags: ["rcon", "管理"] +description: 当玩家尝试在游戏中登录RCON时触发此回调函数（无论成功与否）。 +tags: ["远程控制台", "管理"] --- ## 描述 -当玩家在游戏内尝试登录RCON时触发该回调函数，无论登录是否成功。 +当玩家在游戏内尝试登录RCON时触发此回调函数，无论登录是否成功。 -| 参数名 | 说明 | +| 参数 | 说明 | | ---------- | -------------------------- | | ip[] | 尝试登录的玩家IP地址 | | password[] | 使用的登录密码 | @@ -17,7 +17,7 @@ tags: ["rcon", "管理"] ## 返回值 -该回调始终在滤镜脚本中优先触发。 +此回调始终在滤镜脚本中优先触发。 ## 示例 @@ -55,20 +55,20 @@ public OnRconLoginAttempt(ip[], password[], success) :::tip -- 本回调仅在游戏内使用`/rcon login`时触发 +- 此回调仅在游戏内使用`/rcon login`时触发 - 仅在玩家未登录RCON时触发，登录成功后触发[OnRconCommand](OnRconCommand) ::: ## 相关回调 -以下回调可能与该回调存在关联： +以下回调可能与此回调存在关联： - [OnRconCommand](OnRconCommand): 当发送RCON命令时触发 ## 相关函数 -以下函数可能与该回调存在关联： +以下函数可能与此回调存在关联： - [IsPlayerAdmin](../functions/IsPlayerAdmin): 检测玩家是否为RCON管理员 - [SetPlayerAdmin](../functions/SetPlayerAdmin): 设置玩家为RCON管理员 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnRecordingPlaybackEnd.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnRecordingPlaybackEnd.md index c44a2e61c33..a16afc1954f 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnRecordingPlaybackEnd.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnRecordingPlaybackEnd.md @@ -1,26 +1,26 @@ --- title: OnRecordingPlaybackEnd sidebar_label: OnRecordingPlaybackEnd -description: 当使用StartRecordingPlayback播放的录制文件结束时触发该回调函数。 +description: 当使用StartRecordingPlayback回放的录制文件结束时触发此回调函数。 tags: [] --- ## 描述 -当使用 [StartRecordingPlayback](../functions/StartRecordingPlayback) 播放的.rec文件到达结尾时触发该回调函数。 +当使用 [StartRecordingPlayback](../functions/StartRecordingPlayback) 回放的.rec文件到达结尾时触发此回调函数。 ## 示例 ```c public OnRecordingPlaybackEnd() { - StartRecordingPlayback(PLAYER_RECORDING_TYPE_DRIVER, "all_around_lv_bus"); // 当回放结束时将重新开始播放录制 + StartRecordingPlayback(PLAYER_RECORDING_TYPE_DRIVER, "all_around_lv_bus"); // 当回放结束时将重新开始回放录制 } ``` ## 相关函数 -以下函数可能与该回调存在关联： +以下函数可能与此回调存在关联： - [StartRecordingPlayback](../functions/StartRecordingPlayback): 开始回放录制文件 - [StopRecordingPlayback](../functions/StopRecordingPlayback): 停止回放录制文件 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnScriptLoadPlayer.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnScriptLoadPlayer.md index cf6617503e2..245da2f1d5a 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnScriptLoadPlayer.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnScriptLoadPlayer.md @@ -1,7 +1,7 @@ --- title: OnScriptLoadPlayer sidebar_label: OnScriptLoadPlayer -description: 当脚本加载时，会为每个已连接的玩家调用该回调函数。 +description: 当脚本加载时，会为每个已连接的玩家调用此回调函数。 tags: ["玩家"] --- @@ -9,16 +9,16 @@ tags: ["玩家"] ## 描述 -当脚本加载时，会为每个已连接的玩家调用该回调函数。 +当脚本加载时，会为每个已连接的玩家调用此回调函数。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------------ | ------------------------------------------------ | | playerid | 脚本加载对应的玩家ID | | bool:isEntryScript | 标识是否为入口脚本（主脚本）或侧脚本（滤镜脚本） | ## 返回值 -本回调函数不处理返回值。 +此回调函数不处理返回值。 ## 示例 @@ -33,13 +33,13 @@ public OnScriptLoadPlayer(playerid, bool:isEntryScript) :::tip -本回调在**运行时加载**侧脚本（滤镜脚本）时触发 +此回调在**运行时加载**侧脚本（滤镜脚本）时触发 ::: ## 相关回调 -以下回调可能与该回调存在关联： +以下回调可能与此回调存在关联： - [OnScriptUnloadPlayer](OnScriptUnloadPlayer): 当脚本卸载时为每个玩家触发 - [OnPlayerConnect](OnPlayerConnect): 当玩家连接服务器时触发 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnScriptUnloadPlayer.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnScriptUnloadPlayer.md index b2cb4a9f111..0f634f18365 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnScriptUnloadPlayer.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnScriptUnloadPlayer.md @@ -1,7 +1,7 @@ --- title: OnScriptUnloadPlayer sidebar_label: OnScriptUnloadPlayer -description: 当脚本卸载时，会为每个已连接的玩家调用该回调函数。 +description: 当脚本卸载时，会为每个已连接的玩家调用此回调函数。 tags: ["玩家"] --- @@ -9,16 +9,16 @@ tags: ["玩家"] ## 描述 -当脚本卸载时，会为每个已连接的玩家调用该回调函数。 +当脚本卸载时，会为每个已连接的玩家调用此回调函数。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------------ | ------------------------------------------------ | | playerid | 脚本卸载对应的玩家ID | | bool:isEntryScript | 标识是否为入口脚本（主脚本）或侧脚本（滤镜脚本） | ## 返回值 -本回调函数不处理返回值。 +此回调函数不处理返回值。 ## 示例 @@ -33,13 +33,13 @@ public OnScriptUnloadPlayer(playerid, bool:isEntryScript) :::tip -本回调在**运行时卸载**侧脚本（滤镜脚本）时触发 +此回调在**运行时卸载**侧脚本（滤镜脚本）时触发 ::: ## 相关回调 -以下回调可能与该回调存在关联： +以下回调可能与此回调存在关联： - [OnScriptLoadPlayer](OnScriptLoadPlayer): 当脚本加载时为每个玩家触发 - [OnPlayerConnect](OnPlayerConnect): 当玩家连接服务器时触发 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnTrailerUpdate.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnTrailerUpdate.md index 4501930d6ef..3bde8a1988e 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnTrailerUpdate.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnTrailerUpdate.md @@ -1,15 +1,15 @@ --- title: OnTrailerUpdate sidebar_label: OnTrailerUpdate -description: 当玩家发送拖车状态更新时触发该回调函数。 +description: 当玩家发送拖车状态更新时触发此回调函数。 tags: ["车辆"] --- ## 描述 -当玩家客户端发送拖车状态同步数据时触发该回调函数。 +当玩家客户端发送拖车状态同步数据时触发此回调函数。 -| 参数名 | 说明 | +| 参数 | 说明 | | --------- | ------------------------ | | playerid | 发送拖车状态更新的玩家ID | | vehicleid | 被更新的拖车ID | @@ -20,7 +20,7 @@ tags: ["车辆"] 1 - 正常处理拖车更新并同步给所有玩家 -该回调始终在滤镜脚本中优先触发。 +此回调始终在滤镜脚本中优先触发。 ## 示例 @@ -36,19 +36,19 @@ public OnTrailerUpdate(playerid, vehicleid) :::warning -本回调触发频率极高（每秒多次/每个拖车），请避免在此执行复杂计算或文件读写操作 +此回调触发频率极高（每秒多次/每个拖车），请避免在此执行复杂计算或文件读写操作 ::: ## 相关回调 -以下回调可能与该回调存在关联： +以下回调可能与此回调存在关联： - [OnUnoccupiedVehicleUpdate](OnUnoccupiedVehicleUpdate): 当无驾驶员车辆位置同步时触发 ## 相关函数 -以下函数可能与该回调存在关联： +以下函数可能与此回调存在关联： - [GetVehicleTrailer](../functions/GetVehicleTrailer): 获取车辆牵引的拖车ID - [IsTrailerAttachedToVehicle](../functions/IsTrailerAttachedToVehicle): 检测拖车是否连接 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnUnoccupiedVehicleUpdate.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnUnoccupiedVehicleUpdate.md index f57d53e9ebd..5d8cdca6693 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnUnoccupiedVehicleUpdate.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnUnoccupiedVehicleUpdate.md @@ -1,18 +1,18 @@ --- title: OnUnoccupiedVehicleUpdate sidebar_label: OnUnoccupiedVehicleUpdate -description: 当玩家的客户端同步未驾驶车辆的位置时触发该回调函数。 +description: 当玩家的客户端同步未驾驶车辆的位置时触发此回调函数。 tags: ["车辆"] --- ## 描述 -当玩家的客户端同步其未驾驶车辆的位置时触发该回调函数。触发场景包括： +当玩家的客户端同步其未驾驶车辆的位置时触发此回调函数。触发场景包括： - 玩家处于车辆外部时 - 玩家作为乘客乘坐无驾驶员车辆时 -| 参数名 | 说明 | +| 参数 | 说明 | | -------------- | ------------------------------------------------------------------------------------- | | vehicleid | 被同步位置的车辆ID | | playerid | 发起位置同步的玩家ID | @@ -29,7 +29,7 @@ tags: ["车辆"] 0 - 阻止其他脚本处理此同步事件 1 - 允许正常处理同步数据 -该回调始终在滤镜脚本中优先触发。 +此回调始终在滤镜脚本中优先触发。 ## 示例 @@ -51,20 +51,20 @@ public OnUnoccupiedVehicleUpdate(vehicleid, playerid, passenger_seat, Float:new_ :::warning -- 本回调触发频率极高（每秒多次/每个车辆），请避免在此执行复杂计算或文件操作 +- 此回调触发频率极高（每秒多次/每个车辆），请避免在此执行复杂计算或文件操作 - [GetVehiclePos](../functions/GetVehiclePos) 将返回同步前的旧坐标 ::: ## 相关回调 -以下回调可能与该回调存在关联： +以下回调可能与此回调存在关联： - [OnTrailerUpdate](OnTrailerUpdate): 当拖车位置同步时触发 ## 相关函数 -以下函数可能与该回调存在关联： +以下函数可能与此回调存在关联： - [SetVehiclePos](../functions/SetVehiclePos): 强制设置车辆位置 - [GetVehicleVelocity](../functions/GetVehicleVelocity): 获取车辆速度向量 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnVehicleDamageStatusUpdate.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnVehicleDamageStatusUpdate.md index 4e0d22ae274..df0b9338863 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnVehicleDamageStatusUpdate.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnVehicleDamageStatusUpdate.md @@ -1,7 +1,7 @@ --- title: OnVehicleDamageStatusUpdate sidebar_label: OnVehicleDamageStatusUpdate -description: 当车辆部件（车门/轮胎/面板/车灯）的损坏状态发生变更时触发该回调函数。 +description: 当车辆部件（车门/轮胎/面板/车灯）的损坏状态发生变更时触发此回调函数。 tags: ["车辆"] --- @@ -13,9 +13,9 @@ tags: ["车辆"] ## 描述 -当车辆部件（车门、轮胎、面板或车灯）的损坏状态发生变更时触发该回调函数。 +当车辆部件（车门、轮胎、面板或车灯）的损坏状态发生变更时触发此回调函数。 -| 参数名 | 说明 | +| 参数 | 说明 | | --------- | ---------------------------------------------------- | | vehicleid | 损坏状态发生变化的车辆ID | | playerid | 同步损坏状态变更的玩家ID（造成损坏或修复车辆的玩家） | @@ -25,7 +25,7 @@ tags: ["车辆"] **1** - 阻止其他滤镜脚本接收此回调 **0** - 允许此回调传递给其他滤镜脚本 -该回调始终在滤镜脚本中优先触发。 +此回调始终在滤镜脚本中优先触发。 ## 示例 @@ -54,13 +54,13 @@ public OnVehicleDamageStatusUpdate(vehicleid, playerid) :::tip -本回调不包含车辆生命值（Health）变化的检测 +此回调不包含车辆生命值（Health）变化的检测 ::: ## 相关函数 -以下函数可能与该回调存在关联： +以下函数可能与此回调存在关联： - [GetVehicleDamageStatus](../functions/GetVehicleDamageStatus): 获取车辆各部件损坏状态 - [UpdateVehicleDamageStatus](../functions/UpdateVehicleDamageStatus): 更新车辆损坏状态 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnVehicleDeath.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnVehicleDeath.md index 252f3b30fb5..42f8bed5091 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnVehicleDeath.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnVehicleDeath.md @@ -1,25 +1,25 @@ --- title: OnVehicleDeath sidebar_label: OnVehicleDeath -description: 当车辆被摧毁（爆炸或浸没水中）时触发该回调函数。 +description: 当车辆被摧毁（爆炸或浸没水中）时触发此回调函数。 tags: ["车辆"] --- ## 描述 -当车辆被摧毁时触发该回调函数，触发条件包括： +当车辆被摧毁时触发此回调函数，触发条件包括： - 车辆爆炸 - 车辆完全浸没水中 -| 参数名 | 说明 | +| 参数 | 说明 | | --------- | --------------------------------------------------------------------- | | vehicleid | 被摧毁的车辆ID | | killerid | 报告车辆摧毁状态的玩家ID（参数名易误解，通常为驾驶员/乘客或最近玩家） | ## 返回值 -该回调始终在滤镜脚本中优先触发。 +此回调始终在滤镜脚本中优先触发。 ## 示例 @@ -37,20 +37,20 @@ public OnVehicleDeath(vehicleid, killerid) :::tip -- 车辆部分浸没水中时也会触发本回调，此时通过传送或驶出水域仍可挽救车辆 -- 车辆完全摧毁后，当驾驶员离开或经过短暂时间，车辆会消失且不会再次触发本回调 +- 车辆部分浸没水中时也会触发此回调，此时通过传送或驶出水域仍可挽救车辆 +- 车辆完全摧毁后，当驾驶员离开或经过短暂时间，车辆会消失且不会再次触发此回调 ::: ## 相关回调 -以下回调可能与该回调存在关联： +以下回调可能与此回调存在关联： - [OnVehicleSpawn](OnVehicleSpawn): 当车辆重新生成时触发 ## 相关函数 -以下函数可能与该回调存在关联： +以下函数可能与此回调存在关联： - [SetVehicleHealth](../functions/SetVehicleHealth): 设置车辆生命值 - [GetVehicleHealth](../functions/GetVehicleHealth): 获取车辆生命值 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnVehicleMod.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnVehicleMod.md index eda0d7690f9..fa62e906104 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnVehicleMod.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnVehicleMod.md @@ -1,15 +1,15 @@ --- title: OnVehicleMod sidebar_label: OnVehicleMod -description: 当车辆被改装时触发该回调函数。 +description: 当车辆被改装时触发此回调函数。 tags: ["车辆"] --- ## 描述 -当车辆被改装（添加组件）时触发该回调函数。 +当车辆被改装（添加组件）时触发此回调函数。 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------- | ------------------------------ | | playerid | 进行改装的玩家ID（车辆驾驶员） | | vehicleid | 被改装的车辆ID | @@ -17,7 +17,7 @@ tags: ["车辆"] ## 返回值 -该回调始终在游戏模式中优先触发，返回0将阻止其他滤镜脚本处理此事件。 +此回调始终在游戏模式中优先触发，返回0将阻止其他滤镜脚本处理此事件。 ## 示例 @@ -40,13 +40,13 @@ public OnVehicleMod(playerid, vehicleid, componentid) :::tip -本回调不会通过 [AddVehicleComponent](../functions/AddVehicleComponent) 函数触发 +此回调不会通过 [AddVehicleComponent](../functions/AddVehicleComponent) 函数触发 ::: ## 相关回调 -以下回调可能与该回调存在关联： +以下回调可能与此回调存在关联： - [OnEnterExitModShop](OnEnterExitModShop): 当车辆进入/离开改装店时触发 - [OnVehiclePaintjob](OnVehiclePaintjob): 当车辆涂装变更时触发 @@ -54,7 +54,7 @@ public OnVehicleMod(playerid, vehicleid, componentid) ## 相关函数 -以下函数可能与该回调存在关联： +以下函数可能与此回调存在关联： - [AddVehicleComponent](../functions/AddVehicleComponent): 为车辆添加改装组件 - [RemoveVehicleComponent](../functions/RemoveVehicleComponent): 移除车辆的改装组件 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnVehiclePaintjob.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnVehiclePaintjob.md index 0ffbc63d290..e69802bd6e1 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnVehiclePaintjob.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnVehiclePaintjob.md @@ -1,15 +1,15 @@ --- title: OnVehiclePaintjob sidebar_label: OnVehiclePaintjob -description: 当玩家在改装店预览车辆涂装时触发该回调函数。 +description: 当玩家在改装店预览车辆涂装时触发此回调函数。 tags: ["车辆"] --- ## 描述 -当玩家在改装店内预览车辆涂装时触发该回调函数（注意：玩家购买涂装时不会触发）。 +当玩家在改装店内预览车辆涂装时触发此回调函数（注意：玩家购买涂装时不会触发）。 -| 参数名 | 说明 | +| 参数 | 说明 | | ---------- | -------------------- | | playerid | 变更涂装预览的玩家ID | | vehicleid | 变更涂装预览的车辆ID | @@ -17,7 +17,7 @@ tags: ["车辆"] ## 返回值 -该回调始终在游戏模式中优先触发，返回0将阻止其他滤镜脚本处理此事件。 +此回调始终在游戏模式中优先触发，返回0将阻止其他滤镜脚本处理此事件。 ## 示例 @@ -25,7 +25,7 @@ tags: ["车辆"] public OnVehiclePaintjob(playerid, vehicleid, paintjobid) { new string[128]; - format(string, sizeof(string), "您已将车辆预览涂装变更为 %d 号样式！", paintjobid); + format(string, sizeof(string), "你已将车辆预览涂装变更为 %d 号样式！", paintjobid); SendClientMessage(playerid, 0x33AA33AA, string); return 1; } @@ -35,21 +35,21 @@ public OnVehiclePaintjob(playerid, vehicleid, paintjobid) :::tip -- 本回调不会通过 [ChangeVehiclePaintjob](../functions/ChangeVehiclePaintjob) 函数触发 +- 此回调不会通过 [ChangeVehiclePaintjob](../functions/ChangeVehiclePaintjob) 函数触发 - 如需检测玩家购买涂装行为，可使用 vSync 插件的 OnVehicleChangePaintjob 回调 ::: ## 相关回调 -以下回调可能与该回调存在关联： +以下回调可能与此回调存在关联： - [OnVehicleRespray](OnVehicleRespray): 当车辆重新涂装时触发 - [OnVehicleMod](OnVehicleMod): 当车辆进行改装时触发 ## 相关函数 -以下函数可能与该回调存在关联： +以下函数可能与此回调存在关联： - [ChangeVehiclePaintjob](../functions/ChangeVehiclePaintjob): 变更车辆涂装样式 - [ChangeVehicleColor](../functions/ChangeVehicleColor): 设置车辆颜色 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnVehicleRespray.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnVehicleRespray.md index 5747c757cfd..8e99e012673 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnVehicleRespray.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnVehicleRespray.md @@ -1,15 +1,15 @@ --- title: OnVehicleRespray sidebar_label: OnVehicleRespray -description: 当玩家离开改装店时触发该回调函数，即使颜色未发生变更。 +description: 当玩家离开改装店时触发此回调函数，即使颜色未发生变更。 tags: ["车辆"] --- ## 描述 -当玩家驾驶车辆离开改装店时触发该回调函数，即使车辆颜色未发生改变。注意：该回调名称存在歧义，Pay 'n' Spray涂装店不会触发此回调。 +当玩家驾驶车辆离开改装店时触发此回调函数，即使车辆颜色未发生改变。注意：此回调名称存在歧义，Pay 'n' Spray涂装店不会触发此回调。 -| 参数名 | 说明 | +| 参数 | 说明 | | --------- | ------------------------ | | playerid | 驾驶车辆的玩家ID | | vehicleid | 被重新涂装的车辆ID | @@ -18,7 +18,7 @@ tags: ["车辆"] ## 返回值 -该回调始终在游戏模式中优先触发，返回0将阻止其他滤镜脚本处理此事件。 +此回调始终在游戏模式中优先触发，返回0将阻止其他滤镜脚本处理此事件。 ## 示例 @@ -26,7 +26,7 @@ tags: ["车辆"] public OnVehicleRespray(playerid, vehicleid, color1, color2) { new string[48]; - format(string, sizeof(string), "您已将车辆 %d 颜色更改为 %d 和 %d 号色！", vehicleid, color1, color2); + format(string, sizeof(string), "你已将车辆 %d 颜色更改为 %d 和 %d 号色！", vehicleid, color1, color2); SendClientMessage(playerid, COLOR_GREEN, string); return 1; } @@ -36,7 +36,7 @@ public OnVehicleRespray(playerid, vehicleid, color1, color2) :::tip -- 本回调不会通过 [ChangeVehicleColor](../functions/ChangeVehicleColor) 函数触发 +- 此回调不会通过 [ChangeVehicleColor](../functions/ChangeVehicleColor) 函数触发 - 仅改装店（Mod Shop）会触发此回调，Pay 'n' Spray涂装店不会触发 - 修复方案参考：[https://pastebin.com/G81da7N1](https://pastebin.com/G81da7N1) @@ -51,7 +51,7 @@ public OnVehicleRespray(playerid, vehicleid, color1, color2) ## 相关回调 -以下回调可能与该回调存在关联： +以下回调可能与此回调存在关联： - [OnVehiclePaintjob](OnVehiclePaintjob): 当车辆涂装样式变更时触发 - [OnVehicleMod](OnVehicleMod): 当车辆进行改装时触发 @@ -59,7 +59,7 @@ public OnVehicleRespray(playerid, vehicleid, color1, color2) ## 相关函数 -以下函数可能与该回调存在关联： +以下函数可能与此回调存在关联： - [ChangeVehicleColor](../functions/ChangeVehicleColor): 设置车辆颜色 - [ChangeVehiclePaintjob](../functions/ChangeVehiclePaintjob): 变更车辆涂装样式 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnVehicleSirenStateChange.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnVehicleSirenStateChange.md index 49705c35cb1..a94f386e873 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnVehicleSirenStateChange.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnVehicleSirenStateChange.md @@ -1,7 +1,7 @@ --- title: OnVehicleSirenStateChange sidebar_label: OnVehicleSirenStateChange -description: 当车辆警笛状态发生变更时触发该回调函数。 +description: 当车辆警报器状态发生变更时触发此回调函数。 tags: ["车辆"] --- @@ -9,20 +9,20 @@ tags: ["车辆"] ## 描述 -当车辆的警笛状态被切换时触发该回调函数。 +当车辆的警报器状态被切换时触发此回调函数。 -| 参数名 | 说明 | -| --------- | ------------------------------ | -| playerid | 切换警笛状态的玩家ID（驾驶员） | -| vehicleid | 警笛状态发生变更的车辆ID | -| newstate | 警笛新状态（0=关闭，1=开启） | +| 参数 | 说明 | +| --------- | -------------------------------- | +| playerid | 切换警报器状态的玩家ID（驾驶员） | +| vehicleid | 警报器状态发生变更的车辆ID | +| newstate | 警报器新状态（0=关闭，1=开启） | ## 返回值 1 - 阻止游戏模式接收此回调 0 - 允许回调传递给游戏模式 -该回调始终在滤镜脚本中优先触发。 +此回调始终在滤镜脚本中优先触发。 ## 示例 @@ -31,11 +31,11 @@ public OnVehicleSirenStateChange(playerid, vehicleid, newstate) { if (newstate) { - GameTextForPlayer(playerid, "~W~警笛 ~G~开启", 1000, 3); + GameTextForPlayer(playerid, "~W~警报器 ~G~开启", 1000, 3); } else { - GameTextForPlayer(playerid, "~W~警笛 ~r~关闭", 1000, 3); + GameTextForPlayer(playerid, "~W~警报器 ~r~关闭", 1000, 3); } return 1; } @@ -45,16 +45,16 @@ public OnVehicleSirenStateChange(playerid, vehicleid, newstate) :::tip -本回调仅在警笛开关状态切换时触发，长按喇叭触发的交替警笛声不会触发 +此回调仅在警报器开关状态切换时触发，长按喇叭触发的交替警报器声不会触发 ::: ## 相关函数 -以下函数可能与该回调存在关联： +以下函数可能与此回调存在关联： -- [GetVehicleParamsSirenState](../functions/GetVehicleParamsSirenState): 检测车辆警笛当前状态 -- [SetVehicleParamsSirenState](../functions/SetVehicleParamsSirenState): 设置车辆警笛状态 +- [GetVehicleParamsSirenState](../functions/GetVehicleParamsSirenState): 检测车辆警报器当前状态 +- [SetVehicleParamsSirenState](../functions/SetVehicleParamsSirenState): 设置车辆警报器状态 ## 相关资源 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnVehicleSpawn.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnVehicleSpawn.md index cf73353082a..47974576c16 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnVehicleSpawn.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnVehicleSpawn.md @@ -1,21 +1,21 @@ --- title: OnVehicleSpawn sidebar_label: OnVehicleSpawn -description: 当车辆重生时触发该回调函数。 +description: 当车辆重生时触发此回调函数。 tags: ["车辆"] --- :::warning -本回调**仅**在车辆**重新**生成时触发！使用CreateVehicle和AddStaticVehicle(Ex)创建车辆**不会**触发此回调 +此回调**仅**在车辆**重新**生成时触发！使用CreateVehicle和AddStaticVehicle(Ex)创建车辆**不会**触发此回调 ::: ## 描述 -当车辆重生时触发该回调函数。 +当车辆重生时触发此回调函数。 -| 参数名 | 说明 | +| 参数 | 说明 | | --------- | ------------ | | vehicleid | 重生的车辆ID | @@ -24,7 +24,7 @@ tags: ["车辆"] 0 - 阻止其他滤镜脚本接收此回调 1 - 允许此回调传递给其他滤镜脚本 -该回调始终在滤镜脚本中优先触发。 +此回调始终在滤镜脚本中优先触发。 ## 示例 @@ -38,14 +38,14 @@ public OnVehicleSpawn(vehicleid) ## 相关回调 -以下回调可能与该回调存在关联： +以下回调可能与此回调存在关联： - [OnVehicleDeath](OnVehicleDeath): 当车辆被摧毁时触发 - [OnPlayerSpawn](OnPlayerSpawn): 当玩家生成时触发 ## 相关函数 -以下函数可能与该回调存在关联： +以下函数可能与此回调存在关联： - [SetVehicleToRespawn](../functions/SetVehicleToRespawn): 立即重生指定车辆 - [CreateVehicle](../functions/CreateVehicle): 创建新车辆 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnVehicleStreamIn.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnVehicleStreamIn.md index 0a79142fd3a..183bd0771bc 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnVehicleStreamIn.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnVehicleStreamIn.md @@ -1,22 +1,22 @@ --- title: OnVehicleStreamIn sidebar_label: OnVehicleStreamIn -description: 当车辆被流加载到玩家客户端时触发该回调函数。 +description: 当车辆被流加载到玩家客户端时触发此回调函数。 tags: ["车辆"] --- ## 描述 -当车辆被流加载到玩家客户端时触发该回调函数。 +当车辆被流加载到玩家客户端时触发此回调函数。 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------- | ------------------ | | vehicleid | 被流加载的车辆ID | | forplayerid | 发起流加载的玩家ID | ## 返回值 -该回调始终在滤镜脚本中优先触发。 +此回调始终在滤镜脚本中优先触发。 ## 示例 @@ -24,7 +24,7 @@ tags: ["车辆"] public OnVehicleStreamIn(vehicleid, forplayerid) { new string[32]; - format(string, sizeof(string), "您现在可以看到车辆 %d。", vehicleid); + format(string, sizeof(string), "你现在可以看到车辆 %d。", vehicleid); SendClientMessage(forplayerid, 0xFFFFFFFF, string); return 1; } diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnVehicleStreamOut.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnVehicleStreamOut.md index 0c19bc9f896..1a6c5ebc7f3 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnVehicleStreamOut.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnVehicleStreamOut.md @@ -1,22 +1,22 @@ --- title: OnVehicleStreamOut sidebar_label: OnVehicleStreamOut -description: 当车辆从玩家客户端流卸载时触发该回调函数（车辆距离过远超出可视范围）。 +description: 当车辆从玩家客户端流卸载时触发此回调函数（车辆距离过远超出可视范围）。 tags: ["车辆"] --- ## 描述 -当车辆从玩家客户端流卸载时触发该回调函数（车辆距离过远超出可视范围）。 +当车辆从玩家客户端流卸载时触发此回调函数（车辆距离过远超出可视范围）。 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------- | ------------------------ | | vehicleid | 被流卸载的车辆ID | | forplayerid | 停止流加载该车辆的玩家ID | ## 返回值 -该回调始终在滤镜脚本中优先触发。 +此回调始终在滤镜脚本中优先触发。 ## 示例 @@ -24,7 +24,7 @@ tags: ["车辆"] public OnVehicleStreamOut(vehicleid, forplayerid) { new string[48]; - format(string, sizeof(string), "您的客户端已停止流加载车辆 %d", vehicleid); + format(string, sizeof(string), "你的客户端已停止流加载车辆 %d", vehicleid); SendClientMessage(forplayerid, 0xFFFFFFFF, string); return 1; } diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AddCharModel.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AddCharModel.md index d6671e8f5ea..a7928746014 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AddCharModel.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AddCharModel.md @@ -11,7 +11,7 @@ tags: ["自定义皮肤", "角色模型"] 添加可供下载的新自定义角色模型。模型文件将存储在玩家的「文档\GTA San Andreas User Files\SAMP\cache」目录下，按服务器 IP 和端口分类的文件夹中，并以 CRC 格式文件名保存。 -| 参数名 | 说明 | +| 参数 | 说明 | | ---------------------- | ------------------------------------------------------------------------------------ | | baseid | 基础皮肤模型 ID（用于定义角色行为特性，当下载失败时将使用该原始角色模型）。 | | newid | 新皮肤模型 ID（范围 20001-30000，共 10000 个槽位），后续可通过 SetPlayerSkin 使用 | @@ -44,7 +44,7 @@ AddCharModel(305, 20002, "lapdpd2.dff", "lapdpd2.txd"); :::tip -需先在服务器配置中启用**useartwork**或**artwork.enable**选项才能使本功能生效。 +需先在服务器配置中启用**useartwork**或**artwork.enable**选项才能使此函数生效。 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AddMenuItem.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AddMenuItem.md index 3ffe4824995..b047ffcc6fc 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AddMenuItem.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AddMenuItem.md @@ -9,7 +9,7 @@ tags: ["菜单"] 向指定菜单添加一个项目。 -| 参数名 | 说明 | +| 参数 | 说明 | | ---------------- | ---------------------- | | Menu:menuid | 要添加项目的菜单 ID | | column | 添加项目所在的列 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AddPlayerClass.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AddPlayerClass.md index 0f36437a8ad..9a670e73514 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AddPlayerClass.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AddPlayerClass.md @@ -9,7 +9,7 @@ tags: ["玩家", "职业"] 添加一个职业到职业选择系统。职业系统允许玩家使用自选皮肤进行重生。 -| 参数名 | 说明 | +| 参数 | 说明 | | -------------- | --------------------------------------------- | | skin | 玩家重生时使用的[皮肤 ID](../resources/skins) | | Float:spawnX | 该职业重生点的 X 坐标 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AddPlayerClassEx.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AddPlayerClassEx.md index 578f5f3e50b..87da6d6347a 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AddPlayerClassEx.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AddPlayerClassEx.md @@ -1,15 +1,15 @@ --- title: AddPlayerClassEx sidebar_label: AddPlayerClassEx -description: 本函数与AddPlayerClass功能相同，新增团队参数 +description: 此函数与AddPlayerClass功能相同，新增团队参数 tags: ["玩家", "职业"] --- ## 描述 -本函数功能与 AddPlayerClass 完全一致，额外增加团队参数支持。 +此函数功能与 AddPlayerClass 完全一致，额外增加团队参数支持。 -| 参数名 | 说明 | +| 参数 | 说明 | | -------------- | --------------------------------------------- | | team | 玩家所属的初始团队 | | skin | 玩家重生时使用的[皮肤 ID](../resources/skins) | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AddServerRule.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AddServerRule.md index cb37ff6b382..9e49cfc3473 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AddServerRule.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AddServerRule.md @@ -11,7 +11,7 @@ tags: ["规则"] 添加服务器规则。 -| 参数名 | 说明 | +| 参数 | 说明 | | ---------------- | ---------------------- | | const rule[] | 要添加的服务器规则名称 | | const format[] | 服务器规则对应值 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AddSimpleModel.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AddSimpleModel.md index 768f911d884..ae75b0fb48a 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AddSimpleModel.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AddSimpleModel.md @@ -11,7 +11,7 @@ tags: ["自定义模型", "简单模型"] 添加可供下载的新自定义简单物体模型。模型文件将存储在玩家的「文档\GTA San Andreas User Files\SAMP\cache」目录下，按服务器 IP 和端口分类的文件夹中，并以 CRC 格式文件名保存。 -| 参数名 | 说明 | +| 参数 | 说明 | | ---------------------- | -------------------------------------------------------------------------------------------------------- | | virtualWorld | 模型生效的虚拟世界 ID，使用-1 表示全虚拟世界 | | baseid | 基础物体模型 ID（当下载失败时将使用该原始物体模型） | @@ -43,7 +43,7 @@ AddSimpleModel(-1, 19379, -2000, "wallzzz.dff", "wallzzz.txd"); :::tip -需先在服务器配置中启用**useartwork**或**artwork.enable**选项才能使本功能生效。 +需先在服务器配置中启用**useartwork**或**artwork.enable**选项才能使此函数生效。 当`virtualworld`参数设置时，模型将在玩家进入指定虚拟世界时自动下载。 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AddSimpleModelTimed.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AddSimpleModelTimed.md index 1a3a91d0f18..66526e9c52d 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AddSimpleModelTimed.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AddSimpleModelTimed.md @@ -11,7 +11,7 @@ tags: ["自定义模型", "简单模型"] 添加具有时间限制的自定义简单物体模型。模型文件将存储在玩家的「文档\GTA San Andreas User Files\SAMP\cache」目录下，按服务器 IP 和端口分类的文件夹中，并以 CRC 格式文件名保存。 -| 参数名 | 说明 | +| 参数 | 说明 | | ---------------------- | -------------------------------------------------------------------------------------------------------- | | virtualWorld | 模型生效的虚拟世界 ID，使用-1 表示全虚拟世界 | | baseid | 基础物体模型 ID（当下载失败时将使用该原始物体模型） | @@ -42,7 +42,7 @@ public OnGameModeInit() :::tip -需先在服务器配置中启用**useartwork**或**artwork.enable**选项才能使本功能生效。 +需先在服务器配置中启用**useartwork**或**artwork.enable**选项才能使此函数生效。 当 virtualworld 参数设置时，模型将在玩家进入指定虚拟世界时自动下载。 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AddStaticPickup.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AddStaticPickup.md index e82851e6a2a..f20e0efa081 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AddStaticPickup.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AddStaticPickup.md @@ -7,9 +7,9 @@ tags: ["拾取物"] ## 描述 -本函数用于在游戏中添加「静态」拾取物。这类拾取物支持武器、生命值、护甲等类型，无需额外脚本即可自动生效（武器/生命值/护甲会自动给予玩家）。 +此函数用于在游戏中添加「静态」拾取物。这类拾取物支持武器、生命值、护甲等类型，无需额外脚本即可自动生效（武器/生命值/护甲会自动给予玩家）。 -| 参数名 | 说明 | +| 参数 | 说明 | | -------------------------------- | -------------------------------------------- | | [model](../resources/pickupids) | 拾取物模型 ID | | [type](../resources/pickuptypes) | 拾取物类型，决定被拾取时的响应方式 | @@ -43,7 +43,7 @@ public OnGameModeInit() :::tip -本函数不会返回可用于 OnPlayerPickUpPickup 等回调的拾取物 ID。若需要分配 ID，请使用[CreatePickup](CreatePickup)函数。 +此函数不会返回可用于 OnPlayerPickUpPickup 等回调的拾取物 ID。若需要分配 ID，请使用[CreatePickup](CreatePickup)函数。 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AddStaticVehicle.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AddStaticVehicle.md index d38e237f05c..2a35dd91128 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AddStaticVehicle.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AddStaticVehicle.md @@ -9,7 +9,7 @@ tags: ["车辆"] 在游戏模式中添加静态车辆（模型会预加载给玩家）。 -| 参数名 | 说明 | +| 参数 | 说明 | | -------------------------------------- | ------------------------------------- | | modelid | [车辆模型 ID](../resources/vehicleid) | | Float:spawnX | 生成点的 X 坐标 | @@ -42,7 +42,7 @@ public OnGameModeInit() - [AddStaticVehicleEx](AddStaticVehicleEx): 添加可自定义重生时间的静态车辆 - [CreateVehicle](CreateVehicle): 动态创建车辆 - [DestroyVehicle](DestroyVehicle): 销毁车辆 -- [GetVehicleParamsSirenState](GetVehicleParamsSirenState): 检测车辆警笛状态 +- [GetVehicleParamsSirenState](GetVehicleParamsSirenState): 检测车辆警报器状态 - [SetVehicleSpawnInfo](SetVehicleSpawnInfo): 配置车辆生成参数 - [GetVehicleSpawnInfo](GetVehicleSpawnInfo): 获取车辆生成信息 - [ChangeVehicleColours](ChangeVehicleColours): 修改车辆颜色 @@ -53,7 +53,7 @@ public OnGameModeInit() ## 相关回调 - [OnVehicleSpawn](../callbacks/OnVehicleSpawn): 车辆重生时触发 -- [OnVehicleSirenStateChange](../callbacks/OnVehicleSirenStateChange): 车辆警笛状态变化时触发 +- [OnVehicleSirenStateChange](../callbacks/OnVehicleSirenStateChange): 车辆警报器状态变化时触发 ## 相关资源 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AddStaticVehicleEx.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AddStaticVehicleEx.md index cd9c5a55d34..fbe6a4d9dc9 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AddStaticVehicleEx.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AddStaticVehicleEx.md @@ -11,17 +11,17 @@ tags: ["车辆"] 与 AddStaticVehicle 的唯一区别：可设置车辆无人驾驶后的重生时间。 -| 参数名 | 说明 | -| -------------------------------------- | --------------------------------------------------- | -| modelid | [车辆模型 ID](../resources/vehicleid) | -| Float:spawnX | 生成点的 X 坐标 | -| Float:spawnY | 生成点的 Y 坐标 | -| Float:spawnZ | 生成点的 Z 坐标 | -| Float:angle | 车辆初始朝向角度 | -| [colour1](../resources/vehiclecolorid) | 主颜色 ID | -| [colour2](../resources/vehiclecolorid) | 副颜色 ID | -| respawnDelay | 车辆无人驾驶后的重生延迟（单位：秒） | -| bool:addSiren | 默认值'false'。为车辆添加警笛功能（需车辆自带喇叭） | +| 参数 | 说明 | +| -------------------------------------- | ----------------------------------------------------- | +| modelid | [车辆模型 ID](../resources/vehicleid) | +| Float:spawnX | 生成点的 X 坐标 | +| Float:spawnY | 生成点的 Y 坐标 | +| Float:spawnZ | 生成点的 Z 坐标 | +| Float:angle | 车辆初始朝向角度 | +| [colour1](../resources/vehiclecolorid) | 主颜色 ID | +| [colour2](../resources/vehiclecolorid) | 副颜色 ID | +| respawnDelay | 车辆无人驾驶后的重生延迟（单位：秒） | +| bool:addSiren | 默认值'false'。为车辆添加警报器功能（需车辆自带喇叭） | ## 返回值 @@ -46,7 +46,7 @@ public OnGameModeInit() - [AddStaticVehicle](AddStaticVehicle): 添加基础静态车辆 - [CreateVehicle](CreateVehicle): 动态创建车辆 - [DestroyVehicle](DestroyVehicle): 销毁车辆 -- [GetVehicleParamsSirenState](GetVehicleParamsSirenState): 检测车辆警笛状态 +- [GetVehicleParamsSirenState](GetVehicleParamsSirenState): 检测车辆警报器状态 - [SetVehicleSpawnInfo](SetVehicleSpawnInfo): 配置车辆生成参数 - [GetVehicleSpawnInfo](GetVehicleSpawnInfo): 获取车辆生成信息 - [ChangeVehicleColours](ChangeVehicleColours): 修改车辆颜色 @@ -57,7 +57,7 @@ public OnGameModeInit() ## 相关回调 - [OnVehicleSpawn](../callbacks/OnVehicleSpawn): 车辆重生时触发 -- [OnVehicleSirenStateChange](../callbacks/OnVehicleSirenStateChange): 车辆警笛状态变化时触发 +- [OnVehicleSirenStateChange](../callbacks/OnVehicleSirenStateChange): 车辆警报器状态变化时触发 ## 相关资源 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AddVehicleComponent.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AddVehicleComponent.md index 2146b1e0361..1652e3fe243 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AddVehicleComponent.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AddVehicleComponent.md @@ -9,7 +9,7 @@ tags: ["车辆"] 为车辆添加一个「组件」（通常称为「改装件」）。有效改装件 ID 可参考此列表。 -| 参数名 | 说明 | +| 参数 | 说明 | | ---------------------------------------- | ------------------------------------------- | | vehicleid | 需要添加组件的车辆 ID（注意与模型 ID 区分） | | [component](../resources/carcomponentid) | 要添加的组件 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AllowAdminTeleport.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AllowAdminTeleport.md index 060dc7e00c4..f07782ea221 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AllowAdminTeleport.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AllowAdminTeleport.md @@ -7,21 +7,21 @@ tags: [] :::warning -本函数自 0.3d 版本起已弃用，请使用[OnPlayerClickMap](../callbacks/OnPlayerClickMap)回调替代。 +此函数自 0.3d 版本起已弃用，请使用[OnPlayerClickMap](../callbacks/OnPlayerClickMap)回调替代。 ::: ## 描述 -本函数用于控制远程控制台(RCON)管理员在设置路径点时是否会被传送到该位置。 +此函数用于控制远程控制台(RCON)管理员在设置路径点时是否会被传送到该位置。 -| 参数名 | 说明 | +| 参数 | 说明 | | ---------- | ------------------------------- | | bool:allow | 'false'禁用功能，'true'启用功能 | ## 返回值 -本函数无特定返回值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AllowInteriorWeapons.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AllowInteriorWeapons.md index 470d2a957ff..0297cc42d28 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AllowInteriorWeapons.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AllowInteriorWeapons.md @@ -9,13 +9,13 @@ tags: [] 切换是否允许玩家在室内场景使用武器。 -| 参数名 | 说明 | +| 参数 | 说明 | | ---------- | ----------------------------------------------------------- | | bool:allow | 'true'允许室内使用武器（默认启用），'false'禁止室内使用武器 | ## 返回值 -本函数无特定返回值。 +此函数不返回特定值。 ## 示例 @@ -32,7 +32,7 @@ public OnGameModeInit() :::warning -本功能在当前 SA-MP 版本中无效！ +此函数在当前 SA-MP 版本中无效！ ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AllowNickNameCharacter.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AllowNickNameCharacter.md index 2bb1aa4b701..7e865d6112e 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AllowNickNameCharacter.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AllowNickNameCharacter.md @@ -11,14 +11,14 @@ tags: [] 控制是否允许特定字符出现在玩家昵称中。 -| 参数名 | 说明 | +| 参数 | 说明 | | ---------- | ----------------------------- | | character | 需要控制的 ASCII 字符 | | bool:allow | true-允许使用，false-禁止使用 | ## 返回值 -本函数无特定返回值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AllowPlayerTeleport.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AllowPlayerTeleport.md index 7b6766f39b7..2e0edfd7751 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AllowPlayerTeleport.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AllowPlayerTeleport.md @@ -7,7 +7,7 @@ tags: ["玩家"] :::warning -本函数自 0.3d 版本起已弃用，请使用[OnPlayerClickMap](../callbacks/OnPlayerClickMap)回调替代。 +此函数自 0.3d 版本起已弃用，请使用[OnPlayerClickMap](../callbacks/OnPlayerClickMap)回调替代。 ::: @@ -15,14 +15,14 @@ tags: ["玩家"] 启用/禁用玩家通过右键点击地图进行传送的能力 -| 参数名 | 说明 | +| 参数 | 说明 | | ---------- | ------------------------------- | | playerid | 需要启用传送功能的玩家 ID | | bool:allow | 'false'禁用功能，'true'启用功能 | ## 返回值 -本函数无特定返回值。 +此函数不返回特定值。 ## 示例 @@ -40,7 +40,7 @@ public OnPlayerConnect(playerid) :::warning -需先启用[AllowAdminTeleport](AllowAdminTeleport)且玩家具有管理员权限，本功能方可生效。 +需先启用[AllowAdminTeleport](AllowAdminTeleport)且玩家具有管理员权限，此函数方可生效。 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AllowPlayerWeapons.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AllowPlayerWeapons.md index b29957528e5..ea5eb5cdece 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AllowPlayerWeapons.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AllowPlayerWeapons.md @@ -11,14 +11,14 @@ tags: ["玩家"] 控制玩家是否可以使用武器。 -| 参数名 | 说明 | +| 参数 | 说明 | | ---------- | ------------------------------------- | | playerid | 需要控制武器权限的玩家 ID | | bool:allow | true 允许使用武器，false 禁止使用武器 | ## 返回值 -本函数始终返回 true。 +此函数始终返回 true。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ApplyActorAnimation.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ApplyActorAnimation.md index c6d1eeb73df..a75dd724aa5 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ApplyActorAnimation.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ApplyActorAnimation.md @@ -11,7 +11,7 @@ tags: ["角色", "动画"] 为游戏中的 NPC 角色应用指定的动画效果。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------------------ | ---------------------------------------------------------------------------------------------- | | actorid | 要应用动画的角色 ID | | const animationLibrary[] | 动画资源库名称 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ApplyAnimation.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ApplyAnimation.md index 729afa245d4..f5d52551cd2 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ApplyAnimation.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ApplyAnimation.md @@ -9,7 +9,7 @@ tags: ["玩家", "动画"] 为指定玩家应用动画效果。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------------------ | ------------------------------------------------------------------------------------------------------------------- | | playerid | 需要应用动画的玩家 ID | | const animationLibrary[] | [动画资源库](../resources/animations)名称 | @@ -24,7 +24,7 @@ tags: ["玩家", "动画"] ## 返回值 -本函数始终返回 true（即使玩家不存在或参数无效）。 +此函数始终返回 true（即使玩家不存在或参数无效）。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ArePlayerWeaponsAllowed.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ArePlayerWeaponsAllowed.md index c01ce8c1cd0..ed2958a3db0 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ArePlayerWeaponsAllowed.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ArePlayerWeaponsAllowed.md @@ -11,7 +11,7 @@ tags: ["玩家"] 检测指定玩家是否被允许使用武器。 -| 参数名 | 说明 | +| 参数 | 说明 | | -------- | ----------------- | | playerid | 需要检测的玩家 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Attach3DTextLabelToPlayer.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Attach3DTextLabelToPlayer.md index 4cda91403c3..7ae8b401353 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Attach3DTextLabelToPlayer.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Attach3DTextLabelToPlayer.md @@ -9,7 +9,7 @@ tags: ["玩家", "3d文本标签"] 将 3D 文本标签附加到玩家身上。 -| 名称 | 说明 | +| 参数 | 说明 | | ------------- | ---------------------------------------------------- | | Text3D:textid | 要附加的 3D 文本标签 ID（由 Create3DTextLabel 返回） | | playerid | 要附加标签的玩家 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Attach3DTextLabelToVehicle.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Attach3DTextLabelToVehicle.md index 588db9e5e89..5232e064002 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Attach3DTextLabelToVehicle.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Attach3DTextLabelToVehicle.md @@ -9,7 +9,7 @@ tags: ["车辆", "3d文本标签"] 将 3D 文本标签附加到指定车辆上。 -| 名称 | 说明 | +| 参数 | 说明 | | ------------- | ------------------------------------------------------- | | Text3D:textid | 要附加的 3D 文本标签 ID | | parentid | 要附加的车辆 ID | @@ -19,7 +19,7 @@ tags: ["车辆", "3d文本标签"] ## 返回值 -本函数没有特定返回值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AttachCameraToObject.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AttachCameraToObject.md index 1d872d710b1..c67266af456 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AttachCameraToObject.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AttachCameraToObject.md @@ -1,22 +1,22 @@ --- title: AttachCameraToObject sidebar_label: AttachCameraToObject -description: 您可以使用此功能将玩家视角附加到物体上。 +description: 你可以使用此函数将玩家视角附加到物体上。 tags: ["玩家", "物体"] --- ## 描述 -您可以使用此功能将玩家视角附加到物体上。 +你可以使用此函数将玩家视角附加到物体上。 -| 名称 | 说明 | +| 参数 | 说明 | | -------- | ----------------------- | | playerid | 需要附加视角的玩家 ID | | objectid | 要附加玩家视角的物体 ID | ## 返回值 -本函数没有特定返回值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AttachCameraToPlayerObject.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AttachCameraToPlayerObject.md index bc4ff28bbfa..315ef30ac4c 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AttachCameraToPlayerObject.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AttachCameraToPlayerObject.md @@ -9,14 +9,14 @@ tags: ["玩家", "视角"] 将玩家的视角附加到玩家创建的物体上。玩家在视角附加期间仍可自由操控视角，可与 MovePlayerObject 及 AttachPlayerObjectToVehicle 配合使用。 -| 名称 | 说明 | +| 参数 | 说明 | | -------------- | ----------------------------- | | playerid | 需要附加视角的玩家 ID | | playerobjectid | 要附加视角的玩家创建的物体 ID | ## 返回值 -本函数没有特定返回值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AttachObjectToObject.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AttachObjectToObject.md index 2f43ac6e060..6c483289cff 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AttachObjectToObject.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AttachObjectToObject.md @@ -7,9 +7,9 @@ tags: ["物体"] ## 描述 -您可以使用此功能将物体附加到其他物体上。被附加的物体会跟随主物体移动。 +你可以使用此函数将物体附加到其他物体上。被附加的物体会跟随主物体移动。 -| 名称 | 说明 | +| 参数 | 说明 | | ----------------- | ----------------------------------------------------------- | | objectid | 要附加的物体 ID | | parentid | 目标物体 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AttachObjectToPlayer.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AttachObjectToPlayer.md index c4c766c3004..eb58b63656a 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AttachObjectToPlayer.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AttachObjectToPlayer.md @@ -9,7 +9,7 @@ tags: ["物体", "玩家"] 将物体附加到玩家身上。 -| 名称 | 说明 | +| 参数 | 说明 | | --------------- | ----------------------------- | | objectid | 要附加的物体 ID | | parentid | 要附加的玩家 ID | @@ -22,7 +22,7 @@ tags: ["物体", "玩家"] ## 返回值 -本函数始终返回 **false**。 +此函数始终返回 **false**。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AttachObjectToVehicle.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AttachObjectToVehicle.md index 2dd3c76373f..3b6ffe41d45 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AttachObjectToVehicle.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AttachObjectToVehicle.md @@ -9,7 +9,7 @@ tags: ["物体", "车辆"] 将物体附加到车辆上。 -| 名称 | 说明 | +| 参数 | 说明 | | --------------- | --------------------------------------------------- | | objectid | 要附加的物体 ID（必须是已创建的物体 ID，非模型 ID） | | parentid | 目标车辆 ID | @@ -22,7 +22,7 @@ tags: ["物体", "车辆"] ## 返回值 -本函数没有特定返回值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AttachPlayerObjectToObject.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AttachPlayerObjectToObject.md index ee67b0f93ea..e89f2177059 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AttachPlayerObjectToObject.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AttachPlayerObjectToObject.md @@ -9,9 +9,9 @@ tags: ["玩家", "物体", "玩家物体"] ## 描述 -您可以使用此功能将玩家物体附加到其他玩家物体上。被附加的物体会跟随主物体移动。 +你可以使用此函数将玩家物体附加到其他玩家物体上。被附加的物体会跟随主物体移动。 -| 名称 | 说明 | +| 参数 | 说明 | | ----------------- | ----------------------------------------------------------- | | playerid | 玩家 ID | | objectid | 要附加的玩家物体 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AttachPlayerObjectToPlayer.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AttachPlayerObjectToPlayer.md index d40cfa754cd..f68b93d48b4 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AttachPlayerObjectToPlayer.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AttachPlayerObjectToPlayer.md @@ -9,7 +9,7 @@ tags: ["玩家", "物体", "玩家物体"] 功能与[AttachObjectToPlayer](AttachObjectToPlayer)相同，但针对玩家创建的物体。 -| 名称 | 说明 | +| 参数 | 说明 | | --------------- | --------------------------- | | playerid | 与物体关联的玩家 ID | | objectid | 要附加的玩家物体 ID | @@ -23,7 +23,7 @@ tags: ["玩家", "物体", "玩家物体"] ## 返回值 -本函数没有特定返回值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AttachPlayerObjectToVehicle.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AttachPlayerObjectToVehicle.md index 320c55f12a9..185f8ae8148 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AttachPlayerObjectToVehicle.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AttachPlayerObjectToVehicle.md @@ -9,7 +9,7 @@ tags: ["玩家", "物体", "玩家物体", "车辆"] 将玩家物体附加到车辆上。 -| 名称 | 说明 | +| 参数 | 说明 | | --------------- | ----------------------- | | playerid | 创建该物体的所属玩家 ID | | objectid | 要附加的玩家物体 ID | @@ -23,7 +23,7 @@ tags: ["玩家", "物体", "玩家物体", "车辆"] ## 返回值 -本函数没有特定返回值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AttachTrailerToVehicle.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AttachTrailerToVehicle.md index 3820e999181..53ee480c384 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AttachTrailerToVehicle.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/AttachTrailerToVehicle.md @@ -9,14 +9,14 @@ tags: ["车辆"] 将一个车辆作为拖车附加到另一个车辆上。 -| 名称 | 说明 | +| 参数 | 说明 | | --------- | ----------------- | | trailerid | 被牵引的车辆 ID | | vehicleid | 牵引拖车的车辆 ID | ## 返回值 -本函数始终返回 **true**，即使传入的车辆 ID 无效。 +此函数始终返回 **true**，即使传入的车辆 ID 无效。 ## 示例 @@ -31,7 +31,7 @@ AttachTrailerToVehicle(trailerId, vehicleId); :::warning -该功能仅在两个车辆均被玩家流加载时生效（参见[IsVehicleStreamedIn](IsVehicleStreamedIn)）。 +此函数仅在两个车辆均被玩家流加载时生效（参见[IsVehicleStreamedIn](IsVehicleStreamedIn)）。 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Ban.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Ban.md index 29397cf1073..289d9abe62c 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Ban.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Ban.md @@ -15,13 +15,13 @@ tags: ["玩家", "管理"] 可通过 RCON 命令`banip`和`unbanip`管理 IP 封禁（需配合[SendRconCommand](SendRconCommand)使用）。 -| 名称 | 说明 | +| 参数 | 说明 | | -------- | --------------- | | playerid | 要封禁的玩家 ID | ## 返回值 -本函数没有特定返回值。 +此函数不返回特定值。 ## 注意事项 @@ -51,7 +51,7 @@ public OnPlayerCommandText(playerid, cmdtext[]) // 封禁执行此命令的玩家 // 第一步：发送提示信息 - SendClientMessage(playerid, 0xFF0000FF, "您已被封禁!"); + SendClientMessage(playerid, 0xFF0000FF, "你已被封禁!"); // 通过定时器在1秒后执行封禁 SetTimerEx("DelayedBan", 1000, false, "d", playerid); diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/BanEx.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/BanEx.md index dfbfb4a4ce0..91128089387 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/BanEx.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/BanEx.md @@ -9,14 +9,14 @@ tags: ["玩家", "管理"] 封禁玩家并指定原因。 -| 名称 | 说明 | +| 参数 | 说明 | | -------------- | --------------- | | playerid | 要封禁的玩家 ID | | const reason[] | 封禁原因 | ## 返回值 -本函数没有特定返回值。 +此函数不返回特定值。 ## 注意事项 @@ -65,7 +65,7 @@ public OnPlayerCommandText(playerid, cmdtext[]) if (strcmp(cmdtext, "/banme", true) == 0) { // 封禁执行此命令的玩家 - BanExWithMessage(playerid, 0xFF0000FF, "您已被封禁!", "Request"); + BanExWithMessage(playerid, 0xFF0000FF, "你已被封禁!", "Request"); return 1; } return 0; @@ -76,7 +76,3 @@ public OnPlayerCommandText(playerid, cmdtext[]) - [Ban](Ban): 永久封禁玩家 - [Kick](Kick): 踢出服务器 - -``` - -``` diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/BeginObjectEditing.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/BeginObjectEditing.md index 489be7ceb40..5f9bd7bd59f 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/BeginObjectEditing.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/BeginObjectEditing.md @@ -11,7 +11,7 @@ tags: ["玩家", "物体"] 允许玩家通过图形用户界面（GUI）使用鼠标编辑物体（位置和旋转）。 -| 参数名 | 说明 | +| 参数 | 说明 | | -------- | ------------------------- | | playerid | 需要进行物体编辑的玩家 ID | | objectid | 玩家将要编辑的物体 ID | @@ -38,7 +38,7 @@ public OnPlayerCommandText(playerid, cmdtext[]) if (!strcmp(cmdtext, "/oedit", true)) { BeginObjectEditing(playerid, objectid); - SendClientMessage(playerid, 0xFFFFFFFF, "SERVER: 您现在可以编辑物体了！"); + SendClientMessage(playerid, 0xFFFFFFFF, "服务器：你现在可以编辑物体了！"); return 1; } return 0; diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/BeginObjectSelecting.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/BeginObjectSelecting.md index abddea91ed9..7becbd7c506 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/BeginObjectSelecting.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/BeginObjectSelecting.md @@ -11,13 +11,13 @@ tags: ["物体"] 显示光标并允许玩家选择物体。当玩家选择物体时会触发 OnPlayerSelectObject 回调函数。 -| 参数名 | 说明 | +| 参数 | 说明 | | -------- | ------------------------- | | playerid | 需要进行物体选择的玩家 ID | ## 返回值 -本函数没有特定返回值 +此函数不返回特定值。 ## 示例代码 @@ -27,7 +27,7 @@ public OnPlayerCommandText(playerid, cmdtext[]) if (!strcmp(cmdtext, "/select", true)) { BeginObjectSelecting(playerid); - SendClientMessage(playerid, 0xFFFFFFFF, "SERVER: 请选择您要编辑的物体！"); + SendClientMessage(playerid, 0xFFFFFFFF, "服务器：请选择你要编辑的物体！"); return 1; } return 0; diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/BeginPlayerObjectEditing.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/BeginPlayerObjectEditing.md index 8d2d85c0e1f..6dbb25828d7 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/BeginPlayerObjectEditing.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/BeginPlayerObjectEditing.md @@ -11,7 +11,7 @@ tags: ["玩家", "物体", "玩家物体"] 允许玩家通过图形用户界面（GUI）使用鼠标编辑玩家物体（位置和旋转）。 -| 参数名 | 说明 | +| 参数 | 说明 | | -------- | ------------------------- | | playerid | 需要进行物体编辑的玩家 ID | | objectid | 玩家将要编辑的玩家物体 ID | @@ -37,7 +37,7 @@ public OnPlayerCommandText(playerid, cmdtext[]) if (!strcmp(cmdtext, "/edit", true)) { BeginPlayerObjectEditing(playerid, gPlayerObject[playerid]); - SendClientMessage(playerid, 0xFFFFFFFF, "SERVER: 您现在可以编辑您的玩家物体！"); + SendClientMessage(playerid, 0xFFFFFFFF, "服务器：你现在可以编辑你的玩家物体！"); return 1; } return 0; diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/BlockIpAddress.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/BlockIpAddress.md index a4cf0e4e93b..2cd7500c3c7 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/BlockIpAddress.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/BlockIpAddress.md @@ -7,16 +7,16 @@ tags: ["ip地址"] ## 描述 -阻止指定 IP 地址与服务器通信（允许使用通配符），持续指定时长。被封锁 IP 的玩家尝试连接时会收到通用提示信息"您已被封禁"。已在线的该 IP 玩家将在数秒后超时断开连接，重新连接时也会收到相同提示。 +阻止指定 IP 地址与服务器通信（允许使用通配符），持续指定时长。被封锁 IP 的玩家尝试连接时会收到通用提示信息"你已被封禁"。已在线的该 IP 玩家将在数秒后超时断开连接，重新连接时也会收到相同提示。 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------------- | ------------------------------------- | | const ipAddress[] | 要封锁的 IP 地址 | | timeMS | 封锁时长（毫秒）。使用 0 表示永久封锁 | ## 返回值 -本函数没有特定返回值 +此函数不返回特定值。 ## 示例代码 @@ -35,7 +35,7 @@ public OnRconLoginAttempt(ip[], password[], success) :::tip -本函数支持通配符使用，例如封锁'6.9._._'将匹配前两组为 6 和 9 的所有 IP 地址。下划线可替代任意数字组合 +此函数支持通配符使用，例如封锁'6.9._._'将匹配前两组为 6 和 9 的所有 IP 地址。下划线可替代任意数字组合 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CallLocalFunction.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CallLocalFunction.md index fec3d64ecf0..aa150841a39 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CallLocalFunction.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CallLocalFunction.md @@ -2,14 +2,14 @@ title: CallLocalFunction sidebar_label: CallLocalFunction description: 调用当前脚本中的公共函数。 -tags: ["核心功能"] +tags: ["核心"] --- ## 描述 调用当前脚本中的公共函数。 -| 参数名 | 说明 | +| 参数 | 说明 | | -------------------- | ---------------------------------------- | | const functionName[] | 目标公共函数名称 | | const specifiers[] | 参数格式说明符（指定每个参数的数据类型） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CallRemoteFunction.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CallRemoteFunction.md index 20474d078ed..9f4c840af64 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CallRemoteFunction.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CallRemoteFunction.md @@ -9,7 +9,7 @@ tags: ["核心"] 调用任意已加载脚本中的公共函数。 -| 参数名 | 说明 | +| 参数 | 说明 | | -------------------- | ---------------------------------------- | | const functionName[] | 目标公共函数名称 | | const specifiers[] | 参数格式说明符（指定每个参数的数据类型） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CancelEdit.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CancelEdit.md index ae652deea81..18312616ff3 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CancelEdit.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CancelEdit.md @@ -9,13 +9,13 @@ tags: [] 终止玩家当前的物体编辑状态 -| 参数名 | 说明 | +| 参数 | 说明 | | -------- | --------------------- | | playerid | 需要终止编辑的玩家 ID | ## 返回值 -本函数没有特定返回值 +此函数不返回特定值。 ## 示例代码 @@ -25,7 +25,7 @@ public OnPlayerCommandText(playerid, cmdtext[]) if (!strcmp(cmdtext, "/stopedit", true)) { CancelEdit(playerid); - SendClientMessage(playerid, 0xFFFFFFFF, "服务器: 您已终止物体编辑！"); + SendClientMessage(playerid, 0xFFFFFFFF, "服务器: 你已终止物体编辑！"); return 1; } return 0; diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CancelSelectTextDraw.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CancelSelectTextDraw.md index cacf9aaa678..09b3463be18 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CancelSelectTextDraw.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CancelSelectTextDraw.md @@ -9,13 +9,13 @@ tags: ["文本绘图"] 终止玩家当前的文本绘图选择状态 -| 参数名 | 说明 | +| 参数 | 说明 | | -------- | ----------------------------- | | playerid | 需要禁用文本绘图选择的玩家 ID | ## 返回值 -本函数没有特定返回值 +此函数不返回特定值。 ## 示例代码 @@ -36,7 +36,7 @@ public OnPlayerCommandText(playerid, cmdtext[]) :::warning -本函数会触发 [OnPlayerClickTextDraw](../callbacks/OnPlayerClickTextDraw) 回调并传入 INVALID_TEXT_DRAW (65535) +此函数会触发 [OnPlayerClickTextDraw](../callbacks/OnPlayerClickTextDraw) 回调并传入 INVALID_TEXT_DRAW (65535) 在 OnPlayerClickTextDraw 回调中使用此函数时，若未处理该无效值情况会导致客户端进入无限循环 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ChangeVehicleColor.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ChangeVehicleColor.md index 1279fda1552..11030256f41 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ChangeVehicleColor.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ChangeVehicleColor.md @@ -9,7 +9,7 @@ tags: ["车辆"] 修改指定车辆的主色和副色 -| 参数名 | 说明 | +| 参数 | 说明 | | --------- | ------------- | | vehicleid | 目标车辆 ID | | color1 | 新的主颜色 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ChangeVehicleColours.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ChangeVehicleColours.md index da52424c60d..8ae804eb6d2 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ChangeVehicleColours.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ChangeVehicleColours.md @@ -11,7 +11,7 @@ tags: ["车辆"] 修改指定车辆的主色和副色 -| 参数名 | 说明 | +| 参数 | 说明 | | --------- | ------------- | | vehicleid | 目标车辆 ID | | colour1 | 新的主颜色 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ChangeVehiclePaintjob.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ChangeVehiclePaintjob.md index ae823af395d..e0248cdfcd3 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ChangeVehiclePaintjob.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ChangeVehiclePaintjob.md @@ -9,14 +9,14 @@ tags: ["车辆"] 修改车辆的涂装样式（纯色修改请参考[ChangeVehicleColor](ChangeVehicleColor)） -| 参数名 | 说明 | +| 参数 | 说明 | | --------- | ------------------------------------------------------------------------ | | vehicleid | 目标车辆 ID | | paintjob | 要应用的[涂装样式 ID](../resources/paintjobs)。使用 3 可移除当前涂装样式 | ## 返回值 -本函数始终返回 **true**（执行成功），即使指定车辆不存在 +此函数始终返回 **true**（执行成功），即使指定车辆不存在 ## 示例代码 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ClearActorAnimations.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ClearActorAnimations.md index 21020a3cc9c..41beb39a888 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ClearActorAnimations.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ClearActorAnimations.md @@ -11,7 +11,7 @@ tags: ["角色"] 终止指定角色当前正在播放的动画序列 -| 参数名 | 说明 | +| 参数 | 说明 | | ------- | ----------------------------------------------------- | | actorid | 目标角色 ID（通过[CreateActor](CreateActor)函数创建） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ClearAnimations.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ClearAnimations.md index adccc137a92..a9346d389b8 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ClearAnimations.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ClearAnimations.md @@ -9,14 +9,14 @@ tags: ["玩家", "动画"] 终止指定玩家当前所有动画效果，并取消其正在进行的行为任务（包括但不限于喷气背包飞行、跳伞、进入车辆过程、驾驶状态（强制移出车辆）、游泳等） -| 参数名 | 说明 | +| 参数 | 说明 | | -------------------- | ------------------------------------------------------------------------------------ | | playerid | 目标玩家 ID | | FORCE_SYNC:forceSync | 设置为`SYNC_ALL`将强制玩家在流式传输范围内同步动画状态（默认=SYNC_NONE，不强制同步） | ## 返回值 -本函数始终返回 **true**，即使指定玩家未连接 +此函数始终返回 **true**，即使指定玩家未连接 ## 示例代码 @@ -42,7 +42,7 @@ public OnPlayerCommandText(playerid, cmdtext[]) :::tip -与其他移出车辆方式不同，本函数会将车辆速度立即归零。玩家将出现在车辆顶部，位置与其在座位上的坐标一致 +与其他移出车辆方式不同，此函数会将车辆速度立即归零。玩家将出现在车辆顶部，位置与其在座位上的坐标一致 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ClearPlayerWorldBounds.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ClearPlayerWorldBounds.md index f18b75297b5..21f61195fa9 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ClearPlayerWorldBounds.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ClearPlayerWorldBounds.md @@ -11,7 +11,7 @@ tags: ["玩家"] 将指定玩家的自定义世界边界恢复为系统默认设置 -| 参数名 | 说明 | +| 参数 | 说明 | | -------- | ------------------------- | | playerid | 需要重置世界边界的玩家 ID | @@ -41,7 +41,7 @@ public OnPlayerDeath(playerid, killerid, WEAPON:reason) :::tip -系统默认边界值为 20000.0000, -20000.0000, 20000.0000, -20000.0000。建议使用本函数进行重置以确保代码可读性 +系统默认边界值为 20000.0000, -20000.0000, 20000.0000, -20000.0000。建议使用此函数进行重置以确保代码可读性 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ConnectNPC.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ConnectNPC.md index 99772755c92..48f95400676 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ConnectNPC.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ConnectNPC.md @@ -5,18 +5,24 @@ description: 连接一个NPC到服务器 tags: ["NPC"] --- +:::warning + +此函数已弃用，请使用 [NPC_Create](NPC_Create)。 + +::: + ## 描述 在服务器中创建一个 NPC 角色 -| 参数名 | 说明 | +| 参数 | 说明 | | -------------- | ------------------------------------------------------------ | | const name[] | NPC 连接时使用的名称，必须符合普通玩家命名规则 | | const script[] | 位于 npcmodes 文件夹中的 NPC 脚本名称（无需添加.amx 扩展名） | ## 返回值 -本函数始终返回 1 +此函数始终返回 1 ## 示例代码 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Create3DTextLabel.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Create3DTextLabel.md index 233c6b0b563..9a01848a104 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Create3DTextLabel.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Create3DTextLabel.md @@ -9,7 +9,7 @@ tags: ["3D文本标签"] 在三维空间中创建带有文字内容的可视化标签。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------------ | --------------------------------------------------------- | | const text[] | 初始显示的文本字符串 | | colour | 颜色值（使用整数或 RGBA 十六进制格式） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CreateActor.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CreateActor.md index 2264bf564df..b3af4a47687 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CreateActor.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CreateActor.md @@ -11,7 +11,7 @@ tags: ["角色"] 创建具有基础功能的静态角色实体。该实体类似 NPC 但功能受限，不会占用服务器玩家槽位。 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------- | ------------------------------------------- | | skin | 角色使用的[皮肤模型 ID](../resources/skins) | | Float:x | 生成坐标 X 轴值 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CreateExplosion.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CreateExplosion.md index 68ab362ade2..f2d0f01b5c0 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CreateExplosion.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CreateExplosion.md @@ -9,7 +9,7 @@ tags: [] 在三维空间指定坐标生成爆炸特效。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------ | ------------------------------------------ | | Float:x | 爆炸效果的 X 轴坐标 | | Float:y | 爆炸效果的 Y 轴坐标 | @@ -19,7 +19,7 @@ tags: [] ## 返回值 -本函数始终返回 1，即使爆炸类型或半径参数值无效。 +此函数始终返回 1，即使爆炸类型或半径参数值无效。 ## 应用示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CreateExplosionForPlayer.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CreateExplosionForPlayer.md index 82c9016fc95..ca070a1f8e7 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CreateExplosionForPlayer.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CreateExplosionForPlayer.md @@ -9,7 +9,7 @@ tags: ["玩家"] 创建仅对特定玩家可见的爆炸特效。适用于隔离爆炸效果或指定虚拟世界显示。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------ | ------------------------------------------ | | playerid | 目标玩家 ID | | Float:x | 爆炸 X 轴坐标 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CreateMenu.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CreateMenu.md index d1d20174fc7..e8649d0161d 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CreateMenu.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CreateMenu.md @@ -9,7 +9,7 @@ tags: ["菜单"] 创建基础菜单容器，用于构建玩家交互界面。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------------ | --------------------------------------------- | | const title[] | 菜单标题（最大 31 字符，超长自动截断） | | columns | 列数（仅支持 0 和 1 两列） | @@ -40,7 +40,7 @@ public OnGameModeInit() :::tip -- 本函数仅创建菜单容器，需调用[ShowMenuForPlayer](ShowMenuForPlayer)显示 +- 此函数仅创建菜单容器，需调用[ShowMenuForPlayer](ShowMenuForPlayer)显示 - 实际仅支持 0 和 1 两列配置 - 标题超过 32 字符将自动截断为 30 字符 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CreateObject.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CreateObject.md index b667574b6fe..c60c78d4b4c 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CreateObject.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CreateObject.md @@ -9,7 +9,7 @@ tags: ["物体"] 在三维空间指定位置生成静态/动态物体模型。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------------ | -------------------------------------------- | | modelid | 模型 ID | | Float:x | X 轴坐标 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CreatePickup.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CreatePickup.md index 0b0a2d3b9e5..c894ccc31c9 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CreatePickup.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CreatePickup.md @@ -7,9 +7,9 @@ tags: ["拾取物"] ## 描述 -本函数功能与 AddStaticPickup 相同，但会返回可用于后续销毁操作的拾取物 ID，并能通过 OnPlayerPickUpPickup 回调追踪拾取事件。 +此函数功能与 AddStaticPickup 相同，但会返回可用于后续销毁操作的拾取物 ID，并能通过 OnPlayerPickUpPickup 回调追踪拾取事件。 -| 参数名 | 说明 | +| 参数 | 说明 | | -------------------------------- | ------------------------------------------ | | [model](../resources/pickupids) | 拾取物[模型 ID](../resources/pickupids) | | [type](../resources/pickuptypes) | 拾取物[行为类型](../resources/pickuptypes) | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CreatePlayer3DTextLabel.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CreatePlayer3DTextLabel.md index b14dd759565..99b460a2752 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CreatePlayer3DTextLabel.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CreatePlayer3DTextLabel.md @@ -9,7 +9,7 @@ tags: ["玩家", "3D文本标签"] 创建仅对特定玩家可见的 3D 文本标签，支持实体绑定和视线检测功能。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------------ | ----------------------------------------------------- | | playerid | 可见该标签的目标玩家 ID | | const text[] | 显示文本内容（支持格式符） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CreatePlayerGangZone.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CreatePlayerGangZone.md index 10cdf59a85a..4fa9fb16f0e 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CreatePlayerGangZone.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CreatePlayerGangZone.md @@ -11,7 +11,7 @@ tags: ["玩家", "帮派区域", "玩家帮派区域"] 创建玩家独立可见的帮派区域，用于突破全局帮派区域的数量限制。 -| 参数名 | 说明 | +| 参数 | 说明 | | ---------- | ----------------------------------- | | playerid | 目标玩家 ID | | Float:minX | 区域西侧边界 X 坐标（最小水平坐标） | @@ -60,7 +60,7 @@ public OnPlayerConnect(playerid) :::tip -本函数仅创建区域，需调用[PlayerGangZoneShow](PlayerGangZoneShow)显示可视化效果 +此函数仅创建区域，需调用[PlayerGangZoneShow](PlayerGangZoneShow)显示可视化效果 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CreatePlayerObject.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CreatePlayerObject.md index a30c6473b7b..459bc3811b5 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CreatePlayerObject.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CreatePlayerObject.md @@ -9,7 +9,7 @@ tags: ["玩家", "物体", "玩家物体"] 创建一个仅对单个玩家可见的物体。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------------ | -------------------------------------------------------------------------------------- | | playerid | 要为其创建物体的玩家 ID | | modelid | 要创建的模型 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CreatePlayerPickup.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CreatePlayerPickup.md index 84d0739ea32..24687273cbb 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CreatePlayerPickup.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CreatePlayerPickup.md @@ -11,7 +11,7 @@ tags: ["玩家", "拾取物", "玩家拾取物"] 创建一个仅对单个玩家可见的拾取物。 -| 参数名 | 说明 | +| 参数 | 说明 | | -------------------------------- | ------------------------------------------------------ | | playerid | 要为其创建拾取物的玩家 ID | | [model](../resources/pickupids) | 拾取物的模型 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CreatePlayerTextDraw.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CreatePlayerTextDraw.md index ae03a1f6793..c279690cb67 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CreatePlayerTextDraw.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CreatePlayerTextDraw.md @@ -9,7 +9,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] 为单个玩家创建文本绘图，用于规避全局文本绘图数量限制。 -| 参数名 | 说明 | +| 参数 | 说明 | | ---------------- | --------------------------- | | playerid | 要为其创建文本绘图的玩家 ID | | Float:x | X 轴坐标 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CreateVehicle.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CreateVehicle.md index 703451b898d..2c86e50edac 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CreateVehicle.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/CreateVehicle.md @@ -9,17 +9,17 @@ tags: ["车辆"] 在游戏世界中动态创建车辆，可在脚本任意时刻替代 AddStaticVehicleEx 使用。 -| 参数名 | 说明 | -| -------------------------------------- | --------------------------------------------------- | -| [modelid](../resources/vehicleid) | 车辆模型 ID | -| Float:spawnX | 车辆生成的 X 轴坐标 | -| Float:spawnY | 车辆生成的 Y 轴坐标 | -| Float:spawnZ | 车辆生成的 Z 轴坐标 | -| Float:angle | 车辆初始朝向角度 | -| [colour1](../resources/vehiclecolorid) | 主颜色 ID | -| [colour2](../resources/vehiclecolorid) | 副颜色 ID | -| respawnDelay | 无驾驶员时车辆重生延迟（秒）。使用-1 将禁用自动重生 | -| bool:addSiren | 默认值'false'。为车辆启用警笛功能（需车辆自带喇叭） | +| 参数 | 说明 | +| -------------------------------------- | ----------------------------------------------------- | +| [modelid](../resources/vehicleid) | 车辆模型 ID | +| Float:spawnX | 车辆生成的 X 轴坐标 | +| Float:spawnY | 车辆生成的 Y 轴坐标 | +| Float:spawnZ | 车辆生成的 Z 轴坐标 | +| Float:angle | 车辆初始朝向角度 | +| [colour1](../resources/vehiclecolorid) | 主颜色 ID | +| [colour2](../resources/vehiclecolorid) | 副颜色 ID | +| respawnDelay | 无驾驶员时车辆重生延迟（秒）。使用-1 将禁用自动重生 | +| bool:addSiren | 默认值'false'。为车辆启用警报器功能（需车辆自带喇叭） | ## 返回值 @@ -53,7 +53,7 @@ public OnGameModeInit() - [DestroyVehicle](DestroyVehicle): 销毁车辆 - [AddStaticVehicle](AddStaticVehicle): 添加静态车辆 - [AddStaticVehicleEx](AddStaticVehicleEx): 添加带自定义重生时间的静态车辆 -- [GetVehicleParamsSirenState](GetVehicleParamsSirenState): 检测车辆警笛状态 +- [GetVehicleParamsSirenState](GetVehicleParamsSirenState): 检测车辆警报器状态 - [SetVehicleSpawnInfo](SetVehicleSpawnInfo): 配置车辆生成参数 - [GetVehicleSpawnInfo](GetVehicleSpawnInfo): 获取车辆生成信息 - [ChangeVehicleColours](ChangeVehicleColours): 修改车辆颜色配置 @@ -64,7 +64,7 @@ public OnGameModeInit() ## 相关回调 - [OnVehicleSpawn](../callbacks/OnVehicleSpawn): 车辆重生时触发 -- [OnVehicleSirenStateChange](../callbacks/OnVehicleSirenStateChange): 警笛状态变化时触发 +- [OnVehicleSirenStateChange](../callbacks/OnVehicleSirenStateChange): 警报器状态变化时触发 ## 相关资源 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_ExecuteQuery.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_ExecuteQuery.md index 56f0df8c348..d6449793e12 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_ExecuteQuery.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_ExecuteQuery.md @@ -1,17 +1,15 @@ --- title: DB_ExecuteQuery sidebar_label: DB_ExecuteQuery -description: 该函数用于在已打开的SQLite数据库上执行SQL查询语句。 -keywords: - - sqlite +description: 此函数用于在已打开的SQLite数据库上执行SQL查询语句。 tags: ["sqlite"] --- ## 描述 -该函数用于在已打开的 SQLite 数据库上执行 SQL 查询语句。 +此函数用于在已打开的 SQLite 数据库上执行 SQL 查询语句。 -| 参数名 | 说明 | +| 参数 | 说明 | | ---------------- | -------------------------- | | DB:db | 要执行查询的数据库连接句柄 | | const query[] | 需要执行的 SQL 查询语句 | @@ -58,7 +56,7 @@ public OnGameModeInit() // 创建数据库连接 gDBConnectionHandle = DB_Open("example.db"); - // 验证数据库连接状态 + // 检测数据库连接状态 if (gDBConnectionHandle) { print("成功连接数据库 \"example.db\""); diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_FreeResultSet.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_FreeResultSet.md index f5f590efe56..587ca03f304 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_FreeResultSet.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_FreeResultSet.md @@ -2,8 +2,6 @@ title: DB_FreeResultSet sidebar_label: DB_FreeResultSet description: 释放由DB_ExecuteQuery分配的查询结果内存。 -keywords: - - sqlite tags: ["sqlite"] --- @@ -11,7 +9,7 @@ tags: ["sqlite"] 释放由[DB_ExecuteQuery](DB_ExecuteQuery)分配的查询结果内存。 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------------- | ---------------------------------------------------------------- | | DBResult:dbresult | 要释放的查询结果句柄（由[DB_ExecuteQuery](DB_ExecuteQuery)分配） | @@ -57,6 +55,7 @@ public OnGameModeInit() // 建立数据库连接 gDBConnectionHandle = DB_Open("example.db"); + // 检测数据库连接状态 if (gDBConnectionHandle) { print("成功连接数据库 \"example.db\""); @@ -75,7 +74,8 @@ public OnGameModeExit() // 关闭数据库连接 if (DB_Close(gDBConnectionHandle)) { - gDBConnectionHandle = DB:0; // 重置句柄 + // 重置句柄 + gDBConnectionHandle = DB:0; } return 1; } diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_GetDatabaseConnectionCount.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_GetDatabaseConnectionCount.md index e9dc514509f..c56ba40c92a 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_GetDatabaseConnectionCount.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_GetDatabaseConnectionCount.md @@ -2,14 +2,12 @@ title: DB_GetDatabaseConnectionCount sidebar_label: DB_GetDatabaseConnectionCount description: 用于调试目的获取已打开的数据库连接数量。 -keywords: - - sqlite tags: ["sqlite"] --- ## 描述 -该函数用于调试目的获取已打开的数据库连接数量。 +此函数用于调试目的获取已打开的数据库连接数量。 | 参数 | 说明 | | ---- | ---------------- | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_GetDatabaseResultSetCount.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_GetDatabaseResultSetCount.md index 755f8922e23..89dc746c23c 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_GetDatabaseResultSetCount.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_GetDatabaseResultSetCount.md @@ -2,14 +2,12 @@ title: DB_GetDatabaseResultSetCount sidebar_label: DB_GetDatabaseResultSetCount description: 获取当前已打开的数据库查询结果集数量 -keywords: - - sqlite tags: ["sqlite"] --- ## 描述 -该函数用于获取当前已打开的数据库查询结果集数量。 +此函数用于获取当前已打开的数据库查询结果集数量。 | 参数 | 说明 | | ---- | ---------------- | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_GetFieldCount.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_GetFieldCount.md index 20fef747e34..280c1b1721e 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_GetFieldCount.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_GetFieldCount.md @@ -2,16 +2,14 @@ title: DB_GetFieldCount sidebar_label: DB_GetFieldCount description: 获取通过DB_ExecuteQuery分配的结果集中的字段总数。 -keywords: - - sqlite tags: ["sqlite"] --- ## 描述 -该函数用于获取通过[DB_ExecuteQuery](DB_ExecuteQuery)分配的结果集中的字段总数。 +此函数用于获取通过[DB_ExecuteQuery](DB_ExecuteQuery)分配的结果集中的字段总数。 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------------- | -------------------------------------------------------- | | DBResult:dbresult | 查询结果句柄（由[DB_ExecuteQuery](DB_ExecuteQuery)返回） | @@ -22,7 +20,7 @@ tags: ["sqlite"] ## 示例 ```c -// 示例模块 +// examples.inc // ... @@ -87,7 +85,7 @@ Float:Examples_CalculateSum(DB:dbConnectionHandle) ``` ```c -// 主游戏模式文件 +// mode.pwn // ... @@ -104,6 +102,7 @@ public OnGameModeInit() // 建立数据库连接 gDBConnectionHandle = DB_Open("example.db"); + // 检测数据库连接状态 if (gDBConnectionHandle) { print("成功连接数据库 \"example.db\""); @@ -122,7 +121,8 @@ public OnGameModeExit() // 关闭数据库连接 if (DB_Close(gDBConnectionHandle)) { - gDBConnectionHandle = DB:0; // 重置句柄 + // 重置句柄 + gDBConnectionHandle = DB:0; } return 1; } diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_GetFieldFloat.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_GetFieldFloat.md index 9c0a5e35e2d..e8f77b74510 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_GetFieldFloat.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_GetFieldFloat.md @@ -2,16 +2,14 @@ title: DB_GetFieldFloat sidebar_label: DB_GetFieldFloat description: 通过字段索引从查询结果中获取浮点数值。 -keywords: - - sqlite tags: ["sqlite"] --- ## 描述 -该函数用于通过字段索引从[DB_ExecuteQuery](DB_ExecuteQuery)分配的查询结果中获取浮点数值。 +此函数用于通过字段索引从[DB_ExecuteQuery](DB_ExecuteQuery)分配的查询结果中获取浮点数值。 -| 参数名 | 说明 | +| 参数 | 说明 | | --------------- | -------------------------------------------------------- | | DBResult:result | 查询结果句柄（由[DB_ExecuteQuery](DB_ExecuteQuery)返回） | | field = 0 | 目标字段索引（默认从 0 开始） | @@ -23,7 +21,7 @@ tags: ["sqlite"] ## 示例 ```c -// 示例模块 +// examples.inc // ... @@ -87,7 +85,7 @@ Float:Examples_CalculateSum(DB:dbConnectionHandle) ``` ```c -// 主游戏模式文件 +// mode.pwn // ... @@ -104,6 +102,7 @@ public OnGameModeInit() // 建立数据库连接 gDBConnectionHandle = DB_Open("example.db"); + // 检测数据库连接状态 if (gDBConnectionHandle) { print("成功连接数据库 \"example.db\""); @@ -122,7 +121,8 @@ public OnGameModeExit() // 关闭数据库连接 if (DB_Close(gDBConnectionHandle)) { - gDBConnectionHandle = DB:0; // 重置句柄 + // 重置句柄 + gDBConnectionHandle = DB:0; } return 1; } diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_GetFieldFloatByName.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_GetFieldFloatByName.md index 06a57051ba0..7fc532d107b 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_GetFieldFloatByName.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_GetFieldFloatByName.md @@ -2,16 +2,14 @@ title: DB_GetFieldFloatByName sidebar_label: DB_GetFieldFloatByName description: 通过字段名称从查询结果中获取浮点数值。 -keywords: - - sqlite tags: ["sqlite"] --- ## 描述 -该函数通过字段名称从[DB_ExecuteQuery](DB_ExecuteQuery)分配的查询结果中获取浮点数值。 +此函数通过字段名称从[DB_ExecuteQuery](DB_ExecuteQuery)分配的查询结果中获取浮点数值。 -| 参数名 | 说明 | +| 参数 | 说明 | | --------------- | -------------------------------------------------------- | | DBResult:result | 查询结果句柄（由[DB_ExecuteQuery](DB_ExecuteQuery)返回） | | const field[] | 目标字段名称 | @@ -23,7 +21,7 @@ tags: ["sqlite"] ## 示例 ```c -// 示例模块 +// examples.inc // ... @@ -54,7 +52,7 @@ Float:Examples_CalculateSum(DB:dbConnectionHandle) ``` ```c -// 主游戏模式文件 +// mode.pwn // ... @@ -71,6 +69,7 @@ public OnGameModeInit() // 建立数据库连接 gDBConnectionHandle = DB_Open("example.db"); + // 检测数据库连接状态 if (gDBConnectionHandle) { print("成功连接数据库 \"example.db\""); @@ -89,7 +88,8 @@ public OnGameModeExit() // 关闭数据库连接 if (DB_Close(gDBConnectionHandle)) { - gDBConnectionHandle = DB:0; // 重置句柄 + // 重置句柄 + gDBConnectionHandle = DB:0; } return 1; } diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_GetFieldInt.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_GetFieldInt.md index f1e2b25811d..eaf58404c2e 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_GetFieldInt.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_GetFieldInt.md @@ -2,16 +2,14 @@ title: DB_GetFieldInt sidebar_label: DB_GetFieldInt description: 通过字段索引从DB_ExecuteQuery结果中获取整数值。 -keywords: - - sqlite tags: ["sqlite"] --- ## 描述 -该函数用于通过字段索引从[DB_ExecuteQuery](DB_ExecuteQuery)分配的查询结果中获取整数值。 +此函数用于通过字段索引从[DB_ExecuteQuery](DB_ExecuteQuery)分配的查询结果中获取整数值。 -| 参数名 | 说明 | +| 参数 | 说明 | | --------------- | -------------------------------------------------------- | | DBResult:result | 查询结果句柄（由[DB_ExecuteQuery](DB_ExecuteQuery)返回） | | field = 0 | 目标字段索引（默认从 0 开始） | @@ -23,7 +21,7 @@ tags: ["sqlite"] ## 示例 ```c -// 示例模块 +// examples.inc // ... @@ -88,7 +86,7 @@ Examples_CalculateSum(DB:dbConnectionHandle) ``` ```c -// 主游戏模式文件 +// mode.pwn // ... @@ -105,6 +103,7 @@ public OnGameModeInit() // 建立数据库连接 gDBConnectionHandle = DB_Open("example.db"); + // 检测数据库连接状态 if (gDBConnectionHandle) { print("成功连接数据库 \"example.db\""); @@ -123,7 +122,8 @@ public OnGameModeExit() // 关闭数据库连接 if (DB_Close(gDBConnectionHandle)) { - gDBConnectionHandle = DB:0; // 重置句柄 + // 重置句柄 + gDBConnectionHandle = DB:0; } return 1; } diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_GetFieldIntByName.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_GetFieldIntByName.md index 11ad6a8a047..648c05ee280 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_GetFieldIntByName.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_GetFieldIntByName.md @@ -2,16 +2,14 @@ title: DB_GetFieldIntByName sidebar_label: DB_GetFieldIntByName description: 通过字段名称从查询结果中获取整数值。 -keywords: - - sqlite tags: ["sqlite"] --- ## 描述 -该函数通过字段名称从[DB_ExecuteQuery](DB_ExecuteQuery)分配的查询结果中获取整数值。 +此函数通过字段名称从[DB_ExecuteQuery](DB_ExecuteQuery)分配的查询结果中获取整数值。 -| 参数名 | 说明 | +| 参数 | 说明 | | --------------- | -------------------------------------------------------- | | DBResult:result | 查询结果句柄（由[DB_ExecuteQuery](DB_ExecuteQuery)返回） | | const field[] | 目标字段名称 | @@ -23,7 +21,7 @@ tags: ["sqlite"] ## 示例 ```c -// 示例模块 +// examples.inc // ... @@ -54,7 +52,7 @@ Examples_CalculateSum(DB:dbConnectionHandle) ``` ```c -// 主游戏模式文件 +// mode.pwn // ... @@ -71,6 +69,7 @@ public OnGameModeInit() // 建立数据库连接 gDBConnectionHandle = DB_Open("example.db"); + // 检测数据库连接状态 if (gDBConnectionHandle) { print("成功连接数据库 \"example.db\""); @@ -89,7 +88,8 @@ public OnGameModeExit() // 关闭数据库连接 if (DB_Close(gDBConnectionHandle)) { - gDBConnectionHandle = DB:0; // 重置句柄 + // 重置句柄 + gDBConnectionHandle = DB:0; } return 1; } diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_GetFieldName.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_GetFieldName.md index 0166c9df263..d432dc99cde 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_GetFieldName.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_GetFieldName.md @@ -2,16 +2,14 @@ title: DB_GetFieldName sidebar_label: DB_GetFieldName description: 返回指定索引处的字段名称。 -keywords: - - sqlite tags: ["sqlite"] --- ## 描述 -该函数返回指定索引处的字段名称。 +此函数返回指定索引处的字段名称。 -| 参数名 | 说明 | +| 参数 | 说明 | | ---------------------- | -------------------------------------------------------- | | DBResult:result | 查询结果句柄（由[DB_ExecuteQuery](DB_ExecuteQuery)返回） | | field | 要获取的字段索引（从 0 开始） | @@ -35,6 +33,7 @@ public OnGameModeInit() // 建立数据库连接 gDBConnectionHandle = DB_Open("example.db"); + // 检测数据库连接状态 if (gDBConnectionHandle) { // 从'join_log'表中选择第一条记录 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_GetFieldString.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_GetFieldString.md index b8c73a15353..8de01f7ffd6 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_GetFieldString.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_GetFieldString.md @@ -2,16 +2,14 @@ title: DB_GetFieldString sidebar_label: DB_GetFieldString description: 通过字段索引从DB_ExecuteQuery结果中获取字符串数据。 -keywords: - - sqlite tags: ["sqlite"] --- ## 描述 -该函数用于通过字段索引从[DB_ExecuteQuery](DB_ExecuteQuery)分配的查询结果中获取字符串数据。 +此函数用于通过字段索引从[DB_ExecuteQuery](DB_ExecuteQuery)分配的查询结果中获取字符串数据。 -| 参数名 | 说明 | +| 参数 | 说明 | | ---------------------- | -------------------------------------------------------- | | DBResult:result | 查询结果句柄（由[DB_ExecuteQuery](DB_ExecuteQuery)返回） | | field | 目标字段索引 | @@ -26,7 +24,7 @@ tags: ["sqlite"] ## 示例 ```c -// 示例模块 +// examples.inc // ... @@ -89,7 +87,7 @@ Examples_ListNames(DB:dbConnectionHandle) ``` ```c -// 主游戏模式文件 +// mode.pwn // ... @@ -106,6 +104,7 @@ public OnGameModeInit() // 建立数据库连接 gDBConnectionHandle = DB_Open("example.db"); + // 检测数据库连接状态 if (gDBConnectionHandle) { print("成功连接数据库 \"example.db\""); @@ -124,7 +123,8 @@ public OnGameModeExit() // 关闭数据库连接 if (DB_Close(gDBConnectionHandle)) { - gDBConnectionHandle = DB:0; // 重置句柄 + // 重置句柄 + gDBConnectionHandle = DB:0; } return 1; } diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_GetFieldStringByName.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_GetFieldStringByName.md index 96baa7ca482..9fa3ccb7a1e 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_GetFieldStringByName.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_GetFieldStringByName.md @@ -2,8 +2,6 @@ title: DB_GetFieldStringByName sidebar_label: DB_GetFieldStringByName description: 通过字段名称从查询结果中获取字符串内容。 -keywords: - - sqlite tags: ["sqlite"] --- @@ -11,7 +9,7 @@ tags: ["sqlite"] 通过字段名称从[DB_ExecuteQuery](DB_ExecuteQuery)分配的查询结果中获取字符串数据。 -| 参数名 | 说明 | +| 参数 | 说明 | | ---------------------- | -------------------------------------------------------- | | DBResult:result | 查询结果句柄（由[DB_ExecuteQuery](DB_ExecuteQuery)返回） | | const field[] | 目标字段名称 | @@ -26,7 +24,7 @@ tags: ["sqlite"] ## 示例 ```c -// 示例模块 +// examples.inc // ... @@ -55,7 +53,7 @@ Examples_ListNames(DB:dbConnectionHandle) ``` ```c -// 主游戏模式文件 +// mode.pwn // ... @@ -72,6 +70,7 @@ public OnGameModeInit() // 建立数据库连接 gDBConnectionHandle = DB_Open("example.db"); + // 检测数据库连接状态 if (gDBConnectionHandle) { print("成功连接数据库 \"example.db\""); @@ -90,7 +89,8 @@ public OnGameModeExit() // 关闭数据库连接 if (DB_Close(gDBConnectionHandle)) { - gDBConnectionHandle = DB:0; // 重置句柄 + // 重置句柄 + gDBConnectionHandle = DB:0; } return 1; } diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_GetLegacyDBResult.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_GetLegacyDBResult.md index 58c24c3cbc5..7cae599030b 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_GetLegacyDBResult.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_GetLegacyDBResult.md @@ -2,16 +2,14 @@ title: DB_GetLegacyDBResult sidebar_label: DB_GetLegacyDBResult description: 获取通过DB_ExecuteQuery分配的SQLite查询结果内存句柄 -keywords: - - sqlite tags: ["sqlite"] --- ## 描述 -该函数用于获取通过[DB_ExecuteQuery](DB_ExecuteQuery)执行的 SQLite 数据库查询结果的内存句柄。 +此函数用于获取通过[DB_ExecuteQuery](DB_ExecuteQuery)执行的 SQLite 数据库查询结果的内存句柄。 -| 参数名 | 说明 | +| 参数 | 说明 | | --------------- | ---------------------------------------------------------- | | DBResult:result | 数据库查询句柄（由[DB_ExecuteQuery](DB_ExecuteQuery)返回） | @@ -33,6 +31,7 @@ public OnGameModeInit() // 建立数据库连接 gDBConnectionHandle = DB_Open("example.db"); + // 检测数据库连接状态 if (gDBConnectionHandle) { // 执行数据库查询 @@ -59,7 +58,8 @@ public OnGameModeExit() // 关闭数据库连接 if (DB_Close(gDBConnectionHandle)) { - gDBConnectionHandle = DB:0; // 重置句柄 + // 重置句柄 + gDBConnectionHandle = DB:0; } return 1; } diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_GetMemHandle.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_GetMemHandle.md index 71a0dc1d7b8..120bfea0392 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_GetMemHandle.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_GetMemHandle.md @@ -2,18 +2,16 @@ title: DB_GetMemHandle sidebar_label: DB_GetMemHandle description: 获取通过DB_Open建立的SQLite数据库连接的内存句柄。 -keywords: - - sqlite tags: ["sqlite"] --- ## 描述 -该函数用于获取通过[DB_Open](DB_Open)建立的 SQLite 数据库连接的内存句柄。 +此函数用于获取通过[DB_Open](DB_Open)建立的 SQLite 数据库连接的内存句柄。 -| 参数名 | 说明 | -| ------ | ------------------------------------------ | -| DB:db | 数据库连接句柄（由[DB_Open](DB_Open)返回） | +| 参数 | 说明 | +| ----- | ------------------------------------------ | +| DB:db | 数据库连接句柄（由[DB_Open](DB_Open)返回） | ## 返回值 @@ -33,6 +31,7 @@ public OnGameModeInit() // 建立数据库连接 gDBConnectionHandle = DB_Open("example.db"); + // 检测数据库连接状态 if (gDBConnectionHandle) { print("成功连接数据库 \"example.db\""); @@ -51,7 +50,8 @@ public OnGameModeExit() // 关闭数据库连接 if (DB_Close(gDBConnectionHandle)) { - gDBConnectionHandle = DB:0; // 重置句柄 + // 重置句柄 + gDBConnectionHandle = DB:0; } return 1; } diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_GetRowCount.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_GetRowCount.md index f772b28d2fc..6fd87505f94 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_GetRowCount.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_GetRowCount.md @@ -2,16 +2,14 @@ title: DB_GetRowCount sidebar_label: DB_GetRowCount description: 返回通过DB_ExecuteQuery执行的查询结果中的行数。 -keywords: - - sqlite tags: ["sqlite"] --- ## 描述 -该函数用于获取通过[DB_ExecuteQuery](DB_ExecuteQuery)执行的查询结果中的行数。 +此函数用于获取通过[DB_ExecuteQuery](DB_ExecuteQuery)执行的查询结果中的行数。 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------------- | -------------------------------------------------------- | | DBResult:dbresult | 查询结果句柄（由[DB_ExecuteQuery](DB_ExecuteQuery)返回） | @@ -22,7 +20,7 @@ tags: ["sqlite"] ## 示例 ```c -// 示例模块 +// examples.inc // ... @@ -55,7 +53,7 @@ Examples_ListNames(DB:dbConnectionHandle) ``` ```c -// 主游戏模式文件 +// mode.pwn // ... @@ -72,6 +70,7 @@ public OnGameModeInit() // 建立数据库连接 gDBConnectionHandle = DB_Open("example.db"); + // 检测数据库连接状态 if (gDBConnectionHandle) { print("成功连接数据库 \"example.db\""); @@ -90,7 +89,8 @@ public OnGameModeExit() // 关闭数据库连接 if (DB_Close(gDBConnectionHandle)) { - gDBConnectionHandle = DB:0; // 重置句柄 + // 重置句柄 + gDBConnectionHandle = DB:0; } return 1; } diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_SelectNextRow.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_SelectNextRow.md index 86ffbcecebb..8bdbdcb9dde 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_SelectNextRow.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DB_SelectNextRow.md @@ -2,16 +2,14 @@ title: DB_SelectNextRow sidebar_label: DB_SelectNextRow description: 在DB_ExecuteQuery分配的结果集中移动到下一行。 -keywords: - - sqlite tags: ["sqlite"] --- ## 描述 -该函数用于在通过[DB_ExecuteQuery](DB_ExecuteQuery)分配的结果集中移动到下一行。 +此函数用于在通过[DB_ExecuteQuery](DB_ExecuteQuery)分配的结果集中移动到下一行。 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------------- | -------------------------------------------------------- | | DBResult:dbresult | 查询结果句柄（由[DB_ExecuteQuery](DB_ExecuteQuery)返回） | @@ -23,7 +21,7 @@ tags: ["sqlite"] ## 示例 ```c -// 示例模块 +// examples.inc // ... @@ -52,7 +50,7 @@ Examples_ListNames(DB:dbConnectionHandle) ``` ```c -// 主游戏模式文件 +// mode.pwn // ... @@ -69,6 +67,7 @@ public OnGameModeInit() // 建立数据库连接 gDBConnectionHandle = DB_Open("example.db"); + // 检测数据库连接状态 if (gDBConnectionHandle) { print("成功连接数据库 \"example.db\""); @@ -87,7 +86,8 @@ public OnGameModeExit() // 关闭数据库连接 if (DB_Close(gDBConnectionHandle)) { - gDBConnectionHandle = DB:0; // 重置句柄 + // 重置句柄 + gDBConnectionHandle = DB:0; } return 1; } diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Delete3DTextLabel.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Delete3DTextLabel.md index 7d6665cb708..15e8c77380f 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Delete3DTextLabel.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Delete3DTextLabel.md @@ -7,9 +7,9 @@ tags: ["3d文本标签"] ## 描述 -该函数用于删除通过[Create3DTextLabel](Create3DTextLabel)创建的 3D 文本标签。 +此函数用于删除通过[Create3DTextLabel](Create3DTextLabel)创建的 3D 文本标签。 -| 参数名 | 描述 | +| 参数 | 说明 | | ------------- | ----------------------- | | Text3D:textid | 要删除的 3D 文本标签 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DeletePVar.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DeletePVar.md index d8be2879e48..2da204496c6 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DeletePVar.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DeletePVar.md @@ -2,14 +2,14 @@ title: DeletePVar sidebar_label: DeletePVar description: 删除先前设置的玩家变量。 -tags: ["玩家变量", "pvar"] +tags: ["玩家变量"] --- ## 描述 删除先前设置的玩家变量。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------ | ---------------------- | | playerid | 要删除变量的玩家 ID。 | | const pvar[] | 要删除的玩家变量名称。 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DeletePlayer3DTextLabel.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DeletePlayer3DTextLabel.md index e678f807ee6..b21bdce8d7c 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DeletePlayer3DTextLabel.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DeletePlayer3DTextLabel.md @@ -9,7 +9,7 @@ tags: ["玩家", "3D文本标签"] 销毁通过 CreatePlayer3DTextLabel 创建的 3D 文本标签。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------------- | ------------------------------- | | playerid | 要删除其 3D 文本标签的玩家 ID。 | | PlayerText3D:textid | 要删除的玩家 3D 文本标签 ID。 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DeleteSVar.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DeleteSVar.md index 81f42b39f84..53bb78b6600 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DeleteSVar.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DeleteSVar.md @@ -2,14 +2,14 @@ title: DeleteSVar sidebar_label: DeleteSVar description: 删除先前设置的服务器变量。 -tags: ["服务器变量", "svar"] +tags: ["服务器变量"] --- ## 描述 删除先前设置的服务器变量。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------ | ------------------------ | | const svar[] | 要删除的服务器变量名称。 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DestroyActor.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DestroyActor.md index 1cd2080b728..159df773ae2 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DestroyActor.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DestroyActor.md @@ -11,7 +11,7 @@ tags: ["角色"] 销毁通过 CreateActor 创建的角色。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------- | -------------------------------------------- | | actorid | 要销毁的角色 ID。该 ID 由 CreateActor 返回。 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DestroyMenu.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DestroyMenu.md index 80b855fb64d..eda6b43185c 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DestroyMenu.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DestroyMenu.md @@ -9,7 +9,7 @@ tags: ["菜单"] 销毁指定的菜单。 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------- | --------------- | | Menu:menuid | 要销毁的菜单 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DestroyObject.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DestroyObject.md index 8d3a5027631..08032828c9e 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DestroyObject.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DestroyObject.md @@ -9,13 +9,13 @@ tags: ["物体"] 销毁通过 CreateObject 创建的物体。 -| 名称 | 描述 | +| 参数 | 说明 | | -------- | ------------------------------------- | | objectid | 要销毁的物体 ID，由 CreateObject 返回 | ## 返回值 -该函数不返回特定值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DestroyPickup.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DestroyPickup.md index dc4530906ba..c57f33d60b0 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DestroyPickup.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DestroyPickup.md @@ -9,7 +9,7 @@ tags: ["拾取物"] 销毁通过 CreatePickup 创建的拾取物。 -| 名称 | 描述 | +| 参数 | 说明 | | ------ | ----------------------------------------- | | pickup | 要销毁的拾取物 ID（由 CreatePickup 返回） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DestroyPlayerObject.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DestroyPlayerObject.md index 80459dc8fc3..ce39f844ace 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DestroyPlayerObject.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DestroyPlayerObject.md @@ -2,21 +2,21 @@ title: DestroyPlayerObject sidebar_label: DestroyPlayerObject description: 销毁通过 CreatePlayerObject 创建的玩家专属物体。 -tags: ["玩家", "物体", "玩家专属物体"] +tags: ["玩家", "物体", "玩家物体"] --- ## 描述 销毁通过 [CreatePlayerObject](CreatePlayerObject) 创建的玩家专属物体。 -| 名称 | 描述 | +| 参数 | 说明 | | -------- | ----------------------------------------------------- | | playerid | 要销毁其玩家专属物体的玩家 ID | | objectid | 要销毁的玩家专属物体 ID（由 CreatePlayerObject 返回） | ## 返回值 -该函数不返回特定值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DestroyPlayerPickup.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DestroyPlayerPickup.md index d7e44439745..b8a9d03243c 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DestroyPlayerPickup.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DestroyPlayerPickup.md @@ -2,7 +2,7 @@ title: DestroyPlayerPickup sidebar_label: DestroyPlayerPickup description: 销毁通过 CreatePlayerPickup 创建的玩家专属拾取物。 -tags: ["玩家", "拾取物", "玩家专属拾取物"] +tags: ["玩家", "拾取物", "玩家拾取物"] --- @@ -11,14 +11,14 @@ tags: ["玩家", "拾取物", "玩家专属拾取物"] 销毁通过 [CreatePlayerPickup](CreatePlayerPickup) 创建的玩家专属拾取物。 -| 名称 | 描述 | +| 参数 | 说明 | | -------- | ------------------------------------------------------- | | playerid | 目标玩家 ID | | pickupid | 要销毁的玩家专属拾取物 ID（由 CreatePlayerPickup 返回） | ## 返回值 -该函数不返回特定值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DestroyVehicle.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DestroyVehicle.md index 738231563da..9c74a29137a 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DestroyVehicle.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DestroyVehicle.md @@ -9,7 +9,7 @@ tags: ["车辆"] 销毁一辆车辆。该车辆将立即消失。 -| 名称 | 描述 | +| 参数 | 说明 | | --------- | --------------- | | vehicleid | 要销毁的车辆 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DetachTrailerFromVehicle.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DetachTrailerFromVehicle.md index 3f075b2e780..c4cfed7c623 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DetachTrailerFromVehicle.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DetachTrailerFromVehicle.md @@ -9,13 +9,13 @@ tags: ["车辆"] 断开车辆与其拖车之间的连接（如果存在）。 -| 名称 | 描述 | +| 参数 | 说明 | | --------- | ------------- | | vehicleid | 牵引车辆的 ID | ## 返回值 -该函数不返回特定值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DisableInteriorEnterExits.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DisableInteriorEnterExits.md index c167640f6d2..fbd764dbbb4 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DisableInteriorEnterExits.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DisableInteriorEnterExits.md @@ -23,7 +23,7 @@ public OnGameModeInit() :::warning -该函数仅在玩家连接前调用有效（建议在 [OnGameModeInit](../callbacks/OnGameModeInit) 中使用）。已连接玩家的标记不会被移除。 +此函数仅在玩家连接前调用有效（建议在 [OnGameModeInit](../callbacks/OnGameModeInit) 中使用）。已连接玩家的标记不会被移除。 若在调用此函数后切换游戏模式，且新游戏模式未禁用标记，已连接玩家不会重新显示标记（但新连接玩家会显示）。 @@ -31,7 +31,7 @@ public OnGameModeInit() :::tip -您也可以通过 [config.json](../../server/config.json) 禁用室内入口标记： +你也可以通过 [config.json](../../server/config.json) 禁用室内入口标记： ```json "use_entry_exit_markers": false, diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DisableMenu.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DisableMenu.md index 007f6b0c5dc..7906a611c45 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DisableMenu.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DisableMenu.md @@ -9,13 +9,13 @@ tags: ["菜单"] 禁用一个菜单。 -| 名称 | 描述 | +| 参数 | 说明 | | ----------- | --------------- | | Menu:menuid | 要禁用的菜单 ID | ## 返回值 -该函数不返回特定值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DisableMenuRow.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DisableMenuRow.md index 805c2e8df82..13665955b4f 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DisableMenuRow.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DisableMenuRow.md @@ -9,14 +9,14 @@ tags: ["菜单"] 为所有玩家禁用菜单中的特定行。该行将显示为灰色且不可选择。 -| 名称 | 描述 | +| 参数 | 说明 | | ----------- | --------------------------------------------- | | Menu:menuid | 目标菜单 ID（无效的菜单 ID 会导致服务器崩溃） | | row | 要禁用的行序号（从 0 开始计数） | ## 返回值 -该函数始终返回 **1**（即使操作失败）。 +此函数始终返回 **1**（即使操作失败）。 如果指定无效行序号，不会有任何效果。 @@ -53,7 +53,7 @@ public OnPlayerCommandText(playerid, cmdtext[]) :::tip - 传入无效菜单 ID 会导致服务器崩溃 -- 本函数会对所有玩家生效 +- 此函数会对所有玩家生效 - 没有针对单个玩家的行禁用功能 - 可通过创建多个菜单实现差异化效果（如：包含禁用行的菜单和普通菜单） diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DisableNameTagLOS.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DisableNameTagLOS.md index c75374e7d6b..b2097258272 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DisableNameTagLOS.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DisableNameTagLOS.md @@ -23,7 +23,7 @@ public OnGameModeInit() :::warning -该功能在服务器重启前不可逆。 +此函数在服务器重启前不可逆。 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DisablePlayerCheckpoint.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DisablePlayerCheckpoint.md index 9bec025fa84..f806ea78e9d 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DisablePlayerCheckpoint.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DisablePlayerCheckpoint.md @@ -9,7 +9,7 @@ tags: ["玩家", "检查点"] 禁用（隐藏/销毁）玩家设置的检查点。每个玩家同时只能拥有一个检查点，设置新检查点时会自动覆盖旧检查点。 -| 名称 | 描述 | +| 参数 | 说明 | | -------- | --------------------- | | playerid | 要禁用检查点的玩家 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DisablePlayerRaceCheckpoint.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DisablePlayerRaceCheckpoint.md index ac5576526a7..357239bceed 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DisablePlayerRaceCheckpoint.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DisablePlayerRaceCheckpoint.md @@ -9,13 +9,13 @@ tags: ["玩家", "检查点", "竞速检查点"] 禁用指定玩家已初始化的所有竞速检查点，因为同一时间只能存在一个。 -| 名称 | 描述 | +| 参数 | 说明 | | -------- | ------------------------- | | playerid | 要禁用竞速检查点的玩家 ID | ## 返回值 -该函数不返回特定值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DisableRemoteVehicleCollisions.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DisableRemoteVehicleCollisions.md index f429ee4f866..0b6f89f1ff4 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DisableRemoteVehicleCollisions.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/DisableRemoteVehicleCollisions.md @@ -11,7 +11,7 @@ tags: ["车辆"] 禁用玩家已占用车辆之间的碰撞检测。 -| 名称 | 描述 | +| 参数 | 说明 | | ------------ | ------------------------------ | | playerid | 要设置碰撞状态的玩家 ID | | bool:disable | true 禁用碰撞 / false 启用碰撞 | @@ -33,7 +33,7 @@ public OnPlayerCommandText(playerid, cmdtext[]) { new string[64]; - format(string, sizeof(string), "您的车辆碰撞状态已设置为「%s」", (gPlayerVehicleCollision[playerid] == false) ? ("禁用") : ("启用")); + format(string, sizeof(string), "你的车辆碰撞状态已设置为「%s」", (gPlayerVehicleCollision[playerid] == false) ? ("禁用") : ("启用")); SendClientMessage(playerid, 0xFFFFFFFF, string); gPlayerVehicleCollision[playerid] = !gPlayerVehicleCollision[playerid]; diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/EditAttachedObject.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/EditAttachedObject.md index 0ef8e105b12..315f850197b 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/EditAttachedObject.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/EditAttachedObject.md @@ -9,7 +9,7 @@ tags: ["玩家", "物体", "附加"] 进入附加物体的编辑模式。 -| 名称 | 描述 | +| 参数 | 说明 | | -------- | ---------------------------- | | playerid | 要进入编辑模式的玩家 ID | | index | 要编辑的附加物体索引（槽位） | @@ -33,7 +33,7 @@ public OnPlayerCommandText(playerid, cmdtext[]) if (!strcmp(cmdtext, "/edit", true)) { EditAttachedObject(playerid, 0); - SendClientMessage(playerid, 0xFFFFFFFF, "服务器：您正在编辑槽位0的附加物体！"); + SendClientMessage(playerid, 0xFFFFFFFF, "服务器：你正在编辑槽位0的附加物体！"); return 1; } return 0; diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/EditObject.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/EditObject.md index 446ba02333a..4b46800d711 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/EditObject.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/EditObject.md @@ -9,7 +9,7 @@ tags: [] 允许玩家通过图形用户界面（GUI）使用鼠标编辑物体的位置和旋转。 -| 名称 | 描述 | +| 参数 | 说明 | | -------- | --------------------- | | playerid | 执行编辑操作的玩家 ID | | objectid | 待编辑的物体 ID | @@ -35,7 +35,7 @@ public OnPlayerCommandText(playerid, cmdtext[]) if (!strcmp(cmdtext, "/oedit", true)) { EditObject(playerid, object); - SendClientMessage(playerid, 0xFFFFFFFF, "服务器：您现在可以编辑该物体！"); + SendClientMessage(playerid, 0xFFFFFFFF, "服务器：你现在可以编辑该物体！"); return 1; } return 0; diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/EditPlayerClass.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/EditPlayerClass.md index 6200dd8ce58..d4a042df61e 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/EditPlayerClass.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/EditPlayerClass.md @@ -11,7 +11,7 @@ tags: ["职业"] 编辑已定义的玩家职业数据。 -| 名称 | 描述 | +| 参数 | 说明 | | -------------- | -------------------------------------- | | classid | 要编辑的职业 ID | | team | 玩家生成时所属队伍 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/EditPlayerObject.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/EditPlayerObject.md index 310a5efc24d..b75f690bd51 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/EditPlayerObject.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/EditPlayerObject.md @@ -9,7 +9,7 @@ tags: ["玩家"] 允许玩家通过图形用户界面（GUI）使用鼠标编辑其专属物体的位置和旋转。 -| 名称 | 描述 | +| 参数 | 说明 | | -------- | ----------------------- | | playerid | 执行编辑操作的玩家 ID | | objectid | 待编辑的玩家专属物体 ID | @@ -34,7 +34,7 @@ public OnPlayerCommandText(playerid, cmdtext[]) if (!strcmp(cmdtext, "/edit", true)) { EditPlayerObject(playerid, object[playerid]); - SendClientMessage(playerid, 0xFFFFFFFF, "服务器：您现在可以编辑您的专属物体！"); + SendClientMessage(playerid, 0xFFFFFFFF, "服务器：你现在可以编辑你的专属物体！"); return 1; } return 0; diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/EnableAllAnimations.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/EnableAllAnimations.md index 8ad4c1dc89b..ae6e316977e 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/EnableAllAnimations.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/EnableAllAnimations.md @@ -11,13 +11,13 @@ tags: ["动画"] 启用部分版本中缺失的动画资源。 -| 名称 | 描述 | +| 参数 | 说明 | | ----------- | -------------------------------------- | | bool:enable | true 启用缺失动画 / false 禁用缺失动画 | ## 返回值 -该函数不返回特定值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/EnablePlayerCameraTarget.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/EnablePlayerCameraTarget.md index 7d77c519d71..26465581d67 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/EnablePlayerCameraTarget.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/EnablePlayerCameraTarget.md @@ -9,12 +9,12 @@ tags: ["玩家"] ## 描述 -切换玩家的视角目标检测功能。该功能默认禁用以节省网络带宽。 +切换玩家的视角目标检测功能。此函数默认禁用以节省网络带宽。 -| 名称 | 描述 | -| ----------- | ----------------------------- | +| 参数 | 说明 | +| ----------- | --------------------------- | | playerid | 要设置视角目标功能的玩家 ID | -| bool:enable | true 启用 / false 禁用 | +| bool:enable | true 启用 / false 禁用 | ## 返回值 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/EnableStuntBonusForAll.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/EnableStuntBonusForAll.md index 65990937164..c395636c9cb 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/EnableStuntBonusForAll.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/EnableStuntBonusForAll.md @@ -9,13 +9,13 @@ tags: [] 为所有玩家启用或禁用车辆特技奖励。启用时，玩家执行车辆特技（例如翘轮动作）将获得金钱奖励。 -| 名称 | 描述 | +| 参数 | 说明 | | ----------- | -------------------------------------- | | bool:enable | true 启用特技奖励 / false 禁用特技奖励 | ## 返回值 -该函数不返回特定值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/EnableStuntBonusForPlayer.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/EnableStuntBonusForPlayer.md index 706d3bebcb7..7688ac87714 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/EnableStuntBonusForPlayer.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/EnableStuntBonusForPlayer.md @@ -9,7 +9,7 @@ tags: ["玩家"] 切换指定玩家的车辆特技奖励（默认启用）。 -| 名称 | 描述 | +| 参数 | 说明 | | ----------- | ----------------------- | | playerid | 要设置特技奖励的玩家 ID | | bool:enable | true 启用 / false 禁用 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/EnableTirePopping.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/EnableTirePopping.md index d38282fa7b0..a39bf94c803 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/EnableTirePopping.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/EnableTirePopping.md @@ -9,13 +9,13 @@ tags: [] 通过此函数可以启用或禁用车辆轮胎爆胎机制。 -| 名称 | 描述 | +| 参数 | 说明 | | ----------- | -------------------------------------- | | bool:enable | true 启用轮胎爆胎 / false 禁用轮胎爆胎 | ## 返回值 -该函数不返回特定值。 +此函数不返回特定值。 ## 示例 @@ -32,9 +32,9 @@ public OnGameModeInit() :::warning -- 该函数已在 SA-MP 0.3 版本移除 +- 此函数已在 SA-MP 0.3 版本移除 - 轮胎爆胎机制默认启用 -- 若需禁用该功能，需通过 [OnVehicleDamageStatusUpdate](../callbacks/OnVehicleDamageStatusUpdate) 回调手动实现 +- 若需禁用此函数，需通过 [OnVehicleDamageStatusUpdate](../callbacks/OnVehicleDamageStatusUpdate) 回调手动实现 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/EnableVehicleFriendlyFire.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/EnableVehicleFriendlyFire.md index aa4b2f8e7dd..c89940f4b05 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/EnableVehicleFriendlyFire.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/EnableVehicleFriendlyFire.md @@ -11,7 +11,7 @@ tags: ["车辆"] ## 返回值 -该函数不返回特定值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/EnableZoneNames.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/EnableZoneNames.md index c4de762f4d8..6f03e207ca1 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/EnableZoneNames.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/EnableZoneNames.md @@ -2,20 +2,20 @@ title: EnableZoneNames sidebar_label: EnableZoneNames description: 启用或禁用进入区域时屏幕右下角显示的区域名称（例如"Vinewood"或"Doherty"）。 -tags: ["游戏界面"] +tags: [] --- ## 描述 此函数用于控制玩家进入新区域时是否在屏幕右下角显示区域名称（例如"Vinewood"或"Doherty"）。此设置属于游戏模式选项，应在 [OnGameModeInit](../callbacks/OnGameModeInit) 回调中设置。 -| 名称 | 描述 | +| 参数 | 说明 | | ----------- | -------------------------------------- | | bool:enable | true 启用区域名称显示 / false 禁用显示 | ## 返回值 -该函数不返回特定值。 +此函数不返回特定值。 ## 示例 @@ -31,7 +31,7 @@ public OnGameModeInit() :::warning -该函数已在 SA-MP 0.3 版本移除（因其导致的崩溃问题） +此函数已在 SA-MP 0.3 版本移除（因其导致的崩溃问题） ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/EndObjectEditing.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/EndObjectEditing.md index e14891761e5..5926860ccf3 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/EndObjectEditing.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/EndObjectEditing.md @@ -11,13 +11,13 @@ tags: ["物体"] 强制终止指定玩家的物体编辑状态。 -| 名称 | 描述 | +| 参数 | 说明 | | -------- | ------------------- | | playerid | 要终止编辑的玩家 ID | ## 返回值 -该函数不返回特定值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/FindModelFileNameFromCRC.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/FindModelFileNameFromCRC.md index 13b2446c89c..9e431761ce2 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/FindModelFileNameFromCRC.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/FindModelFileNameFromCRC.md @@ -11,7 +11,7 @@ tags: ["自定义模型", "自定义皮肤", "简单模型"] 根据 CRC 校验和查找已存在的自定义皮肤或简单物体模型文件。模型文件默认存储在服务器的 models 目录下（通过 artpath 配置指定）。 -| 名称 | 描述 | +| 参数 | 说明 | | ---------------------- | ------------------------------------------- | | crc | 自定义模型文件的 CRC 校验和 | | output[] | 用于存储.dff 文件名的数组（通过引用传递） | @@ -25,4 +25,4 @@ tags: ["自定义模型", "自定义皮肤", "简单模型"] ## 相关函数 -- [OnPlayerFinishedDownloading](../callbacks/OnPlayerFinishedDownloading): 当玩家完成自定义模型下载时触发该回调 +- [OnPlayerFinishedDownloading](../callbacks/OnPlayerFinishedDownloading): 当玩家完成自定义模型下载时触发此回调 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/FindTextureFileNameFromCRC.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/FindTextureFileNameFromCRC.md index bcbeba1eb76..75b852721ad 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/FindTextureFileNameFromCRC.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/FindTextureFileNameFromCRC.md @@ -11,7 +11,7 @@ tags: ["自定义模型", "自定义皮肤", "简单模型"] 根据 CRC 校验和查找已存在的自定义皮肤或简单物体纹理文件。模型文件默认存储在服务器的 models 目录下（通过 artpath 配置指定）。 -| 名称 | 描述 | +| 参数 | 说明 | | ---------------------- | ------------------------------------------- | | crc | 自定义模型文件的 CRC 校验和 | | output[] | 用于存储.txd 文件名的数组（通过引用传递） | @@ -25,4 +25,4 @@ tags: ["自定义模型", "自定义皮肤", "简单模型"] ## 相关函数 -- [OnPlayerFinishedDownloading](../callbacks/OnPlayerFinishedDownloading): 当玩家完成自定义模型下载时触发该回调 +- [OnPlayerFinishedDownloading](../callbacks/OnPlayerFinishedDownloading): 当玩家完成自定义模型下载时触发此回调 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ForceClassSelection.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ForceClassSelection.md index 7fdb9c5ef13..e23a96bb995 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ForceClassSelection.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ForceClassSelection.md @@ -2,14 +2,14 @@ title: ForceClassSelection sidebar_label: ForceClassSelection description: 强制玩家返回职业选择界面。 -tags: ["职业系统"] +tags: ["职业"] --- ## 描述 -该函数强制指定玩家返回职业选择界面。 +此函数强制指定玩家返回职业选择界面。 -| 参数名 | 描述 | +| 参数 | 说明 | | -------- | ----------------- | | playerid | 需要操作的玩家 ID | @@ -37,7 +37,7 @@ public OnPlayerCommandText(playerid, cmdtext[]) :::warning -当结合使用 TogglePlayerSpectating 函数时（如上例所示），本函数不会将玩家状态切换为 PLAYER_STATE_WASTED（濒死状态）。 +当结合使用 TogglePlayerSpectating 函数时（如上例所示），此函数不会将玩家状态切换为 PLAYER_STATE_WASTED（濒死状态）。 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GameTextForAll.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GameTextForAll.md index d8227413cf1..58db4fc48d8 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GameTextForAll.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GameTextForAll.md @@ -9,7 +9,7 @@ tags: ["游戏文本"] 为所有玩家显示指定持续时间的'游戏文本'（屏幕文本）。 -| 参数名 | 说明 | +| 参数 | 说明 | | ---------------- | --------------------------------------------- | | const format[] | 要显示的文本内容 | | time | 文本显示持续时间（以毫秒为单位） | @@ -18,7 +18,7 @@ tags: ["游戏文本"] ## 返回值 -该函数总是返回 1。 +此函数总是返回 1。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GameTextForPlayer.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GameTextForPlayer.md index 83e7ce87047..24ae1041947 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GameTextForPlayer.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GameTextForPlayer.md @@ -9,7 +9,7 @@ tags: ["玩家", "游戏文本"] 为指定玩家显示持续特定时间的'游戏文本'（屏幕文本）。 -| 参数名 | 说明 | +| 参数 | 说明 | | ---------------- | --------------------------------------------- | | playerid | 目标玩家的 ID | | const format[] | 要显示的文本内容 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GangZoneCreate.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GangZoneCreate.md index 5ce430eeb7e..e97c3bf312a 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GangZoneCreate.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GangZoneCreate.md @@ -9,7 +9,7 @@ tags: ["帮派区域"] 创建帮派区域（彩色雷达区域）。 -| 参数名 | 说明 | +| 参数 | 说明 | | ---------- | ------------------------- | | Float:minX | 帮派区域西侧边界的 X 坐标 | | Float:minY | 帮派区域南侧边界的 Y 坐标 | @@ -56,7 +56,7 @@ public OnGameModeInit() :::tip -本函数仅创建帮派区域，需使用[GangZoneShowForPlayer](GangZoneShowForPlayer)或[GangZoneShowForAll](GangZoneShowForAll)进行显示 +此函数仅创建帮派区域，需使用[GangZoneShowForPlayer](GangZoneShowForPlayer)或[GangZoneShowForAll](GangZoneShowForAll)进行显示 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GangZoneDestroy.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GangZoneDestroy.md index d883582f7bd..dda3398f65b 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GangZoneDestroy.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GangZoneDestroy.md @@ -9,7 +9,7 @@ tags: ["帮派区域"] 销毁帮派区域。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------ | --------------- | | zoneid | 要销毁的区域 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GangZoneFlashForAll.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GangZoneFlashForAll.md index 2102d527f34..b4bb03bc268 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GangZoneFlashForAll.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GangZoneFlashForAll.md @@ -9,14 +9,14 @@ tags: ["帮派区域"] 为所有玩家闪烁显示帮派区域。 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------- | ------------------------------------------------------- | | zoneid | 要闪烁的区域 ID | | flashColour | 闪烁颜色（RGBA 格式的整型或十六进制值，支持透明度通道） | ## 返回值 -该函数没有返回值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GangZoneFlashForPlayer.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GangZoneFlashForPlayer.md index 8770469c308..28f696610f6 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GangZoneFlashForPlayer.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GangZoneFlashForPlayer.md @@ -9,7 +9,7 @@ tags: ["玩家", "帮派区域"] 使指定玩家的帮派区域闪烁显示。 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------- | ------------------------------------------------------- | | playerid | 目标玩家 ID | | zoneid | 要闪烁的区域 ID | @@ -17,7 +17,7 @@ tags: ["玩家", "帮派区域"] ## 返回值 -该函数没有返回值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GangZoneGetColourForPlayer.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GangZoneGetColourForPlayer.md index eafbdeb026a..4f38afc977b 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GangZoneGetColourForPlayer.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GangZoneGetColourForPlayer.md @@ -11,7 +11,7 @@ tags: ["玩家", "帮派区域"] 获取指定玩家帮派区域的当前颜色。 -| 参数名 | 说明 | +| 参数 | 说明 | | -------- | ----------- | | playerid | 目标玩家 ID | | zoneid | 帮派区域 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GangZoneGetFlashColourForPlayer.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GangZoneGetFlashColourForPlayer.md index c106545a221..d8dadb221c2 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GangZoneGetFlashColourForPlayer.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GangZoneGetFlashColourForPlayer.md @@ -11,7 +11,7 @@ tags: ["玩家", "帮派区域"] 获取指定玩家帮派区域的当前闪烁颜色。 -| 参数名 | 说明 | +| 参数 | 说明 | | -------- | ----------- | | playerid | 目标玩家 ID | | zoneid | 帮派区域 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GangZoneGetPos.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GangZoneGetPos.md index 77e39d23521..fdf2be47ad2 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GangZoneGetPos.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GangZoneGetPos.md @@ -11,7 +11,7 @@ tags: ["玩家", "帮派区域"] 获取帮派区域的坐标位置，包括最小 X、最小 Y、最大 X、最大 Y 坐标。 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------- | ------------------------------------------------------- | | zoneid | 需要获取坐标的帮派区域 ID | | &Float:minX | 用于存储帮派区域西侧边界 X 坐标的浮点变量（按引用传递） | @@ -21,7 +21,7 @@ tags: ["玩家", "帮派区域"] ## 返回值 -该函数总是返回 **true**。 +此函数总是返回 **true**。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GangZoneHideForAll.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GangZoneHideForAll.md index 5709d249a43..7157c728438 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GangZoneHideForAll.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GangZoneHideForAll.md @@ -9,13 +9,13 @@ tags: ["帮派区域"] 为所有玩家隐藏指定的帮派区域。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------ | --------------- | | zoneid | 要隐藏的区域 ID | ## 返回值 -该函数没有返回值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GangZoneHideForPlayer.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GangZoneHideForPlayer.md index e25fe7769f6..4b2a1b9511d 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GangZoneHideForPlayer.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GangZoneHideForPlayer.md @@ -9,14 +9,14 @@ tags: ["玩家", "帮派区域"] 为指定玩家隐藏帮派区域。 -| 参数名 | 说明 | +| 参数 | 说明 | | -------- | --------------- | | playerid | 目标玩家 ID | | zoneid | 要隐藏的区域 ID | ## 返回值 -该函数没有返回值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GangZoneShowForAll.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GangZoneShowForAll.md index d114aa6ec91..9c237bdae00 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GangZoneShowForAll.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GangZoneShowForAll.md @@ -9,7 +9,7 @@ tags: ["帮派区域"] 为所有玩家显示指定颜色的帮派区域。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------ | ----------------------------------------------------------------- | | zoneid | 要显示的帮派区域 ID（由[GangZoneCreate](GangZoneCreate)创建返回） | | colour | 显示颜色（RGBA 格式的整型或十六进制值，支持透明度通道） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GangZoneShowForPlayer.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GangZoneShowForPlayer.md index 81d675c8be4..5ff0133d862 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GangZoneShowForPlayer.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GangZoneShowForPlayer.md @@ -9,7 +9,7 @@ tags: ["玩家", "帮派区域"] 为指定玩家显示帮派区域。需预先使用[GangZoneCreate](GangZoneCreate)创建。 -| 参数名 | 说明 | +| 参数 | 说明 | | -------- | ----------------------------------------------------------------- | | playerid | 目标玩家 ID | | zoneid | 要显示的帮派区域 ID（由[GangZoneCreate](GangZoneCreate)创建返回） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GangZoneStopFlashForAll.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GangZoneStopFlashForAll.md index df7e100b47c..6d264f56e4b 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GangZoneStopFlashForAll.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GangZoneStopFlashForAll.md @@ -9,7 +9,7 @@ tags: ["帮派区域"] 停止指定帮派区域对所有玩家的闪烁效果。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------ | ------------------------------------------------- | | zoneid | 要停止闪烁的区域 ID（由 GangZoneCreate 创建返回） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GangZoneStopFlashForPlayer.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GangZoneStopFlashForPlayer.md index 6189e1c7d69..e981612bf18 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GangZoneStopFlashForPlayer.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GangZoneStopFlashForPlayer.md @@ -9,14 +9,14 @@ tags: ["玩家", "帮派区域"] 停止对指定玩家的帮派区域闪烁效果。 -| 参数名 | 说明 | +| 参数 | 说明 | | -------- | ----------------------- | | playerid | 目标玩家 ID | | zoneid | 要停止闪烁的帮派区域 ID | ## 返回值 -该函数没有返回值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Get3DTextLabelAttachedData.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Get3DTextLabelAttachedData.md index b404077b542..7f03cc3f419 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Get3DTextLabelAttachedData.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Get3DTextLabelAttachedData.md @@ -11,7 +11,7 @@ tags: ["3D文本标签"] 获取 3D 文本标签的附加数据。 -| 参数名 | 说明 | +| 参数 | 说明 | | ---------------- | ---------------------------------------- | | Text3D:textid | 要获取附加数据的 3D 文本标签 ID | | &parentPlayerid | 用于存储父级玩家 ID 的变量（按引用传递） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Get3DTextLabelColor.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Get3DTextLabelColor.md index bac1c72a48c..e5b5a186794 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Get3DTextLabelColor.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Get3DTextLabelColor.md @@ -7,7 +7,7 @@ tags: ["3D文本标签"] :::warning -该函数已弃用，请使用[Get3DTextLabelColour](Get3DTextLabelColour)。 +此函数已弃用，请使用[Get3DTextLabelColour](Get3DTextLabelColour)。 ::: @@ -15,7 +15,7 @@ tags: ["3D文本标签"] 获取 3D 文本标签的颜色值。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------- | --------------------------- | | Text3D:textid | 要获取颜色的 3D 文本标签 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Get3DTextLabelColour.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Get3DTextLabelColour.md index bee5c02272f..0e7ebfc7f9f 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Get3DTextLabelColour.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Get3DTextLabelColour.md @@ -11,7 +11,7 @@ tags: ["3D文本标签"] 获取 3D 文本标签的颜色值。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------- | --------------------------- | | Text3D:textid | 要获取颜色的 3D 文本标签 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Get3DTextLabelDrawDistance.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Get3DTextLabelDrawDistance.md index 3dbc8244954..689679a3db7 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Get3DTextLabelDrawDistance.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Get3DTextLabelDrawDistance.md @@ -11,7 +11,7 @@ tags: ["3D文本标签"] 获取 3D 文本标签的可见绘制距离。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------- | ------------------------------- | | Text3D:textid | 要获取绘制距离的 3D 文本标签 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Get3DTextLabelLOS.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Get3DTextLabelLOS.md index 56f5cc802e5..78913396ac7 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Get3DTextLabelLOS.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Get3DTextLabelLOS.md @@ -11,7 +11,7 @@ tags: ["3D文本标签"] 获取 3D 文本标签的视线检测设置（是否在物体遮挡时隐藏）。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------- | ----------------------------------- | | Text3D:textid | 要获取视线检测设置的 3D 文本标签 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Get3DTextLabelPos.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Get3DTextLabelPos.md index 637f6e54953..99ba1d26886 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Get3DTextLabelPos.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Get3DTextLabelPos.md @@ -11,7 +11,7 @@ tags: ["3D文本标签"] 获取 3D 文本标签的当前位置坐标。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------- | --------------------------------------- | | Text3D:textid | 要获取位置的 3D 文本标签 ID | | &Float:x | 用于存储 X 坐标的浮点变量（按引用传递） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Get3DTextLabelText.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Get3DTextLabelText.md index 877bd74b643..b2ddaa45923 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Get3DTextLabelText.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Get3DTextLabelText.md @@ -11,7 +11,7 @@ tags: ["3D文本标签"] 获取 3D 文本标签的显示文字内容。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------- | -------------------------------------------------- | | Text3D:textid | 要获取文字的 3D 文本标签 ID | | const text[] | 用于存储文字的字符数组（按引用传递） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Get3DTextLabelVirtualWorld.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Get3DTextLabelVirtualWorld.md index 499d6c31023..24a8da51073 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Get3DTextLabelVirtualWorld.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Get3DTextLabelVirtualWorld.md @@ -11,7 +11,7 @@ tags: ["3D文本标签"] 获取 3D 文本标签所属的虚拟世界 ID。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------- | ----------------------------------- | | Text3D:textid | 要获取虚拟世界 ID 的 3D 文本标签 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetActorAnimation.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetActorAnimation.md index 513e3c9048d..a2b74ab20a4 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetActorAnimation.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetActorAnimation.md @@ -11,7 +11,7 @@ tags: ["角色"] 获取角色当前正在播放的动画信息。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------------ | ------------------------------------------- | | actorid | 要获取动画的角色 ID | | animationLibrary[] | 用于存储动画库名称的数组（引用传递） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetActorFacingAngle.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetActorFacingAngle.md index d873117b289..3f9f50162bb 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetActorFacingAngle.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetActorFacingAngle.md @@ -11,7 +11,7 @@ tags: ["角色"] 获取角色的朝向角度。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------ | --------------------------------------------------------------- | | actorid | 要获取朝向角度的角色 ID（由[CreateActor](CreateActor)创建返回） | | &Float:angle | 浮点变量（引用传递），用于存储角色的朝向角度 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetActorHealth.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetActorHealth.md index 78e3cf1e147..effd0b415e0 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetActorHealth.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetActorHealth.md @@ -11,7 +11,7 @@ tags: ["角色"] 获取角色的生命值。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------- | ------------------------------------------ | | actorid | 要获取生命值的角色 ID | | &Float:health | 浮点变量（引用传递），用于存储角色的生命值 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetActorPoolSize.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetActorPoolSize.md index ac0db943006..0a272796b39 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetActorPoolSize.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetActorPoolSize.md @@ -9,7 +9,7 @@ tags: ["角色"] ## 描述 -获取服务器上已创建的最高角色 ID。注意在 SA-MP 中该函数存在缺陷，即使没有角色时也会返回`0`。open.mp 已修正此问题会返回`-1`，同时已弃用该函数，建议改用`MAX_ACTORS`或`foreach`循环。 +获取服务器上已创建的最高角色 ID。注意在 SA-MP 中此函数存在缺陷，即使没有角色时也会返回`0`。open.mp 已修正此问题会返回`-1`，同时已弃用此函数，建议改用`MAX_ACTORS`或`foreach`循环。 ## 示例代码 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetActorPos.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetActorPos.md index 31d6243dd20..e641a50b46b 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetActorPos.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetActorPos.md @@ -11,7 +11,7 @@ tags: ["角色"] 获取角色的坐标位置。 -| 参数名 | 说明 | +| 参数 | 说明 | | -------- | ----------------------------------------------------------- | | actorid | 要获取坐标的角色 ID（由[CreateActor](CreateActor)创建返回） | | &Float:x | 浮点变量（引用传递），用于存储角色的 X 轴坐标 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetActorSkin.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetActorSkin.md index 6fd84932d84..a518c6728c1 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetActorSkin.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetActorSkin.md @@ -11,7 +11,7 @@ tags: ["角色"] 获取角色当前使用的皮肤 ID。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------- | ------------------- | | actorid | 要获取皮肤的角色 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetActorSpawnInfo.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetActorSpawnInfo.md index fda7c091a94..9a043e94811 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetActorSpawnInfo.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetActorSpawnInfo.md @@ -11,7 +11,7 @@ tags: ["角色"] 获取角色的初始生成点信息。 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------------- | -------------------------------------------- | | actorid | 要获取生成信息的角色 ID | | &skin | 整型变量（引用传递），用于存储角色皮肤 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetActors.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetActors.md index 2ccb2f133a3..cbb5d8b1cdc 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetActors.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetActors.md @@ -11,7 +11,7 @@ tags: ["角色"] 获取服务器上已创建的角色 ID 数组。 -| 参数名 | 说明 | +| 参数 | 说明 | | -------- | ------------------------------------- | | actors[] | 数组变量（引用传递），用于存储角色 ID | | size | 数组的容量长度 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetAnimationName.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetAnimationName.md index 9b733e275bd..db7e094de36 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetAnimationName.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetAnimationName.md @@ -9,7 +9,7 @@ tags: [] 根据动画索引获取对应的动画库名称和动画名称。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------------ | ------------------------------------------- | | index | 动画索引（由 GetPlayerAnimationIndex 返回） | | animationLibrary[] | 字符串变量，用于存储动画库名称 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetConsoleVarAsBool.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetConsoleVarAsBool.md index 5739f59961f..9995032ccd0 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetConsoleVarAsBool.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetConsoleVarAsBool.md @@ -9,7 +9,7 @@ tags: [] 获取控制台变量的布尔类型值。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------ | ------------------------------ | | const cvar[] | 要获取的布尔类型控制台变量名称 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetConsoleVarAsFloat.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetConsoleVarAsFloat.md index 65a0a20108f..100da066cb7 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetConsoleVarAsFloat.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetConsoleVarAsFloat.md @@ -9,7 +9,7 @@ tags: [] 获取控制台变量的浮点类型值。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------ | ------------------------------ | | const cvar[] | 要获取的浮点类型控制台变量名称 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetConsoleVarAsInt.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetConsoleVarAsInt.md index ec9fced6a48..de88e85aed3 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetConsoleVarAsInt.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetConsoleVarAsInt.md @@ -9,7 +9,7 @@ tags: [] 获取控制台变量的整数类型值。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------ | -------------------------- | | const cvar[] | 要获取的整型控制台变量名称 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetConsoleVarAsString.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetConsoleVarAsString.md index 86119bb1a3b..4c8e8044526 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetConsoleVarAsString.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetConsoleVarAsString.md @@ -9,7 +9,7 @@ tags: [] 获取控制台变量的字符串类型值。 -| 参数名 | 说明 | +| 参数 | 说明 | | --------------- | -------------------------------- | | const cvar[] | 要获取的字符串类型控制台变量名称 | | buffer[] | 存储值的数组变量（引用传递） | @@ -34,7 +34,7 @@ public OnGameModeInit() :::tip -当变量名为"filterscripts"或"plugins"时，本函数仅返回第一个滤镜脚本/插件的名称。 +当变量名为"filterscripts"或"plugins"时，此函数仅返回第一个滤镜脚本/插件的名称。 ::: @@ -46,8 +46,8 @@ public OnGameModeInit() :::warning -- 在旧版本中，对非字符串类型变量（整型/布尔型/浮点型）使用本函数会导致服务器崩溃（open.mp 已修复） -- 在旧版本中，对不存在的变量使用本函数会导致服务器崩溃（open.mp 已修复） +- 在旧版本中，对非字符串类型变量（整型/布尔型/浮点型）使用此函数会导致服务器崩溃（open.mp 已修复） +- 在旧版本中，对不存在的变量使用此函数会导致服务器崩溃（open.mp 已修复） ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetCustomModelPath.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetCustomModelPath.md index a521404c7a4..0aead3168cc 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetCustomModelPath.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetCustomModelPath.md @@ -11,7 +11,7 @@ tags: ["自定义模型", "自定义皮肤", "简单模型"] 获取指定自定义模型的资源文件路径信息。 -| 参数名 | 说明 | +| 参数 | 说明 | | --------- | ------------------------------------------- | | modelid | 要查询的自定义模型 ID | | dffPath[] | 数组变量（引用传递），用于存储 DFF 文件路径 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetGameText.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetGameText.md index 963c685bbfe..4700e0bba18 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetGameText.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetGameText.md @@ -11,7 +11,7 @@ tags: ["玩家"] 获取指定玩家游戏文本样式的所有相关信息。 -| 参数名 | 说明 | +| 参数 | 说明 | | --------------- | --------------------------------------------------- | | playerid | 要获取信息的玩家 ID | | style | 要查询的[游戏文本样式](../resources/gametextstyles) | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetGravity.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetGravity.md index 76d9681e88c..09716cf988a 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetGravity.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetGravity.md @@ -43,7 +43,7 @@ public OnGameModeInit() :::warning -在 SA-MP 服务器中，该函数默认未定义。需在包含 a_samp.inc 后添加 'native Float:GetGravity();' 声明方可使用。 +在 SA-MP 服务器中，此函数默认未定义。需在包含 a_samp.inc 后添加 'native Float:GetGravity();' 声明方可使用。 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetMaxPlayers.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetMaxPlayers.md index e61ba70fd8e..c64f81f21f6 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetMaxPlayers.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetMaxPlayers.md @@ -21,7 +21,7 @@ SendClientMessage(playerid, 0xFFFFFFFF, string); // 向玩家发送服务器最 :::warning -- 本函数不能替代 MAX_PLAYERS 宏定义 +- 此函数不能替代 MAX_PLAYERS 宏定义 - 不可用于编译时数组大小定义 - 应始终将 MAX_PLAYERS 宏定义为与 max_players 配置相同或更大的值 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetMenuColumnHeader.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetMenuColumnHeader.md index f64494bcdf3..95690eb6403 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetMenuColumnHeader.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetMenuColumnHeader.md @@ -11,7 +11,7 @@ tags: ["菜单"] 获取指定列标题中的文本内容。 -| 参数名 | 说明 | +| 参数 | 说明 | | --------------------- | ---------------------------------- | | Menu:menuid | 要查询的菜单 ID | | column | 列索引（从 0 开始计数） | @@ -20,7 +20,7 @@ tags: ["菜单"] ## 返回值 -本函数始终返回 **true**。 +此函数始终返回 **true**。 ## 示例代码 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetMenuColumnWidth.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetMenuColumnWidth.md index 20d2f3f75c4..eb4ac607ac1 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetMenuColumnWidth.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetMenuColumnWidth.md @@ -11,7 +11,7 @@ tags: ["菜单"] 获取菜单中一列或两列的宽度。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------------- | ---------------------------------------------------- | | Menu:menuid | 要获取列宽的菜单 ID | | &Float:column1Width | 浮点变量（引用传递），用于存储第一列宽度 | @@ -19,7 +19,7 @@ tags: ["菜单"] ## 返回值 -本函数始终返回 **true**。 +此函数始终返回 **true**。 ## 示例代码 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetMenuColumns.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetMenuColumns.md index 2fa92ab6e45..f9707d5cd05 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetMenuColumns.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetMenuColumns.md @@ -11,7 +11,7 @@ tags: ["菜单"] 获取菜单中当前激活的列数。 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------- | ------------------- | | Menu:menuid | 要获取列数的菜单 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetMenuItem.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetMenuItem.md index 30741578629..8d343a91a3b 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetMenuItem.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetMenuItem.md @@ -11,7 +11,7 @@ tags: ["菜单"] 通过列和行索引获取指定单元格中的文本内容。 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------- | ---------------------------------- | | Menu:menuid | 要查询的菜单 ID | | column | 列索引（从 0 开始计数） | @@ -21,7 +21,7 @@ tags: ["菜单"] ## 返回值 -本函数始终返回 true。 +此函数始终返回 true。 ## 示例代码 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetMenuItems.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetMenuItems.md index ea56093ad57..b3bbc6ed3ba 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetMenuItems.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetMenuItems.md @@ -11,7 +11,7 @@ tags: ["菜单"] 获取指定列中的行数。 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------- | ----------------------- | | Menu:menuid | 要查询的菜单 ID | | column | 列索引（从 0 开始计数） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetMenuPos.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetMenuPos.md index 9a90289570e..1ab50b38f90 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetMenuPos.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetMenuPos.md @@ -11,7 +11,7 @@ tags: ["菜单"] 获取菜单在屏幕上的 X/Y 坐标位置。 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------- | --------------------------------------- | | Menu:menuid | 要获取位置的菜单 ID | | &Float:x | 浮点变量（引用传递），用于存储 X 轴坐标 | @@ -19,7 +19,7 @@ tags: ["菜单"] ## 返回值 -本函数始终返回 true。 +此函数始终返回 true。 ## 示例代码 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetMyFacingAngle.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetMyFacingAngle.md index d53a9ce7941..22a71f7ef3f 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetMyFacingAngle.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetMyFacingAngle.md @@ -5,11 +5,17 @@ description: 获取NPC当前的面朝角度 tags: [] --- +:::warning + +此函数已弃用，请使用 [NPC_GetFacingAngle](NPC_GetFacingAngle)。 + +::: + ## 描述 获取 NPC 当前的面朝角度。 -| 名称 | 描述 | +| 参数 | 说明 | | ------------ | ---------------------------------------- | | &Float:Angle | 用于存储角度的浮点数变量，通过引用传递。 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetMyPos.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetMyPos.md index 211e06fea5c..ad7fbdbb83b 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetMyPos.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetMyPos.md @@ -5,11 +5,17 @@ description: 获取NPC的当前位置 tags: ["npc"] --- +:::warning + +此函数已弃用，请使用 [NPC_GetPos](NPC_GetPos)。 + +::: + ## 描述 获取 NPC 的当前位置。 -| 名称 | 描述 | +| 参数 | 说明 | | -------- | ------------------------------------------- | | &Float:x | 用于存储 X 坐标的浮点数变量，通过引用传递。 | | &Float:y | 用于存储 Y 坐标的浮点数变量，通过引用传递。 | @@ -17,7 +23,7 @@ tags: ["npc"] ## 返回值 -本函数不返回特定值。 +此函数不返回特定值。 ## 示例代码 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetNetworkStats.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetNetworkStats.md index c44a3f7ec68..ad5660f8761 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetNetworkStats.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetNetworkStats.md @@ -9,14 +9,14 @@ tags: [] 获取服务器的网络统计数据并存储到字符串中。 -| 名称 | 描述 | +| 参数 | 说明 | | ---------------------- | -------------------------------------------- | | output[] | 用于存储网络统计数据的字符串，通过引用传递。 | | size = sizeof (output) | 待存储字符串的长度 | ## 返回值 -本函数固定返回 1。 +此函数固定返回 1。 ## 示例代码 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetObjectAttachedData.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetObjectAttachedData.md index 112678f705e..3d815a1bd07 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetObjectAttachedData.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetObjectAttachedData.md @@ -11,7 +11,7 @@ tags: ["物体"] 获取物体的附加数据。 -| 名称 | 描述 | +| 参数 | 说明 | | -------------- | ------------------------------------ | | objectid | 需要获取附加数据的物体 ID | | &parentVehicle | 存储父车辆 ID 的变量，通过引用传递。 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetObjectAttachedOffset.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetObjectAttachedOffset.md index d3a136c1da8..5433ac6e8aa 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetObjectAttachedOffset.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetObjectAttachedOffset.md @@ -11,7 +11,7 @@ tags: ["物体"] 获取物体的附加偏移和旋转参数。 -| 名称 | 描述 | +| 参数 | 说明 | | ---------------- | ----------------------------------------------- | | objectid | 需要获取偏移和旋转参数的物体 ID | | &Float:offsetX | 用于存储 X 轴偏移坐标的浮点变量，通过引用传递。 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetObjectDrawDistance.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetObjectDrawDistance.md index 1f673bdb79c..dcfc79e2130 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetObjectDrawDistance.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetObjectDrawDistance.md @@ -11,7 +11,7 @@ tags: ["物体"] 获取物体的绘制距离。 -| 名称 | 描述 | +| 参数 | 说明 | | -------- | ------------------------- | | objectid | 需要获取绘制距离的物体 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetObjectMaterial.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetObjectMaterial.md index fa0b5468969..8043d1184ed 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetObjectMaterial.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetObjectMaterial.md @@ -11,7 +11,7 @@ tags: ["物体"] 从物体的材质索引获取材质数据。 -| 名称 | 描述 | +| 参数 | 说明 | | ------------------ | ---------------------------------- | | objectid | 物体 ID | | materialIndex | 物体的材质索引 (0 至 15) | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetObjectMaterialText.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetObjectMaterialText.md index b6491b29653..48c2728fde1 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetObjectMaterialText.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetObjectMaterialText.md @@ -11,7 +11,7 @@ tags: ["物体"] 从物体的材质索引获取文本材质数据。 -| 名称 | 描述 | +| 参数 | 说明 | | ----------------------------------------- | ------------------------------------ | | objectid | 物体 ID | | materialIndex | 物体的材质索引 (0 至 15) | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetObjectModel.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetObjectModel.md index 2b90eb1b638..98554dcfa10 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetObjectModel.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetObjectModel.md @@ -11,7 +11,7 @@ tags: ["物体"] 获取通过 [CreateObject](CreateObject) 创建的物体模型 ID。 -| 名称 | 描述 | +| 参数 | 说明 | | -------- | ---------------------------- | | objectid | 需要获取模型 ID 的物体标识符 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetObjectMoveSpeed.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetObjectMoveSpeed.md index 73eac45bbfa..2d7882ece2f 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetObjectMoveSpeed.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetObjectMoveSpeed.md @@ -11,7 +11,7 @@ tags: ["物体"] 获取物体的移动速度。 -| 名称 | 描述 | +| 参数 | 说明 | | -------- | ------------------------- | | objectid | 需要获取移动速度的物体 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetObjectMovingTargetPos.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetObjectMovingTargetPos.md index 07452a01ea3..a0d95676c5e 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetObjectMovingTargetPos.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetObjectMovingTargetPos.md @@ -11,7 +11,7 @@ tags: ["物体"] 获取物体的移动目标位置。 -| 名称 | 描述 | +| 参数 | 说明 | | -------------- | --------------------------------------- | | objectid | 需要获取移动目标位置的物体 ID | | &Float:targetX | 存储目标 X 坐标的浮点变量，通过引用传递 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetObjectMovingTargetRot.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetObjectMovingTargetRot.md index 06bdd379b05..59791e3c47b 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetObjectMovingTargetRot.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetObjectMovingTargetRot.md @@ -11,7 +11,7 @@ tags: ["物体"] 获取物体的移动目标旋转参数。 -| 名称 | 描述 | +| 参数 | 说明 | | ---------------- | --------------------------------------- | | objectid | 需要获取移动目标旋转的物体 ID | | &Float:rotationX | 存储旋转 X 坐标的浮点变量，通过引用传递 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetObjectPos.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetObjectPos.md index 9b29506b974..5010d866f58 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetObjectPos.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetObjectPos.md @@ -9,7 +9,7 @@ tags: ["物体"] 获取物体的当前位置。 -| 名称 | 描述 | +| 参数 | 说明 | | -------- | ----------------------------------- | | objectid | 需要获取位置的物体 ID | | &Float:x | 存储 X 坐标的浮点变量，通过引用传递 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetObjectRot.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetObjectRot.md index ccdf429e1c8..8b18f175905 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetObjectRot.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetObjectRot.md @@ -9,7 +9,7 @@ tags: ["物体"] 使用此函数获取物体当前的旋转角度。旋转参数通过引用方式存储在三个变量 rotationX/rotationY/rotationZ 中。 -| 名称 | 描述 | +| 参数 | 说明 | | ---------------- | ----------------------------------------- | | objectid | 需要获取旋转参数的物体 ID | | &Float:rotationX | 存储 X 轴旋转角度的浮点变量，通过引用传递 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetObjectSyncRotation.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetObjectSyncRotation.md index bc28c907cfa..a75f9d05917 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetObjectSyncRotation.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetObjectSyncRotation.md @@ -11,7 +11,7 @@ tags: ["物体"] 获取物体的同步旋转状态。 -| 名称 | 描述 | +| 参数 | 说明 | | -------- | ------------- | | objectid | 目标物体的 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetObjectType.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetObjectType.md index edcdc28792e..f65d246cb13 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetObjectType.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetObjectType.md @@ -11,7 +11,7 @@ tags: ["物体"] 获取物体的类型（全局物体或玩家物体）。 -| 名称 | 描述 | +| 参数 | 说明 | | -------- | --------------------- | | playerid | 玩家 ID | | objectid | 需要获取类型的物体 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPVarFloat.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPVarFloat.md index ab95061d1b1..92386bad681 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPVarFloat.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPVarFloat.md @@ -2,14 +2,14 @@ title: GetPVarFloat sidebar_label: GetPVarFloat description: 获取玩家变量的浮点数值 -tags: ["玩家变量", "pvar"] +tags: ["玩家变量"] --- ## 描述 获取指定玩家的浮点型变量值 -| 名称 | 说明 | +| 参数 | 说明 | | ------------ | --------------------- | | playerid | 需要获取变量的玩家 ID | | const pvar[] | 目标玩家变量名称 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPVarInt.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPVarInt.md index f7095f7e6d9..b6ccae560e7 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPVarInt.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPVarInt.md @@ -2,14 +2,14 @@ title: GetPVarInt sidebar_label: GetPVarInt description: 获取玩家变量的整数值 -tags: ["玩家变量", "pvar"] +tags: ["玩家变量"] --- ## 描述 获取指定玩家变量的整数值 -| 名称 | 说明 | +| 参数 | 说明 | | ------------ | ----------------------------------------------------------------------- | | playerid | 需要获取变量的玩家 ID | | const pvar[] | 目标变量名称（不区分大小写）
需通过[SetPVarInt](SetPVarInt)预先设置 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPVarNameAtIndex.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPVarNameAtIndex.md index aa5ea82e4f3..b4b424240b5 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPVarNameAtIndex.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPVarNameAtIndex.md @@ -2,14 +2,14 @@ title: GetPVarNameAtIndex sidebar_label: GetPVarNameAtIndex description: 通过索引获取玩家变量的名称 -tags: ["玩家变量", "pvar"] +tags: ["玩家变量"] --- ## 描述 通过索引值获取玩家变量的名称 -| 名称 | 说明 | +| 参数 | 说明 | | ---------------------- | ---------------------------------- | | playerid | 需要获取变量名称的玩家 ID | | index | 玩家变量的索引编号（从 0 开始） | @@ -18,7 +18,7 @@ tags: ["玩家变量", "pvar"] ## 返回值 -本函数不直接返回值，变量名称将存储于指定字符数组中 +此函数不直接返回值，变量名称将存储于指定字符数组中 ## 相关函数 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPVarString.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPVarString.md index 85b396b6c48..8baecf3ec73 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPVarString.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPVarString.md @@ -2,14 +2,14 @@ title: GetPVarString sidebar_label: GetPVarString description: 获取玩家变量的字符串值 -tags: ["玩家变量", "pvar"] +tags: ["玩家变量"] --- ## 描述 获取指定玩家变量的字符串值 -| 名称 | 说明 | +| 参数 | 说明 | | --------------------- | ------------------------------------------------------------ | | playerid | 需要获取变量的玩家 ID | | const pvar[] | 目标变量名称（需通过[SetPVarString](SetPVarString)预先设置） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPVarType.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPVarType.md index ad609fd2c3f..4fd7a4c804b 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPVarType.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPVarType.md @@ -2,14 +2,14 @@ title: GetPVarType sidebar_label: GetPVarType description: 获取玩家变量的数据类型（整型、浮点型或字符串） -tags: ["玩家变量", "pvar"] +tags: ["玩家变量"] --- ## 描述 获取指定玩家变量的数据类型（整型、浮点型或字符串） -| 名称 | 说明 | +| 参数 | 说明 | | ------------ | ------------------------- | | playerid | 需要获取变量类型的玩家 ID | | const pvar[] | 目标变量名称（需已设置） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPVarsUpperIndex.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPVarsUpperIndex.md index fd7c62d150c..62fb34805ad 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPVarsUpperIndex.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPVarsUpperIndex.md @@ -2,14 +2,14 @@ title: GetPVarsUpperIndex sidebar_label: GetPVarsUpperIndex description: 获取玩家变量的最大索引值 -tags: ["玩家变量", "pvar"] +tags: ["玩家变量"] --- ## 描述 -玩家变量(PVar)都有唯一的标识索引，本函数返回玩家已设置的变量最大索引值 +玩家变量(PVar)都有唯一的标识索引，此函数返回玩家已设置的变量最大索引值 -| 名称 | 说明 | +| 参数 | 说明 | | -------- | --------------------- | | playerid | 需要获取索引的玩家 ID | @@ -41,7 +41,7 @@ for(new i = 0; i != PVarUpperIndex; i++) // 遍历所有可能的变量索引 } new szString[128]; -format(szString, sizeof(szString), "您已设置了 %i 个玩家变量，最大索引值为 %i", pVarCount, PVarUpperIndex-1); +format(szString, sizeof(szString), "你已设置了 %i 个玩家变量，最大索引值为 %i", pVarCount, PVarUpperIndex-1); SendClientMessage(playerid, -1, szString); ``` diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPickupModel.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPickupModel.md index 5767cf64b64..c767025e5bc 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPickupModel.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPickupModel.md @@ -11,7 +11,7 @@ tags: ["拾取物"] 获取拾取物的模型 ID。 -| 名称 | 描述 | +| 参数 | 说明 | | -------- | ------------------------------ | | pickupid | 需要获取模型 ID 的拾取物标识符 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPickupPos.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPickupPos.md index fd121f42938..01ef21e3426 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPickupPos.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPickupPos.md @@ -11,7 +11,7 @@ tags: ["拾取物"] 获取拾取物的坐标。 -| 名称 | 描述 | +| 参数 | 说明 | | -------- | ----------------------------------- | | pickupid | 需要获取坐标的拾取物 ID | | &Float:x | 存储 X 坐标的浮点变量，通过引用传递 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPickupType.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPickupType.md index bb0a34a8772..a91817639fa 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPickupType.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPickupType.md @@ -11,7 +11,7 @@ tags: ["拾取物"] 获取拾取物的类型。 -| 名称 | 描述 | +| 参数 | 说明 | | -------- | ----------------------- | | pickupid | 需要获取类型的拾取物 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPickupVirtualWorld.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPickupVirtualWorld.md index 889c0277258..7bd5ca5a7f9 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPickupVirtualWorld.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPickupVirtualWorld.md @@ -11,7 +11,7 @@ tags: ["拾取物"] 获取拾取物所属的虚拟世界 ID。 -| 名称 | 描述 | +| 参数 | 说明 | | -------- | ---------------------------------- | | pickupid | 需要获取虚拟世界 ID 的拾取物标识符 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayer3DTextLabelAttached.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayer3DTextLabelAttached.md index faae8461cdd..b5ee89359bd 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayer3DTextLabelAttached.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayer3DTextLabelAttached.md @@ -7,7 +7,7 @@ tags: ["玩家", "3D文本标签"] :::warning -该函数已弃用，请使用 [GetPlayer3DTextLabelAttachedData](GetPlayer3DTextLabelAttachedData)。 +此函数已弃用，请使用 [GetPlayer3DTextLabelAttachedData](GetPlayer3DTextLabelAttachedData)。 ::: @@ -15,7 +15,7 @@ tags: ["玩家", "3D文本标签"] 获取玩家 3D 文本标签的附加数据。 -| 名称 | 描述 | +| 参数 | 说明 | | ------------------- | ------------------------------------- | | playerid | 玩家的 ID | | PlayerText3D:textid | 需要获取附加数据的玩家 3D 文本标签 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayer3DTextLabelAttachedData.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayer3DTextLabelAttachedData.md index e8bdcaaddd3..49aca854f56 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayer3DTextLabelAttachedData.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayer3DTextLabelAttachedData.md @@ -11,7 +11,7 @@ tags: ["玩家", "3D文本标签"] 获取玩家 3D 文本标签的附加数据。 -| 名称 | 描述 | +| 参数 | 说明 | | ------------------- | ------------------------------------- | | playerid | 玩家的 ID | | PlayerText3D:textid | 需要获取附加数据的玩家 3D 文本标签 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayer3DTextLabelColor.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayer3DTextLabelColor.md index 2895bffc8cc..ac2c80481ff 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayer3DTextLabelColor.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayer3DTextLabelColor.md @@ -7,7 +7,7 @@ tags: ["玩家", "3D文本标签"] :::warning -该函数已弃用，请使用 [GetPlayer3DTextLabelColour](GetPlayer3DTextLabelColour)。 +此函数已弃用，请使用 [GetPlayer3DTextLabelColour](GetPlayer3DTextLabelColour)。 ::: @@ -15,7 +15,7 @@ tags: ["玩家", "3D文本标签"] 获取玩家 3D 文本标签的颜色。 -| 名称 | 描述 | +| 参数 | 说明 | | ------------------- | --------------------------------- | | playerid | 玩家的 ID | | PlayerText3D:textid | 需要获取颜色的玩家 3D 文本标签 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayer3DTextLabelColour.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayer3DTextLabelColour.md index 7ec0fa1c479..e7db766127d 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayer3DTextLabelColour.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayer3DTextLabelColour.md @@ -11,7 +11,7 @@ tags: ["玩家", "3D文本标签"] 获取玩家 3D 文本标签的颜色。 -| 名称 | 描述 | +| 参数 | 说明 | | ------------------- | --------------------------------- | | playerid | 玩家的 ID | | PlayerText3D:textid | 需要获取颜色的玩家 3D 文本标签 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayer3DTextLabelDrawDist.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayer3DTextLabelDrawDist.md index a76ae3d829a..744f875e8f2 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayer3DTextLabelDrawDist.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayer3DTextLabelDrawDist.md @@ -7,7 +7,7 @@ tags: ["玩家", "3D文本标签"] :::warning -该函数已弃用，请使用 [GetPlayer3DTextLabelDrawDistance](GetPlayer3DTextLabelDrawDistance)。 +此函数已弃用，请使用 [GetPlayer3DTextLabelDrawDistance](GetPlayer3DTextLabelDrawDistance)。 ::: @@ -15,7 +15,7 @@ tags: ["玩家", "3D文本标签"] 获取玩家 3D 文本标签的绘制距离。 -| 名称 | 描述 | +| 参数 | 说明 | | ------------------- | ------------------------------------- | | playerid | 玩家的 ID | | PlayerText3D:textid | 需要获取绘制距离的玩家 3D 文本标签 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayer3DTextLabelDrawDistance.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayer3DTextLabelDrawDistance.md index a93b6787425..9f1ebfe61a0 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayer3DTextLabelDrawDistance.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayer3DTextLabelDrawDistance.md @@ -11,7 +11,7 @@ tags: ["玩家", "3D文本标签"] 获取玩家 3D 文本标签的绘制距离。 -| 名称 | 描述 | +| 参数 | 说明 | | ------------------- | ------------------------------------- | | playerid | 玩家的 ID | | PlayerText3D:textid | 需要获取绘制距离的玩家 3D 文本标签 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayer3DTextLabelLOS.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayer3DTextLabelLOS.md index fbf833fa243..71125c6174d 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayer3DTextLabelLOS.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayer3DTextLabelLOS.md @@ -11,7 +11,7 @@ tags: ["玩家", "3D文本标签"] 获取玩家 3D 文本标签的视线检测状态。 -| 名称 | 描述 | +| 参数 | 说明 | | ------------------- | ----------------------------------------- | | playerid | 玩家的 ID | | PlayerText3D:textid | 需要获取视线检测状态的玩家 3D 文本标签 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayer3DTextLabelPos.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayer3DTextLabelPos.md index 6a47c5e9ab0..28b08a2b8c2 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayer3DTextLabelPos.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayer3DTextLabelPos.md @@ -11,7 +11,7 @@ tags: ["玩家", "3D文本标签"] 获取玩家 3D 文本标签的位置。 -| 名称 | 描述 | +| 参数 | 说明 | | ------------------- | ----------------------------------- | | playerid | 玩家的 ID | | PlayerText3D:textid | 需要获取位置的玩家 3D 文本标签 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayer3DTextLabelText.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayer3DTextLabelText.md index 23f4098c8d6..efa1aabd35b 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayer3DTextLabelText.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayer3DTextLabelText.md @@ -11,7 +11,7 @@ tags: ["玩家", "3D文本标签"] 获取玩家 3D 文本标签的文本内容。 -| 名称 | 描述 | +| 参数 | 说明 | | ------------------- | --------------------------------- | | playerid | 玩家的 ID | | PlayerText3D:textid | 需要获取文本的玩家 3D 文本标签 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayer3DTextLabelVirtualWorld.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayer3DTextLabelVirtualWorld.md index ac07bcf0bc2..0e98b794d52 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayer3DTextLabelVirtualWorld.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayer3DTextLabelVirtualWorld.md @@ -11,7 +11,7 @@ tags: ["玩家", "3D文本标签"] 获取玩家 3D 文本标签的虚拟世界 ID。 -| 名称 | 描述 | +| 参数 | 说明 | | ------------------- | ----------------------------------------- | | playerid | 玩家的 ID | | PlayerText3D:textid | 需要获取虚拟世界 ID 的玩家 3D 文本标签 ID | @@ -38,7 +38,7 @@ worldid = GetPlayer3DTextLabelVirtualWorld(playerid, playerTextId); :::warning 玩家 3D 文本标签本身不支持虚拟世界设置， -本函数实际返回的是玩家当前的虚拟世界 ID！ +此函数实际返回的是玩家当前的虚拟世界 ID！ ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerAmmo.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerAmmo.md index f7050ab5025..c8a172e6479 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerAmmo.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerAmmo.md @@ -9,7 +9,7 @@ tags: ["玩家"] 获取玩家当前武器的弹药量。 -| 名称 | 描述 | +| 参数 | 说明 | | -------- | ----------------------- | | playerid | 需要获取弹药量的玩家 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerAnimFlags.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerAnimFlags.md index 2df6097ca85..b1f3e9ce268 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerAnimFlags.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerAnimFlags.md @@ -11,7 +11,7 @@ tags: ["玩家", "动画"] 获取玩家当前的动画标志位信息。 -| 名称 | 描述 | +| 参数 | 说明 | | -------- | --------------------------- | | playerid | 需要获取动画标志位的玩家 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerAnimationFlags.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerAnimationFlags.md index f7282d3329b..262de29cd97 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerAnimationFlags.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerAnimationFlags.md @@ -11,7 +11,7 @@ tags: ["玩家", "动画"] 获取玩家当前动画的标志位信息。 -| 名称 | 描述 | +| 参数 | 说明 | | -------- | --------------------------- | | playerid | 需要获取动画标志位的玩家 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerAnimationIndex.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerAnimationIndex.md index 59d2f91d666..0e34f479fab 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerAnimationIndex.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerAnimationIndex.md @@ -9,7 +9,7 @@ tags: ["玩家", "动画"] 获取玩家当前正在应用的动画索引编号。 -| 名称 | 描述 | +| 参数 | 说明 | | -------- | ------------------------- | | playerid | 需要获取动画索引的玩家 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerArmour.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerArmour.md index 2a32be9e202..1fcf66fd5aa 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerArmour.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerArmour.md @@ -9,7 +9,7 @@ tags: ["玩家"] 此函数用于将玩家的护甲值存储到指定变量中。 -| 名称 | 描述 | +| 参数 | 说明 | | ------------- | ---------------------------------- | | playerid | 需要获取护甲值的玩家 ID | | &Float:armour | 存储护甲值的浮点变量，通过引用传递 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerAttachedObject.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerAttachedObject.md index 76a3e22a2d2..a8c80550ded 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerAttachedObject.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerAttachedObject.md @@ -11,7 +11,7 @@ tags: ["玩家", "物体", "附加"] 通过索引获取玩家附加物体的详细数据。 -| 名称 | 描述 | +| 参数 | 说明 | | ---------------- | ------------------------ | | playerid | 要获取数据的玩家 ID | | index | 物体附加的索引位置 (0-9) | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerBuildingsRemoved.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerBuildingsRemoved.md index dd5f8f62828..153580b1424 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerBuildingsRemoved.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerBuildingsRemoved.md @@ -11,7 +11,7 @@ tags: ["玩家"] 获取玩家通过 RemoveBuildingForPlayer 函数已移除的建筑数量。 -| 名称 | 描述 | +| 参数 | 说明 | | -------- | ----------------- | | playerid | 需要查询的玩家 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerCameraAspectRatio.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerCameraAspectRatio.md index 280f698ea45..cb97d82bde8 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerCameraAspectRatio.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerCameraAspectRatio.md @@ -9,8 +9,8 @@ tags: ["玩家", "视角"] 获取玩家当前视角的宽高比参数。 -| 名称 | 描述 | -| -------- | ----------------------------- | +| 参数 | 说明 | +| -------- | --------------------------- | | playerid | 需要获取视角宽高比的玩家 ID | ## 返回值 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerCameraFrontVector.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerCameraFrontVector.md index 6b786752b7c..48a92e529b0 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerCameraFrontVector.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerCameraFrontVector.md @@ -1,13 +1,13 @@ --- title: GetPlayerCameraFrontVector sidebar_label: GetPlayerCameraFrontVector -description: 本函数将返回玩家当前在三维空间中的瞄准方向坐标，该坐标相对于视角位置，具体位置信息请参见[GetPlayerCameraPos](GetPlayerCameraPos)。 +description: 此函数将返回玩家当前在三维空间中的瞄准方向坐标，该坐标相对于视角位置，具体位置信息请参见[GetPlayerCameraPos](GetPlayerCameraPos)。 tags: ["玩家", "视角"] --- ## 描述 -本函数将返回玩家当前在三维空间中的瞄准方向坐标，该坐标相对于视角位置，具体位置信息请参见[GetPlayerCameraPos](GetPlayerCameraPos)。 +此函数将返回玩家当前在三维空间中的瞄准方向坐标，该坐标相对于视角位置，具体位置信息请参见[GetPlayerCameraPos](GetPlayerCameraPos)。 | 参数名 | 说明 | | -------- | ----------------------------------------- | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerCameraTargetActor.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerCameraTargetActor.md index 09b06ca7890..a9e0182195c 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerCameraTargetActor.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerCameraTargetActor.md @@ -62,13 +62,13 @@ public OnPlayerUpdate(playerid) :::tip -本函数仅返回玩家视角方向上的角色 ID，如需检测玩家是否正在瞄准该角色，请使用[GetPlayerTargetActor](GetPlayerTargetActor) +此函数仅返回玩家视角方向上的角色 ID，如需检测玩家是否正在瞄准该角色，请使用[GetPlayerTargetActor](GetPlayerTargetActor) ::: :::warning -本功能默认禁用以节省带宽，需使用[EnablePlayerCameraTarget](EnablePlayerCameraTarget)为每个玩家单独启用 +此函数默认禁用以节省带宽，需使用[EnablePlayerCameraTarget](EnablePlayerCameraTarget)为每个玩家单独启用 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerCameraTargetObject.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerCameraTargetObject.md index 6130de456a5..9243d73b1a9 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerCameraTargetObject.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerCameraTargetObject.md @@ -57,7 +57,7 @@ public OnPlayerCommandText(playerid, cmdtext[]) :::warning -本功能默认禁用以节省带宽，需使用[EnablePlayerCameraTarget](EnablePlayerCameraTarget)为每个玩家单独启用 +此函数默认禁用以节省带宽，需使用[EnablePlayerCameraTarget](EnablePlayerCameraTarget)为每个玩家单独启用 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerCameraTargetPlayer.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerCameraTargetPlayer.md index 4e2f19d620a..800aa771c52 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerCameraTargetPlayer.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerCameraTargetPlayer.md @@ -34,7 +34,7 @@ if (IsPlayerAdmin(playerTarget)) :::warning -请勿与[GetPlayerTargetPlayer](GetPlayerTargetPlayer)混淆。GetPlayerTargetPlayer 返回玩家正在用武器瞄准的玩家 ID，而本函数返回玩家视角中心点所指向的玩家 ID +请勿与[GetPlayerTargetPlayer](GetPlayerTargetPlayer)混淆。GetPlayerTargetPlayer 返回玩家正在用武器瞄准的玩家 ID，而此函数返回玩家视角中心点所指向的玩家 ID ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerCameraTargetPlayerObject.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerCameraTargetPlayerObject.md index 4cb210f1a0b..419c29e2dc0 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerCameraTargetPlayerObject.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerCameraTargetPlayerObject.md @@ -53,7 +53,7 @@ public OnPlayerCommandText(playerid, cmdtext[]) :::warning -本功能默认禁用以节省带宽，需使用[EnablePlayerCameraTarget](EnablePlayerCameraTarget)为每个玩家单独启用 +此函数默认禁用以节省带宽，需使用[EnablePlayerCameraTarget](EnablePlayerCameraTarget)为每个玩家单独启用 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerCameraTargetVehicle.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerCameraTargetVehicle.md index 52856166197..c18a06e6c06 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerCameraTargetVehicle.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerCameraTargetVehicle.md @@ -63,13 +63,13 @@ public OnPlayerCommandText(playerid, cmdtext[]) :::tip -本函数每次只能返回一个车辆 ID（通常为距离玩家最近的车辆），即使玩家视角范围内存在多个车辆 +此函数每次只能返回一个车辆 ID（通常为距离玩家最近的车辆），即使玩家视角范围内存在多个车辆 ::: :::warning -本功能默认禁用以节省带宽，需使用[EnablePlayerCameraTarget](EnablePlayerCameraTarget)为每个玩家单独启用 +此函数默认禁用以节省带宽，需使用[EnablePlayerCameraTarget](EnablePlayerCameraTarget)为每个玩家单独启用 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerCameraUpVector.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerCameraUpVector.md index 972e34a06a6..4b101062642 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerCameraUpVector.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerCameraUpVector.md @@ -1,13 +1,13 @@ --- title: GetPlayerCameraUpVector sidebar_label: GetPlayerCameraUpVector -description: 本函数用于获取玩家视角垂直方向向量，即指向屏幕顶部中间的坐标向量 +description: 此函数用于获取玩家视角垂直方向向量，即指向屏幕顶部中间的坐标向量 tags: ["玩家", "视角"] --- ## 描述 -本函数返回玩家视角垂直方向向量，该向量指向屏幕顶部中心点的三维坐标方向 +此函数返回玩家视角垂直方向向量，该向量指向屏幕顶部中心点的三维坐标方向 | 参数名 | 说明 | | -------- | --------------------------------------------- | @@ -24,7 +24,7 @@ tags: ["玩家", "视角"] :::warning -本函数已在 SA-MP 0.3b 版本中移除 +此函数已在 SA-MP 0.3b 版本中移除 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerCameraZoom.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerCameraZoom.md index 8b84ab23441..225280cad9f 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerCameraZoom.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerCameraZoom.md @@ -30,7 +30,7 @@ SendClientMessage(playerid, -1, string); :::tip -本函数获取的是游戏内置视角系统（包含狙击镜缩放）的缩放级别，与武器模型自带的缩放效果无关 +此函数获取的是游戏内置视角系统（包含狙击镜缩放）的缩放级别，与武器模型自带的缩放效果无关 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerCheckpoint.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerCheckpoint.md index 8e370f4b047..f7bc28cbf9f 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerCheckpoint.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerCheckpoint.md @@ -11,7 +11,7 @@ tags: ["玩家", "检查点"] 获取玩家当前激活的检查点位置及参数信息 -| 参数名 | 说明 | +| 参数 | 说明 | | -------------- | ----------------------------------------------- | | playerid | 需要获取检查点信息的玩家 ID | | &Float:centreX | 存储检查点中心 X 坐标的浮点变量（通过引用传递） | @@ -21,7 +21,7 @@ tags: ["玩家", "检查点"] ## 返回值 -本函数不直接返回值，数据将通过引用参数返回 +此函数不直接返回值，数据将通过引用参数返回 ## 示例代码 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerClass.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerClass.md index 2203f6a2046..b9a7c9be768 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerClass.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerClass.md @@ -2,7 +2,7 @@ title: GetPlayerClass sidebar_label: GetPlayerClass description: 获取职业配置数据 -tags: ["class"] +tags: ["职业"] --- @@ -11,7 +11,7 @@ tags: ["class"] 获取已注册职业的配置数据 -| 参数名 | 说明 | +| 参数 | 说明 | | --------------- | ------------------------------------------- | | classid | 要获取数据的职业 ID | | &team | 存储队伍 ID 的变量（通过引用传递） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerColor.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerColor.md index f7b6df64b02..d9bbd388081 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerColor.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerColor.md @@ -32,7 +32,7 @@ SendClientMessage(playerid, -1, output); :::warning -若未预先调用 SetPlayerColor 设置颜色，本函数将返回 0。点击[此处](../../tutorials/colorfix)查看修复方法 +若未预先调用 SetPlayerColor 设置颜色，此函数将返回 0。点击[此处](../../tutorials/colorfix)查看修复方法 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerCustomSkin.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerCustomSkin.md index f80d7a8ed97..4420649a02a 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerCustomSkin.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerCustomSkin.md @@ -29,7 +29,7 @@ public OnPlayerCommandText(playerid, cmdtext[]) new string[32]; new customSkin = GetPlayerCustomSkin(playerid); - format(string, sizeof(string), "您的自定义皮肤ID: %d", customSkin); + format(string, sizeof(string), "你的自定义皮肤ID: %d", customSkin); SendClientMessage(playerid, -1, string); return 1; } diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerDialog.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerDialog.md index 7044dbfc7af..bcbf9c4bf2f 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerDialog.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerDialog.md @@ -7,7 +7,7 @@ tags: ["玩家", "对话框"] :::warning -本函数已弃用，请使用[GetPlayerDialogID](GetPlayerDialogID) +此函数已弃用，请使用[GetPlayerDialogID](GetPlayerDialogID) ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerDialogData.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerDialogData.md index 399b8860dac..8fea2abbbf6 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerDialogData.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerDialogData.md @@ -11,18 +11,18 @@ tags: ["玩家", "对话框"] 获取当前显示给玩家的对话框完整配置数据 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------------- | -------------------------------------------- | | playerid | 需要获取数据的玩家 ID | | &DIALOG_STYLE:style | 存储对话框样式的枚举变量（通过引用传递） | | title[] | 存储标题文本的数组变量（通过引用传递） | -| titleSize | 标题数组的长度 | +| titleSize | 标题数组的长度 | | body[] | 存储内容文本的数组变量（通过引用传递） | -| bodySize | 内容数组的长度 | +| bodySize | 内容数组的长度 | | button1[] | 存储第一个按钮文本的数组变量（通过引用传递） | -| button1Size | 按钮 1 数组的长度 | +| button1Size | 按钮 1 数组的长度 | | button2[] | 存储第二个按钮文本的数组变量（通过引用传递） | -| button2Size | 按钮 2 数组的长度 | +| button2Size | 按钮 2 数组的长度 | ## 返回值 @@ -38,7 +38,7 @@ enum DIALOG_LOGIN } -ShowPlayerDialog(playerid, DIALOG_LOGIN, DIALOG_STYLE_INPUT, "登录系统", "请输入您的密码:", "登录", "取消"); +ShowPlayerDialog(playerid, DIALOG_LOGIN, DIALOG_STYLE_INPUT, "登录系统", "请输入你的密码:", "登录", "取消"); new DIALOG_STYLE:style, diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerFacingAngle.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerFacingAngle.md index 7533b3fd74c..a0e5e73d0c3 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerFacingAngle.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerFacingAngle.md @@ -9,7 +9,7 @@ tags: ["玩家"] 获取玩家当前面朝方向的水平旋转角度 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------ | ---------------------------------- | | playerid | 需要获取角度的玩家 ID | | &Float:angle | 存储角度的浮点变量（通过引用传递） | @@ -45,7 +45,7 @@ public OnPlayerCommandText(playerid, cmdtext[]) :::tip -当玩家处于车辆内时，本函数返回的角度通常不准确。建议使用[GetVehicleZAngle](GetVehicleZAngle)获取车辆 Z 轴旋转角度 +当玩家处于车辆内时，此函数返回的角度通常不准确。建议使用[GetVehicleZAngle](GetVehicleZAngle)获取车辆 Z 轴旋转角度 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerHealth.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerHealth.md index 9ee11d81619..5a0fe4b1558 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerHealth.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerHealth.md @@ -7,9 +7,9 @@ tags: ["玩家"] ## 描述 -本函数用于获取玩家当前的生命值，常用于反作弊检测等场景 +此函数用于获取玩家当前的生命值，常用于反作弊检测等场景 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------- | ------------------------------------ | | playerid | 需要获取生命值的玩家 ID | | &Float:health | 存储生命值的浮点变量（通过引用传递） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerHydraReactorAngle.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerHydraReactorAngle.md index 4a0bd657a32..08bf38b000c 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerHydraReactorAngle.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerHydraReactorAngle.md @@ -1,7 +1,7 @@ --- title: GetPlayerHydraReactorAngle sidebar_label: GetPlayerHydraReactorAngle -description: 获取玩家车辆的九头蛇推进器角度 +description: 获取玩家驾驶的九头蛇推进器角度 tags: ["玩家", "车辆"] --- diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerInterior.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerInterior.md index 21307ec75d0..80b84118b4d 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerInterior.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerInterior.md @@ -1,7 +1,7 @@ --- title: GetPlayerInterior sidebar_label: GetPlayerInterior -description: 获取玩家当前所在的室内编号 +description: 获取玩家当前所在的室内场景 tags: ["玩家"] --- @@ -11,11 +11,11 @@ tags: ["玩家"] | 参数名 | 说明 | | -------- | ------------------------- | -| playerid | 需要获取室内编号的玩家 ID | +| playerid | 需要获取室内场景的玩家 ID | ## 返回值 -玩家当前所在的室内编号（整数类型） +玩家当前所在的室内场景（整数类型） ## 示例代码 @@ -25,7 +25,7 @@ public OnPlayerCommandText(playerid,text[]) if (strcmp(cmdtext, "/int", true) == 0) { new string[64]; - format(string, sizeof(string), "你当前所在的室内编号是 %i", GetPlayerInterior(playerid)); + format(string, sizeof(string), "你当前所在的室内场景是 %i", GetPlayerInterior(playerid)); SendClientMessage(playerid, 0xFF8000FF, string); return 1; } @@ -37,11 +37,11 @@ public OnPlayerCommandText(playerid,text[]) :::tip -NPC 玩家将始终返回室内编号 0 +NPC 玩家将始终返回室内场景 0 ::: ## 相关函数 -- [SetPlayerInterior](SetPlayerInterior): 设置玩家的室内编号 +- [SetPlayerInterior](SetPlayerInterior): 设置玩家的室内场景 - [GetPlayerVirtualWorld](GetPlayerVirtualWorld): 获取玩家所在的虚拟世界 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerIp.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerIp.md index decc66b05cc..7d0b04565d0 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerIp.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerIp.md @@ -9,7 +9,7 @@ tags: ["玩家", "IP地址"] 获取指定玩家的 IP 地址并存储到字符串数组中 -| 参数名 | 说明 | +| 参数 | 说明 | | ---------------- | ---------------------------------------- | | playerid | 需要获取 IP 地址的玩家 ID | | ip[] | 存储 IP 地址的字符串数组（通过引用传递） | @@ -28,7 +28,7 @@ public OnPlayerConnect(playerid) GetPlayerIp(playerid, ipAddress, sizeof(ipAddress)); if (!strcmp(ipAddress, "127.0.0.1")) { - SendClientMessage(playerid, 0xFFFFFFFF, "欢迎来到您的服务器，管理员 :)"); + SendClientMessage(playerid, 0xFFFFFFFF, "欢迎来到你的服务器，管理员 :)"); } return 1; } diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerKeys.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerKeys.md index 122053d7ca8..82b72225cb5 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerKeys.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerKeys.md @@ -9,7 +9,7 @@ tags: ["玩家"] 检测玩家当前操作的按键状态（行走/驾驶控制） -| 参数名 | 说明 | +| 参数 | 说明 | | ---------- | ----------------------------------------------------------------------------------------------------- | | playerid | 需要检测的玩家 ID | | &KEY:keys | 存储按键位掩码的变量（通过引用传递），用于检测特定功能键状态，详见[按键位掩码说明](../resources/keys) | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerLandingGearState.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerLandingGearState.md index 9f0e6ac86c0..8935abc13c4 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerLandingGearState.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerLandingGearState.md @@ -2,7 +2,7 @@ title: GetPlayerLandingGearState sidebar_label: GetPlayerLandingGearState description: 获取玩家当前驾驶飞机的起落架状态 -tags: ["玩家", "飞机"] +tags: ["玩家", "车辆"] --- diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerLastShotVectors.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerLastShotVectors.md index 929f48eaea9..5664049bc0a 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerLastShotVectors.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerLastShotVectors.md @@ -9,7 +9,7 @@ tags: ["玩家"] 获取玩家最后一次射击子弹的起始点和命中点坐标 -| 参数名 | 说明 | +| 参数 | 说明 | | -------------- | --------------------------------------- | | playerid | 需要获取射击信息的玩家 ID | | &Float:originX | 用于存储子弹发射原点 X 坐标的浮点型变量 | @@ -52,7 +52,7 @@ public OnPlayerCommandText(playerid, cmdtext[]) :::warning -- 本函数仅在开启延迟补偿时生效 +- 此函数仅在开启延迟补偿时生效 - 若子弹未命中任何物体，命中点坐标将返回 0。当前无法计算子弹在空中的飞行距离 ::: @@ -63,6 +63,6 @@ public OnPlayerCommandText(playerid, cmdtext[]) - [GetPlayerWeapon](GetPlayerWeapon): 获取玩家当前手持的武器 - [VectorSize](VectorSize): 计算向量的模长 -## 相关回调函数 +## 相关回调 -- [OnPlayerWeaponShot](../callbacks/OnPlayerWeaponShot): 当玩家发射武器时触发 +- [OnPlayerWeaponShot](../callbacks/OnPlayerWeaponShot): 当玩家开火时触发 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerLastSyncedTrailerID.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerLastSyncedTrailerID.md index e081afde8c6..d236507d946 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerLastSyncedTrailerID.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerLastSyncedTrailerID.md @@ -9,7 +9,7 @@ tags: ["玩家", "车辆"] :::warning -该函数尚未实现。 +此函数尚未实现。 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerLastSyncedVehicleID.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerLastSyncedVehicleID.md index dda5acc38bc..bc28c4f159c 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerLastSyncedVehicleID.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerLastSyncedVehicleID.md @@ -9,7 +9,7 @@ tags: ["玩家", "车辆"] :::warning -该函数尚未实现。 +此函数尚未实现。 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerMarkerForPlayer.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerMarkerForPlayer.md index fdba9bfc464..b5ee08c4764 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerMarkerForPlayer.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerMarkerForPlayer.md @@ -6,15 +6,15 @@ tags: ["玩家"] --- - + ## 描述 获取指定玩家在另一玩家视角下的**名牌**和**雷达标记**颜色 -| 参数名 | 说明 | -| -------- | ------------------------------------------------------ | +| 参数名 | 说明 | +| -------- | -------------------------------------------------- | | playerid | 可以看到目标玩家改变后标记/名牌颜色的观察者玩家 ID | -| targetid | 被修改标记颜色的目标玩家 ID | +| targetid | 被修改标记颜色的目标玩家 ID | ## 返回值 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerMenu.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerMenu.md index 0bfe2a4c954..9a5d8758344 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerMenu.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerMenu.md @@ -41,7 +41,7 @@ new Menu:currentMenu = GetPlayerMenu(playerid); // 将玩家当前菜单存入'c - [DestroyMenu](DestroyMenu): 销毁菜单 - [AddMenuItem](AddMenuItem): 添加菜单项 -## 相关回调函数 +## 相关回调 - [OnPlayerSelectedMenuRow](../callbacks/OnPlayerSelectedMenuRow): 当玩家选择菜单项时触发 - [OnPlayerExitedMenu](../callbacks/OnPlayerExitedMenu): 当玩家退出菜单时触发 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerNetworkStats.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerNetworkStats.md index 56afff403bd..c1110697a65 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerNetworkStats.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerNetworkStats.md @@ -9,7 +9,7 @@ tags: ["玩家", "网络监控"] 获取玩家的网络统计信息并保存到字符串中 -| 参数名 | 说明 | +| 参数 | 说明 | | ---------------------- | ---------------------------------------- | | playerid | 需要获取网络统计数据的玩家 ID | | output[] | 存储网络统计数据的字符串（通过引用传递） | @@ -17,7 +17,7 @@ tags: ["玩家", "网络监控"] ## 返回值 -本函数总是返回 1 +此函数总是返回 1 ## 示例代码 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerObjectAttachedData.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerObjectAttachedData.md index 5e4406b1a9e..28c345e3d7f 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerObjectAttachedData.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerObjectAttachedData.md @@ -11,7 +11,7 @@ tags: ["玩家", "物体", "玩家物体"] 获取玩家物体的附加数据 -| 参数名 | 说明 | +| 参数 | 说明 | | -------------- | -------------------------------------- | | playerid | 玩家 ID | | objectid | 需要获取附加数据的玩家物体 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerObjectAttachedOffset.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerObjectAttachedOffset.md index 64567d5f5f4..49fab43959f 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerObjectAttachedOffset.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerObjectAttachedOffset.md @@ -11,7 +11,7 @@ tags: ["玩家", "物体", "玩家物体"] 获取玩家物体的附加偏移和旋转 -| 参数名 | 说明 | +| 参数 | 说明 | | ---------------- | --------------------------------------------- | | playerid | 玩家 ID | | objectid | 需要获取偏移和旋转的玩家物体 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerObjectMaterial.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerObjectMaterial.md index f7c9874fbd5..a06c2bf25fe 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerObjectMaterial.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerObjectMaterial.md @@ -11,7 +11,7 @@ tags: ["玩家", "物体", "玩家物体"] 获取玩家物体指定索引的材质数据 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------------ | ------------------------------------ | | playerid | 玩家 ID | | objectid | 玩家物体 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerObjectMaterialText.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerObjectMaterialText.md index a01098784a0..685ed4638f1 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerObjectMaterialText.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerObjectMaterialText.md @@ -11,7 +11,7 @@ tags: ["玩家", "物体", "玩家物体"] 获取玩家物体指定索引的材质文本数据 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------------------------------------- | -------------------------------------- | | playerid | 玩家 ID | | objectid | 玩家物体 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerObjectMovingTargetPos.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerObjectMovingTargetPos.md index 636678045af..a3ebfe8bdc6 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerObjectMovingTargetPos.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerObjectMovingTargetPos.md @@ -11,7 +11,7 @@ tags: ["玩家", "物体", "玩家物体"] 获取玩家物体的移动目标位置 -| 参数名 | 说明 | +| 参数 | 说明 | | -------------- | ------------------------------------------- | | playerid | 玩家 ID | | objectid | 需要获取目标位置的玩家物体 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerObjectMovingTargetRot.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerObjectMovingTargetRot.md index ca3757a1c8f..22cb1843799 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerObjectMovingTargetRot.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerObjectMovingTargetRot.md @@ -11,7 +11,7 @@ tags: ["玩家", "物体", "玩家物体"] 获取玩家物体的移动目标旋转 -| 参数名 | 说明 | +| 参数 | 说明 | | ---------------- | ------------------------------------------------- | | playerid | 玩家 ID | | objectid | 需要获取目标旋转的玩家物体 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerObjectRot.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerObjectRot.md index 6992bb2505a..f8d56180a1c 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerObjectRot.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerObjectRot.md @@ -7,9 +7,9 @@ tags: ["玩家", "物体", "玩家物体"] ## 描述 -该函数用于获取玩家物体的当前旋转角度。旋转角度通过引用方式存储在三个 rotationX/rotationY/rotationZ 变量中。 +此函数用于获取玩家物体的当前旋转角度。旋转角度通过引用方式存储在三个 rotationX/rotationY/rotationZ 变量中。 -| 参数名 | 说明 | +| 参数 | 说明 | | ---------------- | --------------------------------------------- | | playerid | 关联该物体的玩家 ID | | objectid | 需要获取旋转角度的物体 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerPickupPos.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerPickupPos.md index e6ef884233f..a4e201aec14 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerPickupPos.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerPickupPos.md @@ -21,7 +21,7 @@ tags: ["玩家", "拾取物", "玩家拾取物"] ## 返回值 -本函数不返回特定值，坐标数据通过参数传递 +此函数不返回特定值，坐标数据通过参数传递。 ## 示例代码 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerPoolSize.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerPoolSize.md index f5d87a42d9c..dc2d63e838a 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerPoolSize.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerPoolSize.md @@ -9,7 +9,7 @@ tags: ["玩家"] ## 描述 -获取服务器当前正在使用的最高玩家 ID。注意在 SA-MP 中该函数存在缺陷，即使没有玩家在线也会返回`0`。open.mp 已修正此问题，返回`-1`，但建议改用`MAX_PLAYERS`或`foreach`替代本函数。 +获取服务器当前正在使用的最高玩家 ID。注意在 SA-MP 中此函数存在缺陷，即使没有玩家在线也会返回`0`。open.mp 已修正此问题，返回`-1`，但建议改用`MAX_PLAYERS`或`foreach`替代此函数。 ## 示例代码 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerRaceCheckpoint.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerRaceCheckpoint.md index 76a33eb7813..dbe57a54f4f 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerRaceCheckpoint.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerRaceCheckpoint.md @@ -11,7 +11,7 @@ tags: ["玩家", "检查点", "竞速检查点"] 获取玩家当前竞速检查点的位置信息（包含中心点、下一个检查点位置及半径） -| 参数名 | 说明 | +| 参数 | 说明 | | -------------- | --------------------------------------------------- | | playerid | 需要获取检查点信息的玩家 ID | | &Float:centreX | 存储中心点 X 坐标的浮点型变量（通过引用传递） | @@ -24,7 +24,7 @@ tags: ["玩家", "检查点", "竞速检查点"] ## 返回值 -本函数不返回具体值，数据通过参数传递 +此函数不返回具体值，数据通过参数传递 ## 示例代码 @@ -52,7 +52,7 @@ GetPlayerRaceCheckpoint(playerid, centreX, centreY, centreZ, nextX, nextY, nextZ - [IsPlayerInRaceCheckpoint](IsPlayerInRaceCheckpoint): 检测玩家是否处于竞速检查点 - [IsPlayerRaceCheckpointActive](IsPlayerRaceCheckpointActive): 检测玩家是否有激活的竞速检查点 -## 相关回调函数 +## 相关回调 - [OnPlayerEnterCheckpoint](../callbacks/OnPlayerEnterCheckpoint): 玩家进入普通检查点时触发 - [OnPlayerLeaveCheckpoint](../callbacks/OnPlayerLeaveCheckpoint): 玩家离开普通检查点时触发 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerRawIp.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerRawIp.md index 1bf4bc8b4e1..200ce9520bd 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerRawIp.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerRawIp.md @@ -25,7 +25,7 @@ tags: ["玩家", "IP地址"] public OnPlayerConnect(playerid) { new rawIp = GetPlayerRawIp(playerid); - SendClientMessage(playerid, 0xFFFF00FF, "服务器：您的原始IP地址：%d", rawIp); + SendClientMessage(playerid, 0xFFFF00FF, "服务器：你的原始IP地址：%d", rawIp); return 1; } ``` diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerRotationQuat.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerRotationQuat.md index adbae5d40af..01919aabd48 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerRotationQuat.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerRotationQuat.md @@ -43,7 +43,7 @@ GetPlayerRotationQuat(playerid, w, x, y, z); :::tip -本函数仅用于获取旋转参数，无法直接设置玩家旋转（可通过[SetPlayerFacingAngle](SetPlayerFacingAngle)设置 Z 轴朝向） +此函数仅用于获取旋转参数，无法直接设置玩家旋转（可通过[SetPlayerFacingAngle](SetPlayerFacingAngle)设置 Z 轴朝向） ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerScore.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerScore.md index 13969430b55..306b483a100 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerScore.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerScore.md @@ -7,7 +7,7 @@ tags: ["玩家"] ## 描述 -该函数用于获取玩家通过[SetPlayerScore](SetPlayerScore)设置的分数值 +此函数用于获取玩家通过[SetPlayerScore](SetPlayerScore)设置的分数值 | 参数名 | 说明 | | -------- | --------------------- | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerSirenState.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerSirenState.md index 7111af257b2..a52fd635fb7 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerSirenState.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerSirenState.md @@ -1,7 +1,7 @@ --- title: GetPlayerSirenState sidebar_label: GetPlayerSirenState -description: 获取玩家车辆的警笛状态 +description: 获取玩家车辆的警报器状态 tags: ["玩家", "车辆"] --- @@ -9,7 +9,7 @@ tags: ["玩家", "车辆"] ## 描述 -获取玩家当前所处车辆的警笛开关状态 +获取玩家当前所处车辆的警报器开关状态 ## 参数 @@ -19,7 +19,7 @@ tags: ["玩家", "车辆"] ## 返回值 -返回警笛状态布尔值（true=开启，false=关闭） +返回警报器状态布尔值（true=开启，false=关闭） ## 示例代码 @@ -35,7 +35,7 @@ public OnPlayerCommandText(playerid, cmdtext[]) new bool:sirenState = GetPlayerSirenState(playerid); - SendClientMessage(playerid, 0xFFFF00FF, "车辆警笛状态：%s", sirenState ? "开启" : "关闭"); + SendClientMessage(playerid, 0xFFFF00FF, "车辆警报器状态：%s", sirenState ? "开启" : "关闭"); return 1; } return 0; @@ -44,7 +44,7 @@ public OnPlayerCommandText(playerid, cmdtext[]) ## 相关函数 -- [SetVehicleParamsSirenState](SetVehicleParamsSirenState): 设置车辆警笛开关状态 -- [ToggleVehicleSirenEnabled](ToggleVehicleSirenEnabled): 切换车辆警笛状态 -- [IsVehicleSirenEnabled](IsVehicleSirenEnabled): 检测车辆警笛是否启用 -- [GetVehicleSirenState](GetVehicleSirenState): 获取车辆警笛状态（通过车辆 ID） +- [SetVehicleParamsSirenState](SetVehicleParamsSirenState): 设置车辆警报器开关状态 +- [ToggleVehicleSirenEnabled](ToggleVehicleSirenEnabled): 切换车辆警报器状态 +- [IsVehicleSirenEnabled](IsVehicleSirenEnabled): 检测车辆警报器是否启用 +- [GetVehicleSirenState](GetVehicleSirenState): 获取车辆警报器状态（通过车辆 ID） diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerSkillLevel.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerSkillLevel.md index ae3a6e748a9..3d2ce48f663 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerSkillLevel.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerSkillLevel.md @@ -11,7 +11,7 @@ tags: ["玩家"] 获取玩家指定武器类型的技能等级 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------------- | ------------------------------------------------- | | playerid | 玩家 ID | | WEAPONSKILL:skill | 要查询的[武器技能类型](../resources/weaponskills) | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerSurfingObjectID.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerSurfingObjectID.md index 6589a2841da..0a57bc01bdb 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerSurfingObjectID.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerSurfingObjectID.md @@ -9,7 +9,7 @@ tags: ["玩家"] 获取玩家当前正在“冲浪”的物体 ID。 -| 参数名 | 描述 | +| 参数 | 说明 | | -------- | ------------------------ | | playerid | 正在冲浪物体的玩家标识符 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerSurfingOffsets.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerSurfingOffsets.md index 9c8a82fbad3..f8fd4b23513 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerSurfingOffsets.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerSurfingOffsets.md @@ -11,7 +11,7 @@ tags: ["玩家"] 获取玩家“冲浪”时的坐标偏移量参数。 -| 参数名 | 描述 | +| 参数 | 说明 | | -------------- | ----------------------------------------- | | playerid | 目标玩家标识符 | | &Float:offsetX | 用于存储 X 轴偏移量的浮点变量（引用传递） | @@ -20,7 +20,7 @@ tags: ["玩家"] ## 返回值 -本函数不返回特定值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerSurfingPlayerObjectID.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerSurfingPlayerObjectID.md index fcbef858188..32f91ceb86b 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerSurfingPlayerObjectID.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerSurfingPlayerObjectID.md @@ -2,7 +2,7 @@ title: GetPlayerSurfingPlayerObjectID sidebar_label: GetPlayerSurfingPlayerObjectID description: 获取玩家正在“冲浪”的玩家私有物体ID。 -tags: ["玩家", "物体", "玩家私有物体"] +tags: ["玩家", "物体", "玩家物体"] --- @@ -11,7 +11,7 @@ tags: ["玩家", "物体", "玩家私有物体"] 获取玩家当前正在“冲浪”的玩家私有物体 ID。 -| 参数名 | 描述 | +| 参数 | 说明 | | -------- | -------------------------- | | playerid | 正在“冲浪”物体的玩家标识符 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerSurfingVehicleID.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerSurfingVehicleID.md index a04fff803e6..34544d1b5b6 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerSurfingVehicleID.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerSurfingVehicleID.md @@ -9,7 +9,7 @@ tags: ["玩家", "车辆"] 获取玩家当前正在“冲浪”（停留在车顶）的车辆 ID。 -| 参数名 | 描述 | +| 参数 | 说明 | | -------- | -------------------------------------- | | playerid | 需要查询“冲浪”车辆 ID 的目标玩家标识符 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerTargetActor.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerTargetActor.md index 728271a31bd..eef69447084 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerTargetActor.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerTargetActor.md @@ -11,7 +11,7 @@ tags: ["玩家"] 获取指定玩家当前瞄准的角色（Actor）ID -| 名称 | 说明 | +| 参数 | 说明 | | -------- | --------------------- | | playerid | 需要获取目标的玩家 ID | @@ -28,7 +28,7 @@ public OnPlayerUpdate(playerid) targetActorId = GetPlayerTargetActor(playerid), string[32]; - format(string, sizeof(string), "您正在瞄准角色ID %d", targetActorId); + format(string, sizeof(string), "你正在瞄准角色ID %d", targetActorId); SendClientMessage(playerid, -1, string); return 1; } diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerTargetPlayer.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerTargetPlayer.md index d8c08e58640..f46b906fe10 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerTargetPlayer.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerTargetPlayer.md @@ -9,7 +9,7 @@ tags: ["玩家"] 检查指定玩家当前瞄准的目标玩家 -| 名称 | 说明 | +| 参数 | 说明 | | -------- | --------------------- | | playerid | 需要获取目标的玩家 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerTeam.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerTeam.md index 4ef6144710a..2f35f866d28 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerTeam.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerTeam.md @@ -9,7 +9,7 @@ tags: ["玩家"] 获取指定玩家当前所属的队伍编号 -| 名称 | 说明 | +| 参数 | 说明 | | -------- | ------------------------- | | playerid | 需要获取队伍信息的玩家 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerTime.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerTime.md index 94ca634c2ae..eb2f35db62b 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerTime.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerTime.md @@ -9,7 +9,7 @@ tags: ["玩家"] 获取玩家当前的游戏时间。该时间通过[SetWorldTime](SetWorldTime)设置，或当使用[TogglePlayerClock](TogglePlayerClock)时由游戏自动设置。 -| 名称 | 说明 | +| 参数 | 说明 | | -------- | -------------------------- | | playerid | 需要获取游戏时间的玩家 ID | | &hour | 存储小时的变量（引用传递） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerTrainSpeed.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerTrainSpeed.md index 282a961d492..07d1234dee1 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerTrainSpeed.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerTrainSpeed.md @@ -13,7 +13,7 @@ tags: ["玩家", "车辆"] ## 参数说明 -| 名称 | 说明 | +| 参数 | 说明 | | -------- | --------- | | playerid | 玩家的 ID | @@ -21,7 +21,7 @@ tags: ["玩家", "车辆"] ```c new Float:speed = GetPlayerTrainSpeed(playerid); -SendClientMessage(playerid, 0xFFFF00FF, "您的火车当前速度：%f", speed); +SendClientMessage(playerid, 0xFFFF00FF, "你的火车当前速度：%f", speed); ``` ## 相关函数 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerVehicleID.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerVehicleID.md index 699c10af481..bdca7aaf5bf 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerVehicleID.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerVehicleID.md @@ -11,7 +11,7 @@ tags: ["玩家", "车辆"] **注意：** 并非车辆的模型 ID，获取模型 ID 请参考[GetVehicleModel](GetVehicleModel) -| 名称 | 说明 | +| 参数 | 说明 | | -------- | ------------------------- | | playerid | 需要获取车辆信息的玩家 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerVehicleSeat.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerVehicleSeat.md index 21d1aaaedbb..a17a593aa42 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerVehicleSeat.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerVehicleSeat.md @@ -9,13 +9,14 @@ tags: ["玩家", "车辆"] 获取指定玩家当前在车辆中的座位编号 -| 名称 | 说明 | +| 参数 | 说明 | | -------- | ------------------------- | | playerid | 需要获取座位信息的玩家 ID | ## 返回值 玩家当前所在的座位编号： + - **-1** 未处于车辆中 - **0** 驾驶位 - **1** 前排乘客位 @@ -42,7 +43,7 @@ public OnPlayerCommandText(playerid, cmdtext[]) new string[24]; - format(string, sizeof(string), "您的座位号：%i", playerSeat); + format(string, sizeof(string), "你的座位号：%i", playerSeat); SendClientMessage(playerid, 0xFFFFFFFF, string); return 1; } diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerVelocity.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerVelocity.md index 91896771d22..5b6c197f0a9 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerVelocity.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerVelocity.md @@ -9,7 +9,7 @@ tags: ["玩家"] 获取玩家在三维坐标系中的运动速度（X/Y/Z 轴分量） -| 名称 | 说明 | +| 参数 | 说明 | | -------- | ----------------------------------- | | playerid | 需要获取速度数据的玩家 ID | | &Float:x | 存储 X 轴速度的浮点变量（引用传递） | @@ -18,7 +18,7 @@ tags: ["玩家"] ## 返回值 -本函数不直接返回值，三维速度分量将存储于指定的浮点变量中 +此函数不直接返回值，三维速度分量将存储于指定的浮点变量中 ## 示例代码 @@ -33,7 +33,7 @@ public OnPlayerCommandText(playerid, cmdtext[]) GetPlayerVelocity(playerid, x, y, z); - format(string, sizeof(string), "您当前的运动速度：X轴 %.2f，Y轴 %.2f，Z轴 %.2f", x, y, z); + format(string, sizeof(string), "你当前的运动速度：X轴 %.2f，Y轴 %.2f，Z轴 %.2f", x, y, z); SendClientMessage(playerid, 0xFFFFFFFF, string); return 1; } diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerVersion.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerVersion.md index c61f0b52066..57b1355e0ed 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerVersion.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerVersion.md @@ -9,7 +9,7 @@ tags: ["玩家"] 获取玩家当前连接的 SA-MP 客户端版本信息 -| 名称 | 说明 | +| 参数 | 说明 | | ---------------------- | -------------------------------- | | playerid | 需要获取版本信息的玩家 ID | | version[] | 存储版本信息的字符串（引用传递） | @@ -28,9 +28,9 @@ public OnPlayerConnect(playerid) GetPlayerVersion(playerid, version, sizeof(version)); new string[64]; - format(string, sizeof(string), "您的SA-MP客户端版本：%s", version); + format(string, sizeof(string), "你的SA-MP客户端版本：%s", version); SendClientMessage(playerid, 0xFFFFFFFF, string); - // 可能显示："您的SA-MP客户端版本：0.3.7" + // 可能显示："你的SA-MP客户端版本：0.3.7" return 1; } ``` diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerVirtualWorld.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerVirtualWorld.md index 9ccc34250a7..acaba7b5a5f 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerVirtualWorld.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerVirtualWorld.md @@ -9,7 +9,7 @@ tags: ["玩家"] 获取玩家当前所在的虚拟世界编号 -| 名称 | 说明 | +| 参数 | 说明 | | -------- | ----------------------------- | | playerid | 需要获取虚拟世界信息的玩家 ID | @@ -25,7 +25,7 @@ public OnPlayerCommandText(playerid, cmdtext[]) if (!strcmp(cmdtext, "/world", true)) { new string[32]; - format(string, sizeof(string), "您所在的虚拟世界编号：%i", GetPlayerVirtualWorld(playerid)); + format(string, sizeof(string), "你所在的虚拟世界编号：%i", GetPlayerVirtualWorld(playerid)); SendClientMessage(playerid, 0xFFFFFFFF, string); return 1; } diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerWantedLevel.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerWantedLevel.md index 25aff504721..2c33c0b96f6 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerWantedLevel.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerWantedLevel.md @@ -9,7 +9,7 @@ tags: ["玩家"] 获取指定玩家的当前通缉等级（警星数量） -| 名称 | 说明 | +| 参数 | 说明 | | -------- | ------------------------- | | playerid | 需要获取通缉等级的玩家 ID | @@ -29,7 +29,7 @@ public OnPlayerCommandText(playerid, cmdtext[]) wantedLevel = GetPlayerWantedLevel(playerid), message[64]; - format(message, sizeof(message), "您当前的通缉等级为：%i 星", wantedLevel); + format(message, sizeof(message), "你当前的通缉等级为：%i 星", wantedLevel); SendClientMessage(playerid, 0xFF0000FF, message); return 1; diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerWeapon.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerWeapon.md index 534d1b8a31a..bec677302de 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerWeapon.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerWeapon.md @@ -9,7 +9,7 @@ tags: ["玩家"] 获取玩家当前手持武器的 ID 编号 -| 名称 | 说明 | +| 参数 | 说明 | | -------- | ------------------------- | | playerid | 需要获取武器信息的玩家 ID | @@ -40,7 +40,7 @@ public OnPlayerDeath(playerid, killerid, WEAPON:reason) :::tip -当玩家处于驾驶状态(`PLAYER_STATE_DRIVER`)或乘客状态(`PLAYER_STATE_PASSENGER`)时，本函数返回玩家进入车辆前持有的武器。若通过作弊手段在车辆内生成武器，本函数无法检测。 +当玩家处于驾驶状态(`PLAYER_STATE_DRIVER`)或乘客状态(`PLAYER_STATE_PASSENGER`)时，此函数返回玩家进入车辆前持有的武器。若通过作弊手段在车辆内生成武器，此函数无法检测。 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerWeaponData.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerWeaponData.md index 338707cdf44..cc67e07e22e 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerWeaponData.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerWeaponData.md @@ -9,7 +9,7 @@ tags: ["玩家"] 获取玩家特定武器槽（如'SMG'槽位）中的武器类型及剩余弹药量 -| 名称 | 说明 | +| 参数 | 说明 | | ---------------- | ------------------------------------------------------- | | playerid | 需要获取武器数据的玩家 ID | | WEAPON_SLOT:slot | [武器槽编号](../resources/weaponslots)（0-12） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerWeaponState.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerWeaponState.md index b2a11ed6de3..b3a8a39454f 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerWeaponState.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerWeaponState.md @@ -9,7 +9,7 @@ tags: ["玩家"] 获取指定玩家武器的当前状态信息 -| 名称 | 说明 | +| 参数 | 说明 | | -------- | ------------------------- | | playerid | 需要获取武器状态的玩家 ID | @@ -35,7 +35,7 @@ public OnPlayerCommandText(playerid, cmdtext[]) }; new string[144]; - format(string, sizeof(string), "您的武器状态：%s", weaponStates[_:state]); + format(string, sizeof(string), "你的武器状态：%s", weaponStates[_:state]); SendClientMessage(playerid, -1, string); return 1; } diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerWeather.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerWeather.md index 80f53ef2128..f20777e6a8b 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerWeather.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerWeather.md @@ -11,7 +11,7 @@ tags: ["玩家"] 获取指定玩家的天气 ID -| 名称 | 说明 | +| 参数 | 说明 | | -------- | ------------------------- | | playerid | 需要获取天气信息的玩家 ID | @@ -36,7 +36,3 @@ printf("玩家天气ID：%d", GetPlayerWeather(playerid)); ## 相关资源 - [天气 ID 列表](../resources/weatherid) - -``` - -``` diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerWorldBounds.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerWorldBounds.md index 728d34417f3..9e539ae8047 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerWorldBounds.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerWorldBounds.md @@ -11,7 +11,7 @@ tags: ["玩家"] 获取指定玩家的世界边界坐标范围 -| 名称 | 说明 | +| 参数 | 说明 | | ----------- | --------------------------------------- | | playerid | 需要获取边界信息的玩家 ID | | &Float:maxX | 存储 X 轴最大边界的浮点变量（引用传递） | @@ -21,7 +21,7 @@ tags: ["玩家"] ## 返回值 -本函数不直接返回值，边界坐标将存储于指定变量中 +此函数不直接返回值，边界坐标将存储于指定变量中 ## 示例代码 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerZAim.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerZAim.md index f0e724f4ce0..08d80dae870 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerZAim.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayerZAim.md @@ -11,7 +11,7 @@ tags: ["玩家"] 获取玩家的 Z 轴瞄准角度（与视角和瞄准机制相关） -| 名称 | 说明 | +| 参数 | 说明 | | -------- | ------------------------------ | | playerid | 需要获取 Z 轴瞄准角度的玩家 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayers.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayers.md index 8aa93331f95..91441309996 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayers.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetPlayers.md @@ -11,7 +11,7 @@ tags: ["玩家"] 获取当前服务器在线玩家的 ID 数组 -| 参数名 | 说明 | +| 参数 | 说明 | | --------- | ---------------------------------- | | players[] | 存储玩家 ID 的数组（通过引用传递） | | size | 数组的容量大小 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetRandomVehicleColourPair.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetRandomVehicleColourPair.md index f65dc44df57..6b31aad0a59 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetRandomVehicleColourPair.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetRandomVehicleColourPair.md @@ -13,7 +13,7 @@ tags: ["车辆"] ## 参数说明 -| 名称 | 说明 | +| 参数 | 说明 | | ------------ | -------------------------------------------- | | modelid | [车辆模型 ID](../resources/vehicleid) | | &colour1 | 存储主颜色索引的变量（引用传递） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetRunningTimers.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetRunningTimers.md index ecb3cc86f89..96b93cb4dae 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetRunningTimers.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetRunningTimers.md @@ -7,7 +7,7 @@ tags: [] :::warning -本函数已弃用，请使用[CountRunningTimers](CountRunningTimers) +此函数已弃用，请使用[CountRunningTimers](CountRunningTimers) ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetSVarFloat.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetSVarFloat.md index 4b6ae841193..1100f2a7efe 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetSVarFloat.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetSVarFloat.md @@ -2,7 +2,7 @@ title: GetSVarFloat sidebar_label: GetSVarFloat description: 获取浮点型服务器变量的值。 -tags: ["服务器变量", "svar"] +tags: ["服务器变量"] --- @@ -11,7 +11,7 @@ tags: ["服务器变量", "svar"] 获取浮点型服务器变量的值。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------ | ----------------------------------------------------------------------- | | const svar[] | 服务器变量名称（不区分大小写）
通过[SetSVarFloat](SetSVarFloat)设置 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetSVarInt.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetSVarInt.md index f4d1ce9998f..c100fa47e2e 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetSVarInt.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetSVarInt.md @@ -2,7 +2,7 @@ title: GetSVarInt sidebar_label: GetSVarInt description: 获取整型服务器变量的值。 -tags: ["服务器变量", "svar"] +tags: ["服务器变量"] --- @@ -11,7 +11,7 @@ tags: ["服务器变量", "svar"] 获取整型服务器变量的值。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------ | ------------------------------------------------------------------- | | const svar[] | 服务器变量名称（不区分大小写）
通过[SetSVarInt](SetSVarInt)设置 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetSVarNameAtIndex.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetSVarNameAtIndex.md index adb27395e54..c3b9e37fbd3 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetSVarNameAtIndex.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetSVarNameAtIndex.md @@ -2,14 +2,14 @@ title: GetSVarNameAtIndex sidebar_label: GetSVarNameAtIndex description: 通过索引获取服务器变量名称 -tags: ["服务器变量", "svar"] +tags: ["服务器变量"] --- ## 描述 通过索引获取服务器变量的名称 -| 参数名 | 说明 | +| 参数 | 说明 | | ---------------------- | -------------------------------- | | index | 服务器变量的索引值 | | output[] | 存储变量名的数组（通过引用传递） | @@ -17,7 +17,7 @@ tags: ["服务器变量", "svar"] ## 返回值 -本函数无特定返回值 +此函数不返回特定值。 ## 相关函数 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetSVarString.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetSVarString.md index b9cf7471db6..56ae466c312 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetSVarString.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetSVarString.md @@ -2,7 +2,7 @@ title: GetSVarString sidebar_label: GetSVarString description: 获取字符串型服务器变量的值。 -tags: ["服务器变量", "svar"] +tags: ["服务器变量"] --- @@ -11,7 +11,7 @@ tags: ["服务器变量", "svar"] 获取字符串型服务器变量的值。 -| 参数名 | 说明 | +| 参数 | 说明 | | --------------------- | ------------------------------------------------------------------------- | | const svar[] | 服务器变量名称（不区分大小写）
通过[SetSVarString](SetSVarString)设置 | | output[] | 存储字符串值的数组（通过引用传递） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetSVarType.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetSVarType.md index cf6582463fc..cd76bcdb537 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetSVarType.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetSVarType.md @@ -2,14 +2,14 @@ title: GetSVarType sidebar_label: GetSVarType description: 获取服务器变量的类型（整型/浮点型/字符串型） -tags: ["服务器变量", "svar"] +tags: ["服务器变量"] --- ## 描述 获取服务器变量的数据类型（整型、浮点型或字符串型） -| 参数名 | 说明 | +| 参数 | 说明 | | ------------ | -------------------------- | | const svar[] | 要获取类型的服务器变量名称 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetSVarsUpperIndex.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetSVarsUpperIndex.md index e3e7bc847aa..74a462bbda3 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetSVarsUpperIndex.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetSVarsUpperIndex.md @@ -1,13 +1,13 @@ --- title: GetSVarsUpperIndex sidebar_label: GetSVarsUpperIndex -description: 获取服务器变量的最大索引值（每个服务器变量都有唯一的标识号用于查找，本函数返回当前最大索引值）。 -tags: ["服务器变量", "svar"] +description: 获取服务器变量的最大索引值（每个服务器变量都有唯一的标识号用于查找，此函数返回当前最大索引值）。 +tags: ["服务器变量"] --- ## 描述 -每个服务器变量(SVar)都有唯一的标识号用于查找，本函数返回当前已存在的最大索引值。 +每个服务器变量(SVar)都有唯一的标识号用于查找，此函数返回当前已存在的最大索引值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetServerRuleFlags.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetServerRuleFlags.md index 43911e738ed..44909bff719 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetServerRuleFlags.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetServerRuleFlags.md @@ -9,7 +9,7 @@ tags: ["规则"] :::warning -本函数暂未实现，请勿在生产环境使用 +此函数暂未实现，请勿在生产环境使用 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetServerVarAsBool.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetServerVarAsBool.md index 345dd164b62..b6e0a3451b8 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetServerVarAsBool.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetServerVarAsBool.md @@ -7,7 +7,7 @@ tags: [] :::warning -本函数自 0.3.7 R2 版本起已弃用，请使用[GetConsoleVarAsBool](GetConsoleVarAsBool) +此函数自 0.3.7 R2 版本起已弃用，请使用[GetConsoleVarAsBool](GetConsoleVarAsBool) ::: @@ -15,7 +15,7 @@ tags: [] 获取服务器布尔型变量（true/false）的当前值 -| 名称 | 说明 | +| 参数 | 说明 | | --------------- | ------------------ | | const varname[] | 目标布尔型变量名称 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetServerVarAsInt.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetServerVarAsInt.md index 4cf56363f56..11d649d6484 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetServerVarAsInt.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetServerVarAsInt.md @@ -7,7 +7,7 @@ tags: [] :::warning -本函数自 0.3.7 R2 版本起已弃用，请使用[GetConsoleVarAsInt](GetConsoleVarAsInt) +此函数自 0.3.7 R2 版本起已弃用，请使用[GetConsoleVarAsInt](GetConsoleVarAsInt) ::: @@ -15,7 +15,7 @@ tags: [] 获取服务器整型变量的当前数值 -| 名称 | 说明 | +| 参数 | 说明 | | --------------- | ---------------- | | const varname[] | 目标整型变量名称 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetServerVarAsString.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetServerVarAsString.md index d96af971dd7..26cb668a706 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetServerVarAsString.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetServerVarAsString.md @@ -7,7 +7,7 @@ tags: [] :::warning -该函数自 0.3.7 R2 版本起已弃用，请使用 GetConsoleVarAsString +此函数自 0.3.7 R2 版本起已弃用，请使用 GetConsoleVarAsString ::: @@ -15,7 +15,7 @@ tags: [] 获取服务器变量的字符串值。 -| 参数名 | 说明 | +| 参数 | 说明 | | --------------- | -------------------------------- | | const varname[] | 要获取值的字符串变量名称 | | buffer[] | 用于存储值的数组（通过引用传递） | @@ -40,7 +40,7 @@ public OnGameModeInit() :::tip -当变量名为 filterscripts 或 plugins 时，本函数仅返回第一个滤镜脚本或插件的名称。这是一个已知缺陷。 +当变量名为 filterscripts 或 plugins 时，此函数仅返回第一个滤镜脚本或插件的名称。这是一个已知缺陷。 ::: @@ -52,7 +52,7 @@ public OnGameModeInit() :::warning -在非字符串类型变量（整型/布尔型/浮点型）或不存在变量上使用本函数将导致服务器崩溃！这是一个已知缺陷。 +在非字符串类型变量（整型/布尔型/浮点型）或不存在变量上使用此函数将导致服务器崩溃！这是一个已知缺陷。 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetSpawnInfo.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetSpawnInfo.md index 7e76408bc51..60edd87efa8 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetSpawnInfo.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetSpawnInfo.md @@ -11,7 +11,7 @@ tags: ["玩家"] 获取玩家的当前重生数据，即下一次重生的位置信息。 -| 参数名 | 说明 | +| 参数 | 说明 | | --------------- | -------------------------------------- | | playerid | 要获取重生信息的玩家 ID | | &team | 存储队伍 ID 的变量（通过引用传递） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetTickCount.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetTickCount.md index afa0e7a87c1..ac26d855a6c 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetTickCount.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetTickCount.md @@ -40,7 +40,7 @@ public OnPlayerCommandText(playerid, cmdtext[]) :::warning -`GetTickCount` 的有效差值范围约为 25 天（2147483647 毫秒）。只要事件间隔在此范围内，本函数能完美工作，但需注意整数溢出的情况： +`GetTickCount` 的有效差值范围约为 25 天（2147483647 毫秒）。只要事件间隔在此范围内，此函数能完美工作，但需注意整数溢出的情况： ```c new start = GetTickCount(); diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleCab.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleCab.md index 468da7b2f56..a71abca6da1 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleCab.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleCab.md @@ -11,7 +11,7 @@ tags: ["车辆"] 获取连接到车辆的驾驶室 ID -| 参数名 | 说明 | +| 参数 | 说明 | | --------- | --------------------- | | vehicleid | 要获取驾驶室的车辆 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleColours.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleColours.md index 98b71a9a2c4..c8ab5e10805 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleColours.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleColours.md @@ -13,7 +13,7 @@ tags: ["车辆"] ## 参数说明 -| 参数名 | 说明 | +| 参数 | 说明 | | --------- | -------------------------------- | | vehicleid | 目标车辆 ID | | &colour1 | 存储主色值的变量（通过引用传递） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleComponentInSlot.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleComponentInSlot.md index 64b164bed96..843a7bb910a 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleComponentInSlot.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleComponentInSlot.md @@ -9,7 +9,7 @@ tags: ["车辆"] 获取车辆在特定改装槽位中已安装的组件 ID（改装店改装部件）。 -| 参数名 | 说明 | +| 参数 | 说明 | | --------------- | --------------------------------------------------------------- | | vehicleid | 要检查改装组件的车辆 ID | | CARMODTYPE:slot | [改装槽位类型](../resources/componentslots)（需检查的组件槽位） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleComponentType.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleComponentType.md index bbf1cc9b518..b7121b227e7 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleComponentType.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleComponentType.md @@ -9,7 +9,7 @@ tags: ["车辆"] 根据组件 ID 获取其对应的改装槽位类型 -| 参数名 | 说明 | +| 参数 | 说明 | | --------- | --------------- | | component | 要检查的组件 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleDamageStatus.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleDamageStatus.md index 22ec65974d9..028cdd94459 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleDamageStatus.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleDamageStatus.md @@ -15,7 +15,7 @@ tags: ["车辆"] 获取车辆的损坏状态信息 -| 参数名 | 说明 | +| 参数 | 说明 | | --------------------------- | -------------------------------------- | | vehicleid | 要获取损坏状态的车辆 ID | | VEHICLE_PANEL_STATUS:panels | 存储面板损坏数据的变量（通过引用传递） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleDistanceFromPoint.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleDistanceFromPoint.md index 0307583ef0d..91de3384af1 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleDistanceFromPoint.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleDistanceFromPoint.md @@ -7,9 +7,9 @@ tags: ["车辆"] ## 描述 -本函数用于计算车辆与指定地图坐标点之间的距离（浮点型），适用于检测车辆与某位置的间距。 +此函数用于计算车辆与指定地图坐标点之间的距离（浮点型），适用于检测车辆与某位置的间距。 -| 参数名 | 说明 | +| 参数 | 说明 | | --------- | ------------------- | | vehicleid | 要计算距离的车辆 ID | | Float:x | 目标点的 X 坐标 | @@ -23,7 +23,7 @@ tags: ["车辆"] ## 示例 ```c -/* 当玩家在聊天框输入'vendingmachine'时触发此功能 */ +/* 当玩家在聊天框输入'vendingmachine'时触发此函数 */ public OnPlayerText(playerid, text[]) { if (strcmp(text, "vendingmachine", true) == 0) @@ -35,7 +35,7 @@ public OnPlayerText(playerid, text[]) new Float:distance = GetVehicleDistanceFromPoint(vehicleid, 237.9, 115.6, 1010.2); - format(string, sizeof(string), "您距离自动售货机还有%.2f米。", distance); + format(string, sizeof(string), "你距离自动售货机还有%.2f米。", distance); SendClientMessage(playerid, 0xA9C4E4FF, string); } return 0; diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleDriver.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleDriver.md index 6a7c5ded059..a0d1ab2f2f9 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleDriver.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleDriver.md @@ -13,7 +13,7 @@ tags: ["车辆"] ## 参数说明 -| 参数名 | 说明 | +| 参数 | 说明 | | --------- | --------------------- | | vehicleid | 要获取驾驶员的车辆 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleHealth.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleHealth.md index 540ef8f8cf4..7f32f105751 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleHealth.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleHealth.md @@ -9,7 +9,7 @@ tags: ["车辆"] 获取车辆的健康值 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------- | ------------------------------------ | | vehicleid | 要获取健康值的车辆 ID | | &Float:health | 存储健康值的浮点变量（通过引用传递） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleHydraReactorAngle.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleHydraReactorAngle.md index 2651d9916c0..b77a9b9d9e8 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleHydraReactorAngle.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleHydraReactorAngle.md @@ -13,7 +13,7 @@ tags: ["车辆"] ## 参数说明 -| 参数名 | 说明 | +| 参数 | 说明 | | --------- | ----------------- | | vehicleid | 目标九头蛇战机 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleInterior.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleInterior.md index 7839e47c431..c64983b2e47 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleInterior.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleInterior.md @@ -13,7 +13,7 @@ tags: ["车辆"] ## 参数 -| 参数名 | 说明 | +| 参数 | 说明 | | --------- | --------------- | | vehicleid | 目标车辆的 ID。 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleLandingGearState.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleLandingGearState.md index e99526831c4..6710d84e06c 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleLandingGearState.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleLandingGearState.md @@ -13,7 +13,7 @@ tags: ["车辆"] ## 参数 -| 参数名 | 说明 | +| 参数 | 说明 | | --------- | --------------- | | vehicleid | 目标飞机的 ID。 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleLastDriver.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleLastDriver.md index 36544ede800..a05eaa79a9f 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleLastDriver.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleLastDriver.md @@ -13,7 +13,7 @@ tags: ["车辆"] ## 参数 -| 参数名 | 说明 | +| 参数 | 说明 | | --------- | --------------- | | vehicleid | 目标车辆的 ID。 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleMatrix.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleMatrix.md index 5888648fae9..3bc57e91240 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleMatrix.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleMatrix.md @@ -13,7 +13,7 @@ tags: ["车辆"] ## 参数 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------- | ---------------------------------------------- | | vehicleid | 目标车辆的 ID。 | | &Float:rightX | 用于存储 rightX 坐标的浮点变量（通过引用传递） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleModel.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleModel.md index ca30906910b..d8e95d49284 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleModel.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleModel.md @@ -9,7 +9,7 @@ tags: ["车辆"] 获取指定车辆的模型 ID。 -| 参数名 | 说明 | +| 参数 | 说明 | | --------- | --------------------- | | vehicleid | 需要查询的目标车辆 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleModelInfo.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleModelInfo.md index 586b3b239bf..8a1f24908f3 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleModelInfo.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleModelInfo.md @@ -9,7 +9,7 @@ tags: ["车辆"] 获取特定车辆模型的详细信息，例如尺寸或座位位置 -| 参数名 | 说明 | +| 参数 | 说明 | | --------------------------- | ---------------------------------------------------------- | | vehiclemodel | 需要查询的车辆模型 ID | | VEHICLE_MODEL_INFO:infotype | 需要获取的[信息类型](../resources/vehicleinformationtypes) | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleNumberPlate.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleNumberPlate.md index 92fb3cf91bc..e424638333d 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleNumberPlate.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleNumberPlate.md @@ -13,7 +13,7 @@ tags: ["车辆"] ## 参数 -| 参数名 | 说明 | +| 参数 | 说明 | | -------------------- | ------------------------------------ | | vehicleid | 车辆 ID | | plate[] | 用于存储车牌号的数组，通过引用传递。 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleOccupiedTick.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleOccupiedTick.md index a8eb933e931..c718221e98a 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleOccupiedTick.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleOccupiedTick.md @@ -13,7 +13,7 @@ tags: ["车辆"] ## 参数 -| 参数名 | 说明 | +| 参数 | 说明 | | --------- | ------------------ | | vehicleid | 目标车辆的 ID 编号 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehiclePaintjob.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehiclePaintjob.md index e8a42e509ea..5cb727917f8 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehiclePaintjob.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehiclePaintjob.md @@ -13,7 +13,7 @@ tags: ["车辆"] ## 参数 -| 参数名 | 说明 | +| 参数 | 说明 | | --------- | ------------------ | | vehicleid | 目标车辆的 ID 编号 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleParamsCarDoors.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleParamsCarDoors.md index aa386f7911e..b127e1033d9 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleParamsCarDoors.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleParamsCarDoors.md @@ -11,7 +11,7 @@ tags: ["车辆"] 获取车辆各个车门的当前开启状态 -| 参数名 | 说明 | +| 参数 | 说明 | | ---------------- | -------------------------------------------------- | | vehicleid | 目标车辆 ID | | &bool:frontLeft | 用于存储驾驶员侧车门状态的整型变量（按引用传递） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleParamsCarWindows.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleParamsCarWindows.md index f0f8b68137a..3a99655496f 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleParamsCarWindows.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleParamsCarWindows.md @@ -11,7 +11,7 @@ tags: ["车辆"] 获取车辆各个车窗的当前开启状态 -| 参数名 | 说明 | +| 参数 | 说明 | | ---------------- | -------------------------------------------------- | | vehicleid | 目标车辆 ID | | &bool:frontLeft | 用于存储驾驶员侧车窗状态的整型变量（按引用传递） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleParamsEx.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleParamsEx.md index c8eb255a789..edc38b10d94 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleParamsEx.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleParamsEx.md @@ -9,7 +9,7 @@ tags: ["车辆"] 获取车辆的扩展参数集。 -| 参数名 | 说明 | +| 参数 | 说明 | | --------------- | -------------------------------------------------------------------- | | vehicleid | 目标车辆 ID | | &bool:engine | 存储引擎状态的布尔变量（按引用传递），1 表示引擎处于运行状态 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleParamsSirenState.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleParamsSirenState.md index de33964b4dc..5b16934c718 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleParamsSirenState.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleParamsSirenState.md @@ -1,7 +1,7 @@ --- title: GetVehicleParamsSirenState sidebar_label: GetVehicleParamsSirenState -description: 获取车辆警笛的开关状态。 +description: 获取车辆警报器的开关状态。 tags: ["车辆"] --- @@ -9,19 +9,19 @@ tags: ["车辆"] ## 描述 -获取车辆警笛的当前开关状态。 +获取车辆警报器的当前开关状态。 -| 参数名 | 说明 | -| --------- | ---------------------------- | -| vehicleid | 要检测警笛状态的车辆 ID 编号 | +| 参数 | 说明 | +| --------- | ------------------------------ | +| vehicleid | 要检测警报器状态的车辆 ID 编号 | ## 返回值 -**-1:** 车辆警笛尚未被设置（默认关闭状态） +**-1:** 车辆警报器尚未被设置（默认关闭状态） -**0:** 警笛处于关闭状态 +**0:** 警报器处于关闭状态 -**1:** 警笛处于开启状态 +**1:** 警报器处于开启状态 ## 示例 @@ -31,15 +31,15 @@ new if (siren == 1) { - // 警笛开启，执行相关操作 + // 警报器开启，执行相关操作 } else if (siren == 0) { - // 警笛关闭，执行相关操作 + // 警报器关闭，执行相关操作 } else { - // 该车辆未配置警笛系统 + // 该车辆未配置警报器系统 } ``` @@ -53,4 +53,4 @@ else ## 相关函数 -- [SetVehicleParamsSirenState](SetVehicleParamsSirenState): 控制车辆警笛的开关状态 +- [SetVehicleParamsSirenState](SetVehicleParamsSirenState): 控制车辆警报器的开关状态 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehiclePoolSize.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehiclePoolSize.md index ac4aefe46b1..50bf3fda2c7 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehiclePoolSize.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehiclePoolSize.md @@ -9,7 +9,7 @@ tags: ["车辆"] ## 描述 -获取服务器当前已使用的最大车辆 ID 编号。注意在 SA-MP 中该函数存在缺陷，即使没有车辆时也会返回`0`。open.mp 已修正此问题，无车辆时返回`-1`，但建议改用`MAX_VEHICLES`或`foreach`替代方案。 +获取服务器当前已使用的最大车辆 ID 编号。注意在 SA-MP 中此函数存在缺陷，即使没有车辆时也会返回`0`。open.mp 已修正此问题，无车辆时返回`-1`，但建议改用`MAX_VEHICLES`或`foreach`替代方案。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehiclePos.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehiclePos.md index 4bdcf1eafd5..822f4d06811 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehiclePos.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehiclePos.md @@ -9,7 +9,7 @@ tags: ["车辆"] 获取车辆的三维坐标位置。 -| 参数名 | 说明 | +| 参数 | 说明 | | --------- | --------------------------------------- | | vehicleid | 目标车辆 ID | | &Float:x | 存储 X 坐标的浮点型变量（通过引用传递） | @@ -34,7 +34,7 @@ public OnPlayerCommandText(playerid, cmdtext[]) // 检测玩家是否处于车辆内 if (vehicleid == 0) { - return SendClientMessage(playerid, -1, "您当前未处于任何车辆中！"); + return SendClientMessage(playerid, -1, "你当前未处于任何车辆中！"); } new diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleRespawnDelay.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleRespawnDelay.md index 1fa1b89685c..5ead4f4e19b 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleRespawnDelay.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleRespawnDelay.md @@ -13,7 +13,7 @@ tags: ["车辆"] ## 参数 -| 参数名 | 说明 | +| 参数 | 说明 | | --------- | ------------------ | | vehicleid | 目标车辆的 ID 编号 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleRespawnTick.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleRespawnTick.md index df96f58adf6..1f02deb4fb7 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleRespawnTick.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleRespawnTick.md @@ -13,7 +13,7 @@ tags: ["车辆"] ## 参数 -| 参数名 | 说明 | +| 参数 | 说明 | | --------- | ------------------ | | vehicleid | 目标车辆的 ID 编号 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleRotation.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleRotation.md new file mode 100644 index 00000000000..d728acc1ed4 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleRotation.md @@ -0,0 +1,51 @@ +--- +title: GetVehicleRotation +sidebar_label: GetVehicleRotation +description: 返回车辆的欧拉角旋转。 +tags: ["车辆"] +--- + +## 描述 + +返回车辆的欧拉角旋转。 + +| 参数 | 说明 | +| --------- | ------------------------------------------- | +| vehicleid | 要获取旋转的车辆的 ID。 | +| &Float:x | 用于存储 X 轴角度的浮点变量，通过引用传递。 | +| &Float:y | 用于存储 Y 轴角度的浮点变量，通过引用传递。 | +| &Float:z | 用于存储 Z 轴角度的浮点变量，通过引用传递。 | + +## 返回值 + +**true** - 函数执行成功。 + +**false** - 函数执行失败。这意味着指定的车辆不存在。 + +车辆的旋转存储在指定的变量中。 + +## 示例 + +```c +new + Float:x, + Float:y, + Float:z; + +GetVehicleRotation(vehicleid, x, y, z); +``` + +## 注意事项 + +:::tip + +- 此函数没有 'set' 变体；你无法设置车辆的旋转（除了 Z 角度） +- 对于无人乘坐的车辆，此函数可能返回不正确的值。原因是如果车辆在无人乘坐时更新，其内部旋转矩阵的第三行会损坏。 + +::: + +## 相关函数 + +- [GetVehicleZAngle](GetVehicleZAngle): 检查车辆的当前角度。 +- [GetVehicleRotationQuat](GetVehicleRotationQuat): 获取车辆的四元数旋转参数。 +- [GetVehicleMatrix](GetVehicleMatrix): 获取车辆的实际旋转矩阵。 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleRotationQuat.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleRotationQuat.md index 31c1166b4c2..22510e1ff84 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleRotationQuat.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleRotationQuat.md @@ -9,7 +9,7 @@ tags: ["车辆"] 获取车辆基于四元数（Quaternion）的三维旋转参数。 -| 参数名 | 说明 | +| 参数 | 说明 | | --------- | --------------------------------------------- | | vehicleid | 目标车辆 ID | | &Float:w | 存储四元数 w 分量的浮点型变量（通过引用传递） | @@ -41,8 +41,8 @@ GetVehicleRotationQuat(vehicleid, w, x, y, z); :::tip -- 本函数没有对应的设置方法（只能通过 SetVehicleZAngle 设置 Z 轴角度） -- 对于无人驾驶的车辆，本函数可能返回不准确数值。原因是当车辆未被占用时，其内部旋转矩阵的第三行数据可能损坏 +- 此函数没有对应的设置方法（只能通过 SetVehicleZAngle 设置 Z 轴角度） +- 对于无人驾驶的车辆，此函数可能返回不准确数值。原因是当车辆未被占用时，其内部旋转矩阵的第三行数据可能损坏 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleSirenState.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleSirenState.md index e6f8c5d8405..f4acadb51aa 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleSirenState.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleSirenState.md @@ -1,7 +1,7 @@ --- title: GetVehicleSirenState sidebar_label: GetVehicleSirenState -description: 获取车辆的警笛开关状态。 +description: 获取车辆的警报器开关状态。 tags: ["车辆"] --- @@ -9,17 +9,17 @@ tags: ["车辆"] ## 描述 -获取车辆当前警笛的启用状态。 +获取车辆当前警报器的启用状态。 ## 参数 -| 参数名 | 说明 | +| 参数 | 说明 | | --------- | ------------------ | | vehicleid | 目标车辆的 ID 编号 | ## 返回值 -返回布尔值表示警笛状态：**true** 开启 / **false** 关闭 +返回布尔值表示警报器状态：**true** 开启 / **false** 关闭 ## 示例 @@ -28,14 +28,14 @@ public OnPlayerEnterVehicle(playerid, vehicleid, ispassenger) { new bool:sirenState = GetVehicleSirenState(vehicleid); - SendClientMessage(playerid, 0xFFFF00FF, "警笛状态: %s", sirenState ? "开启" : "关闭"); + SendClientMessage(playerid, 0xFFFF00FF, "警报器状态: %s", sirenState ? "开启" : "关闭"); return 1; } ``` ## 相关函数 -- [SetVehicleParamsSirenState](SetVehicleParamsSirenState): 设置车辆警笛的开关状态 -- [ToggleVehicleSirenEnabled](ToggleVehicleSirenEnabled): 切换车辆警笛的启用状态 -- [IsVehicleSirenEnabled](IsVehicleSirenEnabled): 检测车辆警笛是否处于开启状态 -- [GetPlayerSirenState](GetPlayerSirenState): 获取玩家当前车辆的警笛状态 +- [SetVehicleParamsSirenState](SetVehicleParamsSirenState): 设置车辆警报器的开关状态 +- [ToggleVehicleSirenEnabled](ToggleVehicleSirenEnabled): 切换车辆警报器的启用状态 +- [IsVehicleSirenEnabled](IsVehicleSirenEnabled): 检测车辆警报器是否处于开启状态 +- [GetPlayerSirenState](GetPlayerSirenState): 获取玩家当前车辆的警报器状态 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleSpawnInfo.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleSpawnInfo.md index b24d959589b..06e0da3f4c3 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleSpawnInfo.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleSpawnInfo.md @@ -13,7 +13,7 @@ tags: ["车辆"] ## 参数 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------- | ----------------------------------------- | | vehicleid | 目标车辆 ID | | &Float:spawnX | 存储重生点 X 坐标的浮点变量（按引用传递） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleTower.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleTower.md index c9dde48fa09..b7a3a7f7700 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleTower.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleTower.md @@ -7,7 +7,7 @@ tags: ["车辆"] :::warning -该函数已弃用，请使用[获取车辆驾驶室](GetVehicleCab)函数替代。 +此函数已弃用，请使用[GetVehicleCab](GetVehicleCab)。 ::: @@ -15,7 +15,7 @@ tags: ["车辆"] 获取与车辆连接的驾驶室单元 ID。 -| 参数名 | 说明 | +| 参数 | 说明 | | --------- | --------------------------- | | vehicleid | 需要查询驾驶室的目标车辆 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleTrailer.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleTrailer.md index 9e80941fb49..48a2c40df07 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleTrailer.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleTrailer.md @@ -9,7 +9,7 @@ tags: ["车辆"] 获取与当前车辆连接的拖车单元 ID。 -| 参数名 | 说明 | +| 参数 | 说明 | | --------- | ----------------------------- | | vehicleid | 需要查询拖车连接的目标车辆 ID | @@ -29,7 +29,7 @@ DetachTrailerFromVehicle(trailerId); :::warning -该函数不适用于火车类轨道车辆 +此函数不适用于火车类轨道车辆 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleTrainSpeed.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleTrainSpeed.md index 6e10838facc..a1f1b54b532 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleTrainSpeed.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleTrainSpeed.md @@ -13,7 +13,7 @@ tags: ["车辆"] ## 参数 -| 参数名 | 说明 | +| 参数 | 说明 | | --------- | ---------------------- | | vehicleid | 目标列车车辆的 ID 编号 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleVelocity.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleVelocity.md index 9046c2ffcf7..9136a306423 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleVelocity.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleVelocity.md @@ -9,7 +9,7 @@ tags: ["车辆"] 获取车辆在三维空间中的运动速度分量。 -| 参数名 | 说明 | +| 参数 | 说明 | | --------- | ------------------------------------------- | | vehicleid | 目标车辆 ID | | &Float:x | 存储 X 轴速度分量的浮点变量（通过引用传递） | @@ -54,7 +54,7 @@ public OnPlayerCommandText(playerid, cmdtext[]) :::tip -本函数可配合公式计算车辆的实际移动速度（单位：千米/小时 或 米/秒） +此函数可配合公式计算车辆的实际移动速度（单位：千米/小时 或 米/秒） ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleVirtualWorld.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleVirtualWorld.md index a4a8d229f77..9367abf2151 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleVirtualWorld.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleVirtualWorld.md @@ -9,7 +9,7 @@ tags: ["车辆"] 获取车辆当前所处的虚拟世界编号。 -| 参数名 | 说明 | +| 参数 | 说明 | | --------- | ------------------ | | vehicleid | 目标车辆的 ID 编号 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleZAngle.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleZAngle.md index 6e9ec9128d9..37a98ae3bc9 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleZAngle.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicleZAngle.md @@ -9,7 +9,7 @@ tags: ["车辆"] 获取车辆在 Z 轴（偏航角）的水平旋转角度。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------ | ------------------------------------------- | | vehicleid | 目标车辆 ID | | &Float:angle | 存储 Z 轴旋转角度的浮点变量（通过引用传递） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicles.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicles.md index fb0e048209f..59c3ecfad81 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicles.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetVehicles.md @@ -11,7 +11,7 @@ tags: ["车辆"] 获取服务器上所有已生成车辆的 ID 数组变量。 -| 参数名 | 说明 | +| 参数 | 说明 | | ---------- | -------------------------------------- | | vehicles[] | 用于存储车辆 ID 的数组（通过引用传递） | | size | 目标数组的容量大小 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetWeaponName.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetWeaponName.md index d43ddcf42ba..147dcd41c90 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetWeaponName.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetWeaponName.md @@ -9,7 +9,7 @@ tags: [] 获取指定武器的名称。 -| 参数名 | 说明 | +| 参数 | 说明 | | --------------------- | ----------------------------------------------------- | | WEAPON:weaponid | 武器的 ID 编号 | | weapon[] | 存储武器名称的数组（按引用传递） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetWeaponSlot.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetWeaponSlot.md index b02bae1be45..b310d414e4d 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetWeaponSlot.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetWeaponSlot.md @@ -5,13 +5,13 @@ description: 获取武器的槽位编号。 tags: ["武器"] --- - + ## 描述 获取指定武器对应的槽位编号。 -| 参数名 | 说明 | +| 参数 | 说明 | | --------------- | ------------------ | | WEAPON:weaponid | 目标武器的 ID 编号 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetWorldTime.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetWorldTime.md index a3fc29710da..7fa5e38f707 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetWorldTime.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GetWorldTime.md @@ -22,5 +22,5 @@ printf("当前世界时间：%d", GetWorldTime()); ## 相关函数 -- [SetWorldTime](SetWorldTime): 为所有玩家设置全局时间（精确到小时） +- [SetWorldTime](SetWorldTime): 为所有玩家设置世界时间（精确到小时） - [SetPlayerTime](SetPlayerTime): 设置玩家独立时间显示 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GivePlayerMoney.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GivePlayerMoney.md index 3ceaa47c24a..79dafe17ece 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GivePlayerMoney.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GivePlayerMoney.md @@ -29,7 +29,7 @@ public OnPlayerDeath(playerid, killerid, WEAPON:reason) { // 给予击杀者1000美元奖励 GivePlayerMoney(killerid, 1000); - SendClientMessage(killerid, -1, "您因击杀获得1000美元奖励"); + SendClientMessage(killerid, -1, "你因击杀获得1000美元奖励"); } // 扣除死亡玩家500美元 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GivePlayerWeapon.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GivePlayerWeapon.md index 0c3d5749881..1ce986a8389 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GivePlayerWeapon.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/GivePlayerWeapon.md @@ -9,7 +9,7 @@ tags: ["玩家"] 为玩家添加指定武器及相应数量的弹药。 -| 参数名 | 说明 | +| 参数 | 说明 | | --------------- | ----------------------------------------- | | playerid | 目标玩家的 ID 编号 | | WEAPON:weaponid | 要给予的[武器 ID](../resources/weaponids) | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/HTTP.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/HTTP.md index f774780f575..41e7a95af28 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/HTTP.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/HTTP.md @@ -75,7 +75,7 @@ public MyHttpResponse(index, response_code, data[]) :::tip -除了上述错误代码，本函数也支持标准 HTTP 状态码，例如 404（页面未找到）、500（服务器错误）和 403（禁止访问） +除了上述错误代码，此函数也支持标准 HTTP 状态码，例如 404（页面未找到）、500（服务器错误）和 403（禁止访问） ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/HasVehicleBeenOccupied.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/HasVehicleBeenOccupied.md index a92c3b5f91a..cf18b42895b 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/HasVehicleBeenOccupied.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/HasVehicleBeenOccupied.md @@ -13,7 +13,7 @@ tags: ["车辆"] ## 参数 -| 参数名 | 说明 | +| 参数 | 说明 | | --------- | ------------------ | | vehicleid | 目标车辆的 ID 编号 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/HideGameTextForAll.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/HideGameTextForAll.md index 26589477da5..c567471b341 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/HideGameTextForAll.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/HideGameTextForAll.md @@ -17,7 +17,7 @@ tags: ["玩家", "游戏文本"] ## 返回值 -此函数没有返回值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/HideGameTextForPlayer.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/HideGameTextForPlayer.md index f760255bb4f..e2220a003d0 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/HideGameTextForPlayer.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/HideGameTextForPlayer.md @@ -18,7 +18,7 @@ tags: ["玩家", "游戏文本"] ## 返回值 -本函数不返回任何特定值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/HideMenuForPlayer.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/HideMenuForPlayer.md index 3cb0355f2c8..2b911e7d186 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/HideMenuForPlayer.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/HideMenuForPlayer.md @@ -45,7 +45,7 @@ public OnPlayerCommandText(playerid, cmdtext[]) :::tip -该函数始终需要菜单 ID 参数，但在 SA:MP 中该参数未被实际使用。无论传入任何值，都会关闭玩家当前正在查看的菜单。 +此函数始终需要菜单 ID 参数，但在 SA:MP 中该参数未被实际使用。无论传入任何值，都会关闭玩家当前正在查看的菜单。 旧代码可能如下所示： @@ -55,7 +55,7 @@ gShopMenu = CreateMenu("text", 2, 100.0, 30.0, 7.0); HideMenuForPlayer(gShopMenu, playerid); ``` -这种写法会始终关闭玩家当前查看的菜单，无论实际显示的是哪个菜单。现在您需要记录玩家当前查看的菜单，或直接获取： +这种写法会始终关闭玩家当前查看的菜单，无论实际显示的是哪个菜单。现在你需要记录玩家当前查看的菜单，或直接获取： ```c gShopMenu = CreateMenu("text", 2, 100.0, 30.0, 7.0); diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/HidePickupForPlayer.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/HidePickupForPlayer.md index 2e50f9d192f..bb6efda97fb 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/HidePickupForPlayer.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/HidePickupForPlayer.md @@ -18,7 +18,7 @@ tags: ["玩家", "拾取物"] ## 返回值 -本函数始终返回 **true**。 +此函数始终返回 **true**。 ## 示例 @@ -44,7 +44,7 @@ public OnPlayerSpawn(playerid) - [AddStaticPickup](AddStaticPickup): 添加静态拾取物 - [DestroyPickup](DestroyPickup): 销毁拾取物 - [IsValidPickup](IsValidPickup): 检查拾取物是否有效 -- [IsPickupStreamedIn](IsPickupStreamedIn): 检查拾取物是否已为玩家流式加载 +- [IsPickupStreamedIn](IsPickupStreamedIn): 检查拾取物是否已为玩家流加载 - [IsPickupHiddenForPlayer](IsPickupHiddenForPlayer): 检查拾取物是否对玩家隐藏 - [SetPickupPos](SetPickupPos): 设置拾取物坐标 - [GetPickupPos](GetPickupPos): 获取拾取物坐标 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/HidePlayerDialog.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/HidePlayerDialog.md index 751747ca835..1ca48519499 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/HidePlayerDialog.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/HidePlayerDialog.md @@ -35,7 +35,7 @@ public OnPlayerConnect(playerid) if (IsBanned(ipAddress)) // 检查IP是否被封禁 { - SendClientMessage(playerid, 0xFF0000FF, "您已被封禁！"); + SendClientMessage(playerid, 0xFF0000FF, "你已被封禁！"); HidePlayerDialog(playerid); // 隐藏登录对话框 } } diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/HideVehicle.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/HideVehicle.md index a138c5ee0c0..ac74454913e 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/HideVehicle.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/HideVehicle.md @@ -9,7 +9,7 @@ tags: ["车辆"] :::warning -此功能尚未实现 +此函数尚未实现 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/InterpolateCameraLookAt.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/InterpolateCameraLookAt.md index abec75181bb..50f7e8519ed 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/InterpolateCameraLookAt.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/InterpolateCameraLookAt.md @@ -23,7 +23,7 @@ tags: ["玩家", "插值过渡"] ## 返回值 -本函数不返回特定值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/InterpolateCameraPos.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/InterpolateCameraPos.md index 7fd5a3dbe6e..702eb10816f 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/InterpolateCameraPos.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/InterpolateCameraPos.md @@ -23,7 +23,7 @@ tags: ["玩家", "插值过渡"] ## 返回值 -本函数不返回特定值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPickupHiddenForPlayer.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPickupHiddenForPlayer.md index c5ce10b7fd4..b357ecf0f17 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPickupHiddenForPlayer.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPickupHiddenForPlayer.md @@ -50,7 +50,7 @@ public OnPlayerSpawn(playerid) - [AddStaticPickup](AddStaticPickup): 添加静态拾取物 - [DestroyPickup](DestroyPickup): 销毁拾取物 - [IsValidPickup](IsValidPickup): 验证拾取物有效性 -- [IsPickupStreamedIn](IsPickupStreamedIn): 检查拾取物是否流式加载 +- [IsPickupStreamedIn](IsPickupStreamedIn): 检查拾取物是否流加载 - [SetPickupPos](SetPickupPos): 设置拾取物坐标 - [GetPickupPos](GetPickupPos): 获取拾取物坐标 - [SetPickupModel](SetPickupModel): 设置拾取物显示模型 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPickupStreamedIn.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPickupStreamedIn.md index d15748e0d40..12790eb5914 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPickupStreamedIn.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPickupStreamedIn.md @@ -1,7 +1,7 @@ --- title: IsPickupStreamedIn sidebar_label: IsPickupStreamedIn -description: 检查指定拾取物是否已为玩家流式加载 +description: 检查指定拾取物是否已为玩家流加载 tags: ["玩家", "拾取物"] --- @@ -9,7 +9,7 @@ tags: ["玩家", "拾取物"] ## 描述 -检测特定拾取物是否已完成对玩家的流式加载过程。 +检测特定拾取物是否已完成对玩家的流加载过程。 | 参数 | 说明 | | -------- | ------------------- | @@ -18,7 +18,7 @@ tags: ["玩家", "拾取物"] ## 返回值 -**true** - 拾取物已完成流式加载 +**true** - 拾取物已完成流加载 **false** - 未完成加载或拾取物不存在 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPlayerAttachedObjectSlotUsed.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPlayerAttachedObjectSlotUsed.md index 1a3540d345d..6cd8e893df8 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPlayerAttachedObjectSlotUsed.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPlayerAttachedObjectSlotUsed.md @@ -2,7 +2,7 @@ title: IsPlayerAttachedObjectSlotUsed sidebar_label: IsPlayerAttachedObjectSlotUsed description: 检查玩家是否在指定索引槽位附加了物体 -tags: ["玩家", "物体", "附加物"] +tags: ["玩家", "物体", "附加"] --- ## 描述 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPlayerConnected.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPlayerConnected.md index 4e38510b062..5a8a4bf394e 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPlayerConnected.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPlayerConnected.md @@ -38,7 +38,7 @@ KillPlayer(playerid) :::tip -许多其他函数已内置连接状态检查，实际开发中可酌情省略本函数调用 +许多其他函数已内置连接状态检查，实际开发中可酌情省略此函数调用 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPlayerGangZoneFlashing.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPlayerGangZoneFlashing.md index c10ac8bf87a..89871f53430 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPlayerGangZoneFlashing.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPlayerGangZoneFlashing.md @@ -2,7 +2,7 @@ title: IsPlayerGangZoneFlashing sidebar_label: IsPlayerGangZoneFlashing description: 检查玩家的私人帮派区域是否处于闪烁状态 -tags: ["玩家", "帮派区域", "私人帮派区域"] +tags: ["玩家", "帮派区域", "玩家帮派区域"] --- diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPlayerInCheckpoint.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPlayerInCheckpoint.md index 36b4f3c9a33..99d197da807 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPlayerInCheckpoint.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPlayerInCheckpoint.md @@ -7,7 +7,7 @@ tags: ["玩家", "检查点"] ## 描述 -检测玩家当前是否处于检查点范围内，该功能常用于房产系统或传送点等交互场景 +检测玩家当前是否处于检查点范围内，此函数常用于房产系统或传送点等交互场景 | 参数名 | 说明 | | -------- | ----------------- | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPlayerInGangZone.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPlayerInGangZone.md index 2dc74cf6a9a..be5b8f20e3d 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPlayerInGangZone.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPlayerInGangZone.md @@ -26,7 +26,7 @@ tags: ["玩家", "帮派区域"] :::warning -本函数仅适用于 open.mp 平台，SA-MP 需使用[YSF 插件](https://github.com/IS4Code/YSF/releases) +此函数仅适用于 open.mp 平台，SA-MP 需使用[YSF 插件](https://github.com/IS4Code/YSF/releases) ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPlayerInModShop.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPlayerInModShop.md index dd295079a09..2c9618fbd3a 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPlayerInModShop.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPlayerInModShop.md @@ -38,13 +38,13 @@ else ## 相关函数 -下列函数可能对本功能有参考价值，因存在关联性： +下列函数可能对此函数有参考价值，因存在关联性： - [AddVehicleComponent](AddVehicleComponent): 为车辆添加改装组件 ## 相关回调 -下列回调可能与本功能相关，建议配合使用： +下列回调可能与此函数相关，建议配合使用： - [OnVehicleMod](../callbacks/OnVehicleMod): 当车辆被改装时触发 - [OnVehicleRespray](../callbacks/OnVehicleRespray): 当玩家离开改装店时触发（即使未更改颜色） diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPlayerInPlayerGangZone.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPlayerInPlayerGangZone.md index ae8df0155c0..3ddf172ed46 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPlayerInPlayerGangZone.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPlayerInPlayerGangZone.md @@ -40,11 +40,11 @@ public OnPlayerCommandText(playerid, cmdtext[]) { if (IsPlayerInPlayerGangZone(playerid, gGangZoneID[playerid])) { - SendClientMessage(playerid, 0x00FF00FF, "您正处于专属帮派领地"); + SendClientMessage(playerid, 0x00FF00FF, "你正处于专属帮派领地"); } else { - SendClientMessage(playerid, 0xFF0000FF, "您未处于专属帮派领地"); + SendClientMessage(playerid, 0xFF0000FF, "你未处于专属帮派领地"); } return 1; } diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPlayerInRangeOfPoint.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPlayerInRangeOfPoint.md index 9c20d1123cd..6d3c31645f3 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPlayerInRangeOfPoint.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPlayerInRangeOfPoint.md @@ -9,7 +9,7 @@ tags: ["玩家"] 快速检测玩家是否处于三维坐标点范围内（原生函数性能优于 PAWN 的距离公式计算） -| 参数名 | 说明 | +| 参数 | 说明 | | ----------- | -------------------------------------- | | playerid | 目标玩家 ID | | Float:range | 检测半径（最大有效距离，使用浮点数值） | @@ -32,7 +32,7 @@ public OnPlayerCommandText(playerid, cmdtext[]) { if (IsPlayerInRangeOfPoint(playerid, 7.0, 2695.6880, -1704.6300, 11.8438)) { - SendClientMessage(playerid, 0xFFFFFFFF, "您位于体育馆入口区域！"); + SendClientMessage(playerid, 0xFFFFFFFF, "你位于体育馆入口区域！"); } return 1; } diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPlayerInVehicle.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPlayerInVehicle.md index 07164948c76..dd11f6ca610 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPlayerInVehicle.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPlayerInVehicle.md @@ -9,7 +9,7 @@ tags: ["玩家", "车辆"] 检测玩家当前是否乘坐于指定车辆实例内 -| 参数名 | 说明 | +| 参数 | 说明 | | --------- | ------------------------------------ | | playerid | 目标玩家 ID | | vehicleid | 车辆实例 ID（注意：非车辆模型 ID！） | @@ -37,7 +37,7 @@ public OnPlayerCommandText(playerid, cmdtext[]) { if (IsPlayerInVehicle(playerid, gSpecialCar)) { - SendClientMessage(playerid, -1, "您正在特殊车辆中！"); + SendClientMessage(playerid, -1, "你正在特殊车辆中！"); } return 1; } diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPlayerNPC.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPlayerNPC.md index 1451efb6c86..9d5a94de3b1 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPlayerNPC.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPlayerNPC.md @@ -2,7 +2,7 @@ title: IsPlayerNPC sidebar_label: IsPlayerNPC description: 验证玩家身份是否为非玩家角色（NPC） -tags: ["玩家", "非玩家角色"] +tags: ["玩家", "npc"] --- ## 描述 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPlayerObjectMaterialSlotUsed.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPlayerObjectMaterialSlotUsed.md index ff95df76304..4744bd084ff 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPlayerObjectMaterialSlotUsed.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPlayerObjectMaterialSlotUsed.md @@ -11,7 +11,7 @@ tags: ["玩家", "物体", "玩家物体"] 检测指定玩家物体的材质槽位使用状态 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------- | ------------------------------- | | playerid | 目标玩家 ID | | objectid | 玩家物体 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPlayerStreamedIn.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPlayerStreamedIn.md index 5f7fc3850af..2bd8be37c51 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPlayerStreamedIn.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPlayerStreamedIn.md @@ -9,7 +9,7 @@ tags: ["玩家"] 检测指定玩家是否在目标玩家的客户端中完成流加载。 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------- | ------------------------------- | | playerid | 被检测的玩家 ID | | forplayerid | 目标玩家 ID（检测的客户端主体） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPlayerTextDrawVisible.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPlayerTextDrawVisible.md index 97a242624a3..ad47805f2f2 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPlayerTextDrawVisible.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPlayerTextDrawVisible.md @@ -11,7 +11,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] 检测指定玩家的专属文本绘图是否处于显示状态。 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------------- | ----------------- | | playerid | 要检测的玩家 ID | | PlayerText:textid | 玩家文本绘图的 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPlayerUsingOfficialClient.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPlayerUsingOfficialClient.md index bd1d86f44f2..f50cf58d75d 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPlayerUsingOfficialClient.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPlayerUsingOfficialClient.md @@ -26,7 +26,7 @@ public OnPlayerConnect(playerid) { if (IsPlayerUsingOfficialClient(playerid) == 0) { - SendClientMessage(playerid, 0xFF0000FF, "[踢出]: 检测到您未使用官方SA-MP客户端！"); + SendClientMessage(playerid, 0xFF0000FF, "[踢出]: 检测到你未使用官方SA-MP客户端！"); Kick(playerid); } diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPlayerUsingOmp.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPlayerUsingOmp.md index a5ec941c53e..6763b5f929b 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPlayerUsingOmp.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsPlayerUsingOmp.md @@ -27,13 +27,13 @@ public OnPlayerConnect(playerid) // 玩家正在使用open.mp启动器 if(IsPlayerUsingOmp(playerid)) { - SendClientMessage(playerid, -1, "您正在使用open.mp启动器。"); + SendClientMessage(playerid, -1, "你正在使用open.mp启动器。"); } // 玩家未使用open.mp启动器 else { - SendClientMessage(playerid, 0xFF0000FF, "[踢出]: 检测到您未使用open.mp启动器"); + SendClientMessage(playerid, 0xFF0000FF, "[踢出]: 检测到你未使用open.mp启动器"); Kick(playerid); } diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsTextDrawVisibleForPlayer.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsTextDrawVisibleForPlayer.md index 254eecdd741..b5a7e48b2ba 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsTextDrawVisibleForPlayer.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsTextDrawVisibleForPlayer.md @@ -11,7 +11,7 @@ tags: ["文本绘图"] 检测指定玩家的全局文本绘图是否处于显示状态。 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------- | ------------------- | | playerid | 要检测的玩家 ID | | Text:textid | 要检测的文本绘图 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsTrailerAttachedToVehicle.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsTrailerAttachedToVehicle.md index d68ad21936a..d582e17bc0e 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsTrailerAttachedToVehicle.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsTrailerAttachedToVehicle.md @@ -9,7 +9,7 @@ tags: ["车辆"] 检测指定车辆是否连接有拖车。可通过[GetVehicleTrailer](GetVehicleTrailer)获取拖车 ID（若存在）。 -| 参数名 | 说明 | +| 参数 | 说明 | | --------- | --------------- | | vehicleid | 要检测的车辆 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsValid3DTextLabel.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsValid3DTextLabel.md index 2d13f692b43..f8f29b1ba0b 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsValid3DTextLabel.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsValid3DTextLabel.md @@ -11,7 +11,7 @@ tags: ["3D文本标签"] 检测指定的全局 3D 文本标签是否有效。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------- | ----------------------- | | Text3D:textid | 要检测的 3D 文本标签 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsValidAnimationLibrary.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsValidAnimationLibrary.md index 6b906214a28..fca9f02fe19 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsValidAnimationLibrary.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsValidAnimationLibrary.md @@ -11,7 +11,7 @@ tags: ["动画"] 检测给定动画库名称是否有效。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------ | ------------------ | | const name[] | 待检测的动画库名称 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsValidMenu.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsValidMenu.md index 5a871ff2e73..de97f4f7ede 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsValidMenu.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsValidMenu.md @@ -9,7 +9,7 @@ tags: ["菜单"] 检测指定菜单 ID 是否有效。 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------- | --------------- | | Menu:menuid | 要检测的菜单 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsValidNickName.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsValidNickName.md index 00a3db164f8..dc230dbc8d7 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsValidNickName.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsValidNickName.md @@ -11,7 +11,7 @@ tags: [] 检测指定昵称字符串是否符合服务器命名规则。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------ | ------------------ | | const name[] | 待检测的昵称字符串 | @@ -28,7 +28,7 @@ if (IsValidNickName("Barnaby_Keene")) } else { - SendClientMessage(playerid, 0xFF0000FF, "您的昵称不符合规范。"); + SendClientMessage(playerid, 0xFF0000FF, "你的昵称不符合规范。"); } ``` diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsValidObject.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsValidObject.md index df7a1fcece9..f9ec118b98e 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsValidObject.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsValidObject.md @@ -44,7 +44,7 @@ public OnGameModeExit() :::warning -本函数仅检测物体实例是否存在，不验证模型 ID 是否有效 +此函数仅检测物体实例是否存在，不验证模型 ID 是否有效 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsValidPlayer3DTextLabel.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsValidPlayer3DTextLabel.md index e73b807f6cf..48c356215d6 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsValidPlayer3DTextLabel.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsValidPlayer3DTextLabel.md @@ -11,7 +11,7 @@ tags: ["玩家", "3D文本标签"] 检测指定玩家的专属 3D 文本标签是否有效。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------------- | --------------------- | | playerid | 要检测的玩家 ID | | PlayerText3D:textid | 玩家的 3D 文本标签 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsValidPlayerTextDraw.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsValidPlayerTextDraw.md index 4c4faa125b2..7a5ac1b4d14 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsValidPlayerTextDraw.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsValidPlayerTextDraw.md @@ -13,7 +13,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] ## 参数说明 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------------- | ----------------- | | playerid | 要检测的玩家 ID | | PlayerText:textid | 玩家的文本绘图 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsValidServerRule.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsValidServerRule.md index 498d389ebae..f9a558bf741 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsValidServerRule.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsValidServerRule.md @@ -2,7 +2,7 @@ title: IsValidServerRule sidebar_label: IsValidServerRule description: 检测服务器规则有效性 -tags: ["服务器规则"] +tags: ["规则"] --- @@ -11,7 +11,7 @@ tags: ["服务器规则"] 检测指定服务器规则是否有效。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------ | ---------------------- | | const rule[] | 待检测的服务器规则名称 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsValidTextDraw.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsValidTextDraw.md index 7a134d4d302..86fa9b7e2d4 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsValidTextDraw.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsValidTextDraw.md @@ -13,7 +13,7 @@ tags: ["文本绘图"] ## 参数说明 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------- | ------------------- | | Text:textid | 要检测的文本绘图 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsValidVehicle.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsValidVehicle.md index 3f1700ed2e6..5b6b768c447 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsValidVehicle.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsValidVehicle.md @@ -17,7 +17,7 @@ tags: ["车辆"] ## 参数说明 -| 参数名 | 说明 | +| 参数 | 说明 | | --------- | --------------- | | vehicleid | 要检测的车辆 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsVehicleDead.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsVehicleDead.md index 9c9b2950422..130a6bd1637 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsVehicleDead.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsVehicleDead.md @@ -13,7 +13,7 @@ tags: ["车辆"] ## 参数说明 -| 参数名 | 说明 | +| 参数 | 说明 | | --------- | --------------- | | vehicleid | 要检测的车辆 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsVehicleHidden.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsVehicleHidden.md index 005fa0a0835..9d3d467c96b 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsVehicleHidden.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsVehicleHidden.md @@ -9,7 +9,7 @@ tags: ["车辆"] :::warning -该函数当前尚未实现 +此函数当前尚未实现 ::: @@ -19,7 +19,7 @@ tags: ["车辆"] ## 参数说明 -| 参数名 | 说明 | +| 参数 | 说明 | | --------- | --------------- | | vehicleid | 要检测的车辆 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsVehicleOccupied.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsVehicleOccupied.md index e71e080e0ae..6baad016788 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsVehicleOccupied.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsVehicleOccupied.md @@ -13,7 +13,7 @@ tags: ["车辆"] ## 参数说明 -| 参数名 | 说明 | +| 参数 | 说明 | | --------- | --------------- | | vehicleid | 要检测的车辆 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsVehicleSirenEnabled.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsVehicleSirenEnabled.md index 4590461e845..29b6c09d778 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsVehicleSirenEnabled.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsVehicleSirenEnabled.md @@ -1,7 +1,7 @@ --- title: IsVehicleSirenEnabled sidebar_label: IsVehicleSirenEnabled -description: 检测车辆警笛状态 +description: 检测车辆警报器状态 tags: ["车辆"] --- @@ -9,34 +9,34 @@ tags: ["车辆"] ## 描述 -检测指定车辆的警笛是否处于开启状态。 +检测指定车辆的警报器是否处于开启状态。 ## 参数说明 -| 参数名 | 说明 | +| 参数 | 说明 | | --------- | --------------- | | vehicleid | 要检测的车辆 ID | ## 返回值 -**true** - 警笛开启 +**true** - 警报器开启 -**false** - 警笛关闭 +**false** - 警报器关闭 ## 示例代码 ```c if (IsVehicleSirenEnabled(vehicleid)) { - // 警笛已开启 + // 警报器已开启 } else { - // 警笛已关闭 + // 警报器已关闭 } ``` ## 相关函数 -- [`SetVehicleParamsSirenState`](SetVehicleParamsSirenState): 设置车辆警笛状态 -- [`ToggleVehicleSirenEnabled`](ToggleVehicleSirenEnabled): 切换车辆警笛状态 +- [`SetVehicleParamsSirenState`](SetVehicleParamsSirenState): 设置车辆警报器状态 +- [`ToggleVehicleSirenEnabled`](ToggleVehicleSirenEnabled): 切换车辆警报器状态 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsVehicleStreamedIn.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsVehicleStreamedIn.md index b9ff72da20b..7a2766165d0 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsVehicleStreamedIn.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/IsVehicleStreamedIn.md @@ -9,7 +9,7 @@ tags: ["车辆"] 检测指定车辆是否在玩家的游戏世界中已加载（流加载）。只有玩家附近的车辆才会被加载（可见）。 -| 参数名 | 说明 | +| 参数 | 说明 | | --------- | --------------- | | vehicleid | 要检测的车辆 ID | | playerid | 要检测的玩家 ID | @@ -35,7 +35,7 @@ for(new i = 1; i < MAX_VEHICLES; i++) } new string[144]; -format(string, sizeof(string), "您当前已加载了 %i 辆车辆。", streamedVehicleCount); +format(string, sizeof(string), "你当前已加载了 %i 辆车辆。", streamedVehicleCount); SendClientMessage(playerid, -1, string); // 发送统计结果给玩家 ``` diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Kick.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Kick.md index 9c435c6a569..01c4d16a542 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Kick.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Kick.md @@ -15,7 +15,7 @@ tags: ["玩家", "管理"] ## 返回值 -该函数总是返回 1，即使执行失败（指定玩家不存在）。 +此函数总是返回 1，即使执行失败（指定玩家不存在）。 ## 注意事项 @@ -39,7 +39,7 @@ public OnPlayerCommandText(playerid, cmdtext[]) // 踢出执行该命令的玩家 // 首先发送踢出提示 - SendClientMessage(playerid, 0xFF0000FF, "您已被踢出服务器！"); + SendClientMessage(playerid, 0xFF0000FF, "你已被踢出服务器！"); // 通过定时器在1秒后执行踢出 SetTimerEx("DelayedKick", 1000, false, "i", playerid); diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/KillTimer.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/KillTimer.md index 9479620b99f..346b462f613 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/KillTimer.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/KillTimer.md @@ -17,7 +17,7 @@ tags: ["定时器"] ## 返回值 -本函数总是返回 0。 +此函数总是返回 0。 ## 示例代码 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/LimitGlobalChatRadius.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/LimitGlobalChatRadius.md index 733aba8ca78..a5b649bd875 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/LimitGlobalChatRadius.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/LimitGlobalChatRadius.md @@ -9,13 +9,13 @@ tags: [] 设置全局聊天信息的可见范围。只有在该距离范围内的玩家才能看到彼此的聊天信息，同时该距离也影响小地图上玩家图标的可见范围。 -| 参数名 | 说明 | +| 参数 | 说明 | | ---------------- | ---------------------------------- | | Float:chatRadius | 聊天信息的可见范围半径（单位：米） | ## 返回值 -本函数没有返回值。 +此函数不返回特定值。 ## 示例代码 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/LimitPlayerMarkerRadius.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/LimitPlayerMarkerRadius.md index 691f6cf9f66..16575e827f6 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/LimitPlayerMarkerRadius.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/LimitPlayerMarkerRadius.md @@ -9,13 +9,13 @@ tags: ["玩家"] 设置玩家在小地图上的标记可见范围。只有在该半径范围内的其他玩家才会显示位置标记。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------------ | ------------ | | Float:markerRadius | 标记可见半径 | ## 返回值 -本函数没有返回值。 +此函数不返回特定值。 ## 示例代码 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/LinkVehicleToInterior.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/LinkVehicleToInterior.md index 2fbf210918e..f0f00104d27 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/LinkVehicleToInterior.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/LinkVehicleToInterior.md @@ -7,9 +7,9 @@ tags: ["车辆"] ## 描述 -将指定车辆关联到特定室内空间。该车辆仅对处于相同室内空间的玩家可见（需通过[SetPlayerInterior](SetPlayerInterior)设置玩家室内位置）。 +将指定车辆关联到特定室内空间。该车辆仅对处于相同室内空间的玩家可见（需通过[SetPlayerInterior](SetPlayerInterior)设置玩家室内场景）。 -| 参数名 | 说明 | +| 参数 | 说明 | | ---------- | ------------------------------------------- | | vehicleid | 要关联的车辆 ID | | interiorid | 目标[室内空间 ID](../resources/interiorids) | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ManualVehicleEngineAndLights.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ManualVehicleEngineAndLights.md index 33fff735f67..4631dc5ade2 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ManualVehicleEngineAndLights.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ManualVehicleEngineAndLights.md @@ -7,7 +7,7 @@ tags: ["车辆"] ## 描述 -需在玩家首次连接前（通常在`OnGameModeInit`回调中）调用本函数，通知所有客户端将由脚本完全控制车辆引擎和灯光系统。启用后将阻止游戏自动执行以下行为： +需在玩家首次连接前（通常在`OnGameModeInit`回调中）调用此函数，通知所有客户端将由脚本完全控制车辆引擎和灯光系统。启用后将阻止游戏自动执行以下行为： - 玩家进入/离开车辆时自动开关引擎 - 环境光线变暗时自动开启车灯 @@ -26,7 +26,7 @@ public OnGameModeInit() :::warning -- 本功能启用后无法撤销，需在开发初期明确是否使用 +- 此函数启用后无法撤销，需在开发初期明确是否使用 - 必须在首个玩家连接服务器前调用（推荐在游戏模式初始化时设置） ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/MoveObject.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/MoveObject.md index 719855a1a53..ca75215df77 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/MoveObject.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/MoveObject.md @@ -55,7 +55,7 @@ public OnPlayerCommandText(playerid, cmdtext[]) :::warning -- 该函数可用于使物体平滑旋转。但为实现此效果，物体必须同时进行**移动**。指定的旋转角度是物体移动后的最终旋转角度。因此，若物体未发生位移，则不会产生旋转效果。具体示例可参考服务器包中 Kye 制作的 ferriswheel.pwn 滤镜脚本（适用于 SA-MP 0.3d 及以上版本） +- 此函数可用于使物体平滑旋转。但为实现此效果，物体必须同时进行**移动**。指定的旋转角度是物体移动后的最终旋转角度。因此，若物体未发生位移，则不会产生旋转效果。具体示例可参考服务器包中 Kye 制作的 ferriswheel.pwn 滤镜脚本（适用于 SA-MP 0.3d 及以上版本） - 为充分理解上述说明，可采用（但不限于）将 Z 轴坐标先增加(+0.001)再减少(-0.001)的操作，因为不改变 X、Y 或 Z 坐标将不会触发物体旋转 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_AddPointToPath.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_AddPointToPath.md new file mode 100644 index 00000000000..477ab54ba35 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_AddPointToPath.md @@ -0,0 +1,71 @@ +--- +title: NPC_AddPointToPath +sidebar_label: NPC_AddPointToPath +description: 向 NPC 路径添加路径点。 +tags: ["npc", "路径"] +--- + + + +## 描述 + +向 NPC 路径添加一个路径点。 + +| 参数 | 说明 | +| --------- | ------------------------ | +| pathid | 要添加路径点的路径 ID | +| x | 路径点的 X 坐标 | +| y | 路径点的 Y 坐标 | +| z | 路径点的 Z 坐标 | +| stopRange | 认为到达该点时的距离阈值 | + +## 返回值 + +成功时返回 `true`，失败时返回 `false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/addpatrolpos", true)) + { + new Float:x, Float:y, Float:z; + GetPlayerPos(playerid, x, y, z); + + // 尝试添加巡逻点 + if (NPC_AddPointToPath(PlayerPatrolPath[playerid], x, y, z, 1.5)) + { + SendClientMessage(playerid, 0x00FF00FF, "已在你的当前位置向路径 %d 添加路径点", PlayerPatrolPath[playerid]); + } + else + { + SendClientMessage(playerid, 0xFF0000FF, "向路径添加路径点失败"); + } + return 1; + } + return 0; +} + +``` + +## 注意事项 + +- 路径点按顺序添加以形成路径路线 +- `stopRange` 参数定义 NPC 需要距离点多近才能移动到下一个点 +- 较小的 `stopRange` 值使 NPC 更精确地沿路径移动 +- 在添加路径点前，必须先使用 `NPC_CreatePath` 创建路径 + +## 相关函数 + +- [NPC_CreatePath](NPC_CreatePath): 创建新路径 +- [NPC_RemovePointFromPath](NPC_RemovePointFromPath): 从路径中移除路径点 +- [NPC_GetPathPoint](NPC_GetPathPoint): 获取特定点的详细信息 +- [NPC_MoveByPath](NPC_MoveByPath): 使 NPC 沿路径移动 +- [NPC_GetPathPointCount](NPC_GetPathPointCount): 获取路径中的路径点数量 + +## 相关回调 + +- [OnNPCFinishMovePathPoint](../callbacks/OnNPCFinishMovePathPoint): NPC 到达每个路径点时调用 +- [OnNPCFinishMovePath](../callbacks/OnNPCFinishMovePath): NPC 完成沿路径移动时调用 +- [OnNPCFinishMove](../callbacks/OnNPCFinishMove): NPC 完成任何移动时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_AimAt.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_AimAt.md new file mode 100644 index 00000000000..f7b45025aac --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_AimAt.md @@ -0,0 +1,84 @@ +--- +title: NPC_AimAt +sidebar_label: NPC_AimAt +description: 使 NPC 瞄准特定位置。 +tags: ["npc", "武器", "瞄准"] +--- + + + +## 描述 + +使 NPC 瞄准指定的坐标位置。 + +| 参数 | 说明 | +| ------------------- | ---------------------------- | +| npcid | NPC 的 ID | +| Float:pointX | 瞄准目标的 X 坐标 | +| Float:pointY | 瞄准目标的 Y 坐标 | +| Float:pointZ | 瞄准目标的 Z 坐标 | +| bool:shoot | 瞄准时是否开火 | +| shootDelay | 射击间隔（毫秒） | +| bool:updateAngle | 是否更新 NPC 的朝向角度 | +| Float:offsetFromX | 相对 NPC 射击位置的 X 偏移量 | +| Float:offsetFromY | 相对 NPC 射击位置的 Y 偏移量 | +| Float:offsetFromZ | 相对 NPC 射击位置的 Z 偏移量 | +| checkInBetweenFlags | 用于碰撞检测的实体检查标志 | + +## 返回值 + +操作成功返回 `true`，否则返回 `false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/aim", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + new Float:x, Float:y, Float:z; + GetPlayerPos(playerid, x, y, z); + + NPC_AimAt(npcid, x, y, z, false, 0, true, 0.0, 0.0, 0.6, NPC_ENTITY_CHECK_NONE); + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 正在瞄准你的位置。", npcid); + return 1; + } + + if (!strcmp(cmdtext, "/aimfire", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + new Float:x, Float:y, Float:z; + GetPlayerPos(playerid, x, y, z); + + NPC_AimAt(npcid, x, y, z, true, 800, true, 0.0, 0.0, 0.6, NPC_ENTITY_CHECK_NONE); + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 正在向你的位置开火。", npcid); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- NPC 将持续瞄准指定位置，直到调用 `NPC_StopAim` 为止 +- 如果 `shoot` 为 `true`，NPC 将以指定间隔向目标位置开火 +- `updateAngle` 参数控制 NPC 是否转向面对目标 +- 偏移参数用于调整相对 NPC 位置的射击起始点 + +## 相关函数 + +- [NPC_AimAtPlayer](NPC_AimAtPlayer): 使 NPC 瞄准玩家 +- [NPC_StopAim](NPC_StopAim): 停止 NPC 瞄准 +- [NPC_IsAiming](NPC_IsAiming): 检查 NPC 是否正在瞄准 +- [NPC_SetWeaponAccuracy](NPC_SetWeaponAccuracy): 设置武器精度 + +## 相关回调 + +- [OnNPCWeaponShot](../callbacks/OnNPCWeaponShot): NPC 开火时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_AimAtPlayer.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_AimAtPlayer.md new file mode 100644 index 00000000000..6347f3f6800 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_AimAtPlayer.md @@ -0,0 +1,81 @@ +--- +title: NPC_AimAtPlayer +sidebar_label: NPC_AimAtPlayer +description: 使 NPC 瞄准玩家。 +tags: ["npc", "武器", "瞄准"] +--- + + + +## 描述 + +使 NPC 瞄准指定玩家。 + +| 参数 | 说明 | +| ------------------- | ---------------------------- | +| npcid | NPC 的 ID | +| playerid | 要瞄准的玩家 ID | +| shoot | 瞄准时是否开火 | +| shootDelay | 射击间隔（毫秒） | +| updateAngle | 是否更新 NPC 的朝向角度 | +| offsetX | 相对目标位置的 X 偏移量 | +| offsetY | 相对目标位置的 Y 偏移量 | +| offsetZ | 相对目标位置的 Z 偏移量 | +| offsetFromX | 相对 NPC 射击位置的 X 偏移量 | +| offsetFromY | 相对 NPC 射击位置的 Y 偏移量 | +| offsetFromZ | 相对 NPC 射击位置的 Z 偏移量 | +| checkInBetweenFlags | 用于碰撞检测的实体检查标志 | + +## 返回值 + +操作成功返回 `true`，否则返回 `false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/hostile", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + NPC_AimAtPlayer(npcid, playerid, true, 800, true, 0.0, 0.0, 0.8, 0.0, 0.0, 0.6, NPC_ENTITY_CHECK_PLAYER); + SendClientMessage(playerid, 0xFF0000FF, "NPC %d 现在对你怀有敌意！", npcid); + return 1; + } + + if (!strcmp(cmdtext, "/guard", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + NPC_AimAtPlayer(npcid, playerid, false, 0, true, 0.0, 0.0, 0.0, 0.0, 0.0, 0.6, NPC_ENTITY_CHECK_PLAYER); + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 现在正在守护你。", npcid); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- NPC 在瞄准时会持续追踪玩家的移动 +- 如果目标玩家断开连接或变为无效状态，NPC 将停止瞄准/射击 +- 目标偏移参数允许瞄准特定身体部位（头部、躯干等） +- NPC 会随着玩家移动自动更新瞄准 +- 使用 `NPC_IsAimingAtPlayer` 检查 NPC 是否正在瞄准特定玩家 + +## 相关函数 + +- [NPC_AimAt](NPC_AimAt): 使 NPC 瞄准位置 +- [NPC_StopAim](NPC_StopAim): 停止 NPC 瞄准 +- [NPC_IsAimingAtPlayer](NPC_IsAimingAtPlayer): 检查 NPC 是否正在瞄准玩家 +- [NPC_SetWeaponAccuracy](NPC_SetWeaponAccuracy): 设置武器精度 + +## 相关回调 + +- [OnNPCWeaponShot](../callbacks/OnNPCWeaponShot): NPC 开火时调用 +- [OnNPCGiveDamage](../callbacks/OnNPCGiveDamage): NPC 对玩家造成伤害时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_ApplyAnimation.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_ApplyAnimation.md new file mode 100644 index 00000000000..b76d940a09a --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_ApplyAnimation.md @@ -0,0 +1,66 @@ +--- +title: NPC_ApplyAnimation +sidebar_label: NPC_ApplyAnimation +description: 对 NPC 应用特定动画。 +tags: ["npc", "动画"] +--- + + + +## 描述 + +使用动画库名称和动画名称为 NPC 应用特定动画。 + +| 参数 | 说明 | +| ---------- | -------------------------- | +| npcid | NPC 的 ID | +| animlib[] | 动画库名称 | +| animname[] | 动画库中的动画名称 | +| delta | 动画播放速度（通常为 4.1） | +| loop | 动画是否循环播放 | +| lockX | 锁定 X 轴移动 | +| lockY | 锁定 Y 轴移动 | +| freeze | 在动画结束时冻结 NPC | +| time | 动画播放时间（毫秒） | + +## 返回值 + +操作成功返回 `true`，否则返回 `false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/applydance", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + NPC_ApplyAnimation(npcid, "DANCING", "dance_loop", 4.1, true, false, false, false, 0); + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 已应用动画。", npcid); + + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 使用 `time` 参数设置动画持续时间 +- 锁定参数可防止动画期间在特定轴上移动 +- 使用 `NPC_ClearAnimations` 停止所有动画 +- Delta 值通常在 1.0 到 10.0 之间（4.1 为标准值） + +## 相关函数 + +- [NPC_SetAnimation](NPC_SetAnimation): 通过 ID 设置动画 +- [NPC_ClearAnimations](NPC_ClearAnimations): 清除所有动画 +- [NPC_ResetAnimation](NPC_ResetAnimation): 重置动画状态 +- [NPC_GetAnimation](NPC_GetAnimation): 获取当前动画数据 + +## 相关回调 + +- [OnNPCSpawn](../callbacks/OnNPCSpawn): NPC 生成时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_ChangeNode.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_ChangeNode.md new file mode 100644 index 00000000000..84520ed0301 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_ChangeNode.md @@ -0,0 +1,77 @@ +--- +title: NPC_ChangeNode +sidebar_label: NPC_ChangeNode +description: 更改 NPC 当前正在播放的节点。 +tags: ["npc", "节点", "导航"] +--- + + + +## 描述 + +将 NPC 当前正在播放的节点更改为不同的节点。 + +| 参数 | 说明 | +| ------ | --------------------- | +| npcid | NPC 的 ID | +| nodeid | 要更改到的新节点的 ID | +| linkid | 用于转换的链接 ID | + +## 返回值 + +返回节点中的新路径点 ID。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/npcchangenode ", true, 15)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new nodeid = strval(cmdtext[15]); + + if (nodeid < 0 || nodeid > 63) + return SendClientMessage(playerid, 0xFF0000FF, "无效的节点 ID。必须在 0 到 63 之间。"); + + new idx = 15; + while (cmdtext[idx] != ' && cmdtext[idx] != '\0') idx++; + while (cmdtext[idx] == ' ') idx++; + + if (cmdtext[idx] == '\0') + return SendClientMessage(playerid, 0xFF0000FF, "用法：/npcchangenode [nodeid] [linkid]"); + + new linkid = strval(cmdtext[idx]); + + NPC_ChangeNode(npcid, nodeid, linkid); + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 通过链接 %d 更改为节点 %d", npcid, nodeid, linkid); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- NPC 必须当前正在播放节点才能更改 +- 目标节点必须先使用 `NPC_OpenNode` 打开 +- 链接 ID 决定节点之间的转换路径 +- 使用此函数创建复杂的导航模式 + +## 相关函数 + +- [NPC_PlayNode](NPC_PlayNode): 开始播放节点 +- [NPC_StopPlayingNode](NPC_StopPlayingNode): 停止播放当前节点 +- [NPC_OpenNode](NPC_OpenNode): 打开节点供使用 +- [NPC_IsPlayingNode](NPC_IsPlayingNode): 检查 NPC 是否正在播放节点 + +## 相关回调 + +- [OnNPCChangeNode](../callbacks/OnNPCChangeNode): 当 NPC 更改节点时调用 +- [OnNPCFinishNode](../callbacks/OnNPCFinishNode): 当 NPC 完成节点时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_ClearAnimations.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_ClearAnimations.md new file mode 100644 index 00000000000..c9882485316 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_ClearAnimations.md @@ -0,0 +1,67 @@ +--- +title: NPC_ClearAnimations +sidebar_label: NPC_ClearAnimations +description: 清除 NPC 的所有动画。 +tags: ["npc", "动画"] +--- + + + +## 描述 + +清除 NPC 的所有动画，使其恢复到默认状态。 + +| 参数 | 说明 | +| ----- | --------- | +| npcid | NPC 的 ID | + +## 返回值 + +操作成功返回 `true`，否则返回 `false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/applydance", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + NPC_ApplyAnimation(npcid, "DANCING", "dance_loop", 4.1, true, false, false, false, 0); + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 已应用动画。", npcid); + + SetTimerEx("ClearNPCAnimations", 25000, false, "ii", playerid, npcid); + + return 1; + } + return 0; +} + +forward ClearNPCAnimations(playerid, npcid); +public ClearNPCAnimations(playerid, npcid) +{ + + NPC_ClearAnimations(npcid); + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 的动画已清除。", npcid); +} + +``` + +## 注意事项 + +- 此函数会停止所有当前播放的动画，包括循环动画 +- NPC 将恢复到默认的闲置姿态 + +## 相关函数 + +- [NPC_ApplyAnimation](NPC_ApplyAnimation): 为 NPC 应用动画 +- [NPC_SetAnimation](NPC_SetAnimation): 通过 ID 设置动画 +- [NPC_ResetAnimation](NPC_ResetAnimation): 重置动画状态 +- [NPC_GetAnimation](NPC_GetAnimation): 获取当前动画数据 + +## 相关回调 + +- [OnNPCSpawn](../callbacks/OnNPCSpawn): NPC 生成时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_ClearPath.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_ClearPath.md new file mode 100644 index 00000000000..cdd2a3d5896 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_ClearPath.md @@ -0,0 +1,63 @@ +--- +title: NPC_ClearPath +sidebar_label: NPC_ClearPath +description: 清除 NPC 路径中的所有路径点。 +tags: ["npc", "路径"] +--- + + + +## 描述 + +清除 NPC 路径中的所有点，使其变为空路径。 + +| 参数 | 说明 | +| ------ | --------------- | +| pathid | 要清除的路径 ID | + +## 返回值 + +成功时返回 `true`，失败时返回 `false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/clearpatrol", true)) + { + // 获取清除前的点数 + new count = NPC_GetPathPointCount(PlayerPatrolPath[playerid]); + + // 尝试清除路径 + if (NPC_ClearPath(PlayerPatrolPath[playerid])) + { + SendClientMessage(playerid, 0x00FF00FF, "已清除路径 %d（移除了 %d 个点）", PlayerPatrolPath[playerid], count); + } + else + { + SendClientMessage(playerid, 0xFF0000FF, "清除路径失败"); + } + + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 此函数会从指定路径中移除所有路径点 +- 路径本身保持有效状态，可以重复使用 +- 当前正在沿此路径移动的任何 NPC 将停止移动 + +## 相关函数 + +- [NPC_CreatePath](NPC_CreatePath): 创建新路径 +- [NPC_AddPointToPath](NPC_AddPointToPath): 向路径添加点 +- [NPC_RemovePointFromPath](NPC_RemovePointFromPath): 移除特定点 +- [NPC_GetPathPointCount](NPC_GetPathPointCount): 获取路径中的点数 + +## 相关回调 + +- [OnNPCFinishMovePath](../callbacks/OnNPCFinishMovePath): NPC 完成路径时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_CloseNode.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_CloseNode.md new file mode 100644 index 00000000000..6b348ad4dc8 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_CloseNode.md @@ -0,0 +1,60 @@ +--- +title: NPC_CloseNode +sidebar_label: NPC_CloseNode +description: 关闭 NPC 节点，使其无法使用。 +tags: ["npc", "节点", "导航"] +--- + + + +## 描述 + +关闭 NPC 节点，使其无法被 NPC 使用。 + +| 参数 | 说明 | +| ------ | ----------------- | +| nodeid | 要关闭的节点的 ID | + +## 返回值 + +操作成功返回 `true`，否则返回 `false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checknodetype ", true, 15)) + { + new nodeid = strval(cmdtext[15]); + + if (nodeid < 0 || nodeid > 63) + return SendClientMessage(playerid, 0xFF0000FF, "无效的节点 ID。必须在 0 到 63 之间。"); + + new nodetype = NPC_GetNodeType(nodeid); + + SendClientMessage(playerid, 0x00FF00FF, "节点 %d 类型：%d", nodeid, nodetype); + return 1; + } + return 0; + +} +``` + +## 注意事项 + +- 关闭节点会阻止新的 NPC 使用它 +- 当前正在使用该节点的 NPC 将继续直到完成 +- 关闭的节点在重新使用 `NPC_OpenNode` 打开之前无法播放 + +## 相关函数 + +- [NPC_OpenNode](NPC_OpenNode): 打开节点供使用 +- [NPC_IsNodeOpen](NPC_IsNodeOpen): 检查节点是否打开 +- [NPC_PlayNode](NPC_PlayNode): 使 NPC 播放节点 +- [NPC_GetNodeType](NPC_GetNodeType): 获取节点类型信息 + +## 相关回调 + +- [OnNPCFinishNode](../callbacks/OnNPCFinishNode): 当 NPC 完成节点时调用 +- [OnNPCChangeNode](../callbacks/OnNPCChangeNode): 当 NPC 更改节点时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_Create.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_Create.md new file mode 100644 index 00000000000..61ac8887928 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_Create.md @@ -0,0 +1,74 @@ +--- +title: NPC_Create +sidebar_label: NPC_Create +description: 创建新的 NPC。 +tags: ["npc"] +--- + + + +## 描述 + +创建一个新的 NPC。 + +| 参数 | 说明 | +| ------------ | ---------------------------- | +| const name[] | NPC 的名称（最多 24 个字符） | + +## 返回值 + +返回创建的 NPC 的 ID，失败时返回 `INVALID_NPC_ID`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/createnpc", true)) + { + new name[24]; + format(name, sizeof name, "Bot_%d", g_NPCCount++); + + new npcid = NPC_Create(name); + if (NPC_IsValid(npcid)) + { + new Float:x, Float:y, Float:z; + GetPlayerPos(playerid, x, y, z); + + NPC_Spawn(npcid); + NPC_SetPos(npcid, x + 3.0, y, z); + NPC_SetWeapon(npcid, WEAPON_M4); + NPC_SetAmmo(npcid, 500); + + PlayerNPC[playerid] = npcid; + SendClientMessage(playerid, 0x00FF00FF, "NPC %s（ID %d）已在你附近生成！", name, npcid); + } + else + { + SendClientMessage(playerid, 0xFF0000FF, "创建NPC失败！"); + } + return 1; + } + return 0; +} +``` + +## 注意事项 + +:::warning + +- NPC 不会自动生成。使用 [NPC_Spawn](NPC_Spawn) 来生成它。 +- NPC 名称必须遵循与玩家名称相同的规则。 +- 最大名称长度为 24 个字符。 + +::: + +## 相关函数 + +- [NPC_Destroy](NPC_Destroy): 销毁 NPC +- [NPC_Spawn](NPC_Spawn): 生成 NPC +- [NPC_IsValid](NPC_IsValid): 检查 NPC ID 是否有效 + +## 相关回调 + +- [OnNPCCreate](../callbacks/OnNPCCreate): NPC 创建时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_CreatePath.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_CreatePath.md new file mode 100644 index 00000000000..c9bbb2ac8ff --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_CreatePath.md @@ -0,0 +1,56 @@ +--- +title: NPC_CreatePath +sidebar_label: NPC_CreatePath +description: 创建新的 NPC 路径。 +tags: ["npc", "路径"] +--- + + + +## 描述 + +创建一个可用于 NPC 导航的新路径。 + +## 返回值 + +返回创建的路径 ID。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/createpatrol", true)) + { + new pathid = NPC_CreatePath(); + g_PatrolPath = pathid; + + // 如果需要，你可以在这里向路径添加点 + // NPC_AddPointToPath(g_PatrolPath, x, y, z, 1.5) + // NPC_AddPointToPath(g_PatrolPath, x1, y1, z1, 1.5) + // NPC_AddPointToPath(g_PatrolPath, x2, y2, z2, 1.5) + + SendClientMessage(playerid, 0x00FF00FF, "已创建巡逻路径 %d", g_PatrolPath); + + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 路径始终创建为空，使用 `NPC_AddPointToPath` 添加路径点 +- 多个 NPC 可以同时使用同一路径 +- 路径在使用 `NPC_DestroyPath` 销毁之前保持有效 + +## 相关函数 + +- [NPC_DestroyPath](NPC_DestroyPath): 销毁路径 +- [NPC_AddPointToPath](NPC_AddPointToPath): 向路径添加路径点 +- [NPC_MoveByPath](NPC_MoveByPath): 使 NPC 沿路径移动 +- [NPC_GetPathCount](NPC_GetPathCount): 获取路径总数 + +## 相关回调 + +- [OnNPCFinishMovePath](../callbacks/OnNPCFinishMovePath): NPC 完成路径时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_Destroy.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_Destroy.md new file mode 100644 index 00000000000..52db152646c --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_Destroy.md @@ -0,0 +1,68 @@ +--- +title: NPC_Destroy +sidebar_label: NPC_Destroy +description: 销毁 NPC。 +tags: ["npc"] +--- + + + +## 描述 + +销毁一个 NPC。 + +| 参数 | 说明 | +| ----- | ------------------ | +| npcid | 要销毁的 NPC 的 ID | + +## 返回值 + +如果 NPC 成功销毁返回 `true`，否则返回 `false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/destroynpc", true)) + { + new npcid = PlayerNPC[playerid]; + + if (!NPC_IsValid(npcid)) + { + SendClientMessage(playerid, 0xFF0000FF, "你没有有效的NPC可以销毁。"); + return 1; + } + + if (NPC_Destroy(npcid)) + { + SendClientMessage(playerid, 0x00FF00FF, "你的NPC（ID %d）已被销毁。", npcid); + PlayerNPC[playerid] = INVALID_NPC_ID; // 如果没有定义INVALID_NPC_ID，可以使用0 + } + else + { + SendClientMessage(playerid, 0xFF0000FF, "销毁你的NPC（ID %d）失败。", npcid); + } + + return 1; + } + return 0; +} +``` + +## 注意事项 + +:::warning + +- 这将从服务器中完全移除 NPC，ID 在销毁后变为无效。 + +::: + +## 相关函数 + +- [NPC_Create](NPC_Create): 创建新 NPC +- [NPC_IsValid](NPC_IsValid): 检查 NPC ID 是否有效 + +## 相关回调 + +- [OnNPCDestroy](../callbacks/OnNPCDestroy): NPC 销毁时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_DestroyAllPath.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_DestroyAllPath.md new file mode 100644 index 00000000000..657150fd359 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_DestroyAllPath.md @@ -0,0 +1,56 @@ +--- +title: NPC_DestroyAllPath +sidebar_label: NPC_DestroyAllPath +description: 销毁所有 NPC 路径。 +tags: ["npc", "路径"] +--- + + + +## 描述 + +销毁服务器上所有现有的 NPC 路径。 + +## 返回值 + +操作成功返回 `true`，否则返回 `false`。 + +## 示例 + +```c +public OnGameModeExit() +{ + // 获取清除前的路径数量 + new total = NPC_GetPathCount(); + + // 尝试销毁所有路径 + if (NPC_DestroyAllPath()) + { + printf("[NPC] 已销毁所有NPC路径（移除了 %d 个）。", total); + } + else + { + printf("[NPC] 销毁NPC路径失败。"); + } + + return 1; +} + +``` + +## 注意事项 + +- 此函数会销毁服务器上的所有路径，当前正在沿路径移动的 NPC 将停止移动 +- 调用此函数后，所有路径 ID 都变为无效 +- 这在游戏模式关闭/重启期间进行清理很有用 + +## 相关函数 + +- [NPC_CreatePath](NPC_CreatePath): 创建新路径 +- [NPC_DestroyPath](NPC_DestroyPath): 销毁特定路径 +- [NPC_GetPathCount](NPC_GetPathCount): 获取路径总数 +- [NPC_ClearPath](NPC_ClearPath): 清除路径中的所有点 + +## 相关回调 + +- [OnNPCFinishMovePath](../callbacks/OnNPCFinishMovePath): NPC 完成路径时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_DestroyPath.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_DestroyPath.md new file mode 100644 index 00000000000..ca1adb087ce --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_DestroyPath.md @@ -0,0 +1,72 @@ +--- +title: NPC_DestroyPath +sidebar_label: NPC_DestroyPath +description: 销毁特定的 NPC 路径。 +tags: ["npc", "路径"] +--- + + + +## 描述 + +销毁特定的 NPC 路径，使其变为无效。 + +| 参数 | 说明 | +| ------ | --------------- | +| pathid | 要销毁的路径 ID | + +## 返回值 + +成功时返回 `true`，失败时返回 `false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/deletepatrol", true)) + { + // 首先检查路径是否有效 + if (!NPC_IsValidPath(PlayerPatrolPath[playerid])) + { + SendClientMessage(playerid, 0xFF0000FF, "没有有效的巡逻路径可以删除。"); + return 1; + } + + // 获取路径中有多少个点 + new count = NPC_GetPathPointCount(PlayerPatrolPath[playerid]); + + // 尝试销毁它 + if (NPC_DestroyPath(PlayerPatrolPath[playerid])) + { + SendClientMessage(playerid, 0x00FF00FF, "已销毁路径 %d（移除了 %d 个点）。", PlayerPatrolPath[playerid], count); + + // 重置全局变量，因为它现在无效了 + PlayerPatrolPath[playerid] = -1; + } + else + { + SendClientMessage(playerid, 0xFF0000FF, "销毁巡逻路径失败。"); + } + + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 路径 ID 在销毁后变为无效 +- 当前正在沿此路径移动的 NPC 将停止移动，因为路径中的所有点都被移除了 + +## 相关函数 + +- [NPC_CreatePath](NPC_CreatePath): 创建新路径 +- [NPC_IsValidPath](NPC_IsValidPath): 检查路径是否有效 +- [NPC_DestroyAllPath](NPC_DestroyAllPath): 销毁所有路径 +- [NPC_GetPathCount](NPC_GetPathCount): 获取路径总数 + +## 相关回调 + +- [OnNPCFinishMovePath](../callbacks/OnNPCFinishMovePath): NPC 完成路径时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_EnableInfiniteAmmo.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_EnableInfiniteAmmo.md new file mode 100644 index 00000000000..cbc49955d94 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_EnableInfiniteAmmo.md @@ -0,0 +1,59 @@ +--- +title: NPC_EnableInfiniteAmmo +sidebar_label: NPC_EnableInfiniteAmmo +description: 启用或禁用 NPC 的无限弹药。 +tags: ["npc", "武器", "子弹"] +--- + + + +## 描述 + +启用或禁用 NPC 的无限弹药。 + +| 参数 | 说明 | +| ------ | --------------------------------- | +| npcid | NPC 的 ID | +| enable | `true` 启用无限弹药，`false` 禁用 | + +## 返回值 + +操作成功返回 `true`，否则返回 `false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/toggleinfiniteammo", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + new bool:infinite = NPC_IsInfiniteAmmoEnabled(npcid); + NPC_EnableInfiniteAmmo(npcid, !infinite); + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 无限弹药：%s", npcid, !infinite ? "已启用" : "已禁用"); + + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 启用时，NPC 永远不会耗尽弹药 +- 这会影响 NPC 使用的所有武器 +- 弹药数量显示可能仍然减少，但武器功能保持正常 + +## 相关函数 + +- [NPC_IsInfiniteAmmoEnabled](NPC_IsInfiniteAmmoEnabled): 检查是否启用了无限弹药 +- [NPC_SetAmmo](NPC_SetAmmo): 设置 NPC 弹药 +- [NPC_GetAmmo](NPC_GetAmmo): 获取 NPC 弹药 +- [NPC_SetWeapon](NPC_SetWeapon): 设置 NPC 武器 + +## 相关回调 + +- [OnNPCWeaponShot](../callbacks/OnNPCWeaponShot): NPC 开火时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_EnableReloading.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_EnableReloading.md new file mode 100644 index 00000000000..f4d398e0770 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_EnableReloading.md @@ -0,0 +1,59 @@ +--- +title: NPC_EnableReloading +sidebar_label: NPC_EnableReloading +description: 启用或禁用 NPC 的自动重新装弹。 +tags: ["npc", "武器", "换弹"] +--- + + + +## 描述 + +启用或禁用 NPC 的自动换弹。 + +| 参数 | 说明 | +| ------ | --------------------------------- | +| npcid | NPC 的 ID | +| enable | `true` 启用换弹，`false` 禁用换弹 | + +## 返回值 + +操作成功返回 `true`，否则返回 `false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/togglereload", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + new bool:reload = NPC_IsReloadEnabled(npcid); + NPC_EnableReloading(npcid, !reload); + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 换弹：%s", npcid, !reload ? "已启用" : "已禁用"); + + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 启用时，NPC 会在弹匣空了时自动换弹 +- 禁用时，NPC 不会换弹，最终会耗尽弹匣中的弹药 +- 换弹时间可以使用 `NPC_SetWeaponReloadTime` 自定义 + +## 相关函数 + +- [NPC_IsReloadEnabled](NPC_IsReloadEnabled): 检查是否启用了换弹 +- [NPC_IsReloading](NPC_IsReloading): 检查 NPC 是否正在换弹 +- [NPC_SetWeaponReloadTime](NPC_SetWeaponReloadTime): 设置武器换弹时间 +- [NPC_GetWeaponReloadTime](NPC_GetWeaponReloadTime): 获取武器换弹时间 + +## 相关回调 + +- [OnNPCWeaponStateChange](../callbacks/OnNPCWeaponStateChange): NPC 武器状态改变时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_EnterVehicle.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_EnterVehicle.md new file mode 100644 index 00000000000..8e1c67f9fbd --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_EnterVehicle.md @@ -0,0 +1,79 @@ +--- +title: NPC_EnterVehicle +sidebar_label: NPC_EnterVehicle +description: 使 NPC 进入车辆。 +tags: ["npc", "车辆"] +--- + + + +## 描述 + +使 NPC 通过走向车辆并进入其中。 + +| 参数 | 说明 | +| --------- | -------------------- | +| npcid | NPC 的 ID | +| vehicleid | 要进入的车辆 ID | +| seatid | 要进入的座位 | +| moveType | 接近时使用的移动类型 | + +## 返回值 + +操作成功返回 `true`，否则返回 `false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/npcenterbike ", true, 14)) + { + new seatid = strval(cmdtext[14]); + if (cmdtext[14] == '\0') + return SendClientMessage(playerid, 0xFF0000FF, "用法：/npcenterbike [座位ID]"); + + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + new vehicleid = PlayerVehicles[playerid][0]; + if (vehicleid == INVALID_VEHICLE_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你的摩托车不可用。"); + + if (NPC_EnterVehicle(npcid, vehicleid, seatid, NPC_MOVE_TYPE_JOG)) + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 正在进入摩托车（座位 %d）。", npcid, seatid); + else + SendClientMessage(playerid, 0xFF0000FF, "NPC %d 进入摩托车失败（座位 %d）。", npcid, seatid); + + return 1; + } + return 0; +} +``` + +## 座位 ID + +| ID | 座位 | +| --- | ---------------- | +| 0 | 驾驶员 | +| 1 | 副驾驶座 | +| 2 | 后左座 | +| 3 | 后右座 | +| 4+ | 乘客座（大巴等） | + +## 注意事项 + +- NPC 会尝试使用指定的移动类型到达车辆门，然后进入 +- 如果座位已被占用，NPC 可能无法进入 + +## 相关函数 + +- [NPC_ExitVehicle](NPC_ExitVehicle): 使 NPC 退出车辆 +- [NPC_PutInVehicle](NPC_PutInVehicle): 立即将 NPC 放入车辆 +- [NPC_GetVehicle](NPC_GetVehicle): 获取 NPC 当前车辆 +- [NPC_IsEnteringVehicle](NPC_IsEnteringVehicle): 检查 NPC 是否正在进入车辆 + +## 相关回调 + +_此函数不会触发特定的回调。_ diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_ExitVehicle.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_ExitVehicle.md new file mode 100644 index 00000000000..2333f3ef2ea --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_ExitVehicle.md @@ -0,0 +1,58 @@ +--- +title: NPC_ExitVehicle +sidebar_label: NPC_ExitVehicle +description: 使 NPC 退出其当前车辆。 +tags: ["npc", "车辆"] +--- + + + +## 描述 + +使 NPC 退出其当前所在的车辆。 + +| 参数 | 说明 | +| ----- | --------- | +| npcid | NPC 的 ID | + +## 返回值 + +操作成功返回 `true`，否则返回 `false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/npcexitbike", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (NPC_ExitVehicle(npcid)) + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 正在离开摩托车.", npcid); + else + SendClientMessage(playerid, 0xFF0000FF, "NPC %d 离开摩托车失败。", npcid); + + return 1; + } + return 0; +} +``` + +## 注意事项 + +- NPC 必须在车辆中此函数才能生效，否则此函数无效 +- NPC 会执行退出动画，退出后，NPC 将在车辆附近步行 + +## 相关函数 + +- [NPC_EnterVehicle](NPC_EnterVehicle): 使 NPC 进入车辆 +- [NPC_PutInVehicle](NPC_PutInVehicle): 立即将 NPC 放入车辆 +- [NPC_RemoveFromVehicle](NPC_RemoveFromVehicle): 立即将 NPC 从车辆中移除 +- [NPC_GetVehicle](NPC_GetVehicle): 获取 NPC 当前车辆 + +## 相关回调 + +_此函数不会触发特定的回调。_ diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetAll.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetAll.md new file mode 100644 index 00000000000..6c7f699272f --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetAll.md @@ -0,0 +1,60 @@ +--- +title: NPC_GetAll +sidebar_label: NPC_GetAll +description: 获取所有 NPC ID 并存储在数组中。 +tags: ["npc"] +--- + + + +## 描述 + +获取所有 NPC ID 并存储到数组中。 + +| 参数 | 说明 | +| ------ | -------------------------------- | +| npcs[] | 存储 NPC ID 的数组，通过引用传递 | +| size | 数组大小 | + +## 返回值 + +返回找到的 NPC 数量。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/countnpcs", true)) + { + new npcs[MAX_NPCS]; + new count = NPC_GetAll(npcs); + + SendClientMessage(playerid, 0x00FF00FF, "服务器上有 %d 个NPC。", count); + + return 1; + } + return 0; +} +``` + +## 注意事项 + +:::warning + +- 数组必须足够大以容纳所有 NPC ID。 +- 只有有效的 NPC 才会包含在数组中。 +- 函数返回实际找到的 NPC 数量。 +- 使用此函数遍历服务器上的所有 NPC。 + +::: + +## 相关函数 + +- [NPC_Create](NPC_Create): 创建新 NPC +- [NPC_IsValid](NPC_IsValid): 检查 NPC ID 是否有效 +- [NPC_Destroy](NPC_Destroy): 销毁 NPC + +## 相关回调 + +- [OnNPCCreate](../callbacks/OnNPCCreate): NPC 创建时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetAmmo.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetAmmo.md new file mode 100644 index 00000000000..7b1524e9f2c --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetAmmo.md @@ -0,0 +1,60 @@ +--- +title: NPC_GetAmmo +sidebar_label: NPC_GetAmmo +description: 获取 NPC 当前武器的弹药数量。 +tags: ["npc", "武器", "子弹"] +--- + + + +## 描述 + +获取 NPC 当前武器的弹药数量。 + +| 参数 | 说明 | +| ----- | --------- | +| npcid | NPC 的 ID | + +## 返回值 + +返回 NPC 当前武器的弹药数量。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkammo", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new ammo = NPC_GetAmmo(npcid); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 总共还有 %d 发子弹", npcid, ammo); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 返回总弹药数量 +- 如果 NPC 没有武器，此函数返回 0 +- 拥有无限弹药的 NPC 仍显示原始弹药数量 + +## 相关函数 + +- [NPC_SetAmmo](NPC_SetAmmo): 设置 NPC 弹药 +- [NPC_GetAmmoInClip](NPC_GetAmmoInClip): 获取当前弹匣中的弹药 +- [NPC_SetAmmoInClip](NPC_SetAmmoInClip): 设置弹匣中的弹药 +- [NPC_GetWeapon](NPC_GetWeapon): 获取 NPC 当前武器 + +## 相关回调 + +- [OnNPCWeaponShot](../callbacks/OnNPCWeaponShot): NPC 开火时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetAmmoInClip.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetAmmoInClip.md new file mode 100644 index 00000000000..896ac9ce560 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetAmmoInClip.md @@ -0,0 +1,59 @@ +--- +title: NPC_GetAmmoInClip +sidebar_label: NPC_GetAmmoInClip +description: 获取 NPC 武器当前弹夹中的弹药数量。 +tags: ["npc", "武器", "子弹"] +--- + + + +## 描述 + +获取 NPC 武器当前弹匣中的弹药数量。 + +| 参数 | 说明 | +| ----- | --------- | +| npcid | NPC 的 ID | + +## 返回值 + +返回 NPC 当前武器弹匣中的弹药数量。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkclip", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new clip = NPC_GetAmmoInClip(npcid); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 弹匣中还有 %d 发子弹", npcid, clip); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 返回武器弹匣中当前装载的弹药数量，与返回 NPC 总弹药的 [NPC_GetAmmo](NPC_GetAmmo) 不同 +- 弹匣大小根据武器类型而变化 + +## 相关函数 + +- [NPC_SetAmmoInClip](NPC_SetAmmoInClip): 设置弹匣中的弹药 +- [NPC_GetAmmo](NPC_GetAmmo): 获取总弹药数量 +- [NPC_SetAmmo](NPC_SetAmmo): 设置总弹药数量 +- [NPC_IsReloading](NPC_IsReloading): 检查 NPC 是否正在换弹 + +## 相关回调 + +- [OnNPCWeaponShot](../callbacks/OnNPCWeaponShot): NPC 开火时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetAnimation.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetAnimation.md new file mode 100644 index 00000000000..35ee9e10302 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetAnimation.md @@ -0,0 +1,71 @@ +--- +title: NPC_GetAnimation +sidebar_label: NPC_GetAnimation +description: 获取 NPC 的当前动画数据。 +tags: ["npc", "动画"] +--- + + + +## 描述 + +获取 NPC 的当前动画数据。 + +| 参数 | 说明 | +| ------------ | ------------------------ | +| npcid | NPC 的 ID | +| &animationId | 存储动画 ID 的变量 | +| &delta | 存储动画速度的变量 | +| &loop | 存储动画是否循环的变量 | +| &lockX | 存储 X 轴锁定状态的变量 | +| &lockY | 存储 Y 轴锁定状态的变量 | +| &freeze | 存储结束时冻结状态的变量 | +| &time | 存储动画时间的变量 | + +## 返回值 + +操作成功返回 `true`，否则返回 `false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/getanim", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + new animid, time; + new Float:delta; + new bool:loop, bool:lockX, bool:lockY, bool:freeze; + + if (!NPC_GetAnimation(npcid, animid, delta, loop, lockX, lockY, freeze, time)) + return SendClientMessage(playerid, 0xFF0000FF, "获取动画数据失败（可能没有活动动画）。"); + + SendClientMessage(playerid, 0xFFFFFFFF, "NPC %d 动画ID：%d | 速度：%.2f | 循环：%d | 锁定X：%d | 锁定Y：%d | 冻结：%d | 时间：%d", + npcid, animid, delta, _:loop, _:lockX, _:lockY, _:freeze, time); + + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 如果与 [NPC_SetAnimation](NPC_SetAnimation) 一起使用，此函数不会返回数据 +- 除 npcid 外的所有参数都通过引用传递，将被修改 +- 如果 NPC 没有活动动画，animationId 将为 0 + +## 相关函数 + +- [NPC_SetAnimation](NPC_SetAnimation): 通过 ID 设置动画 +- [NPC_ApplyAnimation](NPC_ApplyAnimation): 通过名称应用动画 +- [NPC_ClearAnimations](NPC_ClearAnimations): 清除所有动画 +- [NPC_ResetAnimation](NPC_ResetAnimation): 重置动画状态 + +## 相关回调 + +- [OnNPCSpawn](../callbacks/OnNPCSpawn): NPC 生成时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetArmour.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetArmour.md new file mode 100644 index 00000000000..6ccd3c08354 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetArmour.md @@ -0,0 +1,60 @@ +--- +title: NPC_GetArmour +sidebar_label: NPC_GetArmour +description: 获取 NPC 的护甲值。 +tags: ["npc", "生命值"] +--- + + + +## 描述 + +获取 NPC 的护甲值。 + +| 参数 | 说明 | +| ----- | --------- | +| npcid | NPC 的 ID | + +## 返回值 + +返回 NPC 的护甲值（浮点数，范围 0.0 到 100.0）。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkarmour", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new Float:armour = NPC_GetArmour(npcid); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 有 %.1f%% 护甲", npcid, armour); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 护甲值范围从 0.0 到 100.0 +- NPC 默认护甲值为 0.0，使用 [NPC_SetArmour](NPC_SetArmour) 设置更高的值 + +## 相关函数 + +- [NPC_SetArmour](NPC_SetArmour): 设置 NPC 护甲 +- [NPC_GetHealth](NPC_GetHealth): 获取 NPC 生命值 +- [NPC_SetHealth](NPC_SetHealth): 设置 NPC 生命值 +- [NPC_IsDead](NPC_IsDead): 检查 NPC 是否死亡 + +## 相关回调 + +- [OnNPCTakeDamage](../callbacks/OnNPCTakeDamage): NPC 受到伤害时调用 +- [OnNPCDeath](../callbacks/OnNPCDeath): NPC 死亡时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetCurrentPathPointIndex.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetCurrentPathPointIndex.md new file mode 100644 index 00000000000..6e9b841b63b --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetCurrentPathPointIndex.md @@ -0,0 +1,102 @@ +--- +title: NPC_GetCurrentPathPointIndex +sidebar_label: NPC_GetCurrentPathPointIndex +description: 获取 NPC 当前正在移动的路径点索引。 +tags: ["npc", "路径"] +--- + + + +## 描述 + +获取 NPC 当前正移动到的路径点索引。 + +| 参数 | 说明 | +| ----- | --------- | +| npcid | NPC 的 ID | + +## 返回值 + +返回 NPC 当前正移动到的路径点索引。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + // 创建路径和在路径上创建点的命令 + + if (!strcmp(cmdtext, "/startpatrol", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + new count = NPC_GetPathPointCount(PlayerPatrolPath[playerid]); + + if (NPC_IsValidPath(PlayerPatrolPath[playerid])) + { + NPC_MoveByPath(npcid, PlayerPatrolPath[playerid], NPC_MOVE_TYPE_WALK); + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 开始巡逻路线，共 %d 个点", npcid, count); + + PlayerPatrolTimer[playerid] = SetTimerEx("CheckPathProgress", 2000, true, "i", playerid); + } + else + { + SendClientMessage(playerid, 0xFF0000FF, "开始巡逻路线失败"); + } + return 1; + } + return 0; +} + +forward CheckPathProgress(playerid); +public CheckPathProgress(playerid) +{ + if (!IsPlayerConnected(playerid)) + { + // 做点什么 + return 0; + } + + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID || !NPC_IsValid(npcid)) + { + // 做点什么 + return 0; + } + + if (!NPC_IsValidPath(PlayerPatrolPath[playerid])) + { + // 做点什么 + return 0; + } + + new currentPoint = NPC_GetCurrentPathPointIndex(npcid); + new totalPoints = NPC_GetPathPointCount(PlayerPatrolPath[playerid]); + + if (currentPoint != INVALID_NODE_ID) + { + SendClientMessage(playerid, 0xFFFF00FF, "NPC %d 进度：第 %d 个点，共 %d 个", npcid, currentPoint + 1, totalPoints); + } + return 1; +} + +``` + +## 注意事项 + +- 如果 NPC 没有沿路径移动，返回-1 +- 这表示 NPC 当前正移动到的点 + +## 相关函数 + +- [NPC_MoveByPath](NPC_MoveByPath): 使 NPC 沿路径移动 +- [NPC_CreatePath](NPC_CreatePath): 创建新路径 +- [NPC_AddPointToPath](NPC_AddPointToPath): 向路径添加点 +- [NPC_GetPathPointCount](NPC_GetPathPointCount): 获取路径中的总点数 + +## 相关回调 + +- [OnNPCFinishMovePath](../callbacks/OnNPCFinishMovePath): NPC 完成路径时调用 +- [OnNPCFinishMove](../callbacks/OnNPCFinishMove): NPC 完成移动时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetCustomSkin.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetCustomSkin.md new file mode 100644 index 00000000000..aa5fbc4f450 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetCustomSkin.md @@ -0,0 +1,70 @@ +--- +title: NPC_GetCustomSkin +sidebar_label: NPC_GetCustomSkin +description: 获取NPC的自定义皮肤ID。 +tags: ["npc", "皮肤", "模型"] +--- + + + +## 描述 + +获取 NPC 的自定义皮肤 ID。 + +| 名称 | 描述 | +| ----- | ----------- | +| npcid | NPC 的 ID。 | + +## 返回值 + +返回该 NPC 的自定义皮肤 ID。如果该 NPC 没有自定义皮肤或无效，则返回-1。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkcustomskin", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new customskinid = NPC_GetCustomSkin(npcid); + + if (customskinid == -1) + { + SendClientMessage(playerid, 0xFF0000FF, "NPC %d 未设置自定义皮肤", npcid); + } + else + { + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 的自定义皮肤ID: %d", npcid, customskinid); + } + return 1; + } + return 0; +} +``` + +## 说明 + +:::warning + +- 如果 NPC 未设置自定义皮肤或 NPC 无效，则返回-1。 +- 自定义皮肤与常规皮肤不同，通常指的是添加到游戏中的自定义模型。 +- 使用 [NPC_GetSkin](NPC_GetSkin) 来获取常规的皮肤/模型 ID。 + +::: + +## 相关函数 + +- [NPC_SetSkin](NPC_SetSkin): 设置 NPC 的皮肤/模型。 +- [NPC_GetSkin](NPC_GetSkin): 获取 NPC 当前的皮肤/模型 ID。 +- [NPC_IsValid](NPC_IsValid): 检查 NPC 是否有效。 + +## 相关回调 + +- [OnNPCSpawn](../callbacks/OnNPCSpawn): 当 NPC 生成时调用。 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetEnteringVehicle.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetEnteringVehicle.md new file mode 100644 index 00000000000..2b727ff95a0 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetEnteringVehicle.md @@ -0,0 +1,100 @@ +--- +title: NPC_GetEnteringVehicle +sidebar_label: NPC_GetEnteringVehicle +description: 获取 NPC 当前正在进入的车辆。 +tags: ["npc", "车辆"] +--- + + + +## 描述 + +获取 NPC 当前正在进入的车辆。 + +| 参数 | 说明 | +| ----- | --------- | +| npcid | NPC 的 ID | + +## 返回值 + +返回 NPC 正在进入的车辆，若未进入任何车辆则返回 `INVALID_VEHICLE_ID`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkenterveh", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + // 如果尚未运行，则开始监视 + if (PlayerEnterVehicleMonitor[playerid] == INVALID_TIMER_ID) + { + PlayerEnterVehicleMonitor[playerid] = SetTimerEx("CheckNPCEnteringVehicle", 200, true, "i", playerid); + PlayerWasEnteringVehicle[playerid] = false; + SendClientMessage(playerid, 0x00FF00FF, "开始监控 NPC %d 的车辆进入状态。", npcid); + } + else + { + SendClientMessage(playerid, 0xFFFF00FF, "已在监控 NPC %d 的车辆进入状态。", npcid); + } + return 1; + } + return 0; +} + +forward CheckNPCEnteringVehicle(playerid); +public CheckNPCEnteringVehicle(playerid) +{ + if (!IsPlayerConnected(playerid)) + { + StopPlayerEnterVehicleMonitor(playerid); + return 0; + } + + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID || !NPC_IsValid(npcid)) + { + StopPlayerEnterVehicleMonitor(playerid); + return 0; + } + + new bool:isEntering = NPC_IsEnteringVehicle(npcid); + + if (isEntering) + { + new vehicleid = NPC_GetEnteringVehicle(npcid); + new seatid = NPC_GetEnteringVehicleSeat(npcid); + + if (vehicleid != INVALID_VEHICLE_ID && vehicleid != 0) + { + SendClientMessage(playerid, 0xFFFF00FF, "NPC %d 正在进入车辆 %d（座位 %d）", npcid, vehicleid, seatid); + } + } + + return 1; +} +``` + +## 注意事项 + +- 若 NPC 当前未进入车辆，则返回 `INVALID_VEHICLE_ID` +- 此函数与 NPC 已乘坐的车辆不同 +- NPC 必须正在进入过程中，此函数才会返回有效 ID + +## 相关函数 + +- [NPC_EnterVehicle](NPC_EnterVehicle): 使 NPC 进入车辆 +- [NPC_GetVehicle](NPC_GetVehicle): 获取 NPC 当前乘坐的车辆 +- [NPC_IsEnteringVehicle](NPC_IsEnteringVehicle): 检查 NPC 是否正在进入车辆 +- [NPC_GetEnteringVehicleSeat](NPC_GetEnteringVehicleSeat): 获取正在进入的车辆座位 + +## 相关回调 + +_此函数不会触发任何特定的回调。_ diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetEnteringVehicleID.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetEnteringVehicleID.md new file mode 100644 index 00000000000..ef19a49689e --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetEnteringVehicleID.md @@ -0,0 +1,100 @@ +--- +title: NPC_GetEnteringVehicleID +sidebar_label: NPC_GetEnteringVehicleID +description: 获取 NPC 当前正在进入的车辆ID。 +tags: ["npc", "车辆"] +--- + + + +## 描述 + +获取 NPC 当前正在进入的车辆 ID。 + +| 参数 | 说明 | +| ----- | --------- | +| npcid | NPC 的 ID | + +## 返回值 + +返回 NPC 正在进入的车辆 ID，若未进入任何车辆则返回 INVALID_VEHICLE_ID。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkenterveh", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + // 如果尚未运行，则开始监视 + if (PlayerEnterVehicleMonitor[playerid] == INVALID_TIMER_ID) + { + PlayerEnterVehicleMonitor[playerid] = SetTimerEx("CheckNPCEnteringVehicle", 200, true, "i", playerid); + PlayerWasEnteringVehicle[playerid] = false; + SendClientMessage(playerid, 0x00FF00FF, "开始监控 NPC %d 的车辆进入状态。", npcid); + } + else + { + SendClientMessage(playerid, 0xFFFF00FF, "已在监控 NPC %d 的车辆进入状态。", npcid); + } + return 1; + } + return 0; +} + +forward CheckNPCEnteringVehicle(playerid); +public CheckNPCEnteringVehicle(playerid) +{ + if (!IsPlayerConnected(playerid)) + { + StopPlayerEnterVehicleMonitor(playerid); + return 0; + } + + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID || !NPC_IsValid(npcid)) + { + StopPlayerEnterVehicleMonitor(playerid); + return 0; + } + + new bool:isEntering = NPC_IsEnteringVehicle(npcid); + + if (isEntering) + { + new vehicleid = NPC_GetEnteringVehicle(npcid); + new seatid = NPC_GetEnteringVehicleSeat(npcid); + + if (vehicleid != INVALID_VEHICLE_ID && vehicleid != 0) + { + SendClientMessage(playerid, 0xFFFF00FF, "NPC %d 正在进入车辆 %d（座位 %d）", npcid, vehicleid, seatid); + } + } + + return 1; +} +``` + +## 注意事项 + +- 此函数与 NPC_GetEnteringVehicle 类似 +- 若 NPC 未在进入车辆的过程中，则返回 `INVALID_VEHICLE_ID` +- 一旦 NPC 成功进入车辆，该值变为 0 + +## 相关函数 + +- [NPC_GetEnteringVehicle](NPC_GetEnteringVehicle): 获取正在进入的车辆 +- [NPC_GetEnteringVehicleSeat](NPC_GetEnteringVehicleSeat): 获取正在进入的车辆座位 +- [NPC_EnterVehicle](NPC_EnterVehicle): 使 NPC 进入车辆 +- [NPC_IsEnteringVehicle](NPC_IsEnteringVehicle): 检查是否正在进入车辆 + +## 相关回调 + +_此函数不会触发任何特定的回调。_ diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetEnteringVehicleSeat.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetEnteringVehicleSeat.md new file mode 100644 index 00000000000..b3dac5fa595 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetEnteringVehicleSeat.md @@ -0,0 +1,109 @@ +--- +title: NPC_GetEnteringVehicleSeat +sidebar_label: NPC_GetEnteringVehicleSeat +description: 获取 NPC 在车辆中正在进入的座位。 +tags: ["npc", "车辆"] +--- + + + +## 描述 + +获取 NPC 在车辆中正在进入的座位。 + +| 参数 | 说明 | +| ----- | --------- | +| npcid | NPC 的 ID | + +## 返回值 + +返回 NPC 正在进入的座位号，若未进入则返回-1。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkenterveh", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + // 如果尚未运行，则开始监视 + if (PlayerEnterVehicleMonitor[playerid] == INVALID_TIMER_ID) + { + PlayerEnterVehicleMonitor[playerid] = SetTimerEx("CheckNPCEnteringVehicle", 200, true, "i", playerid); + PlayerWasEnteringVehicle[playerid] = false; + SendClientMessage(playerid, 0x00FF00FF, "开始监控 NPC %d 的车辆进入状态。", npcid); + } + else + { + SendClientMessage(playerid, 0xFFFF00FF, "已在监控 NPC %d 的车辆进入状态。", npcid); + } + return 1; + } + return 0; +} + +forward CheckNPCEnteringVehicle(playerid); +public CheckNPCEnteringVehicle(playerid) +{ + if (!IsPlayerConnected(playerid)) + { + StopPlayerEnterVehicleMonitor(playerid); + return 0; + } + + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID || !NPC_IsValid(npcid)) + { + StopPlayerEnterVehicleMonitor(playerid); + return 0; + } + + new bool:isEntering = NPC_IsEnteringVehicle(npcid); + + if (isEntering) + { + new vehicleid = NPC_GetEnteringVehicle(npcid); + new seatid = NPC_GetEnteringVehicleSeat(npcid); + + if (vehicleid != INVALID_VEHICLE_ID && vehicleid != 0) + { + SendClientMessage(playerid, 0xFFFF00FF, "NPC %d 正在进入车辆 %d（座位 %d）", npcid, vehicleid, seatid); + } + } + + return 1; +} +``` + +## 座位 ID + +| ID | 座位 | +| --- | ------------------ | +| 0 | 驾驶员 | +| 1 | 副驾驶乘客 | +| 2 | 后左乘客 | +| 3 | 后右乘客 | +| 4+ | 乘客座位（大巴等） | + +## 注意事项 + +- 若 NPC 未进入任何车辆，则返回-1 +- 此信息仅在 NPC 处于进入过程中时有效 + +## 相关函数 + +- [NPC_GetEnteringVehicle](NPC_GetEnteringVehicle): 获取正在进入的车辆 +- [NPC_GetEnteringVehicleID](NPC_GetEnteringVehicleID): 获取正在进入的车辆 ID +- [NPC_EnterVehicle](NPC_EnterVehicle): 使 NPC 进入车辆 +- [NPC_GetVehicleSeat](NPC_GetVehicleSeat): 获取当前车辆座位 + +## 相关回调 + +_此函数不会触发任何特定的回调。_ diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetFacingAngle.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetFacingAngle.md new file mode 100644 index 00000000000..3f11b36e545 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetFacingAngle.md @@ -0,0 +1,67 @@ +--- +title: NPC_GetFacingAngle +sidebar_label: NPC_GetFacingAngle +description: 获取 NPC 的朝向角度。 +tags: ["npc", "角度"] +--- + + + +## 描述 + +获取 NPC 的朝向角度。 + +| 参数 | 说明 | +| ------------ | -------------------------------------- | +| npcid | NPC 的 ID。 | +| &Float:angle | 用于存储朝向角度的变量，通过引用传递。 | + +## 返回值 + +若成功获取朝向角度则返回 `true`，否则返回 `false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkfacingangle", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new Float:angle; + NPC_GetFacingAngle(npcid, angle); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 的朝向角度为：%.2f", npcid, angle); + return 1; + } + + return 0; +} +``` + +## 注意事项 + +:::warning + +- 角度通过引用传递且会被修改。 +- 角度以度为单位（0.0 到 360.0）。 +- GTA：SA 中的角度是逆时针方向的;在现实世界中，90 度是东方，但在 GTA：SA 中，90 度实际上是西方。北方和南方仍然是 0/360 和 180。要将 GTA：SA 角度转换为现实世界的指南针角度，只需执行 360 - 角度 即可。 + +::: + +## 相关函数 + +- [NPC_SetFacingAngle](NPC_SetFacingAngle): 设置 NPC 朝向角度。 +- [NPC_GetRot](NPC_GetRot): 获取完整 3D 旋转。 +- [NPC_SetRot](NPC_SetRot): 设置完整 3D 旋转。 +- [NPC_GetPos](NPC_GetPos): 获取 NPC 位置。 + +## 相关回调 + +- [../callbacks/OnNPCSpawn](../callbacks/OnNPCSpawn): NPC 生成时调用。 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetFightingStyle.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetFightingStyle.md new file mode 100644 index 00000000000..5edafa10deb --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetFightingStyle.md @@ -0,0 +1,59 @@ +--- +title: NPC_GetFightingStyle +sidebar_label: NPC_GetFightingStyle +description: 获取 NPC 的战斗风格。 +tags: ["npc", "战斗风格"] +--- + + + +## 描述 + +获取 NPC 的战斗风格。 + +| 参数 | 说明 | +| ----- | --------- | +| npcid | NPC 的 ID | + +## 返回值 + +返回 NPC 的战斗风格 ID。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkfightingstyle", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new style = NPC_GetFightingStyle(npcid); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 的战斗风格: %d", npcid, style); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 战斗风格影响近战动画和伤害 +- 每种风格都有不同的拳击和踢腿动画 +- 默认战斗风格为 FIGHT_STYLE_NORMAL + +## 相关函数 + +- [NPC_SetFightingStyle](NPC_SetFightingStyle): 设置 NPC 战斗风格 +- [NPC_MeleeAttack](NPC_MeleeAttack): 使 NPC 执行近战攻击 +- [NPC_IsMeleeAttacking](NPC_IsMeleeAttacking): 检查 NPC 是否正在攻击 + +## 相关回调 + +- [../callbacks/OnNPCGiveDamage](../callbacks/OnNPCGiveDamage): NPC 对他人造成伤害时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetHealth.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetHealth.md new file mode 100644 index 00000000000..0e4bb7766c7 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetHealth.md @@ -0,0 +1,59 @@ +--- +title: NPC_GetHealth +sidebar_label: NPC_GetHealth +description: 获取 NPC 的生命值。 +tags: ["npc", "生命值"] +--- + + + +## 描述 + +获取 NPC 的生命值。 + +| 参数 | 说明 | +| ----- | --------- | +| npcid | NPC 的 ID | + +## 返回值 + +返回 NPC 的生命值（浮点数）。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkhealth", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new Float:health = NPC_GetHealth(npcid); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 的生命值： %.2f", npcid, health); + } + return 0; +} +``` + +## 注意事项 + +- 生命值通常范围在 0.0 到 100.0 之间 +- 生命值为 0.0 的 NPC 被视为已死亡 + +## 相关函数 + +- [NPC_SetHealth](NPC_SetHealth): 设置 NPC 生命值 +- [NPC_GetArmour](NPC_GetArmour): 获取 NPC 护甲 +- [NPC_SetArmour](NPC_SetArmour): 设置 NPC 护甲 +- [NPC_IsDead](NPC_IsDead): 检查 NPC 是否死亡 + +## 相关回调 + +- [../callbacks/OnNPCTakeDamage](../callbacks/OnNPCTakeDamage): NPC 受到伤害时调用 +- [../callbacks/OnNPCDeath](../callbacks/OnNPCDeath): NPC 死亡时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetInterior.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetInterior.md new file mode 100644 index 00000000000..9c8d038691d --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetInterior.md @@ -0,0 +1,58 @@ +--- +title: NPC_GetInterior +sidebar_label: NPC_GetInterior +description: 获取 NPC 的室内场景ID。 +tags: ["npc", "室内场景"] +--- + + + +## 描述 + +获取 NPC 的室内场景 ID。 + +| 参数 | 说明 | +| ----- | --------- | +| npcid | NPC 的 ID | + +## 返回值 + +返回 NPC 当前所在的室内场景 ID。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkinterior", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new interior = NPC_GetInterior(npcid); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 的室内场景： %d", npcid, interior); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 室内场景 0 是主世界（室外） + +## 相关函数 + +- [NPC_SetInterior](NPC_SetInterior): 设置 NPC 室内场景 +- [NPC_GetVirtualWorld](NPC_GetVirtualWorld): 获取 NPC 虚拟世界 +- [NPC_SetVirtualWorld](NPC_SetVirtualWorld): 设置 NPC 虚拟世界 +- [NPC_GetPos](NPC_GetPos): 获取 NPC 位置 + +## 相关回调 + +- [OnNPCSpawn](../callbacks/OnNPCSpawn): 当 NPC 生成时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetKeys.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetKeys.md new file mode 100644 index 00000000000..3211ab8f23e --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetKeys.md @@ -0,0 +1,64 @@ +--- +title: NPC_GetKeys +sidebar_label: NPC_GetKeys +description: 获取 NPC 当前的按键状态。 +tags: ["npc", "按键"] +--- + + + +## 描述 + +获取 NPC 当前的按键状态。 + +| 参数 | 说明 | +| ------------- | -------------------------- | +| npcid | NPC 的 ID | +| &upAndDown | 用于存储上下键状态的变量 | +| &leftAndRight | 用于存储左右键状态的变量 | +| &keys | 用于存储其他按键状态的变量 | + +## 返回值 + +若成功获取按键状态则返回 `true`，否则返回 `false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkkeys", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new keys, updown, leftright; + NPC_GetKeys(npcid, keys, updown, leftright); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 键: %d, 上下: %d, 左右: %d", npcid, keys, updown, leftright); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 除 npcid 外的所有参数都通过引用传递且会被修改 +- 按键状态以位标志形式存储 +- 使用位运算来检查单个按键 +- 此函数反映 NPC 当前的输入状态 + +## 相关函数 + +- [NPC_SetKeys](NPC_SetKeys): 设置 NPC 按键状态 +- [NPC_Move](NPC_Move): 使 NPC 移动到指定位置 +- [NPC_StopMove](NPC_StopMove): 停止 NPC 移动 + +## 相关回调 + +- [../callbacks/OnNPCFinishMove](../callbacks/OnNPCFinishMove): NPC 完成移动时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetNodeInfo.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetNodeInfo.md new file mode 100644 index 00000000000..6e0133b5667 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetNodeInfo.md @@ -0,0 +1,67 @@ +--- +title: NPC_GetNodeInfo +sidebar_label: NPC_GetNodeInfo +description: 获取 NPC 节点的信息。 +tags: ["npc", "节点", "导航"] +--- + + + +## 描述 + +获取 NPC 节点的信息，包括车辆、行人导航数据。 + +| 参数 | 说明 | +| --------- | -------------------------- | +| nodeid | 节点的 ID | +| &vehnodes | 用于存储车辆节点数量的变量 | +| &pednodes | 用于存储行人节点数量的变量 | +| &navinode | 用于存储导航节点信息的变量 | + +## 返回值 + +成功时返回 `true`，失败时返回 `false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checknodeinfo ", true, 15)) + { + new nodeid = strval(cmdtext[15]); + + if (nodeid < 0 || nodeid > 63) + return SendClientMessage(playerid, 0xFF0000FF, "无效的节点 ID。必须在 0 到 63 之间。"); + + new vehnodes, pednodes, navinode; + new bool:success = NPC_GetNodeInfo(nodeid, vehnodes, pednodes, navinode); + + if (success) + SendClientMessage(playerid, 0x00FF00FF, "节点 %d 信息 - 车辆节点：%d，行人节点：%d，导航节点：%d", nodeid, vehnodes, pednodes, navinode); + else + SendClientMessage(playerid, 0xFF0000FF, "获取节点 %d 信息失败", nodeid); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 在获取信息前必须使用 `NPC_OpenNode` 打开节点 +- 车辆节点用于车辆导航路径 +- 行人节点用于步行路径 +- 所有计数参数都通过引用传递 + +## 相关函数 + +- [NPC_OpenNode](NPC_OpenNode): 打开节点以供使用 +- [NPC_CloseNode](NPC_CloseNode): 关闭节点 +- [NPC_IsNodeOpen](NPC_IsNodeOpen): 检查节点是否打开 +- [NPC_GetNodeType](NPC_GetNodeType): 获取节点类型 + +## 相关回调 + +- [../callbacks/OnNPCFinishNode](../callbacks/OnNPCFinishNode): NPC 完成节点时调用 +- [../callbacks/OnNPCChangeNode](../callbacks/OnNPCChangeNode): NPC 更换节点时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetNodePointCount.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetNodePointCount.md new file mode 100644 index 00000000000..ab2cbed9136 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetNodePointCount.md @@ -0,0 +1,58 @@ +--- +title: NPC_GetNodePointCount +sidebar_label: NPC_GetNodePointCount +description: 获取 NPC 节点中点的数量。 +tags: ["npc", "节点", "导航"] +--- + + + +## 描述 + +获取 NPC 节点中点的数量。 + +| 参数 | 说明 | +| ------ | --------- | +| nodeid | 节点的 ID | + +## 返回值 + +返回节点中点的数量，若节点无效则返回 0。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checknodepointcount ", true, 21)) + { + new nodeid = strval(cmdtext[21]); + + if (nodeid < 0 || nodeid > 63) + return SendClientMessage(playerid, 0xFF0000FF, "无效的节点 ID。必须在 0 到 63 之间。"); + + new count = NPC_GetNodePointCount(nodeid); + + SendClientMessage(playerid, 0x00FF00FF, "节点 %d 有 %d 个点", nodeid, count); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 若节点无效或未打开则返回 0 +- 点的数量表示节点内的导航路径点 + +## 相关函数 + +- [NPC_OpenNode](NPC_OpenNode): 打开节点以供使用 +- [NPC_SetNodePoint](NPC_SetNodePoint): 设置当前节点点 +- [NPC_GetNodePointPosition](NPC_GetNodePointPosition): 获取点的位置 +- [NPC_IsNodeOpen](NPC_IsNodeOpen): 检查节点是否打开 + +## 相关回调 + +- [../callbacks/OnNPCFinishNodePoint](../callbacks/OnNPCFinishNodePoint): NPC 完成节点点时调用 +- [../callbacks/OnNPCFinishNode](../callbacks/OnNPCFinishNode): NPC 完成节点时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetNodePointPosition.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetNodePointPosition.md new file mode 100644 index 00000000000..2690536e1e0 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetNodePointPosition.md @@ -0,0 +1,65 @@ +--- +title: NPC_GetNodePointPosition +sidebar_label: NPC_GetNodePointPosition +description: 获取 NPC 节点中当前点的位置。 +tags: ["npc", "节点", "导航", "位置"] +--- + + + +## 描述 + +获取 NPC 节点中当前点的位置。 + +| 参数 | 说明 | +| ------ | --------------------- | +| nodeid | 节点的 ID | +| &x | 用于存储 X 坐标的变量 | +| &y | 用于存储 Y 坐标的变量 | +| &z | 用于存储 Z 坐标的变量 | + +## 返回值 + +成功时返回 `true`，失败时返回 `false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checknodepointpos ", true, 19)) + { + new nodeid = strval(cmdtext[19]); + + if (nodeid < 0 || nodeid > 63) + return SendClientMessage(playerid, 0xFF0000FF, "无效的节点 ID。必须在 0 到 63 之间。"); + + new Float:x, Float:y, Float:z; + new bool:success = NPC_GetNodePointPosition(nodeid, x, y, z); + + if (success) + SendClientMessage(playerid, 0x00FF00FF, "节点 %d 点位置：%.2f, %.2f, %.2f", nodeid, x, y, z); + else + SendClientMessage(playerid, 0xFF0000FF, "获取节点 %d 点位置失败", nodeid); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 必须首先使用 `NPC_OpenNode` 打开节点 +- 在获取位置前必须使用 `NPC_SetNodePoint` 设置一个点 +- 所有坐标参数都通过引用传递 + +## 相关函数 + +- [NPC_OpenNode](NPC_OpenNode): 打开节点以供使用 +- [NPC_SetNodePoint](NPC_SetNodePoint): 设置当前节点点 +- [NPC_GetNodePointCount](NPC_GetNodePointCount): 获取点的数量 +- [NPC_PlayNode](NPC_PlayNode): 使 NPC 播放节点 + +## 相关回调 + +- [../callbacks/OnNPCFinishNodePoint](../callbacks/OnNPCFinishNodePoint): NPC 完成节点点时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetNodeType.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetNodeType.md new file mode 100644 index 00000000000..b14eb9a4c82 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetNodeType.md @@ -0,0 +1,61 @@ +--- +title: NPC_GetNodeType +sidebar_label: NPC_GetNodeType +description: 获取 NPC 节点的类型。 +tags: ["npc", "节点", "导航"] +--- + + + +## 描述 + +获取 NPC 节点的类型。 + +| 参数 | 说明 | +| ------ | --------- | +| nodeid | 节点的 ID | + +## 返回值 + +返回节点类型 ID，若节点无效则返回-1。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checknodetype ", true, 15)) + { + new nodeid = strval(cmdtext[15]); + + if (nodeid < 0 || nodeid > 63) + return SendClientMessage(playerid, 0xFF0000FF, "无效的节点 ID。必须在 0 到 63 之间。"); + + new nodetype = NPC_GetNodeType(nodeid); + + SendClientMessage(playerid, 0x00FF00FF, "节点 %d 类型：%d", nodeid, nodetype); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 若节点无效或未打开则返回-1 +- 不同的节点类型适用于不同的移动方式 +- 行人节点适用于步行的 NPC +- 车辆节点适用于驾驶的 NPC +- 请为 NPC 的移动方式选择合适的节点类型 + +## 相关函数 + +- [NPC_OpenNode](NPC_OpenNode): 打开节点以供使用 +- [NPC_IsNodeOpen](NPC_IsNodeOpen): 检查节点是否打开 +- [NPC_GetNodeInfo](NPC_GetNodeInfo): 获取详细节点信息 +- [NPC_PlayNode](NPC_PlayNode): 使 NPC 播放节点 + +## 相关回调 + +- [../callbacks/OnNPCFinishNode](../callbacks/OnNPCFinishNode): NPC 完成节点时调用 +- [../callbacks/OnNPCChangeNode](../callbacks/OnNPCChangeNode): NPC 更换节点时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetPathCount.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetPathCount.md new file mode 100644 index 00000000000..7834304f5b7 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetPathCount.md @@ -0,0 +1,48 @@ +--- +title: NPC_GetPathCount +sidebar_label: NPC_GetPathCount +description: 获取服务器上 NPC 路径的总数。 +tags: ["npc", "路径"] +--- + + + +## 描述 + +获取服务器上当前存在的 NPC 路径总数。 + +## 返回值 + +返回服务器上存在的路径数量。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkpathcount", true)) + { + new count = NPC_GetPathCount(); + + SendClientMessage(playerid, 0x00FF00FF, "总NPC路径: %d", count); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 此函数计算所有路径，无论它们是否包含路径点 +- 空路径（无路径点）仍会被计算 + +## 相关函数 + +- [NPC_CreatePath](NPC_CreatePath): 创建新路径 +- [NPC_DestroyPath](NPC_DestroyPath): 销毁特定路径 +- [NPC_DestroyAllPath](NPC_DestroyAllPath): 销毁所有路径 +- [NPC_IsValidPath](NPC_IsValidPath): 检查路径是否有效 + +## 相关回调 + +- [../callbacks/OnNPCFinishMovePath](../callbacks/OnNPCFinishMovePath): NPC 完成路径时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetPathPoint.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetPathPoint.md new file mode 100644 index 00000000000..45f7654e843 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetPathPoint.md @@ -0,0 +1,73 @@ +--- +title: NPC_GetPathPoint +sidebar_label: NPC_GetPathPoint +description: 获取 NPC 路径中特定点的坐标和停止范围。 +tags: ["npc", "路径"] +--- + + + +## 描述 + +获取 NPC 路径中特定点的坐标和停止范围。 + +| 参数 | 说明 | +| ----------- | ---------------------- | +| pathid | 路径的 ID | +| point_index | 点的索引（从 0 开始） | +| &x | 用于存储 X 坐标的变量 | +| &y | 用于存储 Y 坐标的变量 | +| &z | 用于存储 Z 坐标的变量 | +| &stopRange | 用于存储停止范围的变量 | + +## 返回值 + +成功时返回 `true`，失败时返回 `false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkpathpoint", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new pathid = PlayerPatrolPath[playerid]; + if (pathid == INVALID_PATH_ID) + return SendClientMessage(playerid, 0xFFFF00FF, "未指定巡逻路径。"); + + new pointindex = NPC_GetCurrentPathPointIndex(npcid); + new Float:x, Float:y, Float:z, Float:stopRange; + + if (!NPC_GetPathPoint(pathid, pointindex, x, y, z, stopRange)) + return SendClientMessage(playerid, 0xFFFF00FF, "无法获取路径点。"); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 路径点 %d: %.2f, %.2f, %.2f", npcid, pointindex, x, y, z); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 所有坐标和停止范围参数都通过引用传递 +- 点的索引从 0 开始 +- 若路径或点索引无效则返回 false + +## 相关函数 + +- [NPC_AddPointToPath](NPC_AddPointToPath): 向路径添加点 +- [NPC_RemovePointFromPath](NPC_RemovePointFromPath): 从路径移除点 +- [NPC_GetPathPointCount](NPC_GetPathPointCount): 获取点的数量 +- [NPC_IsValidPath](NPC_IsValidPath): 检查路径是否有效 + +## 相关回调 + +- [../callbacks/OnNPCFinishMovePath](../callbacks/OnNPCFinishMovePath): NPC 完成路径时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetPathPointCount.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetPathPointCount.md new file mode 100644 index 00000000000..ff595a2c0c5 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetPathPointCount.md @@ -0,0 +1,71 @@ +--- +title: NPC_GetPathPointCount +sidebar_label: NPC_GetPathPointCount +description: 获取 NPC 路径中点的数量。 +tags: ["npc", "路径"] +--- + + + +## 描述 + +获取 NPC 路径中点的数量。 + +| 参数 | 说明 | +| ------ | --------- | +| pathid | 路径的 ID | + +## 返回值 + +返回路径中点的数量，若路径无效则返回 0。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkpathpointcount", true)) + { + new pathid = PlayerPatrolPath[playerid]; + if (pathid == INVALID_PATH_ID) + return SendClientMessage(playerid, 0xFFFF00FF, "未指定巡逻路径。"); + + new count = NPC_GetPathPointCount(pathid); + + SendClientMessage(playerid, 0x00FF00FF, "路径 %d 有 %d 个点", pathid, count); + return 1; + } + return 0; +} + +forward ValidatePathBeforeUse(pathid); +public ValidatePathBeforeUse(pathid) +{ + new pointCount = NPC_GetPathPointCount(pathid); + + if (pointCount < 2) + { + printf("警告: 路径%d只有%d个点，移动需要至少2个点", + pathid, pointCount); + return 0; + } + + printf("路径%d有效，有%d个点", pathid, pointCount); + return 1; +} +``` + +## 注意事项 + +- 若路径无效或为空则返回 0 + +## 相关函数 + +- [NPC_AddPointToPath](NPC_AddPointToPath): 向路径添加点 +- [NPC_RemovePointFromPath](NPC_RemovePointFromPath): 从路径移除点 +- [NPC_GetPathPoint](NPC_GetPathPoint): 获取特定点数据 +- [NPC_ClearPath](NPC_ClearPath): 从路径移除所有点 + +## 相关回调 + +- [../callbacks/OnNPCFinishMovePath](../callbacks/OnNPCFinishMovePath): NPC 完成路径时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetPlayerAimingAt.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetPlayerAimingAt.md new file mode 100644 index 00000000000..a4293a127b0 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetPlayerAimingAt.md @@ -0,0 +1,67 @@ +--- +title: NPC_GetPlayerAimingAt +sidebar_label: NPC_GetPlayerAimingAt +description: 获取NPC当前瞄准的玩家ID +tags: ["npc", "玩家", "瞄准", "武器"] +--- + + + +## 描述 + +获取 NPC 当前瞄准的玩家 ID。 + +| 参数 | 说明 | +| ----- | --------- | +| npcid | NPC 的 ID | + +## 返回值 + +返回被瞄准的玩家 ID，若未瞄准任何玩家则返回 `INVALID_PLAYER_ID`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkwhonpcaiming", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new targetid = NPC_GetPlayerAimingAt(npcid); + + if (targetid == INVALID_PLAYER_ID) + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 没有瞄准任何玩家", npcid); + else + { + new targetName[MAX_PLAYER_NAME]; + GetPlayerName(targetid, targetName, sizeof(targetName)); + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 正在瞄准玩家 %s（ID %d）", npcid, targetName, targetid); + } + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 若 NPC 使用 [NPC_AimAtPlayer](NPC_AimAtPlayer) 瞄准玩家，则返回玩家 ID +- 若 NPC 未瞄准任何玩家，则返回 `INVALID_PLAYER_ID` + +## 相关函数 + +- [NPC_AimAtPlayer](NPC_AimAtPlayer): 使 NPC 瞄准玩家 +- [NPC_IsAimingAtPlayer](NPC_IsAimingAtPlayer): 检查 NPC 是否瞄准特定玩家 +- [NPC_IsAiming](NPC_IsAiming): 检查 NPC 是否正在瞄准 +- [NPC_GetPlayerMovingTo](NPC_GetPlayerMovingTo): 获取 NPC 正在移动向的玩家 + +## 相关回调 + +- [OnNPCWeaponShot](../callbacks/OnNPCWeaponShot): 当 NPC 开火时被调用 +- [OnNPCGiveDamage](../callbacks/OnNPCGiveDamage): 当 NPC 对玩家造成伤害时被调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetPlayerMovingTo.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetPlayerMovingTo.md new file mode 100644 index 00000000000..d08390c067b --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetPlayerMovingTo.md @@ -0,0 +1,67 @@ +--- +title: NPC_GetPlayerMovingTo +sidebar_label: NPC_GetPlayerMovingTo +description: 获取NPC当前正移向的玩家ID +tags: ["npc", "玩家", "移动"] +--- + + + +## 描述 + +获取 NPC 当前正移向的玩家 ID。 + +| 参数 | 说明 | +| ----- | --------- | +| npcid | NPC 的 ID | + +## 返回值 + +返回正移向的玩家 ID，若未向任何玩家移动则返回 `INVALID_PLAYER_ID`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkwhonpcmoving", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new targetid = NPC_GetPlayerMovingTo(npcid); + + if (targetid == INVALID_PLAYER_ID) + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 没有向任何玩家移动", npcid); + else + { + new targetName[MAX_PLAYER_NAME]; + GetPlayerName(targetid, targetName, sizeof(targetName)); + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 正在向玩家 %s（ID %d）移动", npcid, targetName, targetid); + } + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 若 NPC 使用 [NPC_MoveToPlayer](NPC_MoveToPlayer) 向玩家移动，则返回玩家 ID +- 若 NPC 未向任何玩家移动，则返回 `INVALID_PLAYER_ID` +- 这与使用 [NPC_Move](NPC_Move) 向固定位置移动不同 + +## 相关函数 + +- [NPC_MoveToPlayer](NPC_MoveToPlayer): 使 NPC 向玩家移动 +- [NPC_IsMovingToPlayer](NPC_IsMovingToPlayer): 检查 NPC 是否向特定玩家移动 +- [NPC_IsMoving](NPC_IsMoving): 检查 NPC 是否正在移动 +- [NPC_GetPlayerAimingAt](NPC_GetPlayerAimingAt): 获取 NPC 正在瞄准的玩家 + +## 相关回调 + +- [OnNPCFinishMove](../callbacks/OnNPCFinishMove): 当 NPC 完成移动时被调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetPos.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetPos.md new file mode 100644 index 00000000000..91860d45560 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetPos.md @@ -0,0 +1,67 @@ +--- +title: NPC_GetPos +sidebar_label: NPC_GetPos +description: 获取 NPC 的位置。 +tags: ["npc", "位置"] +--- + + + +## 描述 + +获取 NPC 的位置。 + +| 参数 | 说明 | +| -------- | ------------------------------------- | +| npcid | NPC 的 ID。 | +| &Float:x | 用于存储 X 坐标的变量，通过引用传递。 | +| &Float:y | 用于存储 Y 坐标的变量，通过引用传递。 | +| &Float:z | 用于存储 Z 坐标的变量，通过引用传递。 | + +## 返回值 + +若成功获取位置则返回 `true`，否则返回 `false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkpos", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new Float:x, Float:y, Float:z; + NPC_GetPos(npcid, x, y, z); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 位置: %.2f, %.2f, %.2f", npcid, x, y, z); + return 1; + } + return 0; +} +``` + +## 注意事项 + +:::warning + +- 所有坐标参数都通过引用传递且会被修改。 + +::: + +## 相关函数 + +- [NPC_SetPos](NPC_SetPos): 设置 NPC 位置。 +- [NPC_GetRot](NPC_GetRot): 获取 NPC 旋转。 +- [NPC_SetRot](NPC_SetRot): 设置 NPC 旋转。 +- [NPC_GetFacingAngle](NPC_GetFacingAngle): 获取朝向角度。 + +## 相关回调 + +- [../callbacks/OnNPCSpawn](../callbacks/OnNPCSpawn): NPC 生成时调用。 +- [../callbacks/OnNPCFinishMove](../callbacks/OnNPCFinishMove): NPC 完成移动时调用。 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetPosMovingTo.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetPosMovingTo.md new file mode 100644 index 00000000000..33ed75c7b07 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetPosMovingTo.md @@ -0,0 +1,71 @@ +--- +title: NPC_GetPosMovingTo +sidebar_label: NPC_GetPosMovingTo +description: 获取NPC当前正在移动前往的目标位置。 +tags: ["npc", "位置", "移动"] +--- + + + +## 描述 + +获取 NPC 当前正在移动前往的目标位置。 + +| 名称 | 描述 | +| -------- | --------------------------------------------- | +| npcid | NPC 的 ID。 | +| &Float:x | 用于存储目标位置 X 坐标的变量，通过引用传递。 | +| &Float:y | 用于存储目标位置 Y 坐标的变量，通过引用传递。 | +| &Float:z | 用于存储目标位置 Z 坐标的变量，通过引用传递。 | + +## 返回值 + +成功时返回 `true`，失败时返回 `false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkposmovingto", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + if (!NPC_IsMoving(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "NPC %d 当前没有移动。", npcid); + + new Float:x, Float:y, Float:z; + NPC_GetPosMovingTo(npcid, x, y, z); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 的目标位置：%.2f, %.2f, %.2f", npcid, x, y, z); + return 1; + } + return 0; +} +``` + +## 说明 + +:::warning + +- 所有坐标参数均通过引用传递，其值将被修改。 +- 此函数返回的是 NPC 正在移动前往的目标位置，而非当前位置。 +- 在调用此函数前，建议使用 [NPC_IsMoving](NPC_IsMoving) 来检查 NPC 当前是否正在移动。 + +::: + +## 相关函数 + +- [NPC_Move](NPC_Move): 使 NPC 移动到指定位置。 +- [NPC_IsMoving](NPC_IsMoving): 检查 NPC 是否正在移动。 +- [NPC_GetPos](NPC_GetPos): 获取 NPC 的当前位置。 +- [NPC_StopMove](NPC_StopMove): 停止 NPC 的移动。 + +## 相关回调 + +- [OnNPCFinishMove](../callbacks/OnNPCFinishMove): 当 NPC 完成移动时调用。 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetRecordCount.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetRecordCount.md new file mode 100644 index 00000000000..d81b38e157b --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetRecordCount.md @@ -0,0 +1,49 @@ +--- +title: NPC_GetRecordCount +sidebar_label: NPC_GetRecordCount +description: 获取已加载的 NPC 录制文件数量。 +tags: ["npc", "录制", "回放"] +--- + + + +## 描述 + +获取服务器上已加载的 NPC 录制文件数量。 + +## 返回值 + +返回当前已加载的录制文件数量。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkrecordcount", true)) + { + new count = NPC_GetRecordCount(); + SendClientMessage(playerid, 0x00FF00FF, "已加载的录制总数：%d", count); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 返回内存中有效录制的总数 +- 只有成功加载的录制才会被计算 +- 录制会一直存在直到被显式卸载或服务器重启 + +## 相关函数 + +- [NPC_LoadRecord](NPC_LoadRecord): 加载录制文件 +- [NPC_UnloadRecord](NPC_UnloadRecord): 卸载录制 +- [NPC_IsValidRecord](NPC_IsValidRecord): 检查录制是否有效 +- [NPC_UnloadAllRecords](NPC_UnloadAllRecords): 卸载所有录制 + +## 相关回调 + +- [../callbacks/OnNPCPlaybackStart](../callbacks/OnNPCPlaybackStart): 回放开始时调用 +- [../callbacks/OnNPCPlaybackEnd](../callbacks/OnNPCPlaybackEnd): 回放结束时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetRot.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetRot.md new file mode 100644 index 00000000000..dab94f2874f --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetRot.md @@ -0,0 +1,68 @@ +--- +title: NPC_GetRot +sidebar_label: NPC_GetRot +description: 获取 NPC 的旋转角度。 +tags: ["npc", "旋转"] +--- + + + +## 描述 + +获取 NPC 在 3D 空间中的旋转角度。 + +| 参数 | 说明 | +| -------- | ----------------------------------------------- | +| npcid | NPC 的 ID。 | +| &Float:x | 用于存储 X 旋转（俯仰角）的变量，通过引用传递。 | +| &Float:y | 用于存储 Y 旋转（偏航角）的变量，通过引用传递。 | +| &Float:z | 用于存储 Z 旋转（翻滚角）的变量，通过引用传递。 | + +## 返回值 + +若成功获取旋转角度则返回 `true`，否则返回 `false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkrot", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new Float:rotX, Float:rotY, Float:rotZ; + NPC_GetRot(npcid, rotX, rotY, rotZ); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 旋转: X=%.2f, Y=%.2f, Z=%.2f", npcid, rotX, rotY, rotZ); + return 1; + } + return 0; +} +``` + +## 注意事项 + +:::warning + +- 所有旋转参数都通过引用传递且会被修改。 +- X = 俯仰角（上下），Y = 偏航角（左右），Z = 翻滚角（倾斜）。 +- 对于简单的朝向，请改用 [NPC_GetFacingAngle](NPC_GetFacingAngle)。 + +::: + +## 相关函数 + +- [NPC_SetRot](NPC_SetRot): 设置 NPC 旋转。 +- [NPC_GetFacingAngle](NPC_GetFacingAngle): 仅获取朝向角度。 +- [NPC_SetFacingAngle](NPC_SetFacingAngle): 仅设置朝向角度。 +- [NPC_GetPos](NPC_GetPos): 获取 NPC 位置。 + +## 相关回调 + +- [../callbacks/OnNPCSpawn](../callbacks/OnNPCSpawn): NPC 生成时调用。 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetSkin.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetSkin.md new file mode 100644 index 00000000000..38ee0263f5c --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetSkin.md @@ -0,0 +1,58 @@ +--- +title: NPC_GetSkin +sidebar_label: NPC_GetSkin +description: 获取NPC的皮肤/模型ID +tags: ["npc", "皮肤", "模型"] +--- + + + +## 描述 + +获取 NPC 的皮肤/模型 ID。 + +| 参数 | 说明 | +| ----- | --------- | +| npcid | NPC 的 ID | + +## 返回值 + +返回 NPC 的皮肤/模型 ID，若无效则返回-1。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkskin", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new skinid = NPC_GetSkin(npcid); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 的皮肤: %d", npcid, skinid); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 返回 NPC 当前使用的皮肤/模型 +- 使用 [NPC_SetSkin](NPC_SetSkin) 来更改 NPC 的皮肤 + +## 相关函数 + +- [NPC_SetSkin](NPC_SetSkin): 设置 NPC 皮肤/模型 +- [NPC_IsValid](NPC_IsValid): 检查 NPC 是否有效 +- [NPC_IsSpawned](NPC_IsSpawned): 检查 NPC 是否已生成 + +## 相关回调 + +- [OnNPCSpawn](../callbacks/OnNPCSpawn): 当 NPC 生成时被调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetSpecialAction.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetSpecialAction.md new file mode 100644 index 00000000000..fb5d17c2ffd --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetSpecialAction.md @@ -0,0 +1,58 @@ +--- +title: NPC_GetSpecialAction +sidebar_label: NPC_GetSpecialAction +description: 获取 NPC 当前的特殊动作。 +tags: ["npc"] +--- + + + +## 描述 + +获取 NPC 当前的特殊动作。 + +| 参数 | 说明 | +| ----- | --------- | +| npcid | NPC 的 ID | + +## 返回值 + +返回特殊动作 ID，若无特殊动作则返回 `SPECIAL_ACTION_NONE`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkspecialaction", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new action = NPC_GetSpecialAction(npcid); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 特殊动作: %d", npcid, action); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 返回当前的特殊动作常量 +- 使用此函数检查 NPC 当前正在执行的动作 + +## 相关函数 + +- [NPC_SetSpecialAction](NPC_SetSpecialAction): 设置 NPC 特殊动作 +- [NPC_ClearAnimations](NPC_ClearAnimations): 清除所有动画 +- [NPC_ApplyAnimation](NPC_ApplyAnimation): 为 NPC 应用动画 + +## 相关回调 + +- [../callbacks/OnNPCSpawn](../callbacks/OnNPCSpawn): NPC 生成时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetSurfingObject.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetSurfingObject.md new file mode 100644 index 00000000000..af9dfb9f166 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetSurfingObject.md @@ -0,0 +1,62 @@ +--- +title: NPC_GetSurfingObject +sidebar_label: NPC_GetSurfingObject +description: 获取 NPC 正在冲浪的物体。 +tags: ["npc", "冲浪"] +--- + + + +## 描述 + +获取 NPC 正在冲浪的物体。 + +| 参数 | 说明 | +| ----- | --------- | +| npcid | NPC 的 ID | + +## 返回值 + +返回物体 ID，若未在物体上冲浪则返回 `INVALID_OBJECT_ID`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checksurfingobject", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new objectid = NPC_GetSurfingObject(npcid); + + if (objectid == INVALID_OBJECT_ID) + SendClientMessage(playerid, 0xFFFF00FF, "NPC %d 没有在任何物体上冲浪。", npcid); + else + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 正在物体上冲浪: %d", npcid, objectid); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 若 NPC 未在任何物体上冲浪则返回 INVALID_OBJECT_ID + +## 相关函数 + +- [NPC_SetSurfingObject](NPC_SetSurfingObject): 设置 NPC 正在冲浪的物体 +- [NPC_GetSurfingVehicle](NPC_GetSurfingVehicle): 获取 NPC 正在冲浪的车辆 +- [NPC_GetSurfingPlayerObject](NPC_GetSurfingPlayerObject): 获取 NPC 正在冲浪的玩家物体 +- [NPC_GetSurfingOffsets](NPC_GetSurfingOffsets): 获取 NPC 的冲浪偏移 +- [NPC_ResetSurfingData](NPC_ResetSurfingData): 重置 NPC 的所有冲浪数据 + +## 相关回调 + +_此函数不会触发任何特定的回调。_ diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetSurfingOffsets.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetSurfingOffsets.md new file mode 100644 index 00000000000..9fe5f44e6b1 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetSurfingOffsets.md @@ -0,0 +1,64 @@ +--- +title: NPC_GetSurfingOffsets +sidebar_label: NPC_GetSurfingOffsets +description: 获取 NPC 的冲浪偏移。 +tags: ["npc", "冲浪"] +--- + + + +## 描述 + +获取 NPC 的冲浪偏移。 + +| 参数 | 说明 | +| ----- | ----------------------------------- | +| npcid | NPC 的 ID | +| &x | 用于存储 X 偏移的变量，通过引用传递 | +| &y | 用于存储 Y 偏移的变量，通过引用传递 | +| &z | 用于存储 Z 偏移的变量，通过引用传递 | + +## 返回值 + +若操作成功则返回 `true`，否则返回 `false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checksurfingoffset", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new Float:offsetX, Float:offsetY, Float:offsetZ; + NPC_GetSurfingOffset(npcid, offsetX, offsetY, offsetZ); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 冲浪偏移: X=%.2f, Y=%.2f, Z=%.2f", npcid, offsetX, offsetY, offsetZ); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 冲浪偏移表示 NPC 相对于其正在冲浪的物体/车辆的相对位置 +- 所有偏移值都以浮点数形式返回 + +## 相关函数 + +- [NPC_SetSurfingOffsets](NPC_SetSurfingOffsets): 设置 NPC 的冲浪偏移 +- [NPC_GetSurfingObject](NPC_GetSurfingObject): 获取 NPC 正在冲浪的物体 +- [NPC_GetSurfingVehicle](NPC_GetSurfingVehicle): 获取 NPC 正在冲浪的车辆 +- [NPC_GetSurfingPlayerObject](NPC_GetSurfingPlayerObject): 获取 NPC 正在冲浪的玩家物体 +- [NPC_ResetSurfingData](NPC_ResetSurfingData): 重置 NPC 的所有冲浪数据 + +## 相关回调 + +_此函数不会触发任何特定的回调。_ diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetSurfingPlayerObject.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetSurfingPlayerObject.md new file mode 100644 index 00000000000..657a9a14813 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetSurfingPlayerObject.md @@ -0,0 +1,63 @@ +--- +title: NPC_GetSurfingPlayerObject +sidebar_label: NPC_GetSurfingPlayerObject +description: 获取 NPC 正在冲浪的玩家物体。 +tags: ["npc", "冲浪"] +--- + + + +## 描述 + +获取 NPC 正在冲浪的玩家物体。 + +| 参数 | 说明 | +| ----- | --------- | +| npcid | NPC 的 ID | + +## 返回值 + +返回玩家物体 ID，若未在玩家物体上冲浪则返回 `INVALID_OBJECT_ID`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checksurfingplayerobject", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new objectid = NPC_GetSurfingPlayerObject(npcid); + + if (objectid == INVALID_OBJECT_ID) + SendClientMessage(playerid, 0xFFFF00FF, "NPC %d 没有在任何玩家物体上冲浪。", npcid); + else + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 正在玩家物体上冲浪: %d", npcid, objectid); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 若 NPC 未在任何玩家物体上冲浪则返回 INVALID_OBJECT_ID +- 此函数仅检查玩家特定物体，不检查全局物体 + +## 相关函数 + +- [NPC_SetSurfingPlayerObject](NPC_SetSurfingPlayerObject): 设置 NPC 正在冲浪的玩家物体 +- [NPC_GetSurfingObject](NPC_GetSurfingObject): 获取 NPC 正在冲浪的物体 +- [NPC_GetSurfingVehicle](NPC_GetSurfingVehicle): 获取 NPC 正在冲浪的车辆 +- [NPC_GetSurfingOffsets](NPC_GetSurfingOffsets): 获取 NPC 的冲浪偏移 +- [NPC_ResetSurfingData](NPC_ResetSurfingData): 重置 NPC 的所有冲浪数据 + +## 相关回调 + +_此函数不会触发任何特定的回调。_ diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetSurfingVehicle.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetSurfingVehicle.md new file mode 100644 index 00000000000..d222d0510da --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetSurfingVehicle.md @@ -0,0 +1,62 @@ +--- +title: NPC_GetSurfingVehicle +sidebar_label: NPC_GetSurfingVehicle +description: 获取 NPC 正在冲浪的车辆。 +tags: ["npc", "冲浪", "车辆"] +--- + + + +## 描述 + +获取 NPC 正在冲浪的车辆。 + +| 参数 | 说明 | +| ----- | --------- | +| npcid | NPC 的 ID | + +## 返回值 + +返回车辆 ID，若未在车辆上冲浪则返回 `INVALID_VEHICLE_ID`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checksurfingvehicle", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new vehicleid = NPC_GetSurfingVehicle(npcid); + + if (vehicleid == INVALID_VEHICLE_ID) + SendClientMessage(playerid, 0xFFFF00FF, "NPC %d 没有在任何车辆上冲浪。", npcid); + else + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 正在车辆上冲浪: %d", npcid, vehicleid); + return 1; + } + return 0; +``` + +## 注意事项 + +- 若 NPC 未在任何车辆上冲浪则返回 `INVALID_VEHICLE_ID` +- 冲浪允许 NPC 在保持相对位置的同时随车辆移动 + +## 相关函数 + +- [NPC_SetSurfingVehicle](NPC_SetSurfingVehicle): 设置 NPC 正在冲浪的车辆 +- [NPC_GetSurfingObject](NPC_GetSurfingObject): 获取 NPC 正在冲浪的物体 +- [NPC_GetSurfingPlayerObject](NPC_GetSurfingPlayerObject): 获取 NPC 正在冲浪的玩家物体 +- [NPC_GetSurfingOffsets](NPC_GetSurfingOffsets): 获取 NPC 的冲浪偏移 +- [NPC_ResetSurfingData](NPC_ResetSurfingData): 重置 NPC 的所有冲浪数据 + +## 相关回调 + +_此函数不会触发任何特定的回调。_ diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetVehicle.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetVehicle.md new file mode 100644 index 00000000000..4667dd59352 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetVehicle.md @@ -0,0 +1,61 @@ +--- +title: NPC_GetVehicle +sidebar_label: NPC_GetVehicle +description: 获取 NPC 当前乘坐的车辆ID。 +tags: ["npc", "车辆"] +--- + + + +## 描述 + +获取 NPC 当前乘坐的车辆 ID。 + +| 参数 | 说明 | +| ----- | --------- | +| npcid | NPC 的 ID | + +## 返回值 + +返回 NPC 所在的车辆 ID，若未在任何车辆中则返回 INVALID_VEHICLE_ID。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkvehicle", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new vehicleid = NPC_GetVehicle(npcid); + + if (vehicleid == INVALID_VEHICLE_ID) + SendClientMessage(playerid, 0xFFFF00FF, "NPC %d 没有在任何车辆中。", npcid); + else + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 正在车辆里面: %d", npcid, vehicleid); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 若 NPC 未在任何车辆中则返回 INVALID_VEHICLE_ID + +## 相关函数 + +- [NPC_GetVehicleID](NPC_GetVehicleID): 具有相同行为的替代函数 +- [NPC_GetVehicleSeat](NPC_GetVehicleSeat): 获取 NPC 在车辆中的座位 +- [NPC_PutInVehicle](NPC_PutInVehicle): 将 NPC 放入车辆 +- [NPC_RemoveFromVehicle](NPC_RemoveFromVehicle): 将 NPC 从车辆中移出 + +## 相关回调 + +_此函数不会触发任何特定的回调。_ diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetVehicleGearState.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetVehicleGearState.md new file mode 100644 index 00000000000..37d323adbca --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetVehicleGearState.md @@ -0,0 +1,72 @@ +--- +title: NPC_GetVehicleGearState +sidebar_label: NPC_GetVehicleGearState +description: 获取 NPC 飞行器的起落架状态。 +tags: ["npc", "车辆", “飞机”, “起落架”] +--- + + + +## 描述 + +获取 NPC 飞行器的起落架状态。 + +| 参数 | 说明 | +| ----- | --------- | +| npcid | NPC 的 ID | + +## 返回值 + +返回 NPC 飞行器的起落架状态（LANDING_GEAR_STATE_DOWN 或 LANDING_GEAR_STATE_UP）。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkvehiclegearstate", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + if (NPC_GetVehicle(npcid) == INVALID_VEHICLE_ID) + return SendClientMessage(playerid, 0xFFFF00FF, "NPC %d 没有在任何车辆中。", npcid); + + new LANDING_GEAR_STATE:gearState = NPC_GetVehicleGearState(npcid); + + if (gearState == LANDING_GEAR_STATE_UP) + SendClientMessage(playerid, 0x00FF00FF, "NPC %d: 起落架已收起", npcid); + else + SendClientMessage(playerid, 0x00FF00FF, "NPC %d: 起落架已放下", npcid); + + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 仅在 NPC 驾驶飞行器时有效 +- 返回由 NPC_SetVehicleGearState 设置的当前起落架状态 +- 使用与[车辆起落架状态](../resources/landinggearstate)相同的常量：LANDING_GEAR_STATE_DOWN 和 LANDING_GEAR_STATE_UP +- 这是 GetPlayerLandingGearState 的 NPC 等效函数 + +## 相关函数 + +- [NPC_SetVehicleGearState](NPC_SetVehicleGearState): 设置飞行器起落架状态 +- [GetPlayerLandingGearState](GetPlayerLandingGearState): 获取玩家起落架状态 +- [GetVehicleLandingGearState](GetVehicleLandingGearState): 获取车辆起落架状态 +- [NPC_GetVehicle](NPC_GetVehicle): 获取 NPC 当前车辆 + +## 相关资源 + +- [车辆起落架状态](../resources/landinggearstate) + +## 相关回调 + +_此函数不会触发任何特定的回调。_ diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetVehicleHealth.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetVehicleHealth.md new file mode 100644 index 00000000000..b16949e5fde --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetVehicleHealth.md @@ -0,0 +1,64 @@ +--- +title: NPC_GetVehicleHealth +sidebar_label: NPC_GetVehicleHealth +description: 获取 NPC 车辆的生命值。 +tags: ["npc", "车辆"] +--- + + + +## 描述 + +获取 NPC 车辆的生命值。 + +| 参数 | 说明 | +| ----- | --------- | +| npcid | NPC 的 ID | + +## 返回值 + +返回车辆生命值（浮点数），若 NPC 不在车辆中则返回 0.0。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkvehiclehealth", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + if (NPC_GetVehicle(npcid) == INVALID_VEHICLE_ID) + return SendClientMessage(playerid, 0xFFFF00FF, "NPC %d 没有在任何车辆中。", npcid); + + new Float:health; + NPC_GetVehicleHealth(npcid, health); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 车辆生命值: %.2f", npcid, health); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 若 NPC 不在车辆中则返回 0.0 +- 车辆生命值通常范围在 0.0 到 1000.0 之间 +- 生命值低于 250.0 通常意味着车辆会起火 + +## 相关函数 + +- [NPC_SetVehicleHealth](NPC_SetVehicleHealth): 设置车辆生命值 +- [NPC_GetVehicle](NPC_GetVehicle): 获取 NPC 当前车辆 +- [NPC_GetVehicleID](NPC_GetVehicleID): 获取车辆 ID +- [NPC_PutInVehicle](NPC_PutInVehicle): 将 NPC 放入车辆 + +## 相关回调 + +_此函数不会触发任何特定的回调。_ diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetVehicleHydraThrusters.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetVehicleHydraThrusters.md new file mode 100644 index 00000000000..07479afbf08 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetVehicleHydraThrusters.md @@ -0,0 +1,68 @@ +--- +title: NPC_GetVehicleHydraThrusters +sidebar_label: NPC_GetVehicleHydraThrusters +description: 获取 NPC 的九头蛇战机推进器方向。 +tags: ["npc", "车辆", "九头蛇战机"] +--- + + + +## 描述 + +获取 NPC 的九头蛇战机推进器方向。 + +| 参数 | 说明 | +| ----- | --------- | +| npcid | NPC 的 ID | + +## 返回值 + +返回推进器方向（0 = 前进，1 = 垂直），若不在 九头蛇战机 中则返回-1。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkvehiclehydra", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + if (NPC_GetVehicle(npcid) == INVALID_VEHICLE_ID) + return SendClientMessage(playerid, 0xFFFF00FF, "NPC %d 没有在任何车辆中。", npcid); + + new thrusters = NPC_GetVehicleHydraThrusters(npcid); + + if (thrusters == 0) + SendClientMessage(playerid, 0x00FF00FF, "NPC %d: 九头蛇战机推进器 前进 (0)", npcid); + else + SendClientMessage(playerid, 0x00FF00FF, "NPC %d: 九头蛇战机推进器 垂直 (1)", npcid); + + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 仅适用于 九头蛇战机（模型 520） +- 若 NPC 不在 九头蛇战机 中或不在车辆中则返回-1 +- 方向 0 = 前进飞行模式（喷气机模式） +- 方向 1 = 垂直飞行模式（悬停模式） + +## 相关函数 + +- [NPC_SetVehicleHydraThrusters](NPC_SetVehicleHydraThrusters): 设置推进器方向 +- [NPC_GetVehicle](NPC_GetVehicle): 获取 NPC 当前车辆 +- [NPC_GetVehicleHealth](NPC_GetVehicleHealth): 获取车辆生命值 +- [NPC_PutInVehicle](NPC_PutInVehicle): 将 NPC 放入车辆 + +## 相关回调 + +_此函数不会触发任何特定的回调。_ diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetVehicleID.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetVehicleID.md new file mode 100644 index 00000000000..4fb0268c20a --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetVehicleID.md @@ -0,0 +1,61 @@ +--- +title: NPC_GetVehicleID +sidebar_label: NPC_GetVehicleID +description: 获取 NPC 当前乘坐的车辆ID。 +tags: ["npc", "车辆"] +--- + + + +## 描述 + +获取 NPC 当前乘坐的车辆 ID。 + +| 参数 | 说明 | +| ----- | --------- | +| npcid | NPC 的 ID | + +## 返回值 + +返回 NPC 所在的车辆 ID，若未在任何车辆中则返回 INVALID_VEHICLE_ID。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkvehicleid", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new vehicleid = NPC_GetVehicleID(npcid); + + if (vehicleid == INVALID_VEHICLE_ID) + SendClientMessage(playerid, 0xFFFF00FF, "NPC %d 没在任何车辆中。", npcid); + else + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 车辆 ID: %d", npcid, vehicleid); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 若 NPC 未在任何车辆中则返回 INVALID_VEHICLE_ID + +## 相关函数 + +- [NPC_GetVehicleSeat](NPC_GetVehicleSeat): 获取 NPC 在车辆中的座位 +- [NPC_PutInVehicle](NPC_PutInVehicle): 将 NPC 放入车辆 +- [NPC_RemoveFromVehicle](NPC_RemoveFromVehicle): 将 NPC 从车辆中移出 +- [NPC_GetVehicle](NPC_GetVehicle): 具有相同行为的替代函数 + +## 相关回调 + +_此函数不会触发任何特定的回调。_ diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetVehicleSeat.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetVehicleSeat.md new file mode 100644 index 00000000000..9b05834cee4 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetVehicleSeat.md @@ -0,0 +1,72 @@ +--- +title: NPC_GetVehicleSeat +sidebar_label: NPC_GetVehicleSeat +description: 获取 NPC 在车辆中的座位ID。 +tags: ["npc", "车辆"] +--- + + + +## 描述 + +获取 NPC 在车辆中的座位 ID。 + +| 参数 | 说明 | +| ----- | --------- | +| npcid | NPC 的 ID | + +## 返回值 + +返回座位 ID，若不在车辆中则返回-1。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkvehicleseat", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + if (NPC_GetVehicle(npcid) == INVALID_VEHICLE_ID) + return SendClientMessage(playerid, 0xFFFF00FF, "NPC %d 没在任何车辆中。", npcid); + + new seatid = NPC_GetVehicleSeat(npcid); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 在车辆中的座位: %d", npcid, seatid); + return 1; + } + return 0; +} +``` + +## 座位 ID + +| ID | 座位 | +| --- | ------------------ | +| 0 | 驾驶员 | +| 1 | 副驾驶乘客 | +| 2 | 后左乘客 | +| 3 | 后右乘客 | +| 4+ | 乘客座位（大巴等） | + +## 注意事项 + +- 若 NPC 未在任何车辆中则返回-1 +- 座位 0 始终为驾驶员座位 +- 最大座位 ID 取决于车辆模型 + +## 相关函数 + +- [NPC_GetVehicleID](NPC_GetVehicleID): 获取 NPC 的车辆 ID +- [NPC_PutInVehicle](NPC_PutInVehicle): 将 NPC 放入车辆 +- [NPC_RemoveFromVehicle](NPC_RemoveFromVehicle): 将 NPC 从车辆中移出 + +## 相关回调 + +_此函数不会触发任何特定的回调。_ diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetVehicleTrainSpeed.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetVehicleTrainSpeed.md new file mode 100644 index 00000000000..dab6507cd6d --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetVehicleTrainSpeed.md @@ -0,0 +1,61 @@ +--- +title: NPC_GetVehicleTrainSpeed +sidebar_label: NPC_GetVehicleTrainSpeed +description: 获取 NPC 驾驶的火车的速度。 +tags: ["npc", "车辆", "火车"] +--- + + + +## 描述 + +获取 NPC 驾驶的火车的速度。 + +| 参数 | 说明 | +| ----- | --------- | +| npcid | NPC 的 ID | + +## 返回值 + +返回火车速度（浮点数），若不在火车中则返回 0.0。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkvehicletrainspeed", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + if (NPC_GetVehicle(npcid) == INVALID_VEHICLE_ID) + return SendClientMessage(playerid, 0xFFFF00FF, "NPC %d 没在任何车辆中。", npcid); + + new Float:speed = NPC_GetVehicleTrainSpeed(npcid); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 驾驶的火车的速度: %.2f", npcid, speed); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 仅在 NPC 驾驶火车车辆时有效 +- 若 NPC 不在火车中或不是驾驶员则返回 0.0 + +## 相关函数 + +- [NPC_SetVehicleTrainSpeed](NPC_SetVehicleTrainSpeed): 设置火车速度 +- [NPC_GetVehicleID](NPC_GetVehicleID): 获取 NPC 的车辆 +- [NPC_PutInVehicle](NPC_PutInVehicle): 将 NPC 放入车辆 + +## 相关回调 + +_此函数不会触发任何特定的回调。_ diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetVelocity.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetVelocity.md new file mode 100644 index 00000000000..db4ac471040 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetVelocity.md @@ -0,0 +1,65 @@ +--- +title: NPC_GetVelocity +sidebar_label: NPC_GetVelocity +description: 获取NPC的速度 +tags: ["npc", "速度", "移动"] +--- + + + +## 描述 + +获取 NPC 的速度。 + +| 参数 | 说明 | +| -------- | --------------------------------------- | +| npcid | NPC 的 ID | +| &Float:x | 用于存储 X 速度分量的变量，通过引用传递 | +| &Float:y | 用于存储 Y 速度分量的变量，通过引用传递 | +| &Float:z | 用于存储 Z 速度分量的变量，通过引用传递 | + +## 返回值 + +成功时返回 `true`，失败时返回 `false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkvelocity", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new Float:velX, Float:velY, Float:velZ; + NPC_GetVelocity(npcid, velX, velY, velZ); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 的速度: X=%.2f, Y=%.2f, Z=%.2f", npcid, velX, velY, velZ); + return 1; + } + return 0; +} +``` + +## 注意事项 + +:::warning + +- 所有速度参数都通过引用传递，将被修改 + +::: + +## 相关函数 + +- [NPC_SetVelocity](NPC_SetVelocity): 设置 NPC 速度 +- [NPC_GetPos](NPC_GetPos): 获取 NPC 位置 +- [NPC_Move](NPC_Move): 使 NPC 移动到指定位置 + +## 相关回调 + +- [OnNPCFinishMove](../callbacks/OnNPCFinishMove): 当 NPC 完成移动时被调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetVirtualWorld.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetVirtualWorld.md new file mode 100644 index 00000000000..0a759e57151 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetVirtualWorld.md @@ -0,0 +1,63 @@ +--- +title: NPC_GetVirtualWorld +sidebar_label: NPC_GetVirtualWorld +description: 获取 NPC 所在的虚拟世界。 +tags: ["npc"] +--- + + + +## 描述 + +获取 NPC 所在的虚拟世界。 + +| 参数 | 说明 | +| ----- | --------- | +| npcid | NPC 的 ID | + +## 返回值 + +返回虚拟世界 ID，出错时返回 0。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkvirtualworld", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new vw = NPC_GetVirtualWorld(npcid); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 的虚拟世界: %d", npcid, vw); + return 1; + } + return 0; +} +``` + +## 注意事项 + +:::warning + +- 虚拟世界允许分离 NPC 和玩家。 +- 不同虚拟世界中的 NPC 无法互相看到。 +- 虚拟世界 0 是默认世界。 + +::: + +## 相关函数 + +- [NPC_SetVirtualWorld](NPC_SetVirtualWorld): 设置 NPC 虚拟世界。 +- [NPC_GetInterior](NPC_GetInterior): 获取 NPC 室内。 +- [NPC_SetInterior](NPC_SetInterior): 设置 NPC 室内。 + +## 相关回调 + +- [../callbacks/OnNPCSpawn](../callbacks/OnNPCSpawn): NPC 生成时调用。 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetWeapon.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetWeapon.md new file mode 100644 index 00000000000..d0d25e3312c --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetWeapon.md @@ -0,0 +1,59 @@ +--- +title: NPC_GetWeapon +sidebar_label: NPC_GetWeapon +description: 获取 NPC 当前持有的武器。 +tags: ["npc", "武器"] +--- + + + +## 描述 + +获取 NPC 当前持有的武器。 + +| 参数 | 说明 | +| ----- | --------- | +| npcid | NPC 的 ID | + +## 返回值 + +返回 NPC 当前持有的武器 ID。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkweapon", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new weapon = NPC_GetWeapon(npcid); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 武器: %d", npcid, weapon); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 若 NPC 没有武器则返回 0（拳头） +- 武器 ID 与玩家武器 ID 相同 + +## 相关函数 + +- [NPC_SetWeapon](NPC_SetWeapon): 设置 NPC 武器 +- [NPC_GetAmmo](NPC_GetAmmo): 获取 NPC 弹药 +- [NPC_SetAmmo](NPC_SetAmmo): 设置 NPC 弹药 +- [NPC_RemoveWeapon](NPC_RemoveWeapon): 移除 NPC 武器 + +## 相关回调 + +- [../callbacks/OnNPCWeaponShot](../callbacks/OnNPCWeaponShot): NPC 开火时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetWeaponAccuracy.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetWeaponAccuracy.md new file mode 100644 index 00000000000..d72c6a5ecb0 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetWeaponAccuracy.md @@ -0,0 +1,61 @@ +--- +title: NPC_GetWeaponAccuracy +sidebar_label: NPC_GetWeaponAccuracy +description: 获取 NPC 武器的精度设置。 +tags: ["npc", "武器"] +--- + + + +## 描述 + +获取 NPC 武器的精度设置。 + +| 参数 | 说明 | +| -------- | --------------- | +| npcid | NPC 的 ID | +| weaponid | 要检查的武器 ID | + +## 返回值 + +返回精度值（0.0 到 1.0），出错时返回-1.0。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkweaponaccuracy", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new weapon = NPC_GetWeapon(npcid); + new Float:accuracy = NPC_GetWeaponAccuracy(npcid, WEAPON:weapon); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 武器 %d 精度: %.2f", npcid, weapon, accuracy); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 精度是介于 0.0（0%准确）和 1.0（100%准确）之间的值 +- 若 NPC ID 无效或武器不存在则返回-1.0 + +## 相关函数 + +- [NPC_SetWeaponAccuracy](NPC_SetWeaponAccuracy): 设置武器精度 +- [NPC_GetWeapon](NPC_GetWeapon): 获取 NPC 当前武器 +- [NPC_SetWeapon](NPC_SetWeapon): 设置 NPC 武器 + +## 相关回调 + +- [../callbacks/OnNPCWeaponShot](../callbacks/OnNPCWeaponShot): NPC 开火时调用 +- [../callbacks/OnNPCWeaponStateChange](../callbacks/OnNPCWeaponStateChange): 武器状态改变时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetWeaponActualClipSize.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetWeaponActualClipSize.md new file mode 100644 index 00000000000..7b9fa809f6a --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetWeaponActualClipSize.md @@ -0,0 +1,60 @@ +--- +title: NPC_GetWeaponActualClipSize +sidebar_label: NPC_GetWeaponActualClipSize +description: 获取 NPC 武器的实际（默认）弹夹容量。 +tags: ["npc", "武器"] +--- + + + +## 描述 + +从游戏数据中获取 NPC 武器的实际（默认）弹夹容量。 + +| 参数 | 说明 | +| -------- | --------------- | +| npcid | NPC 的 ID | +| weaponid | 要检查的武器 ID | + +## 返回值 + +返回默认弹夹容量，出错时返回-1。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkweaponactualclipsize", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new weapon = NPC_GetWeapon(npcid); + new clipsize = NPC_GetWeaponActualClipSize(npcid, WEAPON:weapon); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 武器的实际弹夹容量: %d", npcid, clipsize); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 返回武器的原始游戏弹夹容量 +- 这与使用`NPC_SetWeaponClipSize`设置的自定义弹夹容量不同 + +## 相关函数 + +- [NPC_SetWeaponClipSize](NPC_SetWeaponClipSize): 设置自定义弹夹容量 +- [NPC_GetWeaponClipSize](NPC_GetWeaponClipSize): 获取当前弹夹容量 +- [NPC_GetAmmo](NPC_GetAmmo): 获取 NPC 当前弹药 + +## 相关回调 + +- [../callbacks/OnNPCWeaponStateChange](../callbacks/OnNPCWeaponStateChange): 武器状态改变时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetWeaponActualReloadTime.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetWeaponActualReloadTime.md new file mode 100644 index 00000000000..aa10514d25f --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetWeaponActualReloadTime.md @@ -0,0 +1,60 @@ +--- +title: NPC_GetWeaponActualReloadTime +sidebar_label: NPC_GetWeaponActualReloadTime +description: 获取 NPC 武器的实际（默认）换弹时间。 +tags: ["npc", "武器"] +--- + + + +## 描述 + +从游戏数据中获取 NPC 武器的实际（默认）换弹时间。 + +| 参数 | 说明 | +| -------- | --------------- | +| npcid | NPC 的 ID | +| weaponid | 要检查的武器 ID | + +## 返回值 + +返回默认换弹时间（毫秒），出错时返回-1。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkweaponactualreloadtime", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new weapon = NPC_GetWeapon(npcid); + new reloadtime = NPC_GetWeaponActualReloadTime(npcid, WEAPON:weapon); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 武器实际装弹时间: %d 毫秒", npcid, reloadtime); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 返回武器的原始游戏换弹时间 +- 这与使用`NPC_SetWeaponReloadTime`设置的自定义换弹时间不同 + +## 相关函数 + +- [NPC_SetWeaponReloadTime](NPC_SetWeaponReloadTime): 设置自定义换弹时间 +- [NPC_GetWeaponReloadTime](NPC_GetWeaponReloadTime): 获取当前换弹时间 +- [NPC_IsReloading](NPC_IsReloading): 检查 NPC 是否正在换弹 + +## 相关回调 + +- [../callbacks/OnNPCWeaponStateChange](../callbacks/OnNPCWeaponStateChange): 武器状态改变时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetWeaponClipSize.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetWeaponClipSize.md new file mode 100644 index 00000000000..066642c45ec --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetWeaponClipSize.md @@ -0,0 +1,60 @@ +--- +title: NPC_GetWeaponClipSize +sidebar_label: NPC_GetWeaponClipSize +description: 获取 NPC 武器的弹夹容量设置。 +tags: ["npc", "武器"] +--- + + + +## 描述 + +获取 NPC 武器的弹夹容量设置。 + +| 参数 | 说明 | +| -------- | --------------- | +| npcid | NPC 的 ID | +| weaponid | 要检查的武器 ID | + +## 返回值 + +返回武器的弹夹容量，出错时返回-1。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkweaponclipsize", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new weapon = NPC_GetWeapon(npcid); + new clipsize = NPC_GetWeaponClipSize(npcid, WEAPON:weapon); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 武器的弹夹容量为: %d", npcid, clipsize); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 返回当前自定义弹夹容量设置 +- 不同武器有不同的默认弹夹容量 + +## 相关函数 + +- [NPC_SetWeaponClipSize](NPC_SetWeaponClipSize): 设置武器弹夹容量 +- [NPC_GetWeapon](NPC_GetWeapon): 获取 NPC 当前武器 +- [NPC_GetAmmo](NPC_GetAmmo): 获取 NPC 当前弹药 + +## 相关回调 + +- [../callbacks/OnNPCWeaponStateChange](../callbacks/OnNPCWeaponStateChange): 武器状态改变时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetWeaponReloadTime.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetWeaponReloadTime.md new file mode 100644 index 00000000000..c52ec17e271 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetWeaponReloadTime.md @@ -0,0 +1,62 @@ +--- +title: NPC_GetWeaponReloadTime +sidebar_label: NPC_GetWeaponReloadTime +description: 获取 NPC 武器的换弹时间。 +tags: ["npc", "武器", "换弹"] +--- + + + +## 描述 + +获取 NPC 武器的换弹时间。 + +| 参数 | 说明 | +| -------- | ----------------------- | +| npcid | NPC 的 ID | +| weaponid | 要获取换弹时间的武器 ID | + +## 返回值 + +返回指定武器的换弹时间（毫秒）。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkweaponreloadtime", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new weapon = NPC_GetWeapon(npcid); + new reloadtime = NPC_GetWeaponReloadTime(npcid, WEAPON:weapon); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 武器的换弹时间: %d 毫秒", npcid, reloadtime); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 返回当前自定义换弹时间设置 +- 使用 NPC_GetWeaponActualReloadTime 获取默认游戏换弹时间 +- 换弹时间影响 NPC 换弹所需的时间 + +## 相关函数 + +- [NPC_SetWeaponReloadTime](NPC_SetWeaponReloadTime): 设置换弹时间 +- [NPC_GetWeaponActualReloadTime](NPC_GetWeaponActualReloadTime): 获取默认换弹时间 +- [NPC_IsReloading](NPC_IsReloading): 检查 NPC 是否正在换弹 +- [NPC_EnableReloading](NPC_EnableReloading): 启用/禁用换弹 + +## 相关回调 + +- [../callbacks/OnNPCWeaponStateChange](../callbacks/OnNPCWeaponStateChange): 武器状态改变时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetWeaponShootTime.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetWeaponShootTime.md new file mode 100644 index 00000000000..97454a0b647 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetWeaponShootTime.md @@ -0,0 +1,62 @@ +--- +title: NPC_GetWeaponShootTime +sidebar_label: NPC_GetWeaponShootTime +description: 获取 NPC 武器的射击时间。 +tags: ["npc", "武器"] +--- + + + +## 描述 + +获取 NPC 武器的射击时间。 + +| 参数 | 说明 | +| -------- | ----------------------- | +| npcid | NPC 的 ID | +| weaponid | 要获取射击时间的武器 ID | + +## 返回值 + +返回指定武器的射击时间（毫秒）。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkweaponshoottime", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new weapon = NPC_GetWeapon(npcid); + new shoottime = NPC_GetWeaponShootTime(npcid, WEAPON:weapon); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 武器 %d 射击时间: %d 毫秒", npcid, weapon, shoottime); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 射击时间影响射击之间的延迟 +- 数值越低意味着射击速率越快 +- 不同武器有不同的默认射击时间 + +## 相关函数 + +- [NPC_SetWeaponShootTime](NPC_SetWeaponShootTime): 设置射击时间 +- [NPC_GetWeapon](NPC_GetWeapon): 获取 NPC 当前武器 +- [NPC_Shoot](NPC_Shoot): 让 NPC 射击 +- [NPC_IsShooting](NPC_IsShooting): 检查 NPC 是否正在射击 + +## 相关回调 + +- [../callbacks/OnNPCWeaponShot](../callbacks/OnNPCWeaponShot): NPC 开火时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetWeaponSkillLevel.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetWeaponSkillLevel.md new file mode 100644 index 00000000000..9dcc5c086fe --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetWeaponSkillLevel.md @@ -0,0 +1,71 @@ +--- +title: NPC_GetWeaponSkillLevel +sidebar_label: NPC_GetWeaponSkillLevel +description: 获取NPC的武器技能等级 +tags: ["npc", "武器", "技能"] +--- + + + +## 描述 + +获取 NPC 的武器技能等级。 + +| 参数 | 说明 | +| ----- | -------------------------- | +| npcid | NPC 的 ID | +| skill | 武器技能类型 (WEAPONSKILL) | + +## 返回值 + +返回武器技能等级（0-999），失败时返回 `UNKNOWN_WEAPONSKILL`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkweaponskill", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new pistol = NPC_GetWeaponSkillLevel(npcid, WEAPONSKILL_PISTOL); + new silenced = NPC_GetWeaponSkillLevel(npcid, WEAPONSKILL_PISTOL_SILENCED); + new deagle = NPC_GetWeaponSkillLevel(npcid, WEAPONSKILL_DESERT_EAGLE); + new shotgun = NPC_GetWeaponSkillLevel(npcid, WEAPONSKILL_SHOTGUN); + new micro = NPC_GetWeaponSkillLevel(npcid, WEAPONSKILL_MICRO_UZI); + new mp5 = NPC_GetWeaponSkillLevel(npcid, WEAPONSKILL_MP5); + new ak47 = NPC_GetWeaponSkillLevel(npcid, WEAPONSKILL_AK47); + new m4 = NPC_GetWeaponSkillLevel(npcid, WEAPONSKILL_M4); + new sniper = NPC_GetWeaponSkillLevel(npcid, WEAPONSKILL_SNIPERRIFLE); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 的武器技能:", npcid); + SendClientMessage(playerid, 0xFFFFFFFF, "手枪:%d 消音手枪:%d 沙漠之鹰:%d 霰弹枪:%d", pistol, silenced, deagle, shotgun); + SendClientMessage(playerid, 0xFFFFFFFF, "微型冲锋枪:%d MP5:%d AK47:%d M4:%d 狙击枪:%d", micro, mp5, ak47, m4, sniper); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 武器技能影响准确度和射击行为 +- 技能等级范围从 0（差）到 999（杀手级） +- 若 NPC 无效或技能类型无效，则返回 `UNKNOWN_WEAPONSKILL` + +## 相关函数 + +- [NPC_SetWeaponSkillLevel](NPC_SetWeaponSkillLevel): 设置 NPC 武器技能等级 +- [NPC_GetWeaponAccuracy](NPC_GetWeaponAccuracy): 获取武器准确度 +- [NPC_SetWeaponAccuracy](NPC_SetWeaponAccuracy): 设置武器准确度 +- [NPC_GetWeapon](NPC_GetWeapon): 获取 NPC 武器 + +## 相关回调 + +- [OnNPCWeaponShot](../callbacks/OnNPCWeaponShot): 当 NPC 开火时被调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetWeaponState.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetWeaponState.md new file mode 100644 index 00000000000..a77748467f8 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_GetWeaponState.md @@ -0,0 +1,69 @@ +--- +title: NPC_GetWeaponState +sidebar_label: NPC_GetWeaponState +description: 获取 NPC 的武器状态。 +tags: ["npc", "武器"] +--- + + + +## 描述 + +获取 NPC 的武器状态。 + +| 参数 | 说明 | +| ----- | --------- | +| npcid | NPC 的 ID | + +## 返回值 + +返回武器状态 ID。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkweaponstate", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new WEAPONSTATE:state = WEAPONSTATE:NPC_GetWeaponState(npcid); + + static weaponStates[5][64] = + { + "未知", + "没有剩余弹药", + "剩下一发子弹", + "剩余多发子弹", + "正在换弹" + }; + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 武器状态：%s (%d)", npcid, weaponStates[state], _:state); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 武器状态包括换弹、射击、弹药耗尽等 +- 使用此函数检查 NPC 武器的当前状态 +- 状态值对应 PlayerWeaponState 常量 + +## 相关函数 + +- [NPC_GetWeapon](NPC_GetWeapon): 获取 NPC 当前武器 +- [NPC_IsReloading](NPC_IsReloading): 检查 NPC 是否正在换弹 +- [NPC_IsShooting](NPC_IsShooting): 检查 NPC 是否正在射击 +- [NPC_GetAmmoInClip](NPC_GetAmmoInClip): 获取弹夹中的弹药 + +## 相关回调 + +- [../callbacks/OnNPCWeaponStateChange](../callbacks/OnNPCWeaponStateChange): 武器状态改变时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_HasPathPointInRange.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_HasPathPointInRange.md new file mode 100644 index 00000000000..fc8afefcd8b --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_HasPathPointInRange.md @@ -0,0 +1,68 @@ +--- +title: NPC_HasPathPointInRange +sidebar_label: NPC_HasPathPointInRange +description: 检查路径中是否有任何点在给定坐标的指定范围内。 +tags: ["npc", "路径"] +--- + + + +## 描述 + +检查路径中是否有任何点在给定坐标的指定范围内。 + +| 参数 | 说明 | +| ------ | -------------------- | +| pathId | 要检查的路径 ID | +| x | 中心位置的 X 坐标 | +| y | 中心位置的 Y 坐标 | +| z | 中心位置的 Z 坐标 | +| radius | 检查路径点的半径范围 | + +## 返回值 + +如果路径在指定范围内至少有一个点则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkpathpointinrange ", true, 23)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new pathid = strval(cmdtext[23]); + + new Float:x, Float:y, Float:z; + GetPlayerPos(playerid, x, y, z); + new bool:hasPoint = NPC_HasPathPointInRange(pathid, x, y, z, 50.0); + + SendClientMessage(playerid, 0x00FF00FF, "路径 %d 是否有点在你附近 (%.2f, %.2f, %.2f): %s", pathid, x, y, z, hasPoint ? "是" : "否"); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 此函数用于在开始路径移动前检查 NPC 路径是否与特定区域或位置相交 +- 函数检查给定位置与每个路径点之间的 3D 距离 +- 只有至少有一个点的有效路径才能返回`true` + +## 相关函数 + +- [NPC_CreatePath](NPC_CreatePath): 创建 NPC 移动的新路径 +- [NPC_AddPointToPath](NPC_AddPointToPath): 向路径添加点 +- [NPC_GetPathPoint](NPC_GetPathPoint): 获取路径中特定点的信息 +- [NPC_MoveByPath](NPC_MoveByPath): 使 NPC 跟随预定义路径 + +## 相关回调 + +_此函数不会触发任何特定的回调。_ diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsAiming.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsAiming.md new file mode 100644 index 00000000000..d497368d882 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsAiming.md @@ -0,0 +1,61 @@ +--- +title: NPC_IsAiming +sidebar_label: NPC_IsAiming +description: 检查 NPC 是否正在瞄准。 +tags: ["npc", "武器", "瞄准"] +--- + + + +## 描述 + +检查 NPC 是否正在瞄准。 + +| 参数 | 说明 | +| ----- | --------- | +| npcid | NPC 的 ID | + +## 返回值 + +如果 NPC 正在瞄准则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkaiming", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new bool:isAiming = NPC_IsAiming(npcid); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 正在瞄准: %s", npcid, isAiming ? "是" : "否"); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 当 NPC 正在进行瞄准目标时返回 true +- 使用此函数检查 NPC 是否处于战斗模式 +- 瞄准可以通过 NPC_AimAt 或 NPC_AimAtPlayer 启动 +- NPC 会持续瞄准直到使用 NPC_StopAim 停止 + +## 相关函数 + +- [NPC_AimAt](NPC_AimAt): 让 NPC 瞄准位置 +- [NPC_AimAtPlayer](NPC_AimAtPlayer): 让 NPC 瞄准玩家 +- [NPC_StopAim](NPC_StopAim): 停止 NPC 瞄准 +- [NPC_IsAimingAtPlayer](NPC_IsAimingAtPlayer): 检查是否瞄准特定玩家 + +## 相关回调 + +- [../callbacks/OnNPCWeaponShot](../callbacks/OnNPCWeaponShot): NPC 开火时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsAimingAtPlayer.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsAimingAtPlayer.md new file mode 100644 index 00000000000..7ba7287d965 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsAimingAtPlayer.md @@ -0,0 +1,61 @@ +--- +title: NPC_IsAimingAtPlayer +sidebar_label: NPC_IsAimingAtPlayer +description: 检查 NPC 是否正在瞄准特定玩家。 +tags: ["npc", "武器", "瞄准"] +--- + + + +## 描述 + +检查 NPC 是否正在瞄准特定玩家。 + +| 参数 | 说明 | +| -------- | --------------- | +| npcid | NPC 的 ID | +| playerid | 要检查的玩家 ID | + +## 返回值 + +如果 NPC 正在瞄准指定玩家则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkaimingat", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new bool:isAimingAtPlayer = NPC_IsAimingAtPlayer(npcid, playerid); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 正在瞄准你: %s", npcid, isAimingAtPlayer ? "是" : "否"); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 只有当 NPC 特别针对给定玩家时才返回 true +- 使用此函数检查玩家是否被 NPC 瞄准 +- NPC 必须使用 NPC_AimAtPlayer 此函数才返回 true + +## 相关函数 + +- [NPC_AimAtPlayer](NPC_AimAtPlayer): 让 NPC 瞄准玩家 +- [NPC_IsAiming](NPC_IsAiming): 检查 NPC 是否正在瞄准 +- [NPC_StopAim](NPC_StopAim): 停止 NPC 瞄准 +- [NPC_AimAt](NPC_AimAt): 让 NPC 瞄准位置 + +## 相关回调 + +- [../callbacks/OnNPCWeaponShot](../callbacks/OnNPCWeaponShot): NPC 开火时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsAnyStreamedIn.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsAnyStreamedIn.md new file mode 100644 index 00000000000..f670a9fa063 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsAnyStreamedIn.md @@ -0,0 +1,51 @@ +--- +title: NPC_IsAnyStreamedIn +sidebar_label: NPC_IsAnyStreamedIn +description: 检查 NPC 是否对任何玩家已流加载。 +tags: ["npc", "流加载"] +--- + + + +## 描述 + +检查 NPC 是否对服务器上的任何玩家已流加载。 + +| 参数 | 说明 | +| ----- | --------- | +| npcid | NPC 的 ID | + +## 返回值 + +如果 NPC 对至少一个玩家已流加载则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkanystreamedin", true)) + { + new bool:anyStreamed = NPC_IsAnyStreamedIn(playerid); + + SendClientMessage(playerid, 0x00FF00FF, "任何NPC已对你流加载: %s", anyStreamed ? "是" : "否"); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 当 NPC 在玩家的流加载范围内时已流加载 + +## 相关函数 + +- [NPC_IsStreamedIn](NPC_IsStreamedIn): 检查是否对特定玩家流加载 +- [NPC_SetPos](NPC_SetPos): 设置 NPC 位置 +- [NPC_SetVirtualWorld](NPC_SetVirtualWorld): 设置 NPC 虚拟世界 +- [NPC_SetInterior](NPC_SetInterior): 设置 NPC 室内 + +## 相关回调 + +- [../callbacks/OnNPCSpawn](../callbacks/OnNPCSpawn): NPC 生成时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsDead.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsDead.md new file mode 100644 index 00000000000..60f69bd4d68 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsDead.md @@ -0,0 +1,63 @@ +--- +title: NPC_IsDead +sidebar_label: NPC_IsDead +description: 检查 NPC 是否死亡。 +tags: ["npc"] +--- + + + +## 描述 + +检查 NPC 是否死亡。 + +| 参数 | 说明 | +| ----- | ------------------ | +| npcid | 要检查的 NPC 的 ID | + +## 返回值 + +如果 NPC 已死亡则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkdead", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new bool:isDead = NPC_IsDead(npcid); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 是否死亡: %s", npcid, isDead ? "是" : "否"); + return 1; + } + return 0; +} +``` + +## 注意事项 + +:::warning + +- 当 NPC 的生命值达到 0.0 或以下时被视为死亡。 +- 死亡的 NPC 可以使用[NPC_Respawn](NPC_Respawn)重生。 + +::: + +## 相关函数 + +- [NPC_GetHealth](NPC_GetHealth): 获取 NPC 的生命值 +- [NPC_SetHealth](NPC_SetHealth): 设置 NPC 的生命值 +- [NPC_Respawn](NPC_Respawn): 重生 NPC + +## 相关回调 + +- [../callbacks/OnNPCDeath](../callbacks/OnNPCDeath): NPC 死亡时调用 +- [../callbacks/OnNPCTakeDamage](../callbacks/OnNPCTakeDamage): NPC 受到伤害时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsEnteringVehicle.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsEnteringVehicle.md new file mode 100644 index 00000000000..84ede0195dc --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsEnteringVehicle.md @@ -0,0 +1,60 @@ +--- +title: NPC_IsEnteringVehicle +sidebar_label: NPC_IsEnteringVehicle +description: 检查 NPC 是否正在进入车辆。 +tags: ["npc", "车辆"] +--- + + + +## 描述 + +检查 NPC 当前是否正在进入车辆的过程中。 + +| 参数 | 说明 | +| ----- | --------- | +| npcid | NPC 的 ID | + +## 返回值 + +如果 NPC 正在进入车辆则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkenteringvehicle", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new bool:isEntering = NPC_IsEnteringVehicle(npcid); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 正在进入车辆: %s", npcid, isEntering ? "是" : "否"); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 仅在进入动画/过程中返回 true +- 一旦 NPC 完全进入车辆，此函数返回 false +- NPC 必须已通过 NPC_EnterVehicle 被指示进入车辆 + +## 相关函数 + +- [NPC_EnterVehicle](NPC_EnterVehicle): 让 NPC 进入车辆 +- [NPC_GetEnteringVehicleID](NPC_GetEnteringVehicleID): 获取正在进入的车辆 ID +- [NPC_GetEnteringVehicleSeat](NPC_GetEnteringVehicleSeat): 获取正在进入的座位 +- [NPC_GetVehicle](NPC_GetVehicle): 获取当前车辆 + +## 相关回调 + +_此函数不会触发任何特定的回调。_ diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsInfiniteAmmoEnabled.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsInfiniteAmmoEnabled.md new file mode 100644 index 00000000000..d3cfbd25de0 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsInfiniteAmmoEnabled.md @@ -0,0 +1,60 @@ +--- +title: NPC_IsInfiniteAmmoEnabled +sidebar_label: NPC_IsInfiniteAmmoEnabled +description: 检查 NPC 是否启用了无限弹药。 +tags: ["npc", "武器", "子弹"] +--- + + + +## 描述 + +检查 NPC 是否启用了无限弹药。 + +| 参数 | 说明 | +| ----- | --------- | +| npcid | NPC 的 ID | + +## 返回值 + +如果启用了无限弹药则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkinfiniteammo", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new bool:infiniteAmmo = NPC_IsInfiniteAmmoEnabled(npcid); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 无限子弹启用: %s", npcid, infiniteAmmo ? "是" : "否"); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 无限弹药防止 NPC 耗尽弹药 +- 弹药计数可能仍显示为减少，但武器功能保持正常 +- 可以通过 NPC_EnableInfiniteAmmo 切换 + +## 相关函数 + +- [NPC_EnableInfiniteAmmo](NPC_EnableInfiniteAmmo): 启用/禁用无限弹药 +- [NPC_GetAmmo](NPC_GetAmmo): 获取 NPC 弹药 +- [NPC_SetAmmo](NPC_SetAmmo): 设置 NPC 弹药 +- [NPC_GetWeapon](NPC_GetWeapon): 获取 NPC 武器 + +## 相关回调 + +- [../callbacks/OnNPCWeaponShot](../callbacks/OnNPCWeaponShot): NPC 开火时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsInvulnerable.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsInvulnerable.md new file mode 100644 index 00000000000..970d9a26a9f --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsInvulnerable.md @@ -0,0 +1,60 @@ +--- +title: NPC_IsInvulnerable +sidebar_label: NPC_IsInvulnerable +description: 检查 NPC 是否对伤害免疫。 +tags: ["npc", "无敌", "伤害", "保护"] +--- + + + +## 描述 + +检查 NPC 是否对伤害免疫。 + +| 参数 | 说明 | +| ----- | --------- | +| npcid | NPC 的 ID | + +## 返回值 + +如果 NPC 免疫伤害则返回 true，否则返回 false。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkinvulnerable", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new bool:isInvulnerable = NPC_IsInvulnerable(npcid); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 伤害免疫: %s", npcid, isInvulnerable ? "是" : "否"); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 返回由`NPC_SetInvulnerable`设置的免疫状态 +- NPC 在创建时默认是脆弱的 + +## 相关函数 + +- [NPC_SetInvulnerable](NPC_SetInvulnerable): 设置 NPC 免疫性 +- [NPC_IsValid](NPC_IsValid): 检查 NPC ID 是否有效 +- [NPC_IsDead](NPC_IsDead): 检查 NPC 是否死亡 +- [NPC_GetHealth](NPC_GetHealth): 获取 NPC 生命值 + +## 相关回调 + +- [../callbacks/OnNPCTakeDamage](../callbacks/OnNPCTakeDamage): NPC 受到伤害时调用（免疫 NPC 不会调用） +- [../callbacks/OnNPCDeath](../callbacks/OnNPCDeath): NPC 死亡时调用（免疫 NPC 不会死亡） diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsMeleeAttacking.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsMeleeAttacking.md new file mode 100644 index 00000000000..8a04fbb3c63 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsMeleeAttacking.md @@ -0,0 +1,59 @@ +--- +title: NPC_IsMeleeAttacking +sidebar_label: NPC_IsMeleeAttacking +description: 检查 NPC 是否正在进行近战攻击。 +tags: ["npc", "近战攻击", "战斗风格"] +--- + + + +## 描述 + +检查 NPC 是否正在进行近战攻击。 + +| 参数 | 说明 | +| ----- | --------- | +| npcid | NPC 的 ID | + +## 返回值 + +如果 NPC 正在进行近战攻击则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkmeleeattacking", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new bool:isMeleeAttacking = NPC_IsMeleeAttacking(npcid); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 正在进行近战攻击: %s", npcid, isMeleeAttacking ? "是" : "否"); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 在近战攻击动画期间返回 true +- 近战攻击通过 NPC_MeleeAttack 启动 + +## 相关函数 + +- [NPC_MeleeAttack](NPC_MeleeAttack): 开始近战攻击 +- [NPC_StopMeleeAttack](NPC_StopMeleeAttack): 停止近战攻击 +- [NPC_SetFightingStyle](NPC_SetFightingStyle): 设置战斗风格 +- [NPC_GetFightingStyle](NPC_GetFightingStyle): 获取战斗风格 + +## 相关回调 + +- [../callbacks/OnNPCGiveDamage](../callbacks/OnNPCGiveDamage): NPC 造成伤害时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsMoving.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsMoving.md new file mode 100644 index 00000000000..a5eed28aff9 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsMoving.md @@ -0,0 +1,59 @@ +--- +title: NPC_IsMoving +sidebar_label: NPC_IsMoving +description: 检查 NPC 当前是否正在移动。 +tags: ["npc", "移动"] +--- + + + +## 描述 + +检查 NPC 当前是否正在移动。 + +| 参数 | 说明 | +| ----- | --------- | +| npcid | NPC 的 ID | + +## 返回值 + +如果 NPC 正在移动则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkmoving", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new bool:isMoving = NPC_IsMoving(npcid); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 正在移动: %s", npcid, isMoving ? "是" : "否"); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 当 NPC 正在步行、跑步或驾车前往目的地时返回 true +- 当 NPC 到达目的地或被停止时返回 false + +## 相关函数 + +- [NPC_Move](NPC_Move): 让 NPC 移动到位置 +- [NPC_StopMove](NPC_StopMove): 停止 NPC 移动 +- [NPC_MoveToPlayer](NPC_MoveToPlayer): 让 NPC 跟随玩家 +- [NPC_MoveByPath](NPC_MoveByPath): 让 NPC 跟随路径 + +## 相关回调 + +- [../callbacks/OnNPCFinishMove](../callbacks/OnNPCFinishMove): NPC 完成移动时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsMovingToPlayer.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsMovingToPlayer.md new file mode 100644 index 00000000000..b6eba592f21 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsMovingToPlayer.md @@ -0,0 +1,60 @@ +--- +title: NPC_IsMovingToPlayer +sidebar_label: NPC_IsMovingToPlayer +description: 检查NPC是否正在向指定玩家移动 +tags: ["npc", "玩家", "移动"] +--- + + + +## 描述 + +检查 NPC 是否正在向指定玩家移动。 + +| 参数 | 说明 | +| -------- | --------------- | +| npcid | NPC 的 ID | +| playerid | 要检查的玩家 ID | + +## 返回值 + +若 NPC 正在向指定玩家移动则返回 `true`，否则返回 `false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkmovingtowardme", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new bool:isMovingToPlayer = NPC_IsMovingToPlayer(npcid, playerid); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 正在朝你移动: %s", npcid, isMovingToPlayer ? "是" : "否"); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 此函数检查 NPC 是否被命令使用 [NPC_MoveToPlayer](NPC_MoveToPlayer) 向指定玩家移动 +- 若 NPC 未移动或正在向不同目标移动，则返回 false + +## 相关函数 + +- [NPC_MoveToPlayer](NPC_MoveToPlayer): 使 NPC 向玩家移动 +- [NPC_IsMoving](NPC_IsMoving): 检查 NPC 是否正在移动 +- [NPC_StopMove](NPC_StopMove): 停止 NPC 移动 +- [NPC_GetPlayerMovingTo](NPC_GetPlayerMovingTo): 获取 NPC 正移向的玩家 ID + +## 相关回调 + +- [OnNPCFinishMove](../callbacks/OnNPCFinishMove): 当 NPC 完成移动时被调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsNodeOpen.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsNodeOpen.md new file mode 100644 index 00000000000..9be998c6351 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsNodeOpen.md @@ -0,0 +1,55 @@ +--- +title: NPC_IsNodeOpen +sidebar_label: NPC_IsNodeOpen +description: 检查 NPC 节点是否打开。 +tags: ["npc", "节点", "导航"] +--- + + + +## 描述 + +检查 NPC 节点是否打开并可供使用。 + +| 参数 | 说明 | +| ------ | --------- | +| nodeid | 节点的 ID | + +## 返回值 + +如果节点打开则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checknodeopen ", true, 15)) + { + new nodeid = strval(cmdtext[15]); + + new bool:isNodeOpen = NPC_IsNodeOpen(nodeid); + + SendClientMessage(playerid, 0x00FF00FF, "节点 %d 是否打开: %s", nodeid, isNodeOpen ? "是" : "否"); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 节点必须先通过 NPC_OpenNode 打开才能使用 +- 只有打开的节点才能被 NPC 播放 +- 在分配给 NPC 之前使用此函数检查节点可用性 + +## 相关函数 + +- [NPC_OpenNode](NPC_OpenNode): 打开节点供使用 +- [NPC_CloseNode](NPC_CloseNode): 关闭节点 +- [NPC_PlayNode](NPC_PlayNode): 让 NPC 播放节点 +- [NPC_GetNodeType](NPC_GetNodeType): 获取节点类型 + +## 相关回调 + +_此函数不会触发任何特定的回调。_ diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsPlaybackPaused.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsPlaybackPaused.md new file mode 100644 index 00000000000..b2cbec21a26 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsPlaybackPaused.md @@ -0,0 +1,60 @@ +--- +title: NPC_IsPlaybackPaused +sidebar_label: NPC_IsPlaybackPaused +description: 检查 NPC 的回放是否暂停。 +tags: ["npc", "录制", "回放"] +--- + + + +## 描述 + +检查 NPC 的回放当前是否暂停。 + +| 参数 | 说明 | +| ----- | --------- | +| npcid | NPC 的 ID | + +## 返回值 + +如果回放暂停则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkplaybackpaused", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new bool:isPlaybackPaused = NPC_IsPlaybackPaused(npcid); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 回放暂停: %s", npcid, isPlaybackPaused ? "是" : "否"); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 只有当 NPC 正在播放录制且已暂停时才返回 true +- 未播放录制的 NPC 将始终返回 false + +## 相关函数 + +- [NPC_PausePlayback](NPC_PausePlayback): 暂停/取消暂停回放 +- [NPC_IsPlayingPlayback](NPC_IsPlayingPlayback): 检查是否正在播放 +- [NPC_StartPlayback](NPC_StartPlayback): 开始回放 +- [NPC_StopPlayback](NPC_StopPlayback): 停止回放 + +## 相关回调 + +- [../callbacks/OnNPCPlaybackStart](../callbacks/OnNPCPlaybackStart): 回放开始时调用 +- [../callbacks/OnNPCPlaybackEnd](../callbacks/OnNPCPlaybackEnd): 回放结束时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsPlayingNode.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsPlayingNode.md new file mode 100644 index 00000000000..0a6145f455c --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsPlayingNode.md @@ -0,0 +1,58 @@ +--- +title: NPC_IsPlayingNode +sidebar_label: NPC_IsPlayingNode +description: 检查 NPC 当前是否正在播放节点。 +tags: ["npc", "节点"] +--- + + + +## 描述 + +检查 NPC 当前是否正在播放节点。 + +| 参数 | 说明 | +| ----- | --------- | +| npcid | NPC 的 ID | + +## 返回值 + +如果 NPC 正在播放节点则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkplayingnode", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new bool:isPlayingNode = NPC_IsPlayingNode(npcid); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 正在播放节点: %s", npcid, isPlayingNode ? "是" : "否"); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 如果 NPC 无效则返回`false` + +## 相关函数 + +- [NPC_PlayNode](NPC_PlayNode): 让 NPC 播放节点 +- [NPC_StopPlayingNode](NPC_StopPlayingNode): 停止播放节点 +- [NPC_IsPlayingNodePaused](NPC_IsPlayingNodePaused): 检查是否暂停 +- [NPC_PausePlayingNode](NPC_PausePlayingNode): 暂停节点播放 + +## 相关回调 + +- [../callbacks/OnNPCFinishNode](../callbacks/OnNPCFinishNode): NPC 完成节点时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsPlayingNodePaused.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsPlayingNodePaused.md new file mode 100644 index 00000000000..266951d0285 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsPlayingNodePaused.md @@ -0,0 +1,58 @@ +--- +title: NPC_IsPlayingNodePaused +sidebar_label: NPC_IsPlayingNodePaused +description: 检查 NPC 的节点播放是否当前暂停。 +tags: ["npc", "节点"] +--- + + + +## 描述 + +检查 NPC 的节点播放当前是否暂停。 + +| 参数 | 说明 | +| ----- | --------- | +| npcid | NPC 的 ID | + +## 返回值 + +如果 NPC 的节点播放暂停则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checknodepaused", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new bool:isNodePaused = NPC_IsPlayingNodePaused(npcid); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 节点暂停: %s", npcid, isNodePaused ? "是" : "否"); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 如果 NPC 没有播放节点则返回`false` + +## 相关函数 + +- [NPC_IsPlayingNode](NPC_IsPlayingNode): 检查是否正在播放节点 +- [NPC_PausePlayingNode](NPC_PausePlayingNode): 暂停节点播放 +- [NPC_ResumePlayingNode](NPC_ResumePlayingNode): 恢复节点播放 +- [NPC_StopPlayingNode](NPC_StopPlayingNode): 停止播放节点 + +## 相关回调 + +- [../callbacks/OnNPCFinishNode](../callbacks/OnNPCFinishNode): NPC 完成节点时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsPlayingPlayback.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsPlayingPlayback.md new file mode 100644 index 00000000000..65199c565b1 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsPlayingPlayback.md @@ -0,0 +1,59 @@ +--- +title: NPC_IsPlayingPlayback +sidebar_label: NPC_IsPlayingPlayback +description: 检查 NPC 是否正在回放录制。 +tags: ["npc", "录制", "回放"] +--- + + + +## 描述 + +检查 NPC 当前是否正在回放录制。 + +| 参数 | 说明 | +| ----- | --------- | +| npcid | NPC 的 ID | + +## 返回值 + +如果 NPC 正在回放回放则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkplayingplayback", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new bool:isPlayingPlayback = NPC_IsPlayingPlayback(npcid); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 正在回放录制: %s", npcid, isPlayingPlayback ? "是" : "否"); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 当 NPC 正在进行回放录制时返回 true + +## 相关函数 + +- [NPC_StartPlayback](NPC_StartPlayback): 开始回放录制 +- [NPC_StopPlayback](NPC_StopPlayback): 停止回放 +- [NPC_PausePlayback](NPC_PausePlayback): 暂停/取消暂停回放 +- [NPC_IsPlaybackPaused](NPC_IsPlaybackPaused): 检查是否暂停 + +## 相关回调 + +- [../callbacks/OnNPCPlaybackStart](../callbacks/OnNPCPlaybackStart): 回放开始时调用 +- [../callbacks/OnNPCPlaybackEnd](../callbacks/OnNPCPlaybackEnd): 回放结束时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsReloadEnabled.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsReloadEnabled.md new file mode 100644 index 00000000000..c01b8fee383 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsReloadEnabled.md @@ -0,0 +1,61 @@ +--- +title: NPC_IsReloadEnabled +sidebar_label: NPC_IsReloadEnabled +description: 检查 NPC 是否启用了自动换弹。 +tags: ["npc", "武器", "子弹"] +--- + + + +## 描述 + +检查 NPC 是否启用了自动换弹。 + +| 参数 | 说明 | +| ----- | --------- | +| npcid | NPC 的 ID | + +## 返回值 + +如果启用了自动换弹则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkreloadenabled", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new bool:isReloadEnabled = NPC_IsReloadEnabled(npcid); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 启用自动换弹: %s", npcid, isReloadEnabled ? "是" : "否"); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 自动换弹使 NPC 在弹夹空时自动换弹 +- 没有自动换弹的 NPC 在弹夹用完时将停止射击 +- 这只影响弹夹弹药，不影响总弹药 +- 使用`NPC_EnableReloading`更改换弹设置 + +## 相关函数 + +- [NPC_EnableReloading](NPC_EnableReloading): 启用/禁用自动换弹 +- [NPC_IsReloading](NPC_IsReloading): 检查是否正在换弹 +- [NPC_GetAmmoInClip](NPC_GetAmmoInClip): 获取弹夹弹药 +- [NPC_SetAmmoInClip](NPC_SetAmmoInClip): 设置弹夹弹药 + +## 相关回调 + +- [../callbacks/OnNPCWeaponShot](../callbacks/OnNPCWeaponShot): NPC 开火时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsReloading.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsReloading.md new file mode 100644 index 00000000000..2b9c3a95ec1 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsReloading.md @@ -0,0 +1,60 @@ +--- +title: NPC_IsReloading +sidebar_label: NPC_IsReloading +description: 检查 NPC 是否正在换弹。 +tags: ["npc", "武器", "换弹"] +--- + + + +## 描述 + +检查 NPC 是否正在换弹。 + +| 参数 | 说明 | +| ----- | --------- | +| npcid | NPC 的 ID | + +## 返回值 + +如果 NPC 正在换弹则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkreloading", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new bool:isReloading = NPC_IsReloading(npcid); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 正在换弹: %s", npcid, isReloading ? "是" : "否"); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 仅在实际换弹动画期间返回 true +- 弹夹中弹药耗尽时自动换弹 +- 使用 NPC_EnableReloading 控制换弹行为 + +## 相关函数 + +- [NPC_EnableReloading](NPC_EnableReloading): 启用/禁用换弹 +- [NPC_Reload](NPC_Reload): 强制 NPC 换弹 +- [NPC_GetAmmoInClip](NPC_GetAmmoInClip): 获取弹夹中的弹药 +- [NPC_GetWeaponReloadTime](NPC_GetWeaponReloadTime): 获取换弹时间 + +## 相关回调 + +- [../callbacks/OnNPCWeaponShot](../callbacks/OnNPCWeaponShot): NPC 开火时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsShooting.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsShooting.md new file mode 100644 index 00000000000..68e49f7ca00 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsShooting.md @@ -0,0 +1,60 @@ +--- +title: NPC_IsShooting +sidebar_label: NPC_IsShooting +description: 检查 NPC 是否正在射击。 +tags: ["npc", "武器", "射击"] +--- + + + +## 描述 + +检查 NPC 是否正在射击。 + +| 参数 | 说明 | +| ----- | --------- | +| npcid | NPC 的 ID | + +## 返回值 + +如果 NPC 正在射击则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkshooting", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new bool:isShooting = NPC_IsShooting(npcid); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 正在射击: %s", npcid, isShooting ? "是" : "否"); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 仅在实际射击动作期间返回 true +- NPC 必须有武器和弹药才能射击 + +## 相关函数 + +- [NPC_Shoot](NPC_Shoot): 让 NPC 射击 +- [NPC_AimAt](NPC_AimAt): 让 NPC 瞄准并射击 +- [NPC_StopShoot](NPC_StopShoot): 停止 NPC 射击 +- [NPC_IsAiming](NPC_IsAiming): 检查是否正在瞄准 + +## 相关回调 + +- [../callbacks/OnNPCWeaponShot](../callbacks/OnNPCWeaponShot): NPC 射击时调用 +- [../callbacks/OnNPCGiveDamage](../callbacks/OnNPCGiveDamage): NPC 对玩家造成伤害时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsSpawned.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsSpawned.md new file mode 100644 index 00000000000..c1db8ff9576 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsSpawned.md @@ -0,0 +1,59 @@ +--- +title: NPC_IsSpawned +sidebar_label: NPC_IsSpawned +description: 检查NPC是否已在游戏世界中生成 +tags: ["npc", "生成"] +--- + + + +## 描述 + +检查 NPC 是否已在游戏世界中生成。 + +| 参数 | 说明 | +| ----- | --------- | +| npcid | NPC 的 ID | + +## 返回值 + +若 NPC 已生成则返回 `true`，否则返回 `false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkspawned", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new bool:isSpawned = NPC_IsSpawned(npcid); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 已生成: %s", npcid, isSpawned ? "是" : "否"); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 这与 [NPC_IsValid](NPC_IsValid) 不同，后者检查 NPC 是否存在 + +## 相关函数 + +- [NPC_Spawn](NPC_Spawn): 生成 NPC +- [NPC_Respawn](NPC_Respawn): 重新生成 NPC +- [NPC_IsValid](NPC_IsValid): 检查 NPC 是否有效 +- [NPC_IsDead](NPC_IsDead): 检查 NPC 是否死亡 + +## 相关回调 + +- [OnNPCSpawn](../callbacks/OnNPCSpawn): 当 NPC 生成时被调用 +- [OnNPCRespawn](../callbacks/OnNPCRespawn): 当 NPC 重新生成时被调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsStreamedIn.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsStreamedIn.md new file mode 100644 index 00000000000..bbe0e484c56 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsStreamedIn.md @@ -0,0 +1,58 @@ +--- +title: NPC_IsStreamedIn +sidebar_label: NPC_IsStreamedIn +description: 检查 NPC 是否对特定玩家流加载。 +tags: ["npc", "流加载"] +--- + + + +## 描述 + +检查 NPC 是否对特定玩家流加载。 + +| 参数 | 说明 | +| -------- | ----------------- | +| npcid | NPC 的 ID | +| playerid | 要检查的玩家的 ID | + +## 返回值 + +如果 NPC 对玩家流加载则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkstreamedin", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new bool:isStreamedIn = NPC_IsStreamedIn(npcid, playerid); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 是否已为你流加载: %s", npcid, isStreamedIn ? "是" : "否"); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- NPC 仅在玩家的流加载距离内才会流加载 +- 流加载取决于距离和室内/虚拟世界匹配 + +## 相关函数 + +- [NPC_IsAnyStreamedIn](NPC_IsAnyStreamedIn): 检查是否有任何玩家可以看到 NPC +- [NPC_SetPos](NPC_SetPos): 设置 NPC 位置 + +## 相关回调 + +_此函数不会触发任何特定的回调。_ diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsValid.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsValid.md new file mode 100644 index 00000000000..d05ff6988b1 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsValid.md @@ -0,0 +1,58 @@ +--- +title: NPC_IsValid +sidebar_label: NPC_IsValid +description: 检查 NPC ID 是否有效。 +tags: ["npc"] +--- + + + +## 描述 + +检查 NPC ID 是否有效且 NPC 存在。 + +| 参数 | 说明 | +| ----- | ----------------- | +| npcid | 要检查的 NPC ID。 | + +## 返回值 + +如果 NPC 有效则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkvalid", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + new bool:isValid = NPC_IsValid(npcid); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 是否有效: %s", npcid, isValid ? "是" : "否"); + return 1; + } + return 0; +} +``` + +## 注意事项 + +:::warning + +- 在对 NPC 执行操作前始终检查其是否有效。 +- NPC 被销毁后会变为无效。 +- 这可以防止运行时错误和崩溃。 +- 在遍历潜在 NPC ID 的循环中使用此函数。 + +::: + +## 相关函数 + +- [NPC_Create](NPC_Create): 创建新 NPC。 +- [NPC_Destroy](NPC_Destroy): 销毁 NPC。 +- [NPC_GetAll](NPC_GetAll): 获取所有有效的 NPC ID。 +- [NPC_IsDead](NPC_IsDead): 检查 NPC 是否死亡。 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsValidPath.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsValidPath.md new file mode 100644 index 00000000000..d4f32ef7fa6 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsValidPath.md @@ -0,0 +1,56 @@ +--- +title: NPC_IsValidPath +sidebar_label: NPC_IsValidPath +description: 检查路径 ID 是否有效且存在。 +tags: ["npc", "路径", "验证"] +--- + + + +## 描述 + +检查路径 ID 是否有效且存在。 + +| 参数 | 说明 | +| ------ | --------- | +| pathid | 路径的 ID | + +## 返回值 + +如果路径有效则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkvalidpath ", true, 16)) + { + new pathid = strval(cmdtext[16]); + + new bool:isValidPath = NPC_IsValidPath(pathid); + + SendClientMessage(playerid, 0x00FF00FF, "路径 %d 是否有效: %s", pathid, isValidPath ? "是" : "否"); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 在与 NPC 一起使用路径前始终检查其是否有效 +- 无效路径可能已被销毁或从未正确创建 +- 在添加点或为 NPC 分配路径前使用此函数 +- 路径被销毁时会重用 ID + +## 相关函数 + +- [NPC_CreatePath](NPC_CreatePath): 创建新路径 +- [NPC_DestroyPath](NPC_DestroyPath): 销毁路径 +- [NPC_GetPathCount](NPC_GetPathCount): 获取路径总数 +- [NPC_AddPointToPath](NPC_AddPointToPath): 向路径添加点 + +## 相关回调 + +_此函数不会触发任何特定的回调。_ diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsValidRecord.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsValidRecord.md new file mode 100644 index 00000000000..1a2be1f46af --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsValidRecord.md @@ -0,0 +1,54 @@ +--- +title: NPC_IsValidRecord +sidebar_label: NPC_IsValidRecord +description: 检查录制文件是否有效且已加载。 +tags: ["npc", "录制", "验证"] +--- + + + +## 描述 + +检查录制 ID 是否有效且已加载。 + +| 参数 | 说明 | +| -------- | --------- | +| recordId | 录制的 ID | + +## 返回值 + +如果录制有效且已加载则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checkvalidrecord ", true, 18)) + { + new recordid = strval(cmdtext[18]); + + new bool:isValidRecord = NPC_IsValidRecord(recordid); + + SendClientMessage(playerid, 0x00FF00FF, "录制 %d 是否有效: %s", recordid, isValidRecord ? "是" : "否"); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 录制必须先通过 NPC_LoadRecord 加载才能变为有效 +- 无效录制不能用于回放 + +## 相关函数 + +- [NPC_LoadRecord](NPC_LoadRecord): 加载录制文件 +- [NPC_UnloadRecord](NPC_UnloadRecord): 卸载录制 +- [NPC_StartPlayback](NPC_StartPlayback): 开始回放录制 +- [NPC_GetRecordCount](NPC_GetRecordCount): 获取已加载录制数量 + +## 相关回调 + +_此函数不会触发任何特定的回调。_ diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsVehicleSirenUsed.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsVehicleSirenUsed.md new file mode 100644 index 00000000000..38b0bbace8c --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_IsVehicleSirenUsed.md @@ -0,0 +1,64 @@ +--- +title: NPC_IsVehicleSirenUsed +sidebar_label: NPC_IsVehicleSirenUsed +description: 检查 NPC 是否正在使用车辆警报器。 +tags: ["npc", "车辆", "警报器"] +--- + + + +## 描述 + +检查 NPC 是否正在使用车辆警报器。 + +| 参数 | 说明 | +| ----- | --------- | +| npcid | NPC 的 ID | + +## 返回值 + +如果 NPC 正在使用车辆警报器则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/checksirenused", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new veh = NPC_GetVehicle(npcid); + if (veh == INVALID_VEHICLE_ID) + return SendClientMessage(playerid, 0xFFFF00FF, "NPC %d 没有在任何车辆中。", npcid); + + new bool:sirenUsed = NPC_IsVehicleSirenUsed(npcid); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 车辆警报器使用中: %s", npcid, sirenUsed ? "是" : "否"); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 如果 NPC 不在车辆中则返回`false` +- 仅适用于有警报器的车辆（警车、救护车、消防车） +- 视觉和音频警报效果对所有玩家可见 + +## 相关函数 + +- [NPC_UseVehicleSiren](NPC_UseVehicleSiren): 切换车辆警报器 +- [NPC_GetVehicleID](NPC_GetVehicleID): 获取 NPC 的车辆 +- [NPC_PutInVehicle](NPC_PutInVehicle): 将 NPC 放入车辆 +- [NPC_RemoveFromVehicle](NPC_RemoveFromVehicle): 将 NPC 从车辆中移出 + +## 相关回调 + +_此函数不会触发任何特定的回调。_ diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_Kill.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_Kill.md new file mode 100644 index 00000000000..aa1fbb905e6 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_Kill.md @@ -0,0 +1,63 @@ +--- +title: NPC_Kill +sidebar_label: NPC_Kill +description: 使用特定武器/原因杀死NPC +tags: ["npc", "死亡", "杀死"] +--- + + + +## 描述 + +使用特定武器/原因杀死 NPC。 + +| 参数 | 说明 | +| -------- | ---------------------------------------------------------- | +| npcid | 要杀死的 NPC 的 ID | +| killerid | 杀死 NPC 的玩家 ID（可选，无杀手时使用 INVALID_PLAYER_ID） | +| reason | 武器 ID 或死亡原因（默认：255 表示自杀） | + +## 返回值 + +成功时返回 `true`，失败时返回 `false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/npckill", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + NPC_Kill(npcid); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 已被杀死。", npcid); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 若没有杀手，killerid 使用 `INVALID_PLAYER_ID` +- reason 参数使用武器 ID（WEAPON 枚举） +- 这会触发 [OnNPCDeath](../callbacks/OnNPCDeath) 回调函数 + +## 相关函数 + +- [NPC_SetHealth](NPC_SetHealth): 设置 NPC 生命值 +- [NPC_GetHealth](NPC_GetHealth): 获取 NPC 生命值 +- [NPC_IsDead](NPC_IsDead): 检查 NPC 是否死亡 +- [NPC_Respawn](NPC_Respawn): 重新生成 NPC + +## 相关回调 + +- [OnNPCDeath](../callbacks/OnNPCDeath): 当 NPC 死亡时被调用 +- [OnNPCTakeDamage](../callbacks/OnNPCTakeDamage): 当 NPC 受到伤害时被调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_LoadRecord.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_LoadRecord.md new file mode 100644 index 00000000000..6bdfee5dc0a --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_LoadRecord.md @@ -0,0 +1,63 @@ +--- +title: NPC_LoadRecord +sidebar_label: NPC_LoadRecord +description: 加载 NPC 录制文件用于回放。 +tags: ["npc", "录制", "回放"] +--- + + + +## 描述 + +加载 NPC 录制文件用于回放使用。 + +| 参数 | 说明 | +| -------------- | -------------- | +| const filePath | 录制文件的路径 | + +## 返回值 + +返回已加载录制的 ID，失败时返回`INVALID_RECORD_ID`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/npcloadrecord ", true, 15)) + { + new filepath[128]; + new len = strlen(cmdtext); + if (len <= 15) + return SendClientMessage(playerid, 0xFF0000FF, "用法：/npcloadrecord [文件路径]"); + + strmid(filepath, cmdtext, 15, len); + + new recordid = NPC_LoadRecord(filepath); + + if (recordid == -1) + SendClientMessage(playerid, 0xFF0000FF, "从 %s 加载录制失败", filepath); + else + SendClientMessage(playerid, 0x00FF00FF, "录制已从 %s 加载，对应ID: %d", filepath, recordid); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 文件应具有 .rec 扩展名，但在文件名中不要包含它 +- 在使用 NPC_StartPlayback 之前加载录制 + +## 相关函数 + +- [NPC_UnloadRecord](NPC_UnloadRecord): 卸载录制 +- [NPC_UnloadAllRecords](NPC_UnloadAllRecords): 卸载所有录制 +- [NPC_StartPlayback](NPC_StartPlayback): 开始回放录制 +- [NPC_GetRecordCount](NPC_GetRecordCount): 获取已加载录制数量 + +## 相关回调 + +- [OnNPCPlaybackStart](../callbacks/OnNPCPlaybackStart): 回放开始时调用 +- [OnNPCPlaybackEnd](../callbacks/OnNPCPlaybackEnd): 回放结束时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_MeleeAttack.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_MeleeAttack.md new file mode 100644 index 00000000000..b249c975968 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_MeleeAttack.md @@ -0,0 +1,67 @@ +--- +title: NPC_MeleeAttack +sidebar_label: NPC_MeleeAttack +description: 让 NPC 执行近战攻击。 +tags: ["npc", "战斗", "近战攻击"] +--- + + + +## 描述 + +让 NPC 执行指定持续时间的近战攻击。 + +| 参数 | 说明 | +| --------------- | ------------------------------- | +| npcid | NPC 的 ID | +| time | 攻击持续时间 | +| secondaryAttack | 是否使用次要攻击（默认: false） | + +## 返回值 + +如果操作成功则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/npcmeleeattack", true, 15)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new time = 1000; + if (strlen(cmdtext) > 16) + time = strval(cmdtext[16]); + + new bool:success = NPC_MeleeAttack(npcid, time, false); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 持续近战攻击 %d毫秒: %s", npcid, time, success ? "成功" : "失败"); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- NPC 必须拥有近战武器或使用拳头进行攻击 +- 持续时间影响攻击动画播放的时间长度 +- 次要攻击通常有不同的动画和效果 +- 使用战斗风格来改变攻击动画和有效性 + +## 相关函数 + +- [NPC_StopMeleeAttack](NPC_StopMeleeAttack): 停止近战攻击 +- [NPC_IsMeleeAttacking](NPC_IsMeleeAttacking): 检查是否正在攻击 +- [NPC_SetFightingStyle](NPC_SetFightingStyle): 设置战斗风格 +- [NPC_GetFightingStyle](NPC_GetFightingStyle): 获取战斗风格 + +## 相关回调 + +- [OnNPCGiveDamage](../callbacks/OnNPCGiveDamage): NPC 对玩家造成伤害时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_Move.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_Move.md new file mode 100644 index 00000000000..296ec6a82db --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_Move.md @@ -0,0 +1,74 @@ +--- +title: NPC_Move +sidebar_label: NPC_Move +description: 让 NPC 移动到指定位置。 +tags: ["npc", "移动"] +--- + + + +## 描述 + +让 NPC 移动到指定位置。 + +| 参数 | 说明 | +| ---------------------- | ----------------------------------------- | +| npcid | NPC 的 ID。 | +| Float:x | 要移动到的 X 坐标。 | +| Float:y | 要移动到的 Y 坐标。 | +| Float:z | 要移动到的 Z 坐标。 | +| NPC_MOVE_TYPE:moveType | 移动类型（默认: `NPC_MOVE_TYPE_JOG`）。 | +| Float:moveSpeed | 移动速度（默认: `NPC_MOVE_SPEED_AUTO`）。 | +| Float:stopRange | 停止前到目标的距离（默认: 0.2）。 | + +## 返回值 + +如果移动成功开始则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/npcmove", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new Float:x, Float:y, Float:z; + GetPlayerPos(playerid, x, y, z); + + NPC_Move(npcid, x, y, z, NPC_MOVE_TYPE_JOG, NPC_MOVE_SPEED_AUTO, 0.2); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 正在移动到 (%.2f, %.2f, %.2f)", npcid, x, y, z); + return 1; + } + return 0; +} +``` + +## 注意事项 + +:::warning + +- NPC 将寻路到目标位置。 +- 移动类型影响动画和速度。 +- 停止范围决定 NPC 在停止前离目标多近。 +- 使用 [NPC_IsMoving](NPC_IsMoving) 检查 NPC 当前是否正在移动 + +::: + +## 相关函数 + +- [NPC_MoveToPlayer](NPC_MoveToPlayer): 让 NPC 移动跟随玩家。 +- [NPC_StopMove](NPC_StopMove): 停止 NPC 移动。 +- [NPC_IsMoving](NPC_IsMoving): 检查 NPC 是否正在移动。 +- [NPC_MoveByPath](NPC_MoveByPath): 让 NPC 沿预定义路径移动。 + +## 相关回调 + +- [OnNPCFinishMove](../callbacks/OnNPCFinishMove): NPC 完成移动时调用。 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_MoveByPath.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_MoveByPath.md new file mode 100644 index 00000000000..f7bd7a3a47c --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_MoveByPath.md @@ -0,0 +1,76 @@ +--- +title: NPC_MoveByPath +sidebar_label: NPC_MoveByPath +description: 使 NPC 沿预定义路径移动 +tags: ["npc", "移动", "路径"] +--- + + + +## 描述 + +使 NPC 沿预定义路径移动，支持多种移动选项。 + +| 参数 | 说明 | +| --------- | ------------------------------------- | +| npcid | NPC 的 ID | +| pathid | 要跟随的路径 ID | +| moveType | 移动类型（默认：NPC_MOVE_TYPE_JOG） | +| moveSpeed | 移动速度（默认：NPC_MOVE_SPEED_AUTO） | +| reversed | 是否反向跟随路径（默认：false） | + +## 返回值 + +如果 NPC 开始跟随路径返回 `true`，否则返回 `false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/startpatrol", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + new count = NPC_GetPathPointCount(PlayerPatrolPath[playerid]); + + if (NPC_IsValidPath(PlayerPatrolPath[playerid])) + { + NPC_MoveByPath(npcid, PlayerPatrolPath[playerid], NPC_MOVE_TYPE_WALK); + SendClientMessage(playerid, 0x00FF00FF, "开始巡逻路线，共 %d 个点", npcid, count); + + StopPlayerPatrolTimer(playerid); + PlayerPatrolTimer[playerid] = SetTimerEx("CheckPathProgress", 2000, true, "i", playerid); + } + else + { + SendClientMessage(playerid, 0xFF0000FF, "开始巡逻失败"); + } + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 路径必须通过 `NPC_CreatePath` 创建，且调用此函数前路径至少需包含一个路径点 +- 使用 `NPC_AddPointToPath` 构建行进路线，若需重置路径请调用 `NPC_ClearPath` +- 设置 `reversed = true` 可使 NPC 按相反顺序遍历路径 +- 当 NPC 无效、正在执行不兼容动作或路径无法被跟随时，返回 `false` + +## 相关函数 + +- [NPC_CreatePath](NPC_CreatePath): 创建新路径 +- [NPC_AddPointToPath](NPC_AddPointToPath): 向路径添加点 +- [NPC_ClearPath](NPC_ClearPath): 清除路径中的所有点 +- [NPC_StopMove](NPC_StopMove): 停止路径移动 +- [NPC_GetCurrentPathPointIndex](NPC_GetCurrentPathPointIndex): 获取当前点 + +## 相关回调 + +- [OnNPCFinishMovePath](../callbacks/OnNPCFinishMovePath): NPC 完成路径移动时调用 +- [OnNPCFinishMovePathPoint](../callbacks/OnNPCFinishMovePathPoint): NPC 到达每个路径点时调用 +- [OnNPCFinishMove](../callbacks/OnNPCFinishMove): NPC 完成移动时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_MoveToPlayer.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_MoveToPlayer.md new file mode 100644 index 00000000000..a138587fe2b --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_MoveToPlayer.md @@ -0,0 +1,72 @@ +--- +title: NPC_MoveToPlayer +sidebar_label: NPC_MoveToPlayer +description: 让 NPC 移向并跟随玩家。 +tags: ["npc", "移动", "玩家", "跟随"] +--- + + + +## 描述 + +让 NPC 移向并跟随玩家。 + +| 参数 | 说明 | +| ---------------------- | --------------------------------------------- | +| npcid | NPC 的 ID。 | +| playerid | 要移向的玩家的 ID。 | +| NPC_MOVE_TYPE:moveType | 移动类型（默认: `NPC_MOVE_TYPE_JOG`）。 | +| Float:moveSpeed | 移动速度（默认: `NPC_MOVE_SPEED_AUTO`）。 | +| Float:stopRange | 距离玩家的停止距离（默认: 0.2） | +| updateDelayMS | 位置检查更新延迟，以毫秒为单位（默认: 500）。 | +| bool:autoRestart | 是否自动重新开始跟随（默认: false）。 | + +## 返回值 + +成功时返回`true`，失败时返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/npcmovetoplayer", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + NPC_MoveToPlayer(npcid, playerid, NPC_MOVE_TYPE_JOG, NPC_MOVE_SPEED_AUTO, 0.2, 500, false); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 现在正在跟随你", npcid); + return 1; + } + return 0; +} +``` + +## 注意事项 + +:::warning + +- NPC 将持续跟随目标玩家直到被停止。 +- `updateDelayMS` 参数控制 NPC 更新目标位置的频率。 +- 较低的 `updateDelayMS` 值提供更平滑的跟随但使用更多资源。 +- `autoRestart` 参数决定跟随在中断后是否恢复。 +- 当目标玩家断开连接时跟随停止。 + +::: + +## 相关函数 + +- [NPC_Move](NPC_Move): 将 NPC 移动到特定位置。 +- [NPC_StopMove](NPC_StopMove): 停止 NPC 移动。 +- [NPC_IsMoving](NPC_IsMoving): 检查 NPC 是否正在移动。 +- [NPC_MoveByPath](NPC_MoveByPath): 让 NPC 沿预定义路径移动。 + +## 相关回调 + +- [OnNPCFinishMove](../callbacks/OnNPCFinishMove): NPC 到达目标时调用（连续跟随时不调用）。 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_OpenNode.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_OpenNode.md new file mode 100644 index 00000000000..0deb1b1b076 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_OpenNode.md @@ -0,0 +1,59 @@ +--- +title: NPC_OpenNode +sidebar_label: NPC_OpenNode +description: 打开 NPC 节点供使用。 +tags: ["npc", "节点", "导航"] +--- + + + +## 描述 + +打开 NPC 节点供使用，使其可供 NPC 导航通过。 + +| 参数 | 说明 | +| ------ | --------- | +| nodeid | 节点的 ID | + +## 返回值 + +如果节点成功打开则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/npcopennode ", true, 13)) + { + new nodeid = strval(cmdtext[13]); + + if (nodeid < 0 || nodeid > 63) + return SendClientMessage(playerid, 0xFF0000FF, "无效的节点ID。必须在 0 ~ 63 之间。"); + + new bool:success = NPC_OpenNode(nodeid); + + SendClientMessage(playerid, 0x00FF00FF, "打开节点 %d: %s", nodeid, success ? "成功" : "失败"); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 节点 ID 范围为 0 到 63 +- 节点必须先打开才能供 NPC 用于导航 +- 打开节点会加载其数据并使其可访问 +- 使用 NPC_IsNodeOpen 检查节点是否已打开 + +## 相关函数 + +- [NPC_CloseNode](NPC_CloseNode): 关闭节点 +- [NPC_IsNodeOpen](NPC_IsNodeOpen): 检查节点是否打开 +- [NPC_PlayNode](NPC_PlayNode): 让 NPC 播放节点 +- [NPC_GetNodeInfo](NPC_GetNodeInfo): 获取节点信息 + +## 相关回调 + +_此函数不会触发任何特定的回调。_ diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_PausePlayback.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_PausePlayback.md new file mode 100644 index 00000000000..52bfaf8461c --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_PausePlayback.md @@ -0,0 +1,62 @@ +--- +title: NPC_PausePlayback +sidebar_label: NPC_PausePlayback +description: 暂停或恢复 NPC 的录制回放。 +tags: ["npc", "录制", "回放"] +--- + + + +## 描述 + +暂停或恢复 NPC 的录制回放。 + +| 参数 | 说明 | +| ----- | ------------------------------ | +| npcid | NPC 的 ID | +| pause | 是否暂停 (true) 或恢复 (false) | + +## 返回值 + +如果操作成功则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/pauseplayback ", true, 15)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new bool:pause = strval(cmdtext[15]) ? true : false; + + NPC_PausePlayback(npcid, pause); + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 回放%s。", npcid, pause ? "已暂停" : "已恢复"); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 仅在 NPC 正在回放录制时有效 +- 暂停的回放可以通过调用 pause = false 来恢复 +- 使用 NPC_IsPlaybackPaused 检查当前暂停状态 + +## 相关函数 + +- [NPC_IsPlaybackPaused](NPC_IsPlaybackPaused): 检查是否暂停 +- [NPC_StartPlayback](NPC_StartPlayback): 开始回放 +- [NPC_StopPlayback](NPC_StopPlayback): 停止回放 +- [NPC_IsPlayingPlayback](NPC_IsPlayingPlayback): 检查是否正在回放 + +## 相关回调 + +_此函数不会触发任何特定的回调。_ diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_PausePlayingNode.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_PausePlayingNode.md new file mode 100644 index 00000000000..0e7c8aa6bd2 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_PausePlayingNode.md @@ -0,0 +1,60 @@ +--- +title: NPC_PausePlayingNode +sidebar_label: NPC_PausePlayingNode +description: 暂停 NPC 的节点导航。 +tags: ["npc", "节点", "导航"] +--- + + + +## 描述 + +暂停 NPC 的节点导航，暂时停止其在节点中的移动。 + +| 参数 | 说明 | +| ----- | --------- | +| npcid | NPC 的 ID | + +## 返回值 + +如果操作成功则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/npcpausenode", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new bool:success = NPC_PausePlayingNode(npcid); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 暂停节点: %s", npcid, success ? "成功" : "失败"); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 仅在 NPC 正在播放节点时有效 +- 暂停的节点导航可以通过 NPC_ResumePlayingNode 恢复 +- 使用 NPC_IsPlayingNodePaused 检查暂停状态 + +## 相关函数 + +- [NPC_ResumePlayingNode](NPC_ResumePlayingNode): 恢复节点播放 +- [NPC_IsPlayingNodePaused](NPC_IsPlayingNodePaused): 检查是否暂停 +- [NPC_PlayNode](NPC_PlayNode): 开始播放节点 +- [NPC_StopPlayingNode](NPC_StopPlayingNode): 停止播放节点 + +## 相关回调 + +_此函数不会触发任何特定的回调。_ diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_PlayNode.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_PlayNode.md new file mode 100644 index 00000000000..69c90db26a7 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_PlayNode.md @@ -0,0 +1,77 @@ +--- +title: NPC_PlayNode +sidebar_label: NPC_PlayNode +description: 让 NPC 通过预定义的导航节点进行导航。 +tags: ["npc", "节点", "导航"] +--- + + + +## 描述 + +让 NPC 使用游戏内置的导航系统通过预定义的导航节点进行导航。 + +| 参数 | 说明 | +| ------------- | ----------------------------------------------- | +| npcid | NPC 的 ID | +| nodeId | 要导航的节点的 ID | +| moveType | 移动类型（默认: NPC_MOVE_TYPE_JOG） | +| Float:speed | 移动速度（默认: NPC_MOVE_SPEED_AUTO） | +| Float:radius | 考虑为到达的节点周围半径（默认: 0.0） | +| bool:setangle | 是否在导航期间更新 NPC 的朝向角度（默认: true） | + +## 返回值 + +如果 NPC 开始播放节点则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/npcplaynode ", true, 13)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new nodeid = strval(cmdtext[13]); + + if (nodeid < 0 || nodeid > 63) + return SendClientMessage(playerid, 0xFF0000FF, "无效的节点ID。必须在 0 ~ 63 之间。"); + + new bool:success = NPC_PlayNode(npcid, nodeid, NPC_MOVE_TYPE_JOG, NPC_MOVE_SPEED_AUTO, 0.0, true); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 播放节点 %d: %s", npcid, nodeid, success ? "成功" : "失败"); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 节点是来自游戏节点文件的预定义导航点（ID 0-63） +- 节点在使用前必须通过 `NPC_OpenNode` 打开 +- NPC 将自动在指定节点内的点之间导航 +- 使用 `setAngle` 参数控制 NPC 是否旋转以面向移动方向 +- `radius` 参数决定 NPC 需要多接近每个点 +- 节点导航可以使用相关函数暂停、恢复或停止 + +## 相关函数 + +- [NPC_StopPlayingNode](NPC_StopPlayingNode): 停止 NPC 节点导航 +- [NPC_PausePlayingNode](NPC_PausePlayingNode): 暂停 NPC 节点导航 +- [NPC_ResumePlayingNode](NPC_ResumePlayingNode): 恢复暂停的节点导航 +- [NPC_IsPlayingNode](NPC_IsPlayingNode): 检查 NPC 是否正在导航节点 +- [NPC_ChangeNode](NPC_ChangeNode): 在导航期间切换到不同节点 +- [NPC_OpenNode](NPC_OpenNode): 打开节点供使用 + +## 相关回调 + +- [OnNPCFinishNode](../callbacks/OnNPCFinishNode): NPC 完成导航节点时调用 +- [OnNPCFinishNodePoint](../callbacks/OnNPCFinishNodePoint): NPC 到达节点内的点时调用 +- [OnNPCChangeNode](../callbacks/OnNPCChangeNode): NPC 从一个节点切换到另一个节点时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_PutInVehicle.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_PutInVehicle.md new file mode 100644 index 00000000000..ef51390b123 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_PutInVehicle.md @@ -0,0 +1,77 @@ +--- +title: NPC_PutInVehicle +sidebar_label: NPC_PutInVehicle +description: 将 NPC 放入车辆的指定座位。 +tags: ["npc", "车辆"] +--- + + + +## 描述 + +将 NPC 放入车辆的指定座位。 + +| 参数 | 说明 | +| --------- | -------------------- | +| npcid | NPC 的 ID | +| vehicleid | 车辆的 ID | +| seatid | 要放入 NPC 的座位 ID | + +## 返回值 + +如果 NPC 成功放入车辆则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/npcputinvehicle", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new vehicleid = GetPlayerVehicleID(playerid); + if (vehicleid == 0) + return SendClientMessage(playerid, 0xFF0000FF, "你不在车里。"); + + new bool:success = NPC_PutInVehicle(npcid, vehicleid, 1); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 放入车辆 %d (座位 1): %s", npcid, vehicleid, success ? "成功" : "失败"); + return 1; + } + return 0; +} +``` + +## 座位 ID + +| ID | 座位 | +| --- | ------------------ | +| 0 | 驾驶员 | +| 1 | 前排乘客 | +| 2 | 后排左侧乘客 | +| 3 | 后排右侧乘客 | +| 4+ | 乘客座位（大巴等） | + +## 注意事项 + +- NPC 会立即出现在车辆中，没有进入动画 +- 使用 NPC_GetVehicleID 检查 NPC 在哪辆车辆中 +- 座位 0 始终是驾驶座 +- 最大座位 ID 取决于车辆型号 + +## 相关函数 + +- [NPC_RemoveFromVehicle](NPC_RemoveFromVehicle): 将 NPC 从车辆中移出 +- [NPC_GetVehicleID](NPC_GetVehicleID): 获取 NPC 的车辆 +- [NPC_GetVehicleSeat](NPC_GetVehicleSeat): 获取 NPC 的座位 +- [NPC_EnterVehicle](NPC_EnterVehicle): 让 NPC 带动画进入车辆 + +## 相关回调 + +_此函数不会触发任何特定的回调。_ diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_RemoveFromVehicle.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_RemoveFromVehicle.md new file mode 100644 index 00000000000..b3e732cb25e --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_RemoveFromVehicle.md @@ -0,0 +1,61 @@ +--- +title: NPC_RemoveFromVehicle +sidebar_label: NPC_RemoveFromVehicle +description: 将 NPC 从其当前车辆中移出。 +tags: ["npc", "车辆"] +--- + + + +## 描述 + +将 NPC 从其当前车辆中移出。 + +| 参数 | 说明 | +| ----- | --------- | +| npcid | NPC 的 ID | + +## 返回值 + +如果 NPC 成功从车辆中移出则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/npcremovefromvehicle", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new bool:success = NPC_RemoveFromVehicle(npcid); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 从车辆中移出：%s", npcid, success ? "成功" : "失败"); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- NPC 会立即出现在车辆外，没有退出动画 +- 使用 NPC_ExitVehicle 进行带动画的退出 +- 如果 NPC 不在车辆中则返回 false +- NPC 位置将设置在车辆附近 + +## 相关函数 + +- [NPC_PutInVehicle](NPC_PutInVehicle): 将 NPC 放入车辆 +- [NPC_ExitVehicle](NPC_ExitVehicle): 让 NPC 带动画退出车辆 +- [NPC_GetVehicleID](NPC_GetVehicleID): 获取 NPC 的车辆 +- [NPC_GetVehicleSeat](NPC_GetVehicleSeat): 获取 NPC 的座位 + +## 相关回调 + +_此函数不会触发任何特定的回调。_ diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_RemovePointFromPath.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_RemovePointFromPath.md new file mode 100644 index 00000000000..c79c9c938ad --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_RemovePointFromPath.md @@ -0,0 +1,76 @@ +--- +title: NPC_RemovePointFromPath +sidebar_label: NPC_RemovePointFromPath +description: 从 NPC 路径中移除路径点。 +tags: ["npc", "路径"] +--- + + + +## 描述 + +从 NPC 路径中移除路径点。 + +| 参数 | 说明 | +| ----------- | ---------------- | +| pathid | 路径的 ID | +| point_index | 要移除的点的索引 | + +## 返回值 + +成功时返回`true`，失败时返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strncmp(cmdtext, "/removepatrolpoint ", 19, true)) + { + if (!NPC_IsValidPath(PlayerPatrolPath[playerid])) + { + SendClientMessage(playerid, 0xFF0000FF, "没有有效的巡逻路径。先使用/createpatrol。"); + return 1; + } + + new pointIndex = strval(cmdtext[19]); + new totalPoints = NPC_GetPathPointCount(PlayerPatrolPath[playerid]); + + if (pointIndex < 0 || pointIndex >= totalPoints) + { + SendClientMessage(playerid, 0xFF0000FF, "无效的点索引。有效范围：0-%d", totalPoints - 1); + return 1; + } + + if (NPC_RemovePointFromPath(PlayerPatrolPath[playerid], pointIndex)) + { + SendClientMessage(playerid, 0x00FF00FF, "从路径 %d 中移除点 %d（现在有 %d 个点）", pointIndex, PlayerPatrolPath[playerid], totalPoints - 1); + } + else + { + SendClientMessage(playerid, 0xFF0000FF, "未能从路径中移除点%d", pointIndex); + } + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 点索引从 0 开始 +- 移除点会将所有后续点的索引向下移动一位 +- 如果指定的索引超出范围，函数将返回`false` +- 不能从无效路径中移除点 + +## 相关函数 + +- [NPC_AddPointToPath](NPC_AddPointToPath): 向路径添加点 +- [NPC_ClearPath](NPC_ClearPath): 清除路径中的所有点 +- [NPC_GetPathPointCount](NPC_GetPathPointCount): 获取路径中的点数 +- [NPC_GetPathPoint](NPC_GetPathPoint): 获取路径点信息 + +## 相关回调 + +- [OnNPCFinishMovePath](../callbacks/OnNPCFinishMovePath): NPC 完成沿路径移动时调用 +- [OnNPCFinishMove](../callbacks/OnNPCFinishMove): NPC 完成任何移动时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_ResetAnimation.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_ResetAnimation.md new file mode 100644 index 00000000000..ae58087aa38 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_ResetAnimation.md @@ -0,0 +1,56 @@ +--- +title: NPC_ResetAnimation +sidebar_label: NPC_ResetAnimation +description: 将 NPC 的当前动画重置为默认状态。 +tags: ["npc", "动画"] +--- + + + +## 描述 + +将 NPC 的当前动画重置为默认状态。 + +| 参数 | 说明 | +| ----- | --------- | +| npcid | NPC 的 ID | + +## 返回值 + +如果操作成功则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/resetanim", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + NPC_ResetAnimation(npcid); + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 动画已重置。", npcid); + + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 停止所有当前动画并让 NPC 返回空闲状态 +- 等同于调用 NPC_ClearAnimations + +## 相关函数 + +- [NPC_ApplyAnimation](NPC_ApplyAnimation): 为 NPC 应用动画 +- [NPC_ClearAnimations](NPC_ClearAnimations): 清除所有动画 +- [NPC_SetAnimation](NPC_SetAnimation): 设置特定动画 +- [NPC_GetAnimation](NPC_GetAnimation): 获取当前动画 + +## 相关回调 + +_此函数不会触发任何特定的回调。_ diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_ResetSurfingData.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_ResetSurfingData.md new file mode 100644 index 00000000000..e8fdab93393 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_ResetSurfingData.md @@ -0,0 +1,61 @@ +--- +title: NPC_ResetSurfingData +sidebar_label: NPC_ResetSurfingData +description: 重置 NPC 的所有冲浪数据。 +tags: ["npc", "冲浪"] +--- + + + +## 描述 + +重置 NPC 的所有冲浪数据。 + +| 参数 | 说明 | +| ----- | --------- | +| npcid | NPC 的 ID | + +## 返回值 + +如果操作成功则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/resetsurfing", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + NPC_ResetSurfingData(npcid); + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 冲浪数据已重置。", npcid); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 此函数清除 NPC 的所有冲浪相关数据，包括冲浪物体/车辆和偏移 +- 调用此函数后，NPC 将不再附着在任何表面上 +- NPC 的位置不会改变，只是重置其冲浪状态 + +## 相关函数 + +- [NPC_SetSurfingObject](NPC_SetSurfingObject): 设置 NPC 冲浪的物体 +- [NPC_SetSurfingVehicle](NPC_SetSurfingVehicle): 设置 NPC 冲浪的车辆 +- [NPC_SetSurfingPlayerObject](NPC_SetSurfingPlayerObject): 设置 NPC 冲浪的玩家物体 +- [NPC_SetSurfingOffsets](NPC_SetSurfingOffsets): 设置 NPC 的冲浪偏移 +- [NPC_GetSurfingObject](NPC_GetSurfingObject): 获取 NPC 冲浪的物体 +- [NPC_GetSurfingVehicle](NPC_GetSurfingVehicle): 获取 NPC 冲浪的车辆 + +## 相关回调 + +_此函数不会触发任何特定的回调。_ diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_Respawn.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_Respawn.md new file mode 100644 index 00000000000..28df07c7e16 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_Respawn.md @@ -0,0 +1,72 @@ +--- +title: NPC_Respawn +sidebar_label: NPC_Respawn +description: 让 NPC 重生到其出生位置，重置其状态。 +tags: ["npc", "出生", "重生"] +--- + + + +## 描述 + +让 NPC 重生到其出生位置，重置其状态。 + +| 参数 | 说明 | +| ----- | --------- | +| npcid | NPC 的 ID | + +## 返回值 + +如果操作成功则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/respawnnpc", true)) + { + new npcid = PlayerNPC[playerid]; + + if (!NPC_IsValid(npcid)) + { + SendClientMessage(playerid, 0xFF0000FF, "你没有有效的NPC可重生。"); + return 1; + } + + if (NPC_Respawn(npcid)) + { + SendClientMessage(playerid, 0x00FF00FF, "你的 NPC (ID %d) 已重生。", npcid); + } + else + { + SendClientMessage(playerid, 0xFF0000FF, "你的 NPC (ID %d) 重生失败。", npcid); + } + + return 1; + } + return 0; +} +``` + +## 注意事项 + +:::warning + +- 重置 NPC 生命值、位置和状态。 +- NPC 返回其原始出生坐标。 +- 所有当前活动（移动、战斗）都会停止。 + +::: + +## 相关函数 + +- [NPC_Spawn](NPC_Spawn): NPC 的初始出生。 +- [NPC_SetPos](NPC_SetPos): 设置 NPC 位置。 +- [NPC_GetHealth](NPC_GetHealth): 获取 NPC 生命值。 +- [NPC_IsDead](NPC_IsDead): 检查 NPC 是否死亡。 + +## 相关回调 + +- [OnNPCSpawn](../callbacks/OnNPCSpawn): NPC 出生时调用。 +- [OnNPCRespawn](../callbacks/OnNPCRespawn): NPC 重生时调用。 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_ResumePlayingNode.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_ResumePlayingNode.md new file mode 100644 index 00000000000..0696ac45a37 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_ResumePlayingNode.md @@ -0,0 +1,59 @@ +--- +title: NPC_ResumePlayingNode +sidebar_label: NPC_ResumePlayingNode +description: 恢复 NPC 的暂停节点导航。 +tags: ["npc", "节点"] +--- + + + +## 描述 + +恢复 NPC 的暂停节点导航。 + +| 参数 | 说明 | +| ----- | --------- | +| npcid | NPC 的 ID | + +## 返回值 + +如果操作成功则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/npcresumenode", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new bool:success = NPC_ResumePlayingNode(npcid); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 恢复节点: %s", npcid, success ? "成功" : "失败"); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 仅在 NPC 的节点导航之前被暂停时有效 +- NPC 将从暂停的位置继续 + +## 相关函数 + +- [NPC_PausePlayingNode](NPC_PausePlayingNode): 暂停节点导航 +- [NPC_PlayNode](NPC_PlayNode): 开始播放节点 +- [NPC_IsPlayingNodePaused](NPC_IsPlayingNodePaused): 检查是否暂停 +- [NPC_IsPlayingNode](NPC_IsPlayingNode): 检查是否正在播放节点 + +## 相关回调 + +- [OnNPCFinishNode](../callbacks/OnNPCFinishNode): NPC 完成节点时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetAmmo.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetAmmo.md new file mode 100644 index 00000000000..321e97e6d46 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetAmmo.md @@ -0,0 +1,65 @@ +--- +title: NPC_SetAmmo +sidebar_label: NPC_SetAmmo +description: 设置 NPC 当前武器的弹药数量。 +tags: ["npc", "武器", "子弹", "弹药"] +--- + + + +## 描述 + +设置 NPC 当前武器的弹药数量。 + +| 参数 | 说明 | +| ----- | ---------------- | +| npcid | NPC 的 ID | +| ammo | 要设置的弹药数量 | + +## 返回值 + +如果弹药设置成功则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/setammo ", true, 9)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new ammo = strval(cmdtext[9]); + if (ammo < 0) + return SendClientMessage(playerid, 0xFF0000FF, "弹药必须是非负整数。"); + + NPC_SetAmmo(npcid, ammo); + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 弹药设置为 %d", npcid, ammo); + + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 将弹药设置为 0 会使武器无法使用 +- 不同武器有不同的最大弹药容量 +- 这设置的是总弹药量，不仅仅是当前弹匣 + +## 相关函数 + +- [NPC_GetAmmo](NPC_GetAmmo): 获取 NPC 弹药 +- [NPC_SetAmmoInClip](NPC_SetAmmoInClip): 设置当前弹匣弹药 +- [NPC_GetAmmoInClip](NPC_GetAmmoInClip): 获取当前弹匣弹药 +- [NPC_EnableInfiniteAmmo](NPC_EnableInfiniteAmmo): 启用无限弹药 + +## 相关回调 + +_此函数不会触发任何特定的回调。_ diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetAmmoInClip.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetAmmoInClip.md new file mode 100644 index 00000000000..65f167772db --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetAmmoInClip.md @@ -0,0 +1,66 @@ +--- +title: NPC_SetAmmoInClip +sidebar_label: NPC_SetAmmoInClip +description: 设置 NPC 武器弹匣中的弹药数量。 +tags: ["npc", "武器", "子弹"] +--- + + + +## 描述 + +设置 NPC 武器弹匣中的弹药数量。 + +| 参数 | 说明 | +| ----- | ---------------- | +| npcid | NPC 的 ID | +| ammo | 要设置的弹药数量 | + +## 返回值 + +如果操作成功则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/setammoclip ", true, 13)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new ammo = strval(cmdtext[13]); + if (ammo < 0) + return SendClientMessage(playerid, 0xFF0000FF, "弹药必须是非负整数。"); + + NPC_SetAmmoInClip(npcid, ammo); + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 弹匣中的弹药数量设置为 %d", npcid, ammo); + + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 数量不能超过武器的最大弹匣容量 +- 设置为 0 将要求 NPC 在射击前重新装弹 +- 使用 NPC_GetAmmoInClip 检查当前弹匣数量 +- 仅影响当前武器的弹匣，不影响总弹药 + +## 相关函数 + +- [NPC_GetAmmoInClip](NPC_GetAmmoInClip): 获取弹匣中的弹药 +- [NPC_GetWeaponClipSize](NPC_GetWeaponClipSize): 获取最大弹匣容量 +- [NPC_GiveWeapon](NPC_GiveWeapon): 给 NPC 武器 +- [NPC_GetAmmo](NPC_GetAmmo): 获取总弹药 + +## 相关回调 + +- [OnNPCWeaponShot](../callbacks/OnNPCWeaponShot): NPC 射击时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetAngleToPlayer.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetAngleToPlayer.md new file mode 100644 index 00000000000..9f98a1820d2 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetAngleToPlayer.md @@ -0,0 +1,63 @@ +--- +title: NPC_SetAngleToPlayer +sidebar_label: NPC_SetAngleToPlayer +description: 使一个NPC朝向特定的玩家旋转。 +tags: ["npc", "角度", "玩家"] +--- + + + +## 描述 + +通过使用玩家当前的位置，旋转 NPC 使其朝向特定的玩家。 + +| 参数 | 说明 | +| -------- | ------------------------- | +| npcid | NPC 的 ID。 | +| playerid | NPC 应当朝向的玩家的 ID。 | + +## 返回值 + +如果 NPC 旋转成功，返回`true`；否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/lookatme", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + if (!IsPlayerConnected(playerid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的玩家。"); + + NPC_SetAngleToPlayer(npcid, playerid); + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 正朝向你。", npcid); + return 1; + } + return 0; +} +``` + +## 注意事项 + +:::warning + +- 此函数执行一次性旋转；若要使 NPC 持续朝向移动中的玩家，需重复调用。 +- 玩家必须处于连接状态，否则 NPC 将不会旋转。 +- 内部通过玩家当前位置调用[NPC_SetAngleToPos](NPC_SetAngleToPos)实现。 + +::: + +## 相关函数 + +- [NPC_SetAngleToPos](NPC_SetAngleToPos)：朝向特定坐标旋转。 +- [NPC_SetFacingAngle](NPC_SetFacingAngle)：设置一个数值角度。 +- [NPC_GetFacingAngle](NPC_GetFacingAngle)：获取 NPC 当前的朝向角度。 +- [NPC_MoveToPlayer](NPC_MoveToPlayer)：将 NPC 移动至玩家所在位置。 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetAngleToPos.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetAngleToPos.md new file mode 100644 index 00000000000..09f38adb955 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetAngleToPos.md @@ -0,0 +1,64 @@ +--- +title: NPC_SetAngleToPos +sidebar_label: NPC_SetAngleToPos +description: 旋转NPC，使其朝向特定的世界坐标位置。 +tags: ["npc", "角度", "位置"] +--- + + + +## 描述 + +旋转 NPC，使其朝向特定的世界坐标位置。 + +| 参数 | 说明 | +| ------- | ------------------- | +| npcid | NPC 的 ID。 | +| Float:x | 目标位置的 X 坐标。 | +| Float:y | 目标位置的 Y 坐标。 | +| Float:z | 目标位置的 Z 坐标。 | + +## 返回值 + +如果 NPC 旋转成功，返回`true`；否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/lookatpos", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new Float:x, Float:y, Float:z; + GetPlayerPos(playerid, x, y, z); + + NPC_SetAngleToPos(npcid, x + 3.0, y, z); + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 正朝向 %.2f, %.2f, %.2f", npcid, x + 3.0, y, z); + return 1; + } + return 0; +} +``` + +## 注意事项 + +:::warning + +- 计算朝向角度时，仅考虑水平面（X/Y 坐标）。 +- NPC 不会移动；仅执行旋转操作以朝向目标位置。 + +::: + +## 相关函数 + +- [NPC_SetFacingAngle](NPC_SetFacingAngle)：设置精确的角度值。 +- [NPC_SetAngleToPlayer](NPC_SetAngleToPlayer)：自动朝向特定玩家。 +- [NPC_GetFacingAngle](NPC_GetFacingAngle)：获取 NPC 当前的朝向角度。 +- [NPC_Move](NPC_Move)：将 NPC 移动至指定坐标位置。 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetAnimation.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetAnimation.md new file mode 100644 index 00000000000..32abc3184ea --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetAnimation.md @@ -0,0 +1,72 @@ +--- +title: NPC_SetAnimation +sidebar_label: NPC_SetAnimation +description: 通过动画 ID 为 NPC 设置动画。 +tags: ["npc", "动画"] +--- + + + +## 描述 + +使用动画 ID 为 NPC 设置动画。 + +| 参数 | 说明 | +| ----------- | -------------------------------------- | +| npcid | NPC 的 ID | +| animationid | 要设置的动画 ID | +| delta | 动画速度（通常为 4.1） | +| loop | 动画是否循环 | +| lockX | 动画期间锁定 X 轴移动 | +| lockY | 动画期间锁定 Y 轴移动 | +| freeze | 动画后冻结 NPC | +| time | 动画持续时间，以毫秒为单位（0 = 无限） | + +## 返回值 + +如果操作成功则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/setdance", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + NPC_SetAnimation(npcid, 405, 4.1, true, false, false, false, 0); + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 已设置动画。", npcid); + + SetTimerEx("ClearNPCAnimations", 25000, false, "ii", playerid, npcid); + + return 1; + } + return 0; +} + +forward ClearNPCAnimations(playerid, npcid); +public ClearNPCAnimations(playerid, npcid) +{ + + NPC_ClearAnimations(npcid); + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 动画已清除。", npcid); +} +``` + +## 注意事项 + +- 动画 ID 对应 GTA San Andreas 动画索引 +- 使用 `NPC_ApplyAnimation` 通过库名和名称设置动画 + +## 相关函数 + +- [NPC_ApplyAnimation](NPC_ApplyAnimation): 通过名称应用动画 +- [NPC_ClearAnimations](NPC_ClearAnimations): 清除所有动画 +- [NPC_ResetAnimation](NPC_ResetAnimation): 重置为默认姿态 + +## 相关回调 + +- [OnNPCSpawn](../callbacks/OnNPCSpawn): NPC 出生时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetArmour.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetArmour.md new file mode 100644 index 00000000000..4b2deddd134 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetArmour.md @@ -0,0 +1,66 @@ +--- +title: NPC_SetArmour +sidebar_label: NPC_SetArmour +description: 设置 NPC 的护甲等级。 +tags: ["npc", "护甲值", "生命值"] +--- + + + +## 描述 + +设置 NPC 的护甲等级。 + +| 参数 | 说明 | +| ------ | --------------------- | +| npcid | NPC 的 ID | +| armour | 护甲数量（0.0-100.0） | + +## 返回值 + +如果护甲设置成功则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/setarmour ", true, 11)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new Float:armour = floatstr(cmdtext[11]); + if (armour < 0.0 || armour > 100.0) + return SendClientMessage(playerid, 0xFF0000FF, "护甲必须在0.0和100.0之间。"); + + NPC_SetArmour(npcid, armour); + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 护甲设置为 %.1f", npcid, armour); + + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 护甲值范围从 0.0（无护甲）到 100.0（满护甲） +- 护甲在生命值受影响前吸收伤害 +- 使用 NPC_GetArmour 检查当前护甲等级 + +## 相关函数 + +- [NPC_GetArmour](NPC_GetArmour): 获取 NPC 护甲等级 +- [NPC_SetHealth](NPC_SetHealth): 设置 NPC 生命值 +- [NPC_GetHealth](NPC_GetHealth): 获取 NPC 生命值 +- [NPC_IsDead](NPC_IsDead): 检查 NPC 是否死亡 + +## 相关回调 + +- [OnNPCTakeDamage](../callbacks/OnNPCTakeDamage): NPC 受到伤害时调用 +- [OnNPCDeath](../callbacks/OnNPCDeath): NPC 死亡时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetFacingAngle.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetFacingAngle.md new file mode 100644 index 00000000000..7403725d544 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetFacingAngle.md @@ -0,0 +1,65 @@ +--- +title: NPC_SetFacingAngle +sidebar_label: NPC_SetFacingAngle +description: 设置 NPC 的朝向角度。 +tags: ["npc", "角度", "旋转"] +--- + + + +## 描述 + +设置 NPC 的朝向角度。 + +| 参数 | 说明 | +| ----------- | ----------------------------- | +| npcid | NPC 的 ID | +| Float:angle | 朝向角度，以度为单位（0-360） | + +## 返回值 + +如果朝向角度设置成功则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/setfacingangle ", true, 16)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new Float:angle = floatstr(cmdtext[16]); + if (angle < 0.0 || angle > 360.0) + return SendClientMessage(playerid, 0xFF0000FF, "角度必须在0.0和360.0之间。"); + + NPC_SetFacingAngle(npcid, angle); + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 朝向角度设置为 %.1f", npcid, angle); + + return 1; + } + return 0; +} +``` + +## 注意事项 + +:::warning + +- 角度以度为单位测量（0-360）。 +- 使用 [NPC_GetFacingAngle](NPC_GetFacingAngle) 获取当前朝向角度。 +- 立即旋转 NPC，没有动画。 + +::: + +## 相关函数 + +- [NPC_GetFacingAngle](NPC_GetFacingAngle): 获取 NPC 朝向角度。 +- [NPC_SetRot](NPC_SetRot): 设置 NPC 旋转（X, Y, Z）。 +- [NPC_GetRot](NPC_GetRot): 获取 NPC 旋转。 +- [NPC_SetPos](NPC_SetPos): 设置 NPC 位置。 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetFightingStyle.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetFightingStyle.md new file mode 100644 index 00000000000..a623b1adc2d --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetFightingStyle.md @@ -0,0 +1,70 @@ +--- +title: NPC_SetFightingStyle +sidebar_label: NPC_SetFightingStyle +description: 设置 NPC 的战斗风格，用于近身战斗。 +tags: ["npc", "战斗", "战斗风格", "近战攻击"] +--- + + + +## 描述 + +设置 NPC 的战斗风格，用于近身战斗。 + +| 参数 | 说明 | +| ----- | ----------- | +| npcid | NPC 的 ID | +| style | 战斗风格 ID | + +## 返回值 + +如果操作成功则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/setfightingstyle ", true, 18)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new styleid = strval(cmdtext[18]); + // 有效的战斗风格: 4, 5, 6, 7, 15, 16 + if (styleid != 4 && styleid != 5 && styleid != 6 && styleid != 7 && styleid != 15 && styleid != 16) + return SendClientMessage(playerid, 0xFF0000FF, "无效的风格。有效：4（普通），5（拳击），6（功夫），7（膝击），15（抓踢），16（肘击）"); + + NPC_SetFightingStyle(npcid, FIGHT_STYLE:styleid); + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 战斗风格设置为 %d", npcid, styleid); + + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 战斗风格影响近身攻击动画和伤害 +- 使用 NPC_GetFightingStyle 检查当前风格 +- 风格影响攻击动画和战斗效果 + +## 相关函数 + +- [NPC_GetFightingStyle](NPC_GetFightingStyle): 获取战斗风格 +- [NPC_MeleeAttack](NPC_MeleeAttack): 让 NPC 攻击 +- [NPC_IsMeleeAttacking](NPC_IsMeleeAttacking): 检查是否正在攻击 +- [NPC_StopMeleeAttack](NPC_StopMeleeAttack): 停止攻击 + +## 相关资源 + +- [战斗风格](../resources/fightingstyles) + +## 相关回调 + +- [OnNPCGiveDamage](../callbacks/OnNPCGiveDamage): NPC 对他人造成伤害时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetHealth.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetHealth.md new file mode 100644 index 00000000000..27c61000c4b --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetHealth.md @@ -0,0 +1,67 @@ +--- +title: NPC_SetHealth +sidebar_label: NPC_SetHealth +description: 设置 NPC 的生命值。 +tags: ["npc", "生命值"] +--- + + + +## 描述 + +设置 NPC 的生命值。 + +| 参数 | 说明 | +| ------ | -------------- | +| npcid | NPC 的 ID | +| health | 要设置的生命值 | + +## 返回值 + +如果生命值设置成功则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/sethealth ", true, 11)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new Float:health = floatstr(cmdtext[11]); + if (health < 0.0 || health > 100.0) + return SendClientMessage(playerid, 0xFF0000FF, "生命值必须在0.0到100.0之间。"); + + NPC_SetHealth(npcid, health); + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 生命值设置为 %.1f", npcid, health); + + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 生命值通常范围从 0.0 到 100.0，但可以设置更高 +- 将生命值设置为 0.0 会杀死 NPC +- NPC 默认出生时生命值为 100.0 + +## 相关函数 + +- [NPC_GetHealth](NPC_GetHealth): 获取 NPC 生命值 +- [NPC_SetArmour](NPC_SetArmour): 设置 NPC 护甲 +- [NPC_GetArmour](NPC_GetArmour): 获取 NPC 护甲 +- [NPC_IsDead](NPC_IsDead): 检查 NPC 是否死亡 +- [NPC_SetInvulnerable](NPC_SetInvulnerable): 使 NPC 无敌 + +## 相关回调 + +- [OnNPCTakeDamage](../callbacks/OnNPCTakeDamage): NPC 受到伤害时调用 +- [OnNPCDeath](../callbacks/OnNPCDeath): NPC 死亡时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetInterior.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetInterior.md new file mode 100644 index 00000000000..e6435f34391 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetInterior.md @@ -0,0 +1,64 @@ +--- +title: NPC_SetInterior +sidebar_label: NPC_SetInterior +description: 设置 NPC 的室内场景。 +tags: ["npc", "室内场景"] +--- + + + +## 描述 + +设置 NPC 的室内场景。 + +| 参数 | 说明 | +| ---------- | ------------------- | +| npcid | NPC 的 ID | +| interiorid | 要设置的室内场景 ID | + +## 返回值 + +如果操作成功则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/setinterior ", true, 13)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new interiorid = strval(cmdtext[13]); + if (interiorid < 0 || interiorid > 255) + return SendClientMessage(playerid, 0xFF0000FF, "室内场景 ID 必须在0到255之间。"); + + NPC_SetInterior(npcid, interiorid); + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 室内场景设置为 %d", npcid, interiorid); + + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 室内场景 0 是主世界（室外） +- 确保为每个室内设置适当的坐标 + +## 相关函数 + +- [NPC_GetInterior](NPC_GetInterior): 获取 NPC 室内场景 +- [NPC_SetVirtualWorld](NPC_SetVirtualWorld): 设置 NPC 虚拟世界 +- [NPC_GetVirtualWorld](NPC_GetVirtualWorld): 获取 NPC 虚拟世界 +- [NPC_SetPos](NPC_SetPos): 设置 NPC 位置 + +## 相关回调 + +- [OnNPCSpawn](../callbacks/OnNPCSpawn): NPC 出生时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetInvulnerable.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetInvulnerable.md new file mode 100644 index 00000000000..00cdc2469c4 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetInvulnerable.md @@ -0,0 +1,63 @@ +--- +title: NPC_SetInvulnerable +sidebar_label: NPC_SetInvulnerable +description: 设置 NPC 是否对伤害免疫。 +tags: ["npc", "无敌", "伤害", "保护"] +--- + + + +## 描述 + +设置 NPC 是否对伤害免疫。 + +| 参数 | 说明 | +| ------ | ------------------------------- | +| npcid | NPC 的 ID | +| toggle | true 设为无敌，false 设为可受伤 | + +## 返回值 + +如果免疫状态设置成功则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/toggleinvulnerable", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new bool:invulnerable = NPC_IsInvulnerable(npcid); + NPC_SetInvulnerable(npcid, !invulnerable); + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 伤害免疫: %s", npcid, !invulnerable ? "启用" : "禁用"); + + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 免疫的 NPC 不会受到武器、爆炸或其他伤害来源的伤害 +- 此设置会持续到被更改或 NPC 被销毁 +- 免疫的 NPC 仍然可以被移动、传送或更改动画 + +## 相关函数 + +- [NPC_IsInvulnerable](NPC_IsInvulnerable): 检查 NPC 是否无敌 +- [NPC_SetHealth](NPC_SetHealth): 设置 NPC 生命值 +- [NPC_GetHealth](NPC_GetHealth): 获取 NPC 生命值 +- [NPC_SetArmour](NPC_SetArmour): 设置 NPC 护甲 + +## 相关回调 + +- [OnNPCTakeDamage](../callbacks/OnNPCTakeDamage): NPC 受到伤害时调用（免疫的 NPC 不会调用） +- [OnNPCDeath](../callbacks/OnNPCDeath): NPC 死亡时调用（免疫的 NPC 不会死亡） diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetKeys.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetKeys.md new file mode 100644 index 00000000000..6b00e417b1e --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetKeys.md @@ -0,0 +1,94 @@ +--- +title: NPC_SetKeys +sidebar_label: NPC_SetKeys +description: 设置 NPC 的按键状态，模拟按键操作。 +tags: ["npc", "按键", "输入"] +--- + + + +## 描述 + +设置 NPC 的按键状态，模拟按键操作。 + +| 参数 | 说明 | +| ------------ | ---------------- | +| npcid | NPC 的 ID | +| upAndDown | 上/下键状态 | +| leftAndRight | 左/右键状态 | +| keys | 要设置的按键组合 | + +## 返回值 + +如果操作成功则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/setkeys ", true, 9)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new idx = 9; + new keys = 0, updown = 0, leftright = 0; + + // 处理按键 + while (cmdtext[idx] == ' ') idx++; + if (cmdtext[idx] == '\0') + return SendClientMessage(playerid, 0xFF0000FF, "用法：/setkeys [按键] [上下] [左右]"); + keys = strval(cmdtext[idx]); + + // 跳到下一个参数 + while (cmdtext[idx] != ' ' && cmdtext[idx] != '\0') idx++; + while (cmdtext[idx] == ' ') idx++; + + // 如果存在，向上解析 + if (cmdtext[idx] != '\0') + { + updown = strval(cmdtext[idx]); + while (cmdtext[idx] != ' ' && cmdtext[idx] != '\0') idx++; + while (cmdtext[idx] == ' ') idx++; + + // 如果存在，向右解析 + if (cmdtext[idx] != '\0') + { + leftright = strval(cmdtext[idx]); + } + } + + NPC_SetKeys(npcid, keys, updown, leftright); + SendClientMessage(playerid, 0x00FF00FF, "NPC %d keys: keys=%d, ud=%d, lr=%d", npcid, keys, updown, leftright); + + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 按键影响 NPC 在车辆内和步行时的行为 +- 使用 NPC_GetKeys 检查当前按键状态 +- 按键状态会持续到被更改或 NPC 状态重置 + +## 相关函数 + +- [NPC_GetKeys](NPC_GetKeys): 获取 NPC 的按键状态 +- [NPC_PutInVehicle](NPC_PutInVehicle): 将 NPC 放入车辆 +- [NPC_Move](NPC_Move): 让 NPC 移动到位置 +- [NPC_StopMove](NPC_StopMove): 停止 NPC 移动 + +## 相关资源 + +- [按键](../resources/keys) + +## 相关回调 + +_此函数不会触发任何特定的回调。_ diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetNodePoint.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetNodePoint.md new file mode 100644 index 00000000000..d7bf94dc90e --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetNodePoint.md @@ -0,0 +1,68 @@ +--- +title: NPC_SetNodePoint +sidebar_label: NPC_SetNodePoint +description: 在 NPC 节点中设置一个点。 +tags: ["npc", "节点", "导航"] +--- + + + +## 描述 + +为 NPC 节点设置当前点索引。 + +| 参数 | 说明 | +| ------- | -------------- | +| nodeid | 节点的 ID | +| pointid | 节点中的点索引 | + +## 返回值 + +如果点设置成功则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/npcsetnodepoint ", true, 17)) + { + new nodeid = strval(cmdtext[17]); + + if (nodeid < 0 || nodeid > 63) + return SendClientMessage(playerid, 0xFF0000FF, "无效的节点ID。必须在 0 ~ 63 之间。"); + + new idx = 17; + while (cmdtext[idx] != ' ' && cmdtext[idx] != '\0') idx++; + while (cmdtext[idx] == ' ') idx++; + + if (cmdtext[idx] == '\0') + return SendClientMessage(playerid, 0xFF0000FF, "用法：/npcsetnodepoint [节点id] [点id]"); + + new pointid = strval(cmdtext[idx]); + + new bool:success = NPC_SetNodePoint(nodeid, pointid); + + SendClientMessage(playerid, 0x00FF00FF, "设置节点 %d 为点 %d: %s", nodeid, pointid, success ? "成功" : "失败"); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 在设置点之前必须打开节点 +- 点索引通常从 0 开始 +- 使用 NPC_GetNodePointPosition 检索点坐标 + +## 相关函数 + +- [NPC_OpenNode](NPC_OpenNode): 打开节点进行编辑 +- [NPC_GetNodePointPosition](NPC_GetNodePointPosition): 获取点坐标 +- [NPC_GetNodePointCount](NPC_GetNodePointCount): 获取点数量 +- [NPC_UpdateNodePoint](NPC_UpdateNodePoint): 更新现有点 + +## 相关回调 + +_此函数不会触发任何特定的回调。_ diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetPos.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetPos.md new file mode 100644 index 00000000000..cecde7377ad --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetPos.md @@ -0,0 +1,70 @@ +--- +title: NPC_SetPos +sidebar_label: NPC_SetPos +description: 瞬间设置 NPC 的位置，无需移动动画。 +tags: ["npc", "位置"] +--- + + + +## 描述 + +瞬间设置 NPC 的位置，无需移动动画。 + +| 参数 | 说明 | +| ------- | ----------- | +| npcid | NPC 的 ID。 | +| Float:x | X 坐标。 | +| Float:y | Y 坐标。 | +| Float:z | Z 坐标。 | + +## 返回值 + +成功时返回`true`，失败时返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/setposhere", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new Float:x, Float:y, Float:z; + GetPlayerPos(playerid, x, y, z); + + NPC_SetPos(npcid, x + 2.0, y, z); + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 传送到你的位置", npcid); + + return 1; + } + return 0; +} +``` + +## 注意事项 + +:::warning + +- 此函数瞬间传送 NPC，没有动画 +- 设置位置时会停止任何当前的移动 +- 如果希望 NPC 走向某个位置，请使用 `NPC_Move` + +::: + +## 相关函数 + +- [NPC_GetPos](NPC_GetPos): 获取 NPC 位置。 +- [NPC_Move](NPC_Move): 带动画移动 NPC 到位置。 +- [NPC_SetRot](NPC_SetRot): 设置 NPC 旋转。 +- [NPC_SetFacingAngle](NPC_SetFacingAngle): 设置 NPC 面向方向。 + +## 相关回调 + +- [OnNPCSpawn](../callbacks/OnNPCSpawn): NPC 出生时调用。 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetRot.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetRot.md new file mode 100644 index 00000000000..75407dede12 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetRot.md @@ -0,0 +1,68 @@ +--- +title: NPC_SetRot +sidebar_label: NPC_SetRot +description: 设置 NPC 在所有轴上的旋转。 +tags: ["npc", "旋转", "角度"] +--- + + + +## 描述 + +设置 NPC 在所有三个轴（X、Y、Z）上的旋转。 + +| 参数 | 说明 | +| ------- | ---------------------- | +| npcid | NPC 的 ID。 | +| Float:x | X 轴旋转，以度为单位。 | +| Float:y | Y 轴旋转，以度为单位。 | +| Float:z | Z 轴旋转，以度为单位。 | + +## 返回值 + +如果操作成功则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/setrandomrot", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new Float:x = float(random(360)); + new Float:y = float(random(360)); + new Float:z = float(random(360)); + + NPC_SetRot(npcid, x, y, z); + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 随机旋转", npcid); + + return 1; + } + return 0; +} +``` + +## 注意事项 + +:::warning + +- 旋转值以度为单位（0-360）。 +- Z 轴旋转影响面向方向（与 [NPC_SetFacingAngle](NPC_SetFacingAngle) 相同）。 +- X 和 Y 旋转可以创建倾斜或倒立的 NPC。 +- 使用 [NPC_GetRot](NPC_GetRot) 检索当前旋转值。 + +::: + +## 相关函数 + +- [NPC_GetRot](NPC_GetRot): 获取 NPC 旋转。 +- [NPC_SetFacingAngle](NPC_SetFacingAngle): 仅设置面向角度。 +- [NPC_GetFacingAngle](NPC_GetFacingAngle): 获取面向角度。 +- [NPC_SetPos](NPC_SetPos): 设置 NPC 位置。 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetSkin.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetSkin.md new file mode 100644 index 00000000000..c66e87f15e2 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetSkin.md @@ -0,0 +1,62 @@ +--- +title: NPC_SetSkin +sidebar_label: NPC_SetSkin +description: 设置 NPC 的皮肤模型，改变其外观。 +tags: ["npc", "皮肤", "模型"] +--- + + + +## 描述 + +设置 NPC 的皮肤模型以改变其外观。 + +| 参数 | 说明 | +| ----- | ------------------- | +| npcid | NPC 的 ID | +| model | 要设置的皮肤模型 ID | + +## 返回值 + +如果皮肤设置成功则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/setskin ", true, 9)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new skinid = strval(cmdtext[9]); + if (skinid < 0 || skinid > 311) + return SendClientMessage(playerid, 0xFF0000FF, "皮肤ID必须在0到311之间。"); + + NPC_SetSkin(npcid, skinid); + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 皮肤设置为 %d", npcid, skinid); + + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 无效的皮肤 ID 可能会导致视觉故障 + +## 相关函数 + +- [NPC_GetSkin](NPC_GetSkin): 获取 NPC 的当前皮肤 +- [NPC_Spawn](NPC_Spawn): 使用默认皮肤生成 NPC +- [NPC_Create](NPC_Create): 创建 NPC + +## 相关回调 + +- [OnNPCSpawn](../callbacks/OnNPCSpawn): NPC 出生时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetSpecialAction.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetSpecialAction.md new file mode 100644 index 00000000000..ec41d4424ba --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetSpecialAction.md @@ -0,0 +1,66 @@ +--- +title: NPC_SetSpecialAction +sidebar_label: NPC_SetSpecialAction +description: 设置 NPC 的特殊动作状态，如坐下、吸烟、饮酒等。 +tags: ["npc", "动作", "特殊"] +--- + + + +## 描述 + +设置 NPC 的特殊动作状态，如坐下、吸烟、饮酒等。 + +| 参数 | 说明 | +| ------ | ------------------- | +| npcid | NPC 的 ID | +| action | 要设置的特殊动作 ID | + +## 返回值 + +如果操作成功则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/setspecialaction ", true, 18)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new actionid = strval(cmdtext[18]); + + NPC_SetSpecialAction(npcid, SPECIAL_ACTION:actionid); + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 特殊动作设置为 %d", npcid, actionid); + + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 使用 SPECIAL_ACTION_NONE 清除当前动作 +- 某些动作可能与移动或其他活动冲突 + +## 相关函数 + +- [NPC_GetSpecialAction](NPC_GetSpecialAction): 获取当前特殊动作 +- [NPC_ApplyAnimation](NPC_ApplyAnimation): 应用自定义动画 +- [NPC_ClearAnimations](NPC_ClearAnimations): 清除动画 +- [NPC_ResetAnimation](NPC_ResetAnimation): 重置为默认状态 + +## Related Resources + +- [Special Actions](../resources/specialactions) + +## 相关回调 + +_此函数不会触发任何特定的回调。_ diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetSurfingObject.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetSurfingObject.md new file mode 100644 index 00000000000..c04df865b18 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetSurfingObject.md @@ -0,0 +1,63 @@ +--- +title: NPC_SetSurfingObject +sidebar_label: NPC_SetSurfingObject +description: 设置 NPC 正在冲浪的物体。 +tags: ["npc", "冲浪"] +--- + + + +## 描述 + +设置 NPC 正在冲浪的物体。 + +| 参数 | 说明 | +| -------- | --------- | +| npcid | NPC 的 ID | +| objectid | 物体 ID | + +## 返回值 + +如果操作成功则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/setsurfingobject ", true, 18)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new objectid = strval(cmdtext[18]); + + NPC_SetSurfingObject(npcid, objectid); + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 冲浪物体设置为 %d", npcid, objectid); + + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 如果物体移动，NPC 将随之移动 +- 物体必须存在才能正常冲浪 + +## 相关函数 + +- [NPC_GetSurfingObject](NPC_GetSurfingObject): 获取 NPC 正在冲浪的物体 +- [NPC_SetSurfingVehicle](NPC_SetSurfingVehicle): 设置 NPC 正在冲浪的车辆 +- [NPC_SetSurfingPlayerObject](NPC_SetSurfingPlayerObject): 设置 NPC 正在冲浪的玩家物体 +- [NPC_SetSurfingOffsets](NPC_SetSurfingOffsets): 设置 NPC 的冲浪偏移 +- [NPC_ResetSurfingData](NPC_ResetSurfingData): 重置 NPC 的所有冲浪数据 + +## 相关回调 + +_此函数不会触发任何特定的回调。_ diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetSurfingOffsets.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetSurfingOffsets.md new file mode 100644 index 00000000000..4a831a886d1 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetSurfingOffsets.md @@ -0,0 +1,90 @@ +--- +title: NPC_SetSurfingOffsets +sidebar_label: NPC_SetSurfingOffsets +description: 设置 NPC 的冲浪偏移。 +tags: ["npc", "冲浪"] +--- + + + +## 描述 + +设置 NPC 的冲浪偏移。 + +| 参数 | 说明 | +| ----- | --------- | +| npcid | NPC 的 ID | +| x | X 偏移 | +| y | Y 偏移 | +| z | Z 偏移 | + +## 返回值 + +如果操作成功则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/setsurfingoffset ", true, 18)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new Float:x, Float:y, Float:z; + new idx = 18; + + // 处理x + while (cmdtext[idx] == ' ') idx++; + new startIdx = idx; + while (cmdtext[idx] != ' ' && cmdtext[idx] != '\0') idx++; + new xStr[32]; + strmid(xStr, cmdtext, startIdx, idx); + x = floatstr(xStr); + + // 处理y + while (cmdtext[idx] == ' ') idx++; + startIdx = idx; + while (cmdtext[idx] != ' ' && cmdtext[idx] != '\0') idx++; + new yStr[32]; + strmid(yStr, cmdtext, startIdx, idx); + y = floatstr(yStr); + + // 处理z + while (cmdtext[idx] == ' ') idx++; + z = floatstr(cmdtext[idx]); + + NPC_SetSurfingOffsets(npcid, x, y, z); + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 冲浪偏移设置为 %.2f, %.2f, %.2f", npcid, x, y, z); + + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 冲浪偏移决定了 NPC 相对于其冲浪的物体/车辆的相对位置 +- 正 Z 值将 NPC 向上移动，负值向下移动 +- 正 Y 值通常将 NPC 相对于车辆方向向前移动 +- 正 X 值将 NPC 相对于车辆方向向右移动 +- 这对于微调冲浪时 NPC 的位置很有用 +- 非常适合创建车辆护送或乘客 + +## 相关函数 + +- [NPC_GetSurfingOffsets](NPC_GetSurfingOffsets): 获取 NPC 的冲浪偏移 +- [NPC_SetSurfingObject](NPC_SetSurfingObject): 设置 NPC 正在冲浪的物体 +- [NPC_SetSurfingVehicle](NPC_SetSurfingVehicle): 设置 NPC 正在冲浪的车辆 +- [NPC_SetSurfingPlayerObject](NPC_SetSurfingPlayerObject): 设置 NPC 正在冲浪的玩家物体 +- [NPC_ResetSurfingData](NPC_ResetSurfingData): 重置 NPC 的所有冲浪数据 + +## 相关回调 + +_此函数不会触发任何特定的回调。_ diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetSurfingPlayerObject.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetSurfingPlayerObject.md new file mode 100644 index 00000000000..4a77cc13199 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetSurfingPlayerObject.md @@ -0,0 +1,64 @@ +--- +title: NPC_SetSurfingPlayerObject +sidebar_label: NPC_SetSurfingPlayerObject +description: 设置 NPC 正在冲浪的玩家物体。 +tags: ["npc", "冲浪"] +--- + + + +## 描述 + +设置 NPC 正在冲浪的玩家物体。 + +| 参数 | 说明 | +| -------- | ----------- | +| npcid | NPC 的 ID | +| objectid | 玩家物体 ID | + +## 返回值 + +如果操作成功则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/setsurfingplayerobject ", true, 24)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new objectid = strval(cmdtext[24]); + + NPC_SetSurfingPlayerObject(npcid, objectid); + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 冲浪的玩家物体设置为 %d", npcid, objectid); + + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 如果玩家物体移动，NPC 将随之移动 +- 玩家物体是专门为单个玩家创建的客户端物体 +- 玩家物体必须存在才能正常冲浪 + +## 相关函数 + +- [NPC_GetSurfingPlayerObject](NPC_GetSurfingPlayerObject): 获取 NPC 正在冲浪的玩家物体 +- [NPC_SetSurfingObject](NPC_SetSurfingObject): 设置 NPC 正在冲浪的物体 +- [NPC_SetSurfingVehicle](NPC_SetSurfingVehicle): 设置 NPC 正在冲浪的车辆 +- [NPC_SetSurfingOffsets](NPC_SetSurfingOffsets): 设置 NPC 的冲浪偏移 +- [NPC_ResetSurfingData](NPC_ResetSurfingData): 重置 NPC 的所有冲浪数据 + +## 相关回调 + +_此函数不会触发任何特定的回调。_ diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetSurfingVehicle.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetSurfingVehicle.md new file mode 100644 index 00000000000..529427f2a5a --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetSurfingVehicle.md @@ -0,0 +1,65 @@ +--- +title: NPC_SetSurfingVehicle +sidebar_label: NPC_SetSurfingVehicle +description: 设置 NPC 正在冲浪的车辆。 +tags: ["npc", "冲浪", "车辆"] +--- + + + +## 描述 + +设置 NPC 正在冲浪的车辆。 + +| 参数 | 说明 | +| --------- | --------- | +| npcid | NPC 的 ID | +| vehicleid | 车辆 ID | + +## 返回值 + +如果操作成功则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/setsurfingvehicle ", true, 19)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new vehicleid = strval(cmdtext[19]); + + NPC_SetSurfingVehicle(npcid, vehicleid); + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 冲浪的车辆设置为 %d", npcid, vehicleid); + + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 此函数允许 NPC 在车辆上"冲浪"，意味着它们会随着车辆移动，同时保持相对于车辆的位置 +- NPC 会跟随车辆的移动、旋转和位置变化 +- 使用 `NPC_SetSurfingOffsets` 将 NPC 定位到车辆的特定位置（车顶、引擎盖等） +- 车辆必须存在才能正常冲浪 + +## 相关函数 + +- [NPC_GetSurfingVehicle](NPC_GetSurfingVehicle): 获取 NPC 正在冲浪的车辆 +- [NPC_SetSurfingObject](NPC_SetSurfingObject): 设置 NPC 正在冲浪的物体 +- [NPC_SetSurfingPlayerObject](NPC_SetSurfingPlayerObject): 设置 NPC 正在冲浪的玩家物体 +- [NPC_SetSurfingOffsets](NPC_SetSurfingOffsets): 设置 NPC 的冲浪偏移 +- [NPC_ResetSurfingData](NPC_ResetSurfingData): 重置 NPC 的所有冲浪数据 + +## 相关回调 + +_此函数不会触发任何特定的回调。_ diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetVehicleGearState.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetVehicleGearState.md new file mode 100644 index 00000000000..fd05f8bb1eb --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetVehicleGearState.md @@ -0,0 +1,67 @@ +--- +title: NPC_SetVehicleGearState +sidebar_label: NPC_SetVehicleGearState +description: 设置 NPC 驾驶飞机时的起落架状态。 +tags: ["npc", "车辆", “飞机”, “起落架”] +--- + + + +## 描述 + +设置 NPC 驾驶飞机时的起落架状态。 + +| 参数 | 说明 | +| --------- | ---------------------------------------------------------------------- | +| npcid | NPC 的 ID | +| gearstate | 要设置的起落架状态（LANDING_GEAR_STATE_DOWN 或 LANDING_GEAR_STATE_UP） | + +## 返回值 + +此函数不返回特定值。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/setvehiclegearstate ", true, 21)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new gearState = strval(cmdtext[21]); + + NPC_SetVehicleGearState(npcid, gearState); + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 飞机起落架状态设置为 %d", npcid, gearState); + + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 仅在 NPC 驾驶飞机时有效 +- 使用与[飞机起落架状态](../resources/landinggearstate)相同的常量：LANDING_GEAR_STATE_DOWN 和 LANDING_GEAR_STATE_UP +- 使用 NPC_GetVehicleGearState 检查当前起落架状态 + +## 相关函数 + +- [NPC_GetVehicleGearState](NPC_GetVehicleGearState): 获取当前起落架状态 +- [GetPlayerLandingGearState](GetPlayerLandingGearState): 获取玩家起落架状态 +- [GetVehicleLandingGearState](GetVehicleLandingGearState): 获取飞机起落架状态 +- [NPC_PutInVehicle](NPC_PutInVehicle): 将 NPC 放入车辆 + +## 相关资源 + +- [飞机起落架状态](../resources/landinggearstate) + +## 相关回调 + +_此函数不会触发任何特定的回调。_ diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetVehicleHealth.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetVehicleHealth.md new file mode 100644 index 00000000000..691364c589e --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetVehicleHealth.md @@ -0,0 +1,63 @@ +--- +title: NPC_SetVehicleHealth +sidebar_label: NPC_SetVehicleHealth +description: 设置 NPC 车辆的生命值。 +tags: ["npc", "车辆", "生命值"] +--- + + + +## 描述 + +设置 NPC 车辆的生命值。 + +| 参数 | 说明 | +| ------ | -------------------- | +| npcid | NPC 的 ID | +| health | 生命值（0.0-1000.0） | + +## 返回值 + +如果操作成功则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/setvehiclehealth ", true, 18)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new Float:health = floatstr(cmdtext[18]); + + NPC_SetVehicleHealth(npcid, health); + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 车辆生命值设置为 %.2f", npcid, health); + + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 仅在 NPC 在车辆中时有效 +- 生命值范围从 0.0（已摧毁）到 1000.0（完美状态） +- Vehicles explode when health drops below 250 + +## 相关函数 + +- [NPC_GetVehicleHealth](NPC_GetVehicleHealth): 获取车辆生命值 +- [NPC_GetVehicleID](NPC_GetVehicleID): 获取 NPC 的车辆 +- [NPC_PutInVehicle](NPC_PutInVehicle): 将 NPC 放入车辆 +- [SetVehicleHealth](SetVehicleHealth): 直接设置车辆生命值 + +## 相关回调 + +_此函数不会触发任何特定的回调。_ diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetVehicleHydraThrusters.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetVehicleHydraThrusters.md new file mode 100644 index 00000000000..1617f42906e --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetVehicleHydraThrusters.md @@ -0,0 +1,64 @@ +--- +title: NPC_SetVehicleHydraThrusters +sidebar_label: NPC_SetVehicleHydraThrusters +description: 设置 NPC 驾驶的九头蛇战机推进器方向。 +tags: ["npc", "车辆", "九头蛇战机", “飞机”] +--- + + + +## 描述 + +设置 NPC 驾驶九头蛇战机时的推进器方向。 + +| 参数 | 说明 | +| --------- | ---------------------------- | +| npcid | NPC 的 ID | +| direction | 推进器方向（0=向前，1=向下） | + +## 返回值 + +如果操作成功则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/sethydrathrusters ", true, 19)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new direction = strval(cmdtext[19]); + + NPC_SetVehicleHydraThrusters(npcid, direction); + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 九头蛇战机推进器方向设置为 %d", npcid, direction); + + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 仅适用于 Hydra 飞机（车辆 ID 520） +- 方向 0 = 向前推进器（喷气模式） +- 方向 1 = 向下推进器（垂直起降 模式） +- 使用 NPC_GetVehicleHydraThrusters 检查当前方向 + +## 相关函数 + +- [NPC_GetVehicleHydraThrusters](NPC_GetVehicleHydraThrusters): 获取推进器方向 +- [NPC_GetVehicleID](NPC_GetVehicleID): 获取 NPC 的车辆 +- [NPC_PutInVehicle](NPC_PutInVehicle): 将 NPC 放入车辆 +- [GetVehicleModel](GetVehicleModel): 获取车辆模型 + +## 相关回调 + +_此函数不会触发任何特定的回调。_ diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetVehicleTrainSpeed.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetVehicleTrainSpeed.md new file mode 100644 index 00000000000..003471a9215 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetVehicleTrainSpeed.md @@ -0,0 +1,63 @@ +--- +title: NPC_SetVehicleTrainSpeed +sidebar_label: NPC_SetVehicleTrainSpeed +description: 设置 NPC 火车的速度。 +tags: ["npc", "车辆", "火车", "速度"] +--- + + + +## 描述 + +设置 NPC 火车的速度。 + +| 参数 | 说明 | +| ----- | ---------------- | +| npcid | NPC 的 ID | +| speed | 要设置的火车速度 | + +## 返回值 + +如果操作成功则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/settrainspeed ", true, 15)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new Float:speed = floatstr(cmdtext[15]); + + NPC_SetVehicleTrainSpeed(npcid, speed); + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 火车车速设置为 to %.2f", npcid, speed); + + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 仅适用于火车（模型 537、538） +- 使用 NPC_GetVehicleTrainSpeed 检查当前速度 +- 将速度设置为 0 会停止火车 + +## 相关函数 + +- [NPC_GetVehicleTrainSpeed](NPC_GetVehicleTrainSpeed): 获取火车速度 +- [NPC_GetVehicleID](NPC_GetVehicleID): 获取 NPC 的车辆 +- [NPC_PutInVehicle](NPC_PutInVehicle): 将 NPC 放入车辆 +- [GetVehicleModel](GetVehicleModel): 获取车辆模型 + +## 相关回调 + +_此函数不会触发任何特定的回调。_ diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetVelocity.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetVelocity.md new file mode 100644 index 00000000000..be4713688c3 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetVelocity.md @@ -0,0 +1,85 @@ +--- +title: NPC_SetVelocity +sidebar_label: NPC_SetVelocity +description: 设置NPC的速度 +tags: ["npc", "速度", "移动"] +--- + + + +## 描述 + +设置 NPC 的速度。 + +| 参数 | 说明 | +| ------- | ---------- | +| npcid | NPC 的 ID | +| Float:x | X 速度分量 | +| Float:y | Y 速度分量 | +| Float:z | Z 速度分量 | + +## 返回值 + +成功时返回 `true`，失败时返回 `false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/setvelocity ", true, 13)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new Float:x, Float:y, Float:z; + new idx = 13; + + // 处理x + while (cmdtext[idx] == ' ') idx++; + new startIdx = idx; + while (cmdtext[idx] != ' ' && cmdtext[idx] != '\0') idx++; + new xStr[32]; + strmid(xStr, cmdtext, startIdx, idx); + x = floatstr(xStr); + + // 处理y + while (cmdtext[idx] == ' ') idx++; + startIdx = idx; + while (cmdtext[idx] != ' ' && cmdtext[idx] != '\0') idx++; + new yStr[32]; + strmid(yStr, cmdtext, startIdx, idx); + y = floatstr(yStr); + + // 处理z + while (cmdtext[idx] == ' ') idx++; + z = floatstr(cmdtext[idx]); + + NPC_SetVelocity(npcid, x, y, z); + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 速度设置为 %.2f, %.2f, %.2f", npcid, x, y, z); + + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 速度值决定了移动的速度和方向 +- 正 Z 值使 NPC 向上移动，负值使 NPC 向下移动 +- 这可用于创建自定义移动行为 + +## 相关函数 + +- [NPC_GetVelocity](NPC_GetVelocity): 获取 NPC 速度 +- [NPC_SetPos](NPC_SetPos): 设置 NPC 位置 +- [NPC_Move](NPC_Move): 使 NPC 移动到指定位置 + +## 相关回调 + +- [OnNPCFinishMove](../callbacks/OnNPCFinishMove): 当 NPC 完成移动时被调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetVirtualWorld.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetVirtualWorld.md new file mode 100644 index 00000000000..223e747fb6f --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetVirtualWorld.md @@ -0,0 +1,66 @@ +--- +title: NPC_SetVirtualWorld +sidebar_label: NPC_SetVirtualWorld +description: 设置 NPC 的虚拟世界。 +tags: ["npc", "虚拟世界", "维度"] +--- + + + +## 描述 + +设置 NPC 的虚拟世界，控制哪些玩家可以看到并与之互动。 + +| 参数 | 说明 | +| ----- | --------------------- | +| npcid | NPC 的 ID。 | +| vw | 要设置的虚拟世界 ID。 | + +## 返回值 + +如果操作成功则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/setvirtualworld ", true, 16)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new vw = strval(cmdtext[16]); + if (vw < 0) + return SendClientMessage(playerid, 0xFF0000FF, "虚拟世界必须为非负整数。"); + + NPC_SetVirtualWorld(npcid, vw); + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 虚拟世界设置为 %d", npcid, vw); + + return 1; + } + return 0; +} +``` + +## 注意事项 + +:::warning + +- 虚拟世界 0 是默认世界，所有玩家都在此开始。 +- 不同虚拟世界中的 NPC 无法看到或相互互动。 +- 玩家必须与 NPC 在相同的虚拟世界中才能看到它们。 +- 使用 [NPC_GetVirtualWorld](NPC_GetVirtualWorld) 检查当前虚拟世界。 + +::: + +## 相关函数 + +- [NPC_GetVirtualWorld](NPC_GetVirtualWorld): 获取 NPC 的虚拟世界。 +- [SetPlayerVirtualWorld](SetPlayerVirtualWorld): 设置玩家的虚拟世界。 +- [GetPlayerVirtualWorld](GetPlayerVirtualWorld): 获取玩家的虚拟世界。 +- [NPC_SetInterior](NPC_SetInterior): 设置 NPC 的室内。 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetWeapon.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetWeapon.md new file mode 100644 index 00000000000..239bf03819a --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetWeapon.md @@ -0,0 +1,64 @@ +--- +title: NPC_SetWeapon +sidebar_label: NPC_SetWeapon +description: 设置 NPC 的当前武器。 +tags: ["npc", "武器", "战斗"] +--- + + + +## 描述 + +设置 NPC 的当前武器为特定武器 ID。 + +| 参数 | 说明 | +| ------ | --------------- | +| npcid | NPC 的 ID | +| weapon | 要设置的武器 ID | + +## 返回值 + +如果武器设置成功则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/setweapon ", true, 11)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new weaponid = strval(cmdtext[11]); + if (weaponid < 0 || weaponid > 46) + return SendClientMessage(playerid, 0xFF0000FF, "无效的武器ID。必须在0到46之间。"); + + NPC_SetWeapon(npcid, WEAPON:weaponid); + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 武器设置为 %d", npcid, weaponid); + + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 设置武器将为 NPC 装备该武器 +- 使用 NPC_SetAmmo 为武器提供弹药 +- 使用 NPC_GetWeapon 检查当前武器 + +## 相关函数 + +- [NPC_GetWeapon](NPC_GetWeapon): 获取 NPC 的当前武器 +- [NPC_SetAmmo](NPC_SetAmmo): 设置 NPC 武器的弹药 +- [NPC_GetAmmo](NPC_GetAmmo): 获取 NPC 的当前弹药数量 + +## 相关回调 + +- [OnNPCWeaponShot](../callbacks/OnNPCWeaponShot): NPC 开火时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetWeaponAccuracy.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetWeaponAccuracy.md new file mode 100644 index 00000000000..0f034edcbf5 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetWeaponAccuracy.md @@ -0,0 +1,63 @@ +--- +title: NPC_SetWeaponAccuracy +sidebar_label: NPC_SetWeaponAccuracy +description: 设置 NPC 特定武器的精准度。 +tags: ["npc", "武器", "精准度"] +--- + + + +## 描述 + +设置 NPC 特定武器的精准度。 + +| 参数 | 说明 | +| -------- | ---------------------- | +| npcid | NPC 的 ID | +| weaponid | 要设置精准度的武器 ID | +| accuracy | 精准度值（0.0 到 1.0） | + +## 返回值 + +如果操作成功则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/setweaponaccuracy ", true, 19)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new weapon = NPC_GetWeapon(npcid); + new Float:accuracy = floatstr(cmdtext[19]); + + NPC_SetWeaponAccuracy(npcid, WEAPON:weapon, accuracy); + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 武器 %d 精准度设置为 %.2f", npcid, weapon, accuracy); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 精准度值范围从 0.0（从不命中）到 1.0（总是命中） +- 默认精准度因武器类型而异 +- 精准度影响子弹散布和命中概率 + +## 相关函数 + +- [NPC_GetWeaponAccuracy](NPC_GetWeaponAccuracy): 获取武器精准度 +- [NPC_SetWeapon](NPC_SetWeapon): 设置 NPC 武器 +- [NPC_Shoot](NPC_Shoot): 让 NPC 开火 + +## 相关回调 + +_此函数不会触发任何特定的回调。_ diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetWeaponClipSize.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetWeaponClipSize.md new file mode 100644 index 00000000000..581a828e383 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetWeaponClipSize.md @@ -0,0 +1,64 @@ +--- +title: NPC_SetWeaponClipSize +sidebar_label: NPC_SetWeaponClipSize +description: 设置 NPC 武器的弹匣容量。 +tags: ["npc", "武器", "子弹"] +--- + + + +## 描述 + +设置 NPC 当前武器的弹匣容量。 + +| 参数 | 说明 | +| ------ | --------------- | +| npcid | NPC 的 ID | +| weapon | 要设置的武器 ID | +| size | 新的弹匣容量 | + +## 返回值 + +如果操作成功则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/setweaponclipsize ", true, 19)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new weapon = NPC_GetWeapon(npcid); + new clipsize = strval(cmdtext[19]); + + NPC_SetWeaponClipSize(npcid, WEAPON:weapon, clipsize); + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 武器 %d 弹匣容量设置为 %d", npcid, weapon, clipsize); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- NPC 必须拥有武器此函数才能工作 +- 弹匣容量影响 NPC 在需要重新装填前可以发射多少弹药 +- 不同武器有不同的默认弹匣容量 + +## 相关函数 + +- [NPC_GetWeaponClipSize](NPC_GetWeaponClipSize): 获取武器弹匣容量 +- [NPC_SetAmmoInClip](NPC_SetAmmoInClip): 设置当前弹匣弹药 +- [NPC_GetAmmoInClip](NPC_GetAmmoInClip): 获取当前弹匣弹药 +- [NPC_SetWeapon](NPC_SetWeapon): 设置 NPC 武器 + +## 相关回调 + +- [OnNPCWeaponShot](../callbacks/OnNPCWeaponShot): NPC 开火时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetWeaponReloadTime.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetWeaponReloadTime.md new file mode 100644 index 00000000000..ceacdb9cb3d --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetWeaponReloadTime.md @@ -0,0 +1,63 @@ +--- +title: NPC_SetWeaponReloadTime +sidebar_label: NPC_SetWeaponReloadTime +description: 设置 NPC 武器的重新装填时间。 +tags: ["npc", "武器", "换弹", "时间"] +--- + + + +## 描述 + +设置 NPC 特定武器的重新装填时间。 + +| 参数 | 说明 | +| -------- | --------------------------- | +| npcid | NPC 的 ID | +| weaponid | 要设置重新装填时间的武器 ID | +| time | 重新装填时间（毫秒） | + +## 返回值 + +如果操作成功则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/setweaponreloadtime ", true, 21)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new weapon = NPC_GetWeapon(npcid); + new reloadtime = strval(cmdtext[21]); + + NPC_SetWeaponReloadTime(npcid, WEAPON:weapon, reloadtime); + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 武器 %d 换弹时间设置为 %d 毫秒", npcid, weapon, reloadtime); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 重新装填时间以毫秒为单位 +- 使用 NPC_GetWeaponReloadTime 检查当前重新装填时间 + +## 相关函数 + +- [NPC_GetWeaponReloadTime](NPC_GetWeaponReloadTime): 获取重新装填时间 +- [NPC_GetWeaponActualReloadTime](NPC_GetWeaponActualReloadTime): 获取实际重新装填时间 +- [NPC_IsReloading](NPC_IsReloading): 检查是否正在重新装填 +- [NPC_EnableReloading](NPC_EnableReloading): 启用/禁用重新装填 + +## 相关回调 + +- [OnNPCWeaponShot](../callbacks/OnNPCWeaponShot): NPC 开火时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetWeaponShootTime.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetWeaponShootTime.md new file mode 100644 index 00000000000..e2ef8a4596c --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetWeaponShootTime.md @@ -0,0 +1,64 @@ +--- +title: NPC_SetWeaponShootTime +sidebar_label: NPC_SetWeaponShootTime +description: 设置 NPC 武器的射击间隔。 +tags: ["npc", "武器", "射击", "时间"] +--- + + + +## 描述 + +设置 NPC 特定武器的射击间隔。 + +| 参数 | 说明 | +| -------- | ----------------------- | +| npcid | NPC 的 ID | +| weaponid | 要设置射击时间的武器 ID | +| time | 射击间隔（毫秒） | + +## 返回值 + +如果操作成功则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/setweaponshoottime ", true, 20)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new weapon = NPC_GetWeapon(npcid); + new shoottime = strval(cmdtext[20]); + + NPC_SetWeaponShootTime(npcid, WEAPON:weapon, shoottime); + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 武器 %d 射击时间设置为 %d 毫秒", npcid, weapon, shoottime); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 射击时间以每次射击之间的毫秒为单位 +- 使用 NPC_GetWeaponShootTime 检查当前射击时间 + +## 相关函数 + +- [NPC_GetWeaponShootTime](NPC_GetWeaponShootTime): 获取射击时间 +- [NPC_IsShooting](NPC_IsShooting): 检查是否正在射击 +- [NPC_Shoot](NPC_Shoot): 让 NPC 射击 +- [NPC_GetWeapon](NPC_GetWeapon): 获取当前武器 + +## 相关回调 + +- [OnNPCWeaponShot](../callbacks/OnNPCWeaponShot): NPC 射击时调用 +- [OnNPCGiveDamage](../callbacks/OnNPCGiveDamage): NPC 对他人造成伤害时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetWeaponSkillLevel.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetWeaponSkillLevel.md new file mode 100644 index 00000000000..8632867f941 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetWeaponSkillLevel.md @@ -0,0 +1,72 @@ +--- +title: NPC_SetWeaponSkillLevel +sidebar_label: NPC_SetWeaponSkillLevel +description: 设置NPC的武器技能等级 +tags: ["npc", "武器", "技能"] +--- + + + +## 描述 + +设置 NPC 的武器技能等级。 + +| 参数 | 说明 | +| ----- | -------------------------- | +| npcid | NPC 的 ID | +| skill | 武器技能类型 (WEAPONSKILL) | +| level | 要设置的技能等级 (0-999) | + +## 返回值 + +成功时返回 `true`，失败时返回 `false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/setweaponskill ", true, 16)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new level = strval(cmdtext[16]); + + NPC_SetWeaponSkillLevel(npcid, WEAPONSKILL_PISTOL, level); + NPC_SetWeaponSkillLevel(npcid, WEAPONSKILL_PISTOL_SILENCED, level); + NPC_SetWeaponSkillLevel(npcid, WEAPONSKILL_DESERT_EAGLE, level); + NPC_SetWeaponSkillLevel(npcid, WEAPONSKILL_SHOTGUN, level); + NPC_SetWeaponSkillLevel(npcid, WEAPONSKILL_MICRO_UZI, level); + NPC_SetWeaponSkillLevel(npcid, WEAPONSKILL_MP5, level); + NPC_SetWeaponSkillLevel(npcid, WEAPONSKILL_AK47, level); + NPC_SetWeaponSkillLevel(npcid, WEAPONSKILL_M4, level); + NPC_SetWeaponSkillLevel(npcid, WEAPONSKILL_SNIPERRIFLE, level); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 所有武器技能设置为 %d", npcid, level); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 武器技能影响准确度和射击行为 +- 技能等级范围从 0（差）到 999（杀手级） +- 不同武器类型有不同的技能类别 + +## 相关函数 + +- [NPC_GetWeaponSkillLevel](NPC_GetWeaponSkillLevel): 获取 NPC 武器技能等级 +- [NPC_SetWeaponAccuracy](NPC_SetWeaponAccuracy): 设置武器准确度 +- [NPC_GetWeaponAccuracy](NPC_GetWeaponAccuracy): 获取武器准确度 +- [NPC_SetWeapon](NPC_SetWeapon): 设置 NPC 武器 + +## 相关回调 + +- [OnNPCWeaponShot](../callbacks/OnNPCWeaponShot): 当 NPC 开火时被调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetWeaponState.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetWeaponState.md new file mode 100644 index 00000000000..db77f23e0ca --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_SetWeaponState.md @@ -0,0 +1,76 @@ +--- +title: NPC_SetWeaponState +sidebar_label: NPC_SetWeaponState +description: 设置NPC的武器状态 +tags: ["npc", "武器", "状态"] +--- + + + +## 描述 + +设置 NPC 的武器状态。 + +| 参数 | 说明 | +| ----------- | ---------------- | +| npcid | NPC 的 ID | +| weaponState | 要设置的武器状态 | + +## 返回值 + +成功时返回 `true`，失败时返回 `false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/setweaponstate ", true, 16)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new weaponstate = strval(cmdtext[16]); + + static weaponStates[5][64] = + { + "未知", + "没有剩余弹药", + "剩下一发子弹", + "剩余多发子弹", + "正在换弹" + }; + + NPC_SetWeaponState(npcid, WEAPONSTATE:weaponstate); + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 武器状态设置为：%s (%d)", npcid, weaponStates[weaponstate], weaponstate); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 武器状态控制 NPC 武器的当前动作 +- 使用 [NPC_GetWeaponState](NPC_GetWeaponState) 来获取当前状态 +- 更改武器状态会影响 NPC 的射击行为 + +## 相关函数 + +- [NPC_GetWeaponState](NPC_GetWeaponState): 获取 NPC 武器状态 +- [NPC_SetWeapon](NPC_SetWeapon): 设置 NPC 武器 +- [NPC_GetWeapon](NPC_GetWeapon): 获取 NPC 武器 +- [NPC_IsReloading](NPC_IsReloading): 检查 NPC 是否正在装弹 + +## Related Resources + +- [Weapon States](../resources/weaponstates) + +## 相关回调 + +- [OnNPCWeaponStateChange](../callbacks/OnNPCWeaponStateChange): 当 NPC 武器状态改变时被调用 +- [OnNPCWeaponShot](../callbacks/OnNPCWeaponShot): 当 NPC 开火时被调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_Shoot.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_Shoot.md new file mode 100644 index 00000000000..90a3efa4b37 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_Shoot.md @@ -0,0 +1,76 @@ +--- +title: NPC_Shoot +sidebar_label: NPC_Shoot +description: 让 NPC 开火射击。 +tags: ["npc", "武器", "射击", "战斗"] +--- + + + +## 描述 + +让 NPC 开火射击。 + +| 参数 | 说明 | +| ------------------- | ------------------------------------------ | +| npcid | NPC 的 ID | +| weapon | 用于射击的武器 ID | +| hitId | 被射击目标实体的 ID | +| hitType | 被击中的实体类型（玩家、NPC、车辆等） | +| endPointX | 子弹终点的 X 坐标 | +| endPointY | 子弹终点的 Y 坐标 | +| endPointZ | 子弹终点的 Z 坐标 | +| offsetX | 距离击中点的 X 偏移 | +| offsetY | 距离击中点的 Y 偏移 | +| offsetZ | 距离击中点的 Z 偏移 | +| isHit | 射击是否实际击中目标 | +| checkInBetweenFlags | 实体检查标志（默认：NPC_ENTITY_CHECK_ALL） | + +## 返回值 + +如果操作成功则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/npcshoot", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new Float:x, Float:y, Float:z; + GetPlayerPos(playerid, x, y, z); + + new weapon = NPC_GetWeapon(npcid); + NPC_Shoot(npcid, WEAPON:weapon, playerid, 1, x, y, z, 0.0, 0.0, 0.0, true, NPC_ENTITY_CHECK_ALL); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 向你开了一枪。", npcid); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- NPC 在射击前必须使用 `NPC_SetWeapon` 设置武器 +- 使用 `isHit = false` 进行警告射击或压制火力 +- `checkInBetweenFlags` 参数决定哪些实体会阻挡射击 + +## 相关函数 + +- [NPC_SetWeapon](NPC_SetWeapon): 设置 NPC 武器 +- [NPC_GetWeapon](NPC_GetWeapon): 获取 NPC 当前武器 +- [NPC_IsShooting](NPC_IsShooting): 检查 NPC 是否正在射击 +- [NPC_AimAt](NPC_AimAt): 让 NPC 瞄准位置 + +## 相关回调 + +- [OnNPCWeaponShot](../callbacks/OnNPCWeaponShot): NPC 开火时调用 +- [OnNPCGiveDamage](../callbacks/OnNPCGiveDamage): NPC 对其他实体造成伤害时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_Spawn.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_Spawn.md new file mode 100644 index 00000000000..134be610678 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_Spawn.md @@ -0,0 +1,74 @@ +--- +title: NPC_Spawn +sidebar_label: NPC_Spawn +description: 将 NPC 生成到游戏世界中。 +tags: ["npc"] +--- + + + +## 描述 + +生成 NPC 到游戏世界中，使其可见并活跃。 + +| 参数 | 说明 | +| ----- | --------- | +| npcid | NPC 的 ID | + +## 返回值 + +如果 NPC 成功生成返回 `true`，否则返回 `false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/createnpc", true)) + { + new name[24]; + format(name, sizeof name, "Bot_%d", g_NPCCount++); + + new npcid = NPC_Create(name); + if (NPC_IsValid(npcid)) + { + new Float:x, Float:y, Float:z; + GetPlayerPos(playerid, x, y, z); + + NPC_Spawn(npcid); + NPC_SetPos(npcid, x + 3.0, y, z); + NPC_SetWeapon(npcid, WEAPON_M4); + NPC_SetAmmo(npcid, 500); + + PlayerNPC[playerid] = npcid; + SendClientMessage(playerid, 0x00FF00FF, "NPC %s (ID %d) 已在你附近生成！", name, npcid); + } + else + { + SendClientMessage(playerid, 0xFF0000FF, "创建NPC失败！"); + } + return 1; + } + return 0; +} +``` + +## 注意事项 + +:::warning + +- NPC 在生成前必须通过 [NPC_Create](NPC_Create) 创建。 + +::: + +## 相关函数 + +- [NPC_Create](NPC_Create): 创建新 NPC +- [NPC_IsValid](NPC_IsValid): 检查 NPC ID 是否有效 +- [NPC_SetPos](NPC_SetPos): 设置 NPC 位置 +- [NPC_Destroy](NPC_Destroy): 销毁 NPC + +## 相关回调 + +- [OnNPCSpawn](../callbacks/OnNPCSpawn): NPC 生成时调用 +- [OnNPCCreate](../callbacks/OnNPCCreate): NPC 创建时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_StartPlayback.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_StartPlayback.md new file mode 100644 index 00000000000..39c10ff765c --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_StartPlayback.md @@ -0,0 +1,83 @@ +--- +title: NPC_StartPlayback +sidebar_label: NPC_StartPlayback +description: 为 NPC 开始回放录制文件。 +tags: ["npc", "录制", "回放"] +--- + + + +## 描述 + +通过文件名为 NPC 开始回放录制文件。 + +| 参数 | 说明 | +| ------------ | -------------------------- | +| npcid | NPC 的 ID | +| recordName[] | 要回放的录制文件名 | +| autoUnload | 回放完成后是否卸载录制文件 | +| startX | 起始 X 坐标 | +| startY | 起始 Y 坐标 | +| startZ | 起始 Z 坐标 | +| rotX | 起始 X 旋转 | +| rotY | 起始 Y 旋转 | +| rotZ | 起始 Z 旋转 | + +## 返回值 + +如果回放成功开始则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/startplayback ", true, 15)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new recordName[64]; + new len = strlen(cmdtext); + if (len <= 15) + return SendClientMessage(playerid, 0xFF0000FF, "用法：/startplayback [recordname]"); + + strmid(recordName, cmdtext, 15, len); + + new Float:x, Float:y, Float:z; + NPC_GetPos(npcid, x, y, z); + + new bool:success = NPC_StartPlayback(npcid, recordName, true, x, y, z, 0.0, 0.0, 0.0); + + if (success) + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 开始回放：%s", npcid, recordName); + else + SendClientMessage(playerid, 0xFF0000FF, "NPC %d 开始回放失败", npcid); + + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 录制文件必须存在于 `npcmodes\recordings` 目录中 +- 如果 autoUnload 为 true，回放结束时录制文件将被卸载 +- 使用 NPC_StartPlaybackEx 可以通过预加载的录制获得更好的控制 + +## 相关函数 + +- [NPC_StartPlaybackEx](NPC_StartPlaybackEx): 通过录制 ID 开始回放 +- [NPC_StopPlayback](NPC_StopPlayback): 停止回放 +- [NPC_PausePlayback](NPC_PausePlayback): 暂停/取消暂停回放 +- [NPC_LoadRecord](NPC_LoadRecord): 预加载录制文件 + +## 相关回调 + +- [OnNPCPlaybackStart](../callbacks/OnNPCPlaybackStart): 回放开始时调用 +- [OnNPCPlaybackEnd](../callbacks/OnNPCPlaybackEnd): 回放结束时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_StartPlaybackEx.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_StartPlaybackEx.md new file mode 100644 index 00000000000..95e917f25ce --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_StartPlaybackEx.md @@ -0,0 +1,75 @@ +--- +title: NPC_StartPlaybackEx +sidebar_label: NPC_StartPlaybackEx +description: 使用预加载的录制 ID 为 NPC 开始回放，支持扩展选项。 +tags: ["npc", "回放", "录制"] +--- + + + +## 描述 + +使用预加载的录制 ID 为 NPC 开始回放，支持扩展选项。 + +| 参数 | 说明 | +| ---------- | ----------------------- | +| npcid | NPC 的 ID | +| recordId | 预加载的录制 ID | +| autoUnload | 回放完成后是否自动卸载 | +| startX | 相对于录制位置的 X 偏移 | +| startY | 相对于录制位置的 Y 偏移 | +| startZ | 相对于录制位置的 Z 偏移 | +| rotX | X 旋转偏移 | +| rotY | Y 旋转偏移 | +| rotZ | Z 旋转偏移 | + +## 返回值 + +如果操作成功则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/startplaybackex ", true, 17)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new recordId = strval(cmdtext[17]); + + new Float:x, Float:y, Float:z; + NPC_GetPos(npcid, x, y, z); + + new bool:success = NPC_StartPlaybackEx(npcid, recordId, true, x, y, z, 0.0, 0.0, 0.0); + + if (success) + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 使用录制 ID %d 开始回放", npcid, recordId); + else + SendClientMessage(playerid, 0xFF0000FF, "NPC %d 使用录制 ID %d 开始回放失败", npcid, recordId); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 录制必须使用 `NPC_LoadRecord` 预加载 +- 自动卸载可在回放完成后节省内存 + +## 相关函数 + +- [NPC_LoadRecord](NPC_LoadRecord): 加载录制文件 +- [NPC_StartPlayback](NPC_StartPlayback): 通过文件名开始回放 +- [NPC_StopPlayback](NPC_StopPlayback): 停止回放 +- [NPC_IsValidRecord](NPC_IsValidRecord): 检查录制是否有效 + +## 相关回调 + +- [OnNPCPlaybackEnd](../callbacks/OnNPCPlaybackEnd): 回放结束时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_StopAim.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_StopAim.md new file mode 100644 index 00000000000..bb9d75cf126 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_StopAim.md @@ -0,0 +1,53 @@ +--- +title: NPC_StopAim +sidebar_label: NPC_StopAim +description: 停止 NPC 的瞄准状态。 +tags: ["npc", "武器", "瞄准"] +--- + + + +## 描述 + +停止 NPC 对任何目标的瞄准。 + +| 参数 | 说明 | +| ----- | --------- | +| npcid | NPC 的 ID | + +## 返回值 + +如果操作成功则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/friendly", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + NPC_StopAim(npcid); + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 停止瞄准。", npcid); +} +``` + +## 注意事项 + +- 如果 NPC 同时在瞄准和射击，这将停止两者 +- NPC 在停止瞄准后将回到正常姿态 +- 如果 NPC 当前没有瞄准，则此函数无效 + +## 相关函数 + +- [NPC_AimAt](NPC_AimAt): 让 NPC 瞄准位置 +- [NPC_AimAtPlayer](NPC_AimAtPlayer): 让 NPC 瞄准玩家 +- [NPC_IsAiming](NPC_IsAiming): 检查 NPC 是否在瞄准 +- [NPC_Shoot](NPC_Shoot): 让 NPC 射击 + +## 相关回调 + +- [OnNPCWeaponShot](../callbacks/OnNPCWeaponShot): NPC 开火时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_StopMeleeAttack.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_StopMeleeAttack.md new file mode 100644 index 00000000000..e478966cea4 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_StopMeleeAttack.md @@ -0,0 +1,60 @@ +--- +title: NPC_StopMeleeAttack +sidebar_label: NPC_StopMeleeAttack +description: 停止 NPC 的近战攻击。 +tags: ["npc", "近战攻击", "战斗风格"] +--- + + + +## 描述 + +停止 NPC 的近战攻击。 + +| 参数 | 说明 | +| ----- | --------- | +| npcid | NPC 的 ID | + +## 返回值 + +如果操作成功则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/npcstopmelee", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new bool:success = NPC_StopMeleeAttack(npcid); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 停止近战攻击：%s", npcid, success ? "成功" : "失败"); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 这会立即停止任何正在进行的近战攻击动画 +- NPC 将回到正常姿态 +- 如果 NPC 当前没有攻击，则此函数无效 + +## 相关函数 + +- [NPC_MeleeAttack](NPC_MeleeAttack): 开始近战攻击 +- [NPC_IsMeleeAttacking](NPC_IsMeleeAttacking): 检查 NPC 是否在攻击 +- [NPC_SetFightingStyle](NPC_SetFightingStyle): 设置战斗风格 +- [NPC_GetFightingStyle](NPC_GetFightingStyle): 获取战斗风格 + +## 相关回调 + +- [OnNPCGiveDamage](../callbacks/OnNPCGiveDamage): NPC 对他人造成伤害时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_StopMove.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_StopMove.md new file mode 100644 index 00000000000..5d66e3f4858 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_StopMove.md @@ -0,0 +1,61 @@ +--- +title: NPC_StopMove +sidebar_label: NPC_StopMove +description: 停止 NPC 的移动。 +tags: ["npc", "移动"] +--- + + + +## 描述 + +停止 NPC 向当前目标的移动。 + +| 参数 | 说明 | +| ----- | ----------- | +| npcid | NPC 的 ID。 | + +## 返回值 + +如果操作成功则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/npcstopmove", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new bool:success = NPC_StopMove(npcid); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 停止移动：%s", npcid, success ? "成功" : "失败"); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 这会让 NPC 在当前位置停止。 +- 如果 NPC 没有在移动，此函数无效。 +- NPC 将保持在停止的位置，直到收到新的移动命令。 +- 使用 [NPC_IsMoving](NPC_IsMoving) 检查 NPC 当前是否在移动。 + +## 相关函数 + +- [NPC_Move](NPC_Move): 让 NPC 移动到位置。 +- [NPC_IsMoving](NPC_IsMoving): 检查 NPC 是否在移动。 +- [NPC_MoveByPath](NPC_MoveByPath): 让 NPC 沿路径移动。 +- [NPC_SetPos](NPC_SetPos): 立即设置 NPC 位置。 + +## 相关回调 + +- [OnNPCFinishMove](../callbacks/OnNPCFinishMove): NPC 完成移动时调用。 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_StopPlayback.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_StopPlayback.md new file mode 100644 index 00000000000..a21155fe288 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_StopPlayback.md @@ -0,0 +1,60 @@ +--- +title: NPC_StopPlayback +sidebar_label: NPC_StopPlayback +description: 停止 NPC 的录制回放。 +tags: ["npc", "回放", "录制"] +--- + + + +## 描述 + +停止 NPC 当前录制回放的回放。 + +| 参数 | 说明 | +| ----- | --------- | +| npcid | NPC 的 ID | + +## 返回值 + +如果操作成功则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/stopplayback", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new bool:success = NPC_StopPlayback(npcid); + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 回放停止：%s", npcid, success ? "成功" : "失败"); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- NPC 将在回放结束时停在当前位置 +- 如果 NPC 没有在回放录制，此函数无效 +- 使用 `NPC_IsPlayingPlayback` 检查 NPC 是否在回放录制 +- 录制文件保持加载状态，可以再次使用 + +## 相关函数 + +- [NPC_StartPlayback](NPC_StartPlayback): 开始 NPC 回放 +- [NPC_IsPlayingPlayback](NPC_IsPlayingPlayback): 检查是否在回放 +- [NPC_LoadRecord](NPC_LoadRecord): 加载录制文件 +- [NPC_UnloadRecord](NPC_UnloadRecord): 卸载录制 + +## 相关回调 + +- [OnNPCPlaybackEnd](../callbacks/OnNPCPlaybackEnd): 回放结束时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_StopPlayingNode.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_StopPlayingNode.md new file mode 100644 index 00000000000..c9a39ab3b4e --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_StopPlayingNode.md @@ -0,0 +1,61 @@ +--- +title: NPC_StopPlayingNode +sidebar_label: NPC_StopPlayingNode +description: 停止 NPC 的节点播放。 +tags: ["npc", "节点"] +--- + + + +## 描述 + +停止 NPC 当前节点的播放。 + +| 参数 | 说明 | +| ----- | --------- | +| npcid | NPC 的 ID | + +## 返回值 + +如果 NPC 成功停止则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/npcstopnode", true)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new bool:success = NPC_StopPlayingNode(npcid); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 停止节点：%s", npcid, success ? "成功" : "失败"); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- NPC 将在节点中的当前位置停止 +- 如果 NPC 没有在播放节点，此函数返回`false` +- 节点保持打开状态，可以被其他 NPC 使用 +- 使用 `NPC_IsPlayingNode` 检查 NPC 是否在播放节点 + +## 相关函数 + +- [NPC_PlayNode](NPC_PlayNode): 让 NPC 播放节点 +- [NPC_IsPlayingNode](NPC_IsPlayingNode): 检查 NPC 是否在播放节点 +- [NPC_PausePlayingNode](NPC_PausePlayingNode): 暂停节点播放 +- [NPC_ResumePlayingNode](NPC_ResumePlayingNode): 恢复节点播放 + +## 相关回调 + +- [OnNPCFinishNode](../callbacks/OnNPCFinishNode): NPC 完成节点时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_UnloadAllRecords.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_UnloadAllRecords.md new file mode 100644 index 00000000000..31780958322 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_UnloadAllRecords.md @@ -0,0 +1,52 @@ +--- +title: NPC_UnloadAllRecords +sidebar_label: NPC_UnloadAllRecords +description: 从内存中卸载所有 NPC 录制文件。 +tags: ["npc", "录制"] +--- + + + +## 描述 + +从内存中卸载所有 NPC 录制文件以释放资源。 + +## 返回值 + +如果所有录制都成功卸载则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/npcunloadallrecords", true)) + { + new bool:success = NPC_UnloadAllRecords(); + + if (success) + SendClientMessage(playerid, 0x00FF00FF, "所有录制卸载成功"); + else + SendClientMessage(playerid, 0xFF0000FF, "卸载所有录制失败"); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 这会释放已加载录制占用的内存 +- 此函数后所有录制 ID 变为无效 +- 任何使用这些录制的 NPC 将停止播放 + +## 相关函数 + +- [NPC_LoadRecord](NPC_LoadRecord): 加载录制文件 +- [NPC_UnloadRecord](NPC_UnloadRecord): 卸载特定录制 +- [NPC_GetRecordCount](NPC_GetRecordCount): 获取已加载录制数量 +- [NPC_IsValidRecord](NPC_IsValidRecord): 检查录制是否有效 + +## 相关回调 + +- [OnNPCPlaybackEnd](../callbacks/OnNPCPlaybackEnd): 播放结束时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_UnloadRecord.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_UnloadRecord.md new file mode 100644 index 00000000000..3ec8783cbfa --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_UnloadRecord.md @@ -0,0 +1,59 @@ +--- +title: NPC_UnloadRecord +sidebar_label: NPC_UnloadRecord +description: 从内存中卸载特定的 NPC 录制。 +tags: ["npc", "录制"] +--- + + + +## 描述 + +从内存中卸载特定的 NPC 录制以释放资源。 + +| 参数 | 说明 | +| -------- | --------------- | +| recordId | 要卸载的录制 ID | + +## 返回值 + +如果录制成功卸载则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/npcunloadrecord ", true, 17)) + { + new recordid = strval(cmdtext[17]); + + new bool:success = NPC_UnloadRecord(recordid); + + if (success) + SendClientMessage(playerid, 0x00FF00FF, "录制 %d 卸载成功", recordid); + else + SendClientMessage(playerid, 0xFF0000FF, "录制 %d 卸载失败", recordid); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 释放特定录制占用的内存 +- 卸载后录制 ID 变为无效 +- 任何使用此录制的 NPC 将停止回放 +- 使用 `NPC_UnloadAllRecords` 一次性卸载所有录制 + +## 相关函数 + +- [NPC_LoadRecord](NPC_LoadRecord): 加载录制文件 +- [NPC_UnloadAllRecords](NPC_UnloadAllRecords): 卸载所有录制 +- [NPC_IsValidRecord](NPC_IsValidRecord): 检查录制是否有效 +- [NPC_GetRecordCount](NPC_GetRecordCount): 获取已加载录制数量 + +## 相关回调 + +- [OnNPCPlaybackEnd](../callbacks/OnNPCPlaybackEnd): 回放结束时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_UpdateNodePoint.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_UpdateNodePoint.md new file mode 100644 index 00000000000..12d37a402d6 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_UpdateNodePoint.md @@ -0,0 +1,64 @@ +--- +title: NPC_UpdateNodePoint +sidebar_label: NPC_UpdateNodePoint +description: 将 NPC 更新到当前播放节点中的特定点。 +tags: ["npc", "节点"] +--- + + + +## 描述 + +将 NPC 更新到当前播放节点中的特定点。 + +| 参数 | 说明 | +| ------- | ----------------------- | +| npcid | NPC 的 ID | +| pointid | 要更新到的节点中的点 ID | + +## 返回值 + +如果更新成功则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/npcupdatenodepoint ", true, 20)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new pointid = strval(cmdtext[20]); + + new bool:success = NPC_UpdateNodePoint(npcid, pointid); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 更新节点点 %d：%s", npcid, pointid, success ? "成功" : "失败"); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- NPC 必须当前正在播放节点 +- 点 ID 必须存在于当前节点中 +- 使用此函数跳转到导航中的特定路径点 +- 用于在当前路径内传送 NPC + +## 相关函数 + +- [NPC_PlayNode](NPC_PlayNode): 开始播放节点 +- [NPC_SetNodePoint](NPC_SetNodePoint): 设置节点点坐标 +- [NPC_GetNodePointPosition](NPC_GetNodePointPosition): 获取点位置 +- [NPC_IsPlayingNode](NPC_IsPlayingNode): 检查是否在播放节点 + +## 相关回调 + +- [OnNPCFinishNode](../callbacks/OnNPCFinishNode): NPC 完成节点时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_UseVehicleSiren.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_UseVehicleSiren.md new file mode 100644 index 00000000000..33bdfe85d15 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NPC_UseVehicleSiren.md @@ -0,0 +1,67 @@ +--- +title: NPC_UseVehicleSiren +sidebar_label: NPC_UseVehicleSiren +description: 让 NPC 使用或停止使用车辆警报器。 +tags: ["npc", "车辆", "警报器"] +--- + + + +## 描述 + +让 NPC 使用或停止使用车辆警报器。 + +| 参数 | 说明 | +| ----- | --------------------------------------------- | +| npcid | NPC 的 ID | +| use | `true` 使用警报器，`false` 停止（默认：true） | + +## 返回值 + +如果操作成功则返回`true`，否则返回`false`。 + +## 示例 + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/npcusesiren ", true, 13)) + { + new npcid = PlayerNPC[playerid]; + if (npcid == INVALID_NPC_ID) + return SendClientMessage(playerid, 0xFF0000FF, "你没有在调试NPC。"); + + if (!NPC_IsValid(npcid)) + return SendClientMessage(playerid, 0xFF0000FF, "无效的NPC。"); + + new veh = NPC_GetVehicle(npcid); + if (veh == INVALID_VEHICLE_ID) + return SendClientMessage(playerid, 0xFFFF00FF, "NPC %d 不在任何车辆中。", npcid); + + new bool:use = strval(cmdtext[13]) ? true : false; + + new bool:success = NPC_UseVehicleSiren(npcid, use); + + SendClientMessage(playerid, 0x00FF00FF, "NPC %d 车辆警报器%s：%s", npcid, use ? "启用" : "禁用", success ? "成功" : "失败"); + return 1; + } + return 0; +} +``` + +## 注意事项 + +- 仅在 NPC 作为驾驶员在车辆中时有效 +- 车辆必须支持警报器（紧急车辆） +- 警报器状态持续保持直到更改或 NPC 下车 + +## 相关函数 + +- [NPC_IsVehicleSirenUsed](NPC_IsVehicleSirenUsed): 检查警报器是否在使用 +- [NPC_GetVehicle](NPC_GetVehicle): 获取 NPC 当前车辆 +- [NPC_PutInVehicle](NPC_PutInVehicle): 将 NPC 放入车辆 +- [NPC_Move](NPC_Move): 让 NPC 驾驶到位置 + +## 相关回调 + +_此函数不会触发任何特定的回调。_ diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NetStats_BytesReceived.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NetStats_BytesReceived.md index 82308424064..f916d18c389 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NetStats_BytesReceived.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NetStats_BytesReceived.md @@ -27,7 +27,7 @@ public OnPlayerCommandText(playerid,cmdtext[]) if (!strcmp(cmdtext, "/bytesreceived")) { new szString[144]; - format(szString, sizeof(szString), "您已向服务器发送了 %i 字节的数据", NetStats_BytesReceived(playerid)); + format(szString, sizeof(szString), "你已向服务器发送了 %i 字节的数据", NetStats_BytesReceived(playerid)); SendClientMessage(playerid, -1, szString); } return 1; diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NetStats_BytesSent.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NetStats_BytesSent.md index fe11927a30e..78366a2e8a6 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NetStats_BytesSent.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NetStats_BytesSent.md @@ -27,7 +27,7 @@ public OnPlayerCommandText(playerid,cmdtext[]) if (!strcmp(cmdtext, "/bytes_sent")) { new szString[144]; - format(szString, sizeof(szString), "服务器已向您发送了 %i 字节的数据", NetStats_BytesSent(playerid)); + format(szString, sizeof(szString), "服务器已向你发送了 %i 字节的数据", NetStats_BytesSent(playerid)); SendClientMessage(playerid, -1, szString); } return 1; diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NetStats_ConnectionStatus.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NetStats_ConnectionStatus.md index 1920657dc54..161d26bce5a 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NetStats_ConnectionStatus.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NetStats_ConnectionStatus.md @@ -40,7 +40,7 @@ public OnPlayerCommandText(playerid, cmdtext[]) new connectionStatus = NetStats_ConnectionStatus(playerid); new string[144]; - format(string, sizeof(string), "您当前的连接状态: %s", ConnectionStatuses[connectionStatus]); + format(string, sizeof(string), "你当前的连接状态: %s", ConnectionStatuses[connectionStatus]); SendClientMessage(playerid, -1, string); } return 1; diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NetStats_GetConnectedTime.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NetStats_GetConnectedTime.md index 01ada9335f7..da32fa78a35 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NetStats_GetConnectedTime.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NetStats_GetConnectedTime.md @@ -27,7 +27,7 @@ public OnPlayerCommandText(playerid,cmdtext[]) if (!strcmp(cmdtext, "/connectedtime")) { new szString[144]; - format(szString, sizeof(szString), "您已连接服务器达 %i 毫秒", NetStats_GetConnectedTime(playerid)); + format(szString, sizeof(szString), "你已连接服务器达 %i 毫秒", NetStats_GetConnectedTime(playerid)); SendClientMessage(playerid, -1, szString); } return 1; diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NetStats_GetIpPort.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NetStats_GetIpPort.md index 4e231bfa73d..0cc7ff33e76 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NetStats_GetIpPort.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NetStats_GetIpPort.md @@ -30,7 +30,7 @@ public OnPlayerCommandText(playerid, cmdtext[]) NetStats_GetIpPort(playerid, dest, sizeof(dest)); new szString[144]; - format(szString, sizeof(szString), "您当前的IP与端口：%s", dest); + format(szString, sizeof(szString), "你当前的IP与端口：%s", dest); SendClientMessage(playerid, -1, szString); } return 1; diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NetStats_MessagesReceived.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NetStats_MessagesReceived.md index 9b45d42f58f..e2e3bfcd68d 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NetStats_MessagesReceived.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NetStats_MessagesReceived.md @@ -27,7 +27,7 @@ public OnPlayerCommandText(playerid,cmdtext[]) if (!strcmp(cmdtext, "/msgs")) { new szString[144]; - format(szString, sizeof(szString), "您已发送了 %i 条网络消息", NetStats_MessagesReceived(playerid)); + format(szString, sizeof(szString), "你已发送了 %i 条网络消息", NetStats_MessagesReceived(playerid)); SendClientMessage(playerid, -1, szString); } return 1; diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NetStats_MessagesRecvPerSecond.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NetStats_MessagesRecvPerSecond.md index 9eac60bdccc..b4fb77bafd5 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NetStats_MessagesRecvPerSecond.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NetStats_MessagesRecvPerSecond.md @@ -25,7 +25,7 @@ public OnPlayerCommandText(playerid,cmdtext[]) if (!strcmp(cmdtext, "/msgpersec")) { new szString[144]; - format(szString, sizeof(szString), "您在过去一秒内接收到了 %i 条网络消息", NetStats_MessagesRecvPerSecond(playerid)); + format(szString, sizeof(szString), "你在过去一秒内接收到了 %i 条网络消息", NetStats_MessagesRecvPerSecond(playerid)); SendClientMessage(playerid, -1, szString); } return 1; diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NetStats_MessagesSent.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NetStats_MessagesSent.md index aba1c9b2a7f..1ac8d8d81ad 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NetStats_MessagesSent.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NetStats_MessagesSent.md @@ -25,7 +25,7 @@ public OnPlayerCommandText(playerid,cmdtext[]) if (!strcmp(cmdtext, "/msgsent")) { new szString[144]; - format(szString, sizeof(szString), "服务器已向您发送了 %i 条网络消息", NetStats_MessagesSent(playerid)); + format(szString, sizeof(szString), "服务器已向你发送了 %i 条网络消息", NetStats_MessagesSent(playerid)); SendClientMessage(playerid, -1, szString); } return 1; diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NetStats_PacketLossPercent.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NetStats_PacketLossPercent.md index ce7f609b334..c049e8f3bf8 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NetStats_PacketLossPercent.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/NetStats_PacketLossPercent.md @@ -36,7 +36,7 @@ public OnPlayerCommandText(playerid,cmdtext[]) :::tip -当前该函数的返回值可能存在偏差，实际结果与客户端显示数据存在差异。建议使用以下更精确的替代方案： +当前此函数的返回值可能存在偏差，实际结果与客户端显示数据存在差异。建议使用以下更精确的替代方案： ```c stock GetPlayerPacketLoss(playerid, &Float:packetLoss) @@ -64,7 +64,7 @@ stock GetPlayerPacketLoss(playerid, &Float:packetLoss) :::tip -请注意该函数反映的是服务器的丢包数据。客户端显示的数值**会**有所不同，并非数据错误，而是因为服务器与客户端各自仅能感知自身发送的数据包丢失情况 +请注意此函数反映的是服务器的丢包数据。客户端显示的数值**会**有所不同，并非数据错误，而是因为服务器与客户端各自仅能感知自身发送的数据包丢失情况 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PauseRecordingPlayback.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PauseRecordingPlayback.md index fc03baeff7e..742801b67f0 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PauseRecordingPlayback.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PauseRecordingPlayback.md @@ -7,7 +7,7 @@ tags: [] ## 描述 -该函数用于暂停当前正在进行的录制回放 +此函数用于暂停当前正在进行的录制回放 ## 相关函数 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayCrimeReportForPlayer.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayCrimeReportForPlayer.md index a0dcf21397a..bb5754b453e 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayCrimeReportForPlayer.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayCrimeReportForPlayer.md @@ -7,7 +7,7 @@ tags: ["玩家"] ## 描述 -该函数用于为玩家播放犯罪报告，效果类似于《侠盗猎车手》单机模式中 CJ 犯罪时的警用通报 +此函数用于为玩家播放犯罪报告，效果类似于《侠盗猎车手》单机模式中 CJ 犯罪时的警用通报 | 参数 | 说明 | | --------- | ------------------------------------------------------------------------------------------------- | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerGangZoneFlash.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerGangZoneFlash.md index be0a9638151..2b34b4ad331 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerGangZoneFlash.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerGangZoneFlash.md @@ -2,7 +2,7 @@ title: PlayerGangZoneFlash sidebar_label: PlayerGangZoneFlash description: 启动玩家专属帮派区域的闪烁效果 -tags: ["玩家", "帮派区域", "玩家专属帮派区域"] +tags: ["玩家", "帮派区域", "玩家帮派区域"] --- diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerGangZoneGetColour.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerGangZoneGetColour.md index fb6487cdcfc..51e026730cd 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerGangZoneGetColour.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerGangZoneGetColour.md @@ -2,7 +2,7 @@ title: PlayerGangZoneGetColour sidebar_label: PlayerGangZoneGetColour description: 获取玩家专属帮派区域的颜色值 -tags: ["玩家", "帮派区域", "玩家专属帮派区域"] +tags: ["玩家", "帮派区域", "玩家帮派区域"] --- diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerGangZoneGetFlashColour.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerGangZoneGetFlashColour.md index 124ef468c1e..d284f2cb044 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerGangZoneGetFlashColour.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerGangZoneGetFlashColour.md @@ -2,7 +2,7 @@ title: PlayerGangZoneGetFlashColour sidebar_label: PlayerGangZoneGetFlashColour description: 获取玩家专属帮派区域的闪烁颜色值 -tags: ["玩家", "帮派区域", "玩家专属帮派区域"] +tags: ["玩家", "帮派区域", "玩家帮派区域"] --- diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerGangZoneGetPos.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerGangZoneGetPos.md index 3d6f702014b..66fda9a129d 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerGangZoneGetPos.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerGangZoneGetPos.md @@ -2,7 +2,7 @@ title: PlayerGangZoneGetPos sidebar_label: PlayerGangZoneGetPos description: 获取帮派区域的坐标范围（最小X/Y，最大X/Y） -tags: ["玩家", "帮派区域", "玩家专属帮派区域"] +tags: ["玩家", "帮派区域", "玩家帮派区域"] --- @@ -22,7 +22,7 @@ tags: ["玩家", "帮派区域", "玩家专属帮派区域"] ## 返回值 -该函数始终返回 **true** +此函数始终返回 **true** ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerGangZoneHide.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerGangZoneHide.md index 0ddf365c198..0bf60a967ec 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerGangZoneHide.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerGangZoneHide.md @@ -2,7 +2,7 @@ title: PlayerGangZoneGetPos sidebar_label: PlayerGangZoneGetPos description: 获取帮派区域的坐标范围（最小X/Y，最大X/Y） -tags: ["玩家", "帮派区域", "玩家专属帮派区域"] +tags: ["玩家", "帮派区域", "玩家帮派区域"] --- @@ -22,7 +22,7 @@ tags: ["玩家", "帮派区域", "玩家专属帮派区域"] ## 返回值 -该函数始终返回 **true** +此函数始终返回 **true** ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerGangZoneShow.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerGangZoneShow.md index 43b4999e436..f11437003b6 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerGangZoneShow.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerGangZoneShow.md @@ -2,7 +2,7 @@ title: PlayerGangZoneShow sidebar_label: PlayerGangZoneShow description: 以指定颜色显示玩家专属帮派区域 -tags: ["玩家", "帮派区域", "玩家专属帮派区域"] +tags: ["玩家", "帮派区域", "玩家帮派区域"] --- diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerGangZoneStopFlash.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerGangZoneStopFlash.md index 6bfe4a3ced3..7c868efa576 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerGangZoneStopFlash.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerGangZoneStopFlash.md @@ -2,7 +2,7 @@ title: PlayerGangZoneStopFlash sidebar_label: PlayerGangZoneStopFlash description: 停止玩家专属帮派区域的闪烁效果 -tags: ["玩家", "帮派区域", "玩家专属帮派区域"] +tags: ["玩家", "帮派区域", "玩家帮派区域"] --- diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerSpectatePlayer.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerSpectatePlayer.md index ca8bebcd8d4..ff3fc8f3116 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerSpectatePlayer.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerSpectatePlayer.md @@ -7,7 +7,7 @@ tags: ["玩家"] ## 描述 -该函数用于使指定玩家进入旁观模式并观察另一玩家 +此函数用于使指定玩家进入旁观模式并观察另一玩家 | 参数 | 说明 | | ------------------ | -------------------------------------------------------------- | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawAlignment.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawAlignment.md index f27a9383398..fd530af12e0 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawAlignment.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawAlignment.md @@ -17,7 +17,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] ## 返回值 -此函数不返回特定值 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawBackgroundColor.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawBackgroundColor.md index 8f6376d72d9..9fa07ef6207 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawBackgroundColor.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawBackgroundColor.md @@ -9,7 +9,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] 调整玩家文本绘图的背景颜色。 -| 名称 | 描述 | +| 参数 | 说明 | | ----------------- | ----------------------------------------- | | playerid | 要设置背景颜色的玩家文本绘图所属玩家的 ID | | PlayerText:textid | 要设置背景颜色的玩家文本绘图的 ID | @@ -17,7 +17,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] ## 返回值 -该函数不返回任何特定值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawBackgroundColour.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawBackgroundColour.md index 7d3499f5800..f9ca5e44a10 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawBackgroundColour.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawBackgroundColour.md @@ -11,7 +11,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] 调整玩家文本绘图的背景颜色。 -| 名称 | 描述 | +| 参数 | 说明 | | ----------------- | ------------------------------------------------ | | playerid | 要设置背景颜色的玩家文本绘图所属玩家的 ID | | PlayerText:textid | 要设置背景颜色的玩家文本绘图的 ID | @@ -19,7 +19,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] ## 返回值 -该函数不返回任何特定值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawBoxColor.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawBoxColor.md index da6a2c5f405..fbecb1ac069 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawBoxColor.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawBoxColor.md @@ -9,7 +9,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] 设置玩家文本绘图方框的颜色（需要先使用 PlayerTextDrawUseBox 启用方框）。 -| 名称 | 描述 | +| 参数 | 说明 | | ----------------- | ---------------------------------------------------------- | | playerid | 要设置方框颜色的玩家文本绘图所属玩家的 ID | | PlayerText:textid | 要设置方框颜色的玩家文本绘图的 ID | @@ -17,7 +17,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] ## 返回值 -该函数不返回任何特定值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawBoxColour.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawBoxColour.md index e78db43d982..5b0c5ade7a7 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawBoxColour.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawBoxColour.md @@ -11,7 +11,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] 设置玩家文本绘图方框的颜色（需要先使用 PlayerTextDrawUseBox 启用方框）。 -| 名称 | 描述 | +| 参数 | 说明 | | ----------------- | ---------------------------------------------------------- | | playerid | 要设置方框颜色的玩家文本绘图所属玩家的 ID | | PlayerText:textid | 要设置方框颜色的玩家文本绘图的 ID | @@ -19,7 +19,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] ## 返回值 -该函数不返回任何特定值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawColor.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawColor.md index 10b9014c980..821c37db63c 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawColor.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawColor.md @@ -9,7 +9,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] 设置玩家文本绘图的文字颜色。 -| 名称 | 描述 | +| 参数 | 说明 | | ----------------- | ----------------------------------------- | | playerid | 要设置文字颜色的玩家文本绘图所属玩家的 ID | | PlayerText:textid | 要设置文字颜色的玩家文本绘图的 ID | @@ -17,7 +17,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] ## 返回值 -该函数不返回任何特定值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawColour.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawColour.md index 183ed6dc1b8..7385d77d8fb 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawColour.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawColour.md @@ -11,7 +11,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] 设置玩家文本绘图的文字颜色。 -| 名称 | 描述 | +| 参数 | 说明 | | ----------------- | ------------------------------------------- | | playerid | 要设置文字颜色的玩家文本绘图所属玩家的 ID | | PlayerText:textid | 要设置文字颜色的玩家文本绘图的 ID | @@ -19,7 +19,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] ## 返回值 -该函数不返回任何特定值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawDestroy.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawDestroy.md index 2f514d5ae44..760c809c664 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawDestroy.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawDestroy.md @@ -9,14 +9,14 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] 销毁一个玩家文本绘图。 -| 名称 | 描述 | +| 参数 | 说明 | | ----------------- | --------------------------------- | | playerid | 要销毁的玩家文本绘图所属玩家的 ID | | PlayerText:textid | 要销毁的玩家文本绘图的 ID | ## 返回值 -该函数不返回任何特定值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawFont.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawFont.md index 5ae7fa9ffd9..d194fe562e0 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawFont.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawFont.md @@ -9,7 +9,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] 设置玩家文本绘图的字体样式。 -| 名称 | 描述 | +| 参数 | 说明 | | ------------------- | ----------------------------------------------------------------------------- | | playerid | 要设置字体的玩家文本绘图所属玩家的 ID | | PlayerText:textid | 要设置字体的玩家文本绘图的 ID | @@ -23,7 +23,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] ## 返回值 -该函数不返回任何特定值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetAlignment.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetAlignment.md index 1a1e9c9ffb7..9ab3de83529 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetAlignment.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetAlignment.md @@ -11,7 +11,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] 获取玩家文本绘图的文本对齐方式。 -| 名称 | 描述 | +| 参数 | 说明 | | ----------------- | --------------------------------- | | playerid | 要查询的玩家 ID | | PlayerText:textid | 要获取对齐方式的玩家文本绘图的 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetBackgroundCol.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetBackgroundCol.md index b897f786a45..5633b7e2863 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetBackgroundCol.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetBackgroundCol.md @@ -11,7 +11,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] 获取玩家文本绘图的背景颜色。 -| 名称 | 描述 | +| 参数 | 说明 | | ----------------- | --------------------------------- | | playerid | 要查询的玩家 ID | | PlayerText:textid | 要获取背景颜色的玩家文本绘图的 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetBackgroundColour.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetBackgroundColour.md index fbb0561b96d..0260bbce93d 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetBackgroundColour.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetBackgroundColour.md @@ -11,7 +11,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] 获取玩家文本绘图的背景颜色。 -| 名称 | 描述 | +| 参数 | 说明 | | ----------------- | --------------------------------- | | playerid | 要查询的玩家 ID | | PlayerText:textid | 要获取背景颜色的玩家文本绘图的 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetBoxColor.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetBoxColor.md index 1a556efbacd..a1ead23ed09 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetBoxColor.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetBoxColor.md @@ -11,7 +11,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] 获取玩家文本绘图方框的颜色值。 -| 名称 | 描述 | +| 参数 | 说明 | | ----------------- | --------------------------------- | | playerid | 要查询的玩家 ID | | PlayerText:textid | 要获取方框颜色的玩家文本绘图的 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetBoxColour.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetBoxColour.md index 5887f912481..156aef4288a 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetBoxColour.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetBoxColour.md @@ -11,7 +11,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] 获取玩家文本绘图方框的颜色值。 -| 名称 | 描述 | +| 参数 | 说明 | | ----------------- | --------------------------------- | | playerid | 要查询的玩家 ID | | PlayerText:textid | 要获取方框颜色的玩家文本绘图的 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetColor.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetColor.md index 898d075b354..754d3ca9168 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetColor.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetColor.md @@ -11,7 +11,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] 获取玩家文本绘图的文本颜色 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------------- | ----------------------------- | | playerid | 玩家的 ID | | PlayerText:textid | 要获取颜色的玩家文本绘图的 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetColour.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetColour.md index beb67e259c8..d86e2618074 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetColour.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetColour.md @@ -11,7 +11,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] 获取玩家文本绘图的文本颜色 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------------- | ----------------------------- | | playerid | 玩家的 ID | | PlayerText:textid | 要获取颜色的玩家文本绘图的 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetFont.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetFont.md index acab5d48dae..a6ab3a13ae2 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetFont.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetFont.md @@ -11,7 +11,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] 获取玩家文本绘图的字体 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------------- | ----------------------------- | | playerid | 玩家的 ID | | PlayerText:textid | 要获取字体的玩家文本绘图的 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetLetterSize.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetLetterSize.md index c7ecab5c34e..5ce8b8de6b1 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetLetterSize.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetLetterSize.md @@ -11,7 +11,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] 获取文本字符的宽度和高度 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------------- | ------------------------------------ | | playerid | 玩家的 ID | | PlayerText:textid | 要获取字符尺寸的玩家文本绘图的 ID | @@ -20,7 +20,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] ## 返回值 -该函数不返回特定值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetOutline.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetOutline.md index e3237f23714..b14225e7f19 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetOutline.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetOutline.md @@ -11,7 +11,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] 获取玩家文本绘图的轮廓大小 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------------- | --------------------------------- | | playerid | 玩家的 ID | | PlayerText:textid | 要获取轮廓大小的玩家文本绘图的 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetPos.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetPos.md index b77f85a0fdf..82c18ececf5 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetPos.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetPos.md @@ -11,7 +11,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] 获取玩家文本绘图的屏幕坐标位置（X 轴和 Y 轴） -| 参数名 | 说明 | +| 参数 | 说明 | | ----------------- | --------------------------------------- | | playerid | 玩家的 ID | | PlayerText:textid | 要获取位置的玩家文本绘图的 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetPreviewModel.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetPreviewModel.md index 6bce55cd141..57c0fb1ed80 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetPreviewModel.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetPreviewModel.md @@ -11,7 +11,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] 获取 3D 预览玩家文本绘图的预览模型 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------------- | --------------------------------- | | playerid | 玩家的 ID | | PlayerText:textid | 要获取预览模型的玩家文本绘图的 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetPreviewRot.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetPreviewRot.md index 6b387e46e29..f8175513c84 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetPreviewRot.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetPreviewRot.md @@ -11,7 +11,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] 获取 3D 模型预览玩家文本绘图的旋转角度和缩放值 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------------- | --------------------------------------------- | | playerid | 玩家的 ID | | PlayerText:textid | 要获取旋转和缩放参数的玩家文本绘图的 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetPreviewVehCol.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetPreviewVehCol.md index d911e5eaafc..35855de703f 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetPreviewVehCol.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetPreviewVehCol.md @@ -11,7 +11,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] 获取 3D 预览玩家文本绘图的车辆颜色 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------------- | ---------------------------------- | | playerid | 玩家的 ID | | PlayerText:textid | 要获取车辆颜色的玩家文本绘图的 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetPreviewVehicleColours.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetPreviewVehicleColours.md index d742f29a832..4d369bdfcce 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetPreviewVehicleColours.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetPreviewVehicleColours.md @@ -11,7 +11,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] 获取 3D 预览玩家文本绘图的车辆颜色 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------------- | ---------------------------------- | | playerid | 玩家的 ID | | PlayerText:textid | 要获取车辆颜色的玩家文本绘图的 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetShadow.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetShadow.md index c05b36e2188..ecabc20851b 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetShadow.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetShadow.md @@ -11,7 +11,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] 获取玩家文本绘图的阴影大小 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------------- | --------------------------------- | | playerid | 玩家的 ID | | PlayerText:textid | 要获取阴影大小的玩家文本绘图的 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetString.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetString.md index 0b658975836..820d95d4426 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetString.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetString.md @@ -11,7 +11,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] 获取玩家文本绘图的文本内容 -| 参数名 | 说明 | +| 参数 | 说明 | | ---------------------------- | -------------------------------- | | playerid | 玩家的 ID | | PlayerText:textid | 要获取文本的玩家文本绘图的 ID | @@ -20,7 +20,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] ## 返回值 -该函数不返回特定值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetTextSize.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetTextSize.md index fad87f62e5f..08047aaba81 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetTextSize.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawGetTextSize.md @@ -11,7 +11,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] 获取玩家文本绘图文本尺寸的 X 轴和 Y 轴值 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------------- | ------------------------------------ | | playerid | 玩家的 ID | | PlayerText:textid | 要获取文本尺寸的玩家文本绘图的 ID | @@ -20,7 +20,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] ## 返回值 -该函数不返回特定值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawHide.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawHide.md index d3723923d1f..28b5d4a5760 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawHide.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawHide.md @@ -9,14 +9,14 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] 隐藏为指定玩家创建的玩家文本绘图 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------------- | ------------------------- | | playerid | 要隐藏文本绘图的玩家 ID | | PlayerText:textid | 要隐藏的玩家文本绘图的 ID | ## 返回值 -该函数不返回特定值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawIsBox.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawIsBox.md index c747e705b08..e4583e20b7d 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawIsBox.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawIsBox.md @@ -13,7 +13,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] ## 参数 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------------- | ------------------------- | | playerid | 玩家的 ID | | PlayerText:textid | 要检查的玩家文本绘图的 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawIsProportional.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawIsProportional.md index 81642195322..91fe081a117 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawIsProportional.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawIsProportional.md @@ -13,7 +13,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] ## 参数 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------------- | ------------------------- | | playerid | 玩家的 ID | | PlayerText:textid | 要检查的玩家文本绘图的 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawIsSelectable.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawIsSelectable.md index bc806a08662..e8c610db0ad 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawIsSelectable.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawIsSelectable.md @@ -13,7 +13,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] ## 参数 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------------- | ------------------------- | | playerid | 玩家的 ID | | PlayerText:textid | 要检查的玩家文本绘图的 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawLetterSize.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawLetterSize.md index d5e19064a6a..5a7edb72e02 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawLetterSize.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawLetterSize.md @@ -9,7 +9,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] 设置玩家文本绘图中字符的宽度和高度 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------------- | --------------------------------- | | playerid | 要设置字符尺寸的玩家 ID | | PlayerText:textid | 要修改字符尺寸的玩家文本绘图的 ID | @@ -18,7 +18,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] ## 返回值 -该函数不返回特定值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawSetOutline.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawSetOutline.md index 954a45323ea..5c32c33d9eb 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawSetOutline.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawSetOutline.md @@ -9,7 +9,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] 设置玩家文本绘图的轮廓。轮廓颜色需通过[PlayerTextDrawBackgroundColor](PlayerTextDrawBackgroundColor)进行修改 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------------- | -------------------------------------------- | | playerid | 要设置轮廓的玩家 ID | | PlayerText:textid | 要设置轮廓的玩家文本绘图的 ID | @@ -17,7 +17,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] ## 返回值 -该函数不返回特定值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawSetPos.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawSetPos.md index 76ca7bf4eae..f075f610bfe 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawSetPos.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawSetPos.md @@ -11,7 +11,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] 设置玩家文本绘图的屏幕坐标位置（X 轴和 Y 轴） -| 参数名 | 说明 | +| 参数 | 说明 | | ----------------- | ----------------------------- | | playerid | 玩家的 ID | | PlayerText:textid | 要设置位置的玩家文本绘图的 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawSetPreviewModel.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawSetPreviewModel.md index f5f26679f47..da110189579 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawSetPreviewModel.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawSetPreviewModel.md @@ -9,7 +9,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] 设置玩家文本绘图的指定模型 ID 的 3D 预览模型 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------------- | --------------------------------- | | playerid | 玩家的 ID | | PlayerText:textid | 要显示 3D 预览的玩家文本绘图的 ID | @@ -47,7 +47,7 @@ public OnPlayerConnect(playerid) :::warning -必须使用字体类型`TEXT_DRAW_FONT_MODEL_PREVIEW`（模型预览字体）才能使此功能生效 +必须使用字体类型`TEXT_DRAW_FONT_MODEL_PREVIEW`（模型预览字体）才能使此函数生效 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawSetPreviewRot.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawSetPreviewRot.md index 663493266a9..49d6af53779 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawSetPreviewRot.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawSetPreviewRot.md @@ -9,7 +9,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] 设置 3D 模型预览玩家文本绘图的旋转角度和缩放值 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------------- | -------------------------------------------------- | | playerid | 要修改的玩家 ID | | PlayerText:textid | 要修改的玩家文本绘图的 ID | @@ -20,7 +20,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] ## 返回值 -该函数不返回特定值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawSetPreviewVehCol.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawSetPreviewVehCol.md index 92a16a2245b..a4b817f7838 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawSetPreviewVehCol.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawSetPreviewVehCol.md @@ -9,7 +9,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] 设置玩家文本绘图 3D 预览中显示的车辆主副配色（需预览模型为车辆） -| 参数名 | 说明 | +| 参数 | 说明 | | ----------------- | ------------------------- | | playerid | 要修改的玩家 ID | | PlayerText:textid | 要修改的玩家文本绘图的 ID | @@ -18,7 +18,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] ## 返回值 -该函数不返回特定值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawSetPreviewVehicleColours.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawSetPreviewVehicleColours.md index 1651c422444..1e89333d77c 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawSetPreviewVehicleColours.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawSetPreviewVehicleColours.md @@ -11,7 +11,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] 设置玩家文本绘图 3D 预览中显示的车辆主副配色（需预览模型为车辆） -| 参数名 | 说明 | +| 参数 | 说明 | | ----------------- | ------------------------- | | playerid | 要修改的玩家 ID | | PlayerText:textid | 要修改的玩家文本绘图的 ID | @@ -20,7 +20,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] ## 返回值 -该函数不返回特定值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawSetProportional.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawSetProportional.md index bce10339d93..fe11ac87a15 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawSetProportional.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawSetProportional.md @@ -7,9 +7,9 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] ## 描述 -按比例缩放玩家文本绘图的字符间距。当使用[PlayerTextDrawLetterSize](PlayerTextDrawLetterSize)时，该功能可确保文本字符间距均匀分布 +按比例缩放玩家文本绘图的字符间距。当使用[PlayerTextDrawLetterSize](PlayerTextDrawLetterSize)时，此函数可确保文本字符间距均匀分布 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------------- | --------------------------------- | | playerid | 要设置比例缩放的玩家 ID | | PlayerText:textid | 要设置比例缩放的玩家文本绘图的 ID | @@ -17,7 +17,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] ## 返回值 -该函数不返回特定值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawSetSelectable.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawSetSelectable.md index 446aa3cb30c..5bec5b8aebc 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawSetSelectable.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawSetSelectable.md @@ -9,7 +9,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] 设置玩家文本绘图是否可被鼠标选择 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------------- | ------------------------------------------------------ | | playerid | 要设置可选状态的玩家 ID | | PlayerText:textid | 要设置可选状态的玩家文本绘图的 ID | @@ -17,7 +17,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] ## 返回值 -该函数不返回特定值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawSetShadow.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawSetShadow.md index fd083ad7974..12df61e00cb 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawSetShadow.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawSetShadow.md @@ -9,7 +9,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] 为玩家文本绘图的文本添加右下角阴影效果，阴影的字体样式与文本字体保持一致 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------------- | ----------------------------- | | playerid | 要设置阴影的玩家 ID | | PlayerText:textid | 要设置阴影的玩家文本绘图的 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawSetString.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawSetString.md index b9c8c0d7ddc..32d768a4962 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawSetString.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawSetString.md @@ -9,7 +9,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] 修改玩家文本绘图的文本内容 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------------- | ------------------------------ | | playerid | 要设置文本的玩家 ID | | PlayerText:textid | 要修改的玩家文本绘图的 ID | @@ -18,7 +18,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] ## 返回值 -该函数不返回特定值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawShow.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawShow.md index d10bab10656..9c2e85f32d2 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawShow.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawShow.md @@ -9,14 +9,14 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] 向创建该文本绘图的指定玩家显示其专属的玩家文本绘图 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------------- | ------------------------- | | playerid | 要显示文本绘图的玩家 ID | | PlayerText:textid | 要显示的玩家文本绘图的 ID | ## 返回值 -该函数不返回特定值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawTextSize.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawTextSize.md index 3c1f6af08db..fddd6daf570 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawTextSize.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawTextSize.md @@ -9,7 +9,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] 设置玩家文本绘图的尺寸（当启用[PlayerTextDrawUseBox](PlayerTextDrawUseBox)时的方框尺寸，或用于[PlayerTextDrawSetSelectable](PlayerTextDrawSetSelectable)的可点击区域） -| 参数名 | 说明 | +| 参数 | 说明 | | ----------------- | --------------------------------------------------------------------- | | playerid | 要设置尺寸的玩家 ID | | PlayerText:textid | 要设置尺寸的玩家文本绘图的 ID | @@ -18,7 +18,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] ## 返回值 -该函数不返回特定值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawUseBox.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawUseBox.md index 59c02ff0b94..0f46bc581e3 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawUseBox.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PlayerTextDrawUseBox.md @@ -9,7 +9,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] 切换玩家文本绘图的方框显示状态 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------------- | ----------------------------------- | | playerid | 要操作的玩家 ID | | PlayerText:textid | 要操作的玩家文本绘图的 ID | @@ -17,7 +17,7 @@ tags: ["玩家", "文本绘图", "玩家文本绘图"] ## 返回值 -该函数不返回特定值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PutPlayerInVehicle.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PutPlayerInVehicle.md index 6c3ad65633d..58713e4e295 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PutPlayerInVehicle.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/PutPlayerInVehicle.md @@ -9,7 +9,7 @@ tags: ["玩家", "车辆"] 将玩家放置到车辆中 -| 参数名 | 描述 | +| 参数 | 说明 | | --------- | ----------------- | | playerid | 需要放置的玩家 ID | | vehicleid | 目标车辆 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/RedirectDownload.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/RedirectDownload.md index 1a1bc191fea..71ecd6e3c41 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/RedirectDownload.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/RedirectDownload.md @@ -13,7 +13,7 @@ tags: ["自定义模型", "自定义皮肤", "简单模型"] ## 参数 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------- | --------------------------- | | playerid | 请求下载自定义模型的玩家 ID | | const url[] | 要重定向下载的 URL 链接 | @@ -66,6 +66,6 @@ public OnPlayerRequestDownload(playerid, type, crc) - [AddSimpleModel](AddSimpleModel): 添加一个新的自定义简单物体模型供下载 - [AddSimpleModelTimed](AddSimpleModelTimed): 添加一个带时限的自定义简单物体模型供下载 -## 相关回调函数 +## 相关回调 - [OnPlayerFinishedDownloading](../callbacks/OnPlayerFinishedDownloading): 当玩家完成自定义模型下载时调用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/RemoveBuildingForPlayer.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/RemoveBuildingForPlayer.md index efa993fc3a2..df6770cba89 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/RemoveBuildingForPlayer.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/RemoveBuildingForPlayer.md @@ -9,7 +9,7 @@ tags: ["玩家"] 为单个玩家在指定范围内移除圣安地列斯的标准模型。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------- | ---------------------------------------------- | | playerid | 需要移除物体的玩家 ID | | modelid | 要移除的模型 ID | @@ -20,7 +20,7 @@ tags: ["玩家"] ## 返回值 -该函数不返回任何特定值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/RemovePlayerAttachedObject.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/RemovePlayerAttachedObject.md index 0e0697d69bb..690c25876df 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/RemovePlayerAttachedObject.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/RemovePlayerAttachedObject.md @@ -2,7 +2,7 @@ title: RemovePlayerAttachedObject sidebar_label: RemovePlayerAttachedObject description: 移除玩家身上的附加物体。 -tags: ["玩家", "物体", "附加物"] +tags: ["玩家", "物体", "附加"] --- ## 描述 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/RemovePlayerFromVehicle.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/RemovePlayerFromVehicle.md index c9d4be05651..4932c76dc4d 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/RemovePlayerFromVehicle.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/RemovePlayerFromVehicle.md @@ -9,7 +9,7 @@ tags: ["玩家", "车辆"] 将玩家强制移出当前所在的车辆。 -| 参数名 | 说明 | +| 参数 | 说明 | | ---------- | ------------------------------------- | | playerid | 需要移出车辆的玩家 ID | | bool:force | 是否强制立即移出车辆（默认：`false`） | @@ -39,8 +39,8 @@ public OnPlayerStateChange(playerid, PLAYER_STATE:newstate, PLAYER_STATE:oldstat :::tip - 退出车辆的动画效果不会同步给其他玩家 -- 该函数在[OnPlayerEnterVehicle](../callbacks/OnPlayerEnterVehicle)回调中无效，因为此时玩家尚未进入车辆。请改用[OnPlayerStateChange](../callbacks/OnPlayerStateChange)回调（参见上方示例） -- 如果玩家正在遥控车（RC）中，该函数不会生效（需使用`.force = true`参数或[ClearAnimations](ClearAnimations)函数） +- 此函数在[OnPlayerEnterVehicle](../callbacks/OnPlayerEnterVehicle)回调中无效，因为此时玩家尚未进入车辆。请改用[OnPlayerStateChange](../callbacks/OnPlayerStateChange)回调（参见上方示例） +- 如果玩家正在遥控车（RC）中，此函数不会生效（需使用`.force = true`参数或[ClearAnimations](ClearAnimations)函数） ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/RemovePlayerWeapon.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/RemovePlayerWeapon.md index fcf1b308d4b..405d146d0af 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/RemovePlayerWeapon.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/RemovePlayerWeapon.md @@ -11,7 +11,7 @@ tags: ["玩家"] 移除玩家指定的武器。 -| 参数名 | 说明 | +| 参数 | 说明 | | --------------- | ----------------------------------------- | | playerid | 需要移除武器的玩家 ID | | WEAPON:weaponid | 要移除的[武器 ID](../resources/weaponids) | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/RemoveServerRule.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/RemoveServerRule.md index e02b36841aa..1dbdceaabbd 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/RemoveServerRule.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/RemoveServerRule.md @@ -11,7 +11,7 @@ tags: ["规则"] 移除指定的服务器规则。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------ | ---------------------- | | const rule[] | 要移除的服务器规则名称 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/RemoveVehicleComponent.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/RemoveVehicleComponent.md index afebfaa786d..9aa88a04cf1 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/RemoveVehicleComponent.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/RemoveVehicleComponent.md @@ -9,7 +9,7 @@ tags: ["车辆"] 从车辆上移除指定组件。 -| 参数名 | 说明 | +| 参数 | 说明 | | ---------------------------------------- | --------------- | | vehicleid | 目标车辆的 ID | | [component](../resources/carcomponentid) | 要移除的组件 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/RepairVehicle.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/RepairVehicle.md index 30ad22b6954..0639fb8ae38 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/RepairVehicle.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/RepairVehicle.md @@ -9,7 +9,7 @@ tags: ["车辆"] 完全修复车辆，包含外观损伤（凹陷、划痕、爆胎等）。 -| 参数名 | 说明 | +| 参数 | 说明 | | --------- | ----------------- | | vehicleid | 需要修复的车辆 ID | @@ -28,12 +28,12 @@ public OnPlayerCommandText(playerid, cmdtext[]) { if (!IsPlayerInAnyVehicle(playerid)) { - return SendClientMessage(playerid, 0xFFFFFFFF, "您当前未处于车辆中！"); + return SendClientMessage(playerid, 0xFFFFFFFF, "你当前未处于车辆中！"); } RepairVehicle(GetPlayerVehicleID(playerid)); - SendClientMessage(playerid, 0xFFFFFFFF, "您的车辆已修复完成！"); + SendClientMessage(playerid, 0xFFFFFFFF, "你的车辆已修复完成！"); return 1; } return 0; diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ResetPlayerMoney.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ResetPlayerMoney.md index 5e8238b4c42..e3098e0d6e3 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ResetPlayerMoney.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ResetPlayerMoney.md @@ -24,7 +24,7 @@ tags: ["玩家"] ```c public OnPlayerDeath(playerid, killerid, WEAPON:reason) { - SendClientMessage(playerid, 0xFFFFFFAA, "您已死亡，所有现金已被清空！"); + SendClientMessage(playerid, 0xFFFFFFAA, "你已死亡，所有现金已被清空！"); ResetPlayerMoney(playerid); return 1; } diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ResumeRecordingPlayback.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ResumeRecordingPlayback.md index b5f6c31abdf..d965aec19cc 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ResumeRecordingPlayback.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ResumeRecordingPlayback.md @@ -7,7 +7,7 @@ tags: [] ## 描述 -该函数用于恢复之前被暂停的录制回放进程。 +此函数用于恢复之前被暂停的录制回放进程。 ## 相关函数 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SHA256_PassHash.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SHA256_PassHash.md index bb8354aabeb..5f7eb8fd8f8 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SHA256_PassHash.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SHA256_PassHash.md @@ -17,7 +17,7 @@ tags: ["加密"] 使用 SHA-256 哈希算法对密码进行哈希处理（含盐值）。输出固定为 256 位（即 64 个 Pawn 单元长度）。 -| 参数名 | 说明 | +| 参数 | 说明 | | ---------------------- | ---------------------------- | | const password[] | 待哈希的原始密码字符串 | | const salt[] | 用于哈希计算的盐值 | @@ -60,6 +60,6 @@ public OnGameModeInit() :::warning -本函数不支持二进制安全操作，在密码或盐值中使用二进制数据可能导致意外结果 +此函数不支持二进制安全操作，在密码或盐值中使用二进制数据可能导致意外结果 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SelectObject.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SelectObject.md index bf3bcc58f19..0d23c0ac941 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SelectObject.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SelectObject.md @@ -15,7 +15,7 @@ tags: [] ## 返回值 -该函数没有特定返回值 +此函数不返回特定值。 ## 示例代码 @@ -25,7 +25,7 @@ public OnPlayerCommandText(playerid, cmdtext[]) if (!strcmp(cmdtext, "/select", true)) { SelectObject(playerid); - SendClientMessage(playerid, 0xFFFFFFFF, "服务器：请选择您要编辑的物体！"); + SendClientMessage(playerid, 0xFFFFFFFF, "服务器：请选择你要编辑的物体！"); return 1; } return 0; diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SelectTextDraw.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SelectTextDraw.md index 557820faf01..f587b5fdf5d 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SelectTextDraw.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SelectTextDraw.md @@ -9,14 +9,14 @@ tags: ["文本绘图"] 显示光标并允许玩家选择文本绘图 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------- | ----------------------------------------- | | playerid | 可进行文本绘图选择的玩家 ID | | hoverColour | 鼠标悬停时文本绘图的高亮颜色（RGBA 格式） | ## 返回值 -该函数没有特定返回值 +此函数不返回特定值。 ## 示例代码 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SendChat.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SendChat.md index 42c6b3dde61..68931b63a8c 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SendChat.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SendChat.md @@ -7,7 +7,7 @@ tags: [] ## 描述 -该函数允许 NPC 发送聊天消息，类似于[SendPlayerMessageToAll](SendPlayerMessageToAll)，但专用于 NPC 脚本内部使用。 +此函数允许 NPC 发送聊天消息，类似于[SendPlayerMessageToAll](SendPlayerMessageToAll)，但专用于 NPC 脚本内部使用。 | 参数名 | 说明 | | ------ | -------------------- | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SendClientCheck.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SendClientCheck.md index d5f65f1edf2..5075ef58d39 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SendClientCheck.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SendClientCheck.md @@ -9,7 +9,7 @@ tags: [] 在客户端执行内存检查 -| 参数名 | 说明 | +| 参数 | 说明 | | --------- | --------------------------------------------------- | | playerid | 需要检查的玩家 ID | | type | 需要执行的检查类型 [参见此处](../resources/opcodes) | @@ -54,9 +54,9 @@ public OnClientCheckResponse(playerid, actionid, memaddr, retndata) :::warning -**SA:MP 服务器**：该函数仅在滤镜脚本中生效 +**SA:MP 服务器**：此函数仅在滤镜脚本中生效 -**Open Multiplayer 服务器**：该函数在游戏模式/滤镜脚本中均可正常使用 +**Open Multiplayer 服务器**：此函数在游戏模式/滤镜脚本中均可正常使用 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SendClientMessage.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SendClientMessage.md index 4045d40a92c..660741e0274 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SendClientMessage.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SendClientMessage.md @@ -1,15 +1,15 @@ --- title: SendClientMessage sidebar_label: SendClientMessage -description: 该函数用于向指定玩家发送带有特定颜色的聊天消息。 +description: 此函数用于向指定玩家发送带有特定颜色的聊天消息。 tags: [] --- ## 描述 -该函数向指定玩家的聊天框发送带有设定颜色的消息。聊天框中的整行文字将显示为设定颜色，除非使用了颜色嵌入技术。 +此函数向指定玩家的聊天框发送带有设定颜色的消息。聊天框中的整行文字将显示为设定颜色，除非使用了颜色嵌入技术。 -| 参数名 | 说明 | +| 参数 | 说明 | | ---------------- | ----------------------------------- | | playerid | 接收消息的玩家 ID | | color | 消息颜色（0xRRGGBBAA 十六进制格式） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SendClientMessageToAll.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SendClientMessageToAll.md index 462b78645b0..a17230b4545 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SendClientMessageToAll.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SendClientMessageToAll.md @@ -7,9 +7,9 @@ tags: [] ## 描述 -该函数向服务器内所有玩家的聊天框发送消息，功能等同于对每个玩家调用[SendClientMessage](SendClientMessage)。 +此函数向服务器内所有玩家的聊天框发送消息，功能等同于对每个玩家调用[SendClientMessage](SendClientMessage)。 -| 参数名 | 说明 | +| 参数 | 说明 | | ---------------- | ----------------------------------- | | colour | 消息颜色（0xRRGGBBAA 十六进制格式） | | const format[] | 要显示的文本内容（最多 144 个字符） | @@ -17,7 +17,7 @@ tags: [] ## 返回值 -该函数始终返回 **true (1)**。 +此函数始终返回 **true (1)**。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SendClientMessageToAllf.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SendClientMessageToAllf.md index 5158eed5e6b..9acb3a93bfa 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SendClientMessageToAllf.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SendClientMessageToAllf.md @@ -17,9 +17,9 @@ tags: [] ## 描述 -向所有玩家发送格式化聊天消息（该函数已弃用，请使用 SendClientMessageToAll 替代）。此功能等同于对每个玩家调用 SendClientMessage。 +向所有玩家发送格式化聊天消息（此函数已弃用，请使用 SendClientMessageToAll 替代）。此函数等同于对每个玩家调用 SendClientMessage。 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------------- | ---------------------------------------- | | color | 消息颜色（0xRRGGBBAA 十六进制格式） | | const message[] | 格式化消息内容（最多 144 字符） | @@ -27,7 +27,7 @@ tags: [] ## 返回值 -该函数始终返回 true (1)。 +此函数始终返回 true (1)。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SendClientMessagef.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SendClientMessagef.md index 49c2d113323..0349db8a009 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SendClientMessagef.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SendClientMessagef.md @@ -19,7 +19,7 @@ tags: [] 向指定玩家发送格式化的彩色聊天信息。整行文字将使用设定颜色显示，除非使用颜色嵌入功能。 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------------- | ----------------------------------- | | playerid | 接收信息的玩家 ID | | color | 信息颜色（0xRRGGBBAA 十六进制格式） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SendCommand.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SendCommand.md index 8cae6ba55da..b3176c6b281 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SendCommand.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SendCommand.md @@ -7,9 +7,9 @@ tags: [] ## 描述 -该函数允许 NPC 模拟执行指定的控制台命令，并产生相应的游戏效果。 +此函数允许 NPC 模拟执行指定的控制台命令，并产生相应的游戏效果。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------- | -------------------- | | commandtext[] | NPC 要执行的命令文本 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SendDeathMessage.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SendDeathMessage.md index aadf0d0b925..4886831c682 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SendDeathMessage.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SendDeathMessage.md @@ -17,7 +17,7 @@ tags: [] ## 返回值 -该函数始终返回**true**，即使执行失败 +此函数始终返回**true**，即使执行失败 当玩家 ID 无效时，函数不会显示死亡信息 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SendPlayerMessageToAll.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SendPlayerMessageToAll.md index 864804fc9b3..dbfa20d6f76 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SendPlayerMessageToAll.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SendPlayerMessageToAll.md @@ -9,7 +9,7 @@ tags: ["玩家"] 在服务器中以指定玩家身份向所有其他玩家发送仿冒消息。消息将以发送者的名称（使用其颜色）开头，后接白色文本内容。 -| 参数名 | 说明 | +| 参数 | 说明 | | ---------------- | ------------------------------------------- | | senderid | 发送者玩家 ID（无效 ID 将导致消息无法发送） | | const format[] | 需要发送的消息内容 | @@ -17,7 +17,7 @@ tags: ["玩家"] ## 返回值 -该函数没有特定返回值 +此函数不返回特定值。 ## 示例代码 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SendPlayerMessageToPlayer.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SendPlayerMessageToPlayer.md index 4c701ab96e4..caddf29ff84 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SendPlayerMessageToPlayer.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SendPlayerMessageToPlayer.md @@ -7,9 +7,9 @@ tags: ["玩家"] ## 描述 -该函数允许以某玩家的名义向指定玩家发送私聊消息。消息会显示在接收者的聊天框，格式为「发送者名称（原色）: 白色消息内容」。 +此函数允许以某玩家的名义向指定玩家发送私聊消息。消息会显示在接收者的聊天框，格式为「发送者名称（原色）: 白色消息内容」。 -| 参数名 | 说明 | +| 参数 | 说明 | | ---------------- | ------------------------------------- | | playerid | 接收消息的玩家 ID | | senderid | 消息发送者 ID（若无效则消息不会发送） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SendRconCommand.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SendRconCommand.md index a3b7aa3703f..bd8842aa59d 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SendRconCommand.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SendRconCommand.md @@ -9,14 +9,14 @@ tags: ["管理"] 发送 RCON（远程控制台）命令 -| 参数名 | 说明 | +| 参数 | 说明 | | ---------------- | -------------------------- | | const format[] | 需要执行的 RCON 命令 | | OPEN_MP_TAGS:... | 不定数量的任意标签类型参数 | ## 返回值 -该函数始终返回 1 +此函数始终返回 1 ## 示例代码 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Set3DTextLabelDrawDistance.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Set3DTextLabelDrawDistance.md index d0ff6808cbf..9639a8e5de3 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Set3DTextLabelDrawDistance.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Set3DTextLabelDrawDistance.md @@ -11,14 +11,14 @@ tags: ["3d文本标签"] 设置 3D 文本标签的可视渲染距离。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------------ | -------------------------------------------------- | | Text3D:textid | 要设置的可视距离的 3D 文本标签 ID | | Float:drawDistance | 能够看到该 3D 文本标签的最远距离（单位：游戏单位） | ## 返回值 -该函数始终返回 true。 +此函数始终返回 true。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Set3DTextLabelLOS.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Set3DTextLabelLOS.md index 71fb5ee9490..3b9a4601562 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Set3DTextLabelLOS.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Set3DTextLabelLOS.md @@ -11,7 +11,7 @@ tags: ["3D文本标签"] 设置 3D 文本标签的视线检测功能，控制标签是否会被物体遮挡 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------- | ---------------------------------------------------------- | | Text3D:textid | 需要设置视线检测的 3D 文本标签 ID | | bool:enable | 启用状态（false=禁用/true=启用）控制标签是否可穿透物体显示 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Set3DTextLabelVirtualWorld.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Set3DTextLabelVirtualWorld.md index d556d5b9a15..381d1f45a90 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Set3DTextLabelVirtualWorld.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Set3DTextLabelVirtualWorld.md @@ -11,7 +11,7 @@ tags: ["3D文本标签"] 设置 3D 文本标签的虚拟世界 ID。 -| 参数名 | 描述 | +| 参数 | 说明 | | ------------- | ----------------------------------- | | Text3D:textid | 要设置虚拟世界 ID 的 3D 文本标签 ID | | virtualWorld | 可以看见该 3D 文本的虚拟世界 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetActorFacingAngle.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetActorFacingAngle.md index 6ec16b4c7fe..6ca357a17ba 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetActorFacingAngle.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetActorFacingAngle.md @@ -11,7 +11,7 @@ tags: ["角色"] 设置角色的朝向角度。 -| 参数名 | 描述 | +| 参数 | 说明 | | ----------- | ------------------------------------------------ | | actorid | 要设置朝向角度的角色 ID，由 CreateActor 函数返回 | | Float:angle | 要设置的朝向角度值（单位：度） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetActorHealth.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetActorHealth.md index f996124f5c3..a1562e9afb4 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetActorHealth.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetActorHealth.md @@ -11,7 +11,7 @@ tags: ["角色"] 设置角色的生命值。 -| 参数名 | 描述 | +| 参数 | 说明 | | ------------ | ---------------------------- | | actorid | 要设置生命值的角色 ID | | Float:health | 要设置的生命值数值（浮点数） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetActorInvulnerable.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetActorInvulnerable.md index 6787f0b8e99..8d12de3f726 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetActorInvulnerable.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetActorInvulnerable.md @@ -11,7 +11,7 @@ tags: ["角色"] 切换角色的无敌状态。 -| 参数名 | 描述 | +| 参数 | 说明 | | ----------------- | --------------------------------- | | actorid | 要设置无敌状态的角色 ID | | bool:invulnerable | 'false'设为可伤害，'true'设为无敌 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetActorPos.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetActorPos.md index 0ba80538b62..ec94beeb9be 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetActorPos.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetActorPos.md @@ -11,7 +11,7 @@ tags: ["角色"] 设置角色的坐标位置。 -| 参数名 | 描述 | +| 参数 | 说明 | | ------- | ------------------------------------------------ | | actorid | 要设置坐标位置的角色 ID，由 CreateActor 函数返回 | | Float:x | X 坐标值 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetActorSkin.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetActorSkin.md index 0de5ca60c86..ecccd5cd345 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetActorSkin.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetActorSkin.md @@ -11,7 +11,7 @@ tags: ["角色"] 设置角色的皮肤。 -| 参数名 | 描述 | +| 参数 | 说明 | | ------- | --------------- | | actorid | 要设置的角色 ID | | skin | 要设置的皮肤 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetActorVirtualWorld.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetActorVirtualWorld.md index 091252f6782..ee949a2e063 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetActorVirtualWorld.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetActorVirtualWorld.md @@ -11,7 +11,7 @@ tags: ["角色"] 设置角色的虚拟世界。只有处于相同虚拟世界的玩家才能看到该角色。 -| 参数名 | 描述 | +| 参数 | 说明 | | ------------ | -------------------------------------------------- | | actorid | 要设置虚拟世界的角色 ID（由 CreateActor 函数返回） | | virtualWorld | 角色所属的虚拟世界 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetCameraBehindPlayer.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetCameraBehindPlayer.md index e85382b31ac..22ab64ed729 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetCameraBehindPlayer.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetCameraBehindPlayer.md @@ -9,7 +9,7 @@ tags: ["玩家", "视角"] 在使用类似[SetPlayerCameraPos](SetPlayerCameraPos)的函数后，将玩家的视角重置到其身后。 -| 参数名 | 描述 | +| 参数 | 说明 | | -------- | --------------------- | | playerid | 需要重置视角的玩家 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetDeathDropAmount.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetDeathDropAmount.md index 5b3595749dc..315be746c79 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetDeathDropAmount.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetDeathDropAmount.md @@ -7,7 +7,7 @@ tags: [] :::warning -该函数无效，请使用[CreatePickup](CreatePickup) +此函数无效，请使用[CreatePickup](CreatePickup) ::: @@ -15,13 +15,13 @@ tags: [] 设置玩家死亡时掉落的金额。 -| 参数名 | 描述 | +| 参数 | 说明 | | ------ | ---------------- | | amount | 要设置的金额数目 | ## 返回值 -该函数不返回任何特定值 +此函数不返回特定值 ## 示例代码 @@ -37,7 +37,7 @@ public OnGameModeInit() :::warning -该函数在当前 SA:MP 版本中无效！ +此函数在当前 SA:MP 版本中无效！ ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetGameModeText.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetGameModeText.md index 3d4263242d8..c9d87f755a6 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetGameModeText.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetGameModeText.md @@ -9,14 +9,14 @@ tags: [] 设置游戏模式名称，该名称会显示在服务器浏览器中。 -| 参数名 | 描述 | +| 参数 | 说明 | | ---------------- | ---------------------------------- | | format[] | 要显示的游戏模式名称 | | OPEN_MP_TAGS:... | 可变参数（支持多种标签类型的参数） | ## 返回值 -该函数不返回任何特定值 +此函数不返回特定值 ## 示例代码 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetGravity.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetGravity.md index dd25b636f9e..0decad82d61 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetGravity.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetGravity.md @@ -9,13 +9,13 @@ tags: [] 设置所有玩家的重力参数。 -| 参数名 | 描述 | +| 参数 | 说明 | | ------------- | ----------------------------------------- | | Float:gravity | 要设置的重力值（有效范围：-50.0 至 50.0） | ## 返回值 -该函数总是返回 1，即使重力值超出有效范围（低于-50.0 或高于+50.0）也会返回 1。 +此函数总是返回 1，即使重力值超出有效范围（低于-50.0 或高于+50.0）也会返回 1。 ## 示例代码 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetMenuColumnHeader.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetMenuColumnHeader.md index aeb66936f36..8106424814c 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetMenuColumnHeader.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetMenuColumnHeader.md @@ -9,7 +9,7 @@ tags: ["菜单"] 设置指定菜单列的标题文本。 -| 参数名 | 描述 | +| 参数 | 说明 | | ---------------- | ---------------------------------- | | Menu:menuid | 要修改的菜单 ID | | column | 要设置的列编号（0 或 1） | @@ -18,7 +18,7 @@ tags: ["菜单"] ## 返回值 -该函数不返回任何特定值 +此函数不返回特定值 ## 示例代码 @@ -45,7 +45,7 @@ AddMenuItem(gTestMenu, 1, "第二列项1"); :::warning -注意通过[AddMenuItem](AddMenuItem)最多只能添加 12 个菜单项。第 13 个菜单项会覆盖通过本函数设置的列标题 +注意通过[AddMenuItem](AddMenuItem)最多只能添加 12 个菜单项。第 13 个菜单项会覆盖通过此函数设置的列标题 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetModeRestartTime.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetModeRestartTime.md index a05c3f344f9..e36f0c33f4e 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetModeRestartTime.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetModeRestartTime.md @@ -13,7 +13,7 @@ tags: [] ## 参数 -| 参数名 | 描述 | +| 参数 | 说明 | | ------------- | ---------------------- | | Float:seconds | 重启延迟秒数（浮点数） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetMyFacingAngle.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetMyFacingAngle.md index 450735cbcf3..a2ce77e8ea9 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetMyFacingAngle.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetMyFacingAngle.md @@ -5,11 +5,17 @@ description: 设置NPC的朝向角度。 tags: [] --- +:::warning + +此函数已弃用，请使用 [NPC_SetFacingAngle](NPC_SetFacingAngle)。 + +::: + ## 描述 设置 NPC 的朝向角度。 -| 参数名 | 描述 | +| 参数 | 说明 | | --------- | ---------------------------- | | Float:ang | 要设置的朝向角度值（浮点数） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetMyPos.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetMyPos.md index 8a34cb77242..832c3e9c164 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetMyPos.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetMyPos.md @@ -5,11 +5,17 @@ description: 设置NPC的位置 tags: ["NPC"] --- +:::warning + +此函数已弃用，请使用 [NPC_SetPos](NPC_SetPos)。 + +::: + ## 描述 设置 NPC 的坐标位置。 -| 参数名 | 描述 | +| 参数 | 说明 | | ------- | ------------------- | | Float:x | NPC 所在的 X 坐标值 | | Float:y | NPC 所在的 Y 坐标值 | @@ -17,7 +23,7 @@ tags: ["NPC"] ## 返回值 -该函数不返回任何特定值。 +此函数不返回特定值。 ## 示例代码 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetNameTagDrawDistance.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetNameTagDrawDistance.md index 1ab2c8d567f..03063751301 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetNameTagDrawDistance.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetNameTagDrawDistance.md @@ -9,13 +9,13 @@ tags: [] 设置显示玩家名牌的最大可见距离。 -| 参数名 | 描述 | +| 参数 | 说明 | | -------------- | --------------------------------- | | Float:distance | 要设置的可见距离（单位：SA 单位） | ## 返回值 -该函数不返回任何特定值。 +此函数不返回特定值。 ## 示例代码 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetObjectMaterial.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetObjectMaterial.md index e6647af633b..4518d47fb7a 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetObjectMaterial.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetObjectMaterial.md @@ -9,7 +9,7 @@ tags: ["物体"] 使用游戏中其他模型的纹理替换指定物体的材质。 -| 参数名 | 描述 | +| 参数 | 说明 | | ---------------------- | ------------------------------------------------------------------------ | | objectid | 要修改的物体 ID | | materialIndex | 要修改的材质索引（0-15） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetObjectMaterialText.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetObjectMaterialText.md index 4397a0fe7be..2a988ec9c65 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetObjectMaterialText.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetObjectMaterialText.md @@ -9,19 +9,19 @@ tags: ["物体"] 用自定义文本替换指定物体的材质纹理。 -| 参数名 | 描述 | -| ---------------------------------------- | ------------------------------------------------------------------------------- | -| objectid | 要设置材质文本的物体 ID | -| const text[] | 要显示的文本内容（最大 2048 字符） | -| materialIndex | 要替换的材质索引 | +| 参数 | 说明 | +| ---------------------------------------- | ------------------------------------------------------------------ | +| objectid | 要设置材质文本的物体 ID | +| const text[] | 要显示的文本内容（最大 2048 字符） | +| materialIndex | 要替换的材质索引 | | OBJECT_MATERIAL_SIZE:materialsize | 材质[尺寸](../resources/materialtextsizes) | -| const fontFace[] | 使用的字体名称 | -| fontSize | 字体大小（最大 255） | -| bool:bold | 是否加粗（true 为加粗，false 为正常） | -| fontColour | 文本颜色（ARGB 格式） | -| backgroundColour | 背景颜色（ARGB 格式） | +| const fontFace[] | 使用的字体名称 | +| fontSize | 字体大小（最大 255） | +| bool:bold | 是否加粗（true 为加粗，false 为正常） | +| fontColour | 文本颜色（ARGB 格式） | +| backgroundColour | 背景颜色（ARGB 格式） | | OBJECT_MATERIAL_TEXT_ALIGN:textAlignment | 文本[对齐方式](../resources/materialtextalignment)（默认：左对齐） | -| OPEN_MP_TAGS:... | 可变参数（支持多种标签类型的参数） | +| OPEN_MP_TAGS:... | 可变参数（支持多种标签类型的参数） | ## 返回值 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetObjectMoveSpeed.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetObjectMoveSpeed.md index 0849c22a2f4..f23529f643e 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetObjectMoveSpeed.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetObjectMoveSpeed.md @@ -11,7 +11,7 @@ tags: ["物体"] 设置物体的移动速度。 -| 参数名 | 描述 | +| 参数 | 说明 | | ----------- | ------------------------- | | objectid | 要设置移动速度的物体 ID | | Float:speed | 物体的移动速度（单位/秒） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetObjectNoCameraCol.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetObjectNoCameraCol.md index 4a42dbfe538..762c54ba694 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetObjectNoCameraCol.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetObjectNoCameraCol.md @@ -11,7 +11,7 @@ tags: ["视角"] 禁用玩家视角与指定物体的碰撞检测。 -| 参数名 | 描述 | +| 参数 | 说明 | | -------- | --------------------------- | | objectid | 要禁用视角碰撞检测的物体 ID | @@ -47,7 +47,7 @@ public OnGameModeInit() :::tip -该功能仅在地图边界外生效（X/Y 轴超过 ±3000 单位时） +此函数仅在地图边界外生效（X/Y 轴超过 ±3000 单位时） ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetObjectNoCameraCollision.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetObjectNoCameraCollision.md index fb0ad199339..79564d4a58e 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetObjectNoCameraCollision.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetObjectNoCameraCollision.md @@ -11,7 +11,7 @@ tags: ["物体", "视角"] 禁用玩家视角与指定物体的碰撞检测。 -| 参数名 | 描述 | +| 参数 | 说明 | | -------- | --------------------------- | | objectid | 要禁用视角碰撞检测的物体 ID | @@ -40,7 +40,7 @@ public OnObjectMoved(objectid) :::tip -该功能仅在地图边界外生效（X/Y 轴超过 ±3000 单位时） +此函数仅在地图边界外生效（X/Y 轴超过 ±3000 单位时） ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetObjectPos.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetObjectPos.md index b9cb1017d62..a7fdfbf59d6 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetObjectPos.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetObjectPos.md @@ -9,7 +9,7 @@ tags: ["物体"] 设置物体的坐标位置 -| 参数名 | 描述 | +| 参数 | 说明 | | -------- | ----------------------------------------------- | | objectid | 要设置位置的物体 ID（由 CreateObject 函数返回） | | Float:x | 物体新的 X 坐标值 | @@ -18,7 +18,7 @@ tags: ["物体"] ## 返回值 -该函数总是返回 **true**，即使指定的物体不存在也会返回成功 +此函数总是返回 **true**，即使指定的物体不存在也会返回成功 ## 示例代码 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetObjectRot.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetObjectRot.md index 012cd3982e4..f23e0398329 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetObjectRot.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetObjectRot.md @@ -9,7 +9,7 @@ tags: ["物体"] 设置物体在三个轴（X/Y/Z）上的旋转角度。 -| 参数名 | 描述 | +| 参数 | 说明 | | --------------- | ------------------------ | | objectid | 要设置旋转的物体 ID | | Float:rotationX | X 轴旋转角度（单位：度） | @@ -18,7 +18,7 @@ tags: ["物体"] ## 返回值 -该函数总是返回 1，即使指定的物体不存在也会返回成功 +此函数总是返回 1，即使指定的物体不存在也会返回成功 ## 示例代码 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetObjectsDefaultCameraCol.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetObjectsDefaultCameraCol.md index 413e5c0ed73..99f14cbb6c7 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetObjectsDefaultCameraCol.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetObjectsDefaultCameraCol.md @@ -11,13 +11,13 @@ tags: ["物体", "视角"] 设置新创建物体的默认视角碰撞状态（是否禁用）。 -| 参数名 | 描述 | +| 参数 | 说明 | | ------- | ------------------------------------------------------ | | disable | 1 表示禁用新创建物体的视角碰撞，0 表示启用（默认启用） | ## 返回值 -该函数没有传统意义上的返回值，但会影响后续创建的物体 +此函数没有传统意义上的返回值，但会影响后续创建的物体 :::tip 此设置仅影响调用函数之后新创建的物体，不会修改已存在物体的视角碰撞状态 @@ -60,7 +60,7 @@ public OnGameModeInit() :::warning -该功能仅在地图边界外生效（X/Y 轴超过 ±3000 单位时） +此函数仅在地图边界外生效（X/Y 轴超过 ±3000 单位时） ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetObjectsDefaultCameraCollision.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetObjectsDefaultCameraCollision.md index 3a5078c8c18..97479540d48 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetObjectsDefaultCameraCollision.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetObjectsDefaultCameraCollision.md @@ -11,13 +11,13 @@ tags: ["物体", "视角"] 设置新创建物体的默认视角碰撞状态（是否禁用）。 -| 参数名 | 描述 | +| 参数 | 说明 | | ------------ | ------------------------------------------------------- | | bool:disable | `true`禁用新创建物体的视角碰撞，`false`启用（默认启用） | ## 返回值 -该函数没有传统意义上的返回值，但会影响后续创建的物体 +此函数没有传统意义上的返回值，但会影响后续创建的物体 :::tip 此设置仅影响调用函数之后新创建的物体，不会修改已存在物体的视角碰撞状态 @@ -60,7 +60,7 @@ public OnGameModeInit() :::warning -该功能仅在地图边界外生效（X/Y 轴超过 ±3000 单位时） +此函数仅在地图边界外生效（X/Y 轴超过 ±3000 单位时） ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPVarFloat.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPVarFloat.md index 531b255d8ae..273c2b9be77 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPVarFloat.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPVarFloat.md @@ -2,14 +2,14 @@ title: SetPVarFloat sidebar_label: SetPVarFloat description: 设置浮点型玩家变量的值。 -tags: ["玩家变量", "pvar"] +tags: ["玩家变量"] --- ## 描述 设置浮点型玩家变量的值。 -| 名称 | 说明 | +| 参数 | 说明 | | ------------ | ------------------- | | playerid | 要设置变量的玩家 ID | | const pvar[] | 变量名称 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPVarInt.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPVarInt.md index b3e6d738161..7b33feba2d0 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPVarInt.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPVarInt.md @@ -2,14 +2,14 @@ title: SetPVarInt sidebar_label: SetPVarInt description: 设置整数型玩家变量。 -tags: ["玩家变量", "pvar"] +tags: ["玩家变量"] --- ## 描述 设置一个整数类型的玩家变量。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------ | -------------------------- | | playerid | 需要设置变量的玩家 ID | | const pvar[] | 变量名称（需用双引号包裹） | @@ -35,7 +35,7 @@ printf("当前金钱: %d", GetPVarInt(playerid, "Money")); :::tip -玩家变量在[OnPlayerDisconnect](../callbacks/OnPlayerDisconnect)回调触发前不会被重置，因此在该回调中仍可访问变量值。 +玩家变量在[OnPlayerDisconnect](../callbacks/OnPlayerDisconnect)回调触发前不会被重置，因此在此回调中仍可访问变量值。 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPVarString.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPVarString.md index 8d45494f86f..ad4e8a892e6 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPVarString.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPVarString.md @@ -2,14 +2,14 @@ title: SetPVarString sidebar_label: SetPVarString description: 将字符串保存到玩家变量中。 -tags: ["玩家变量", "pvar"] +tags: ["玩家变量"] --- ## 描述 将字符串保存到玩家变量中。 -| 参数名 | 描述 | +| 参数 | 说明 | | ---------------- | ---------------------- | | playerid | 要设置变量的玩家 ID | | const pvar[] | 玩家变量名称 | @@ -18,7 +18,7 @@ tags: ["玩家变量", "pvar"] ## 返回值 -本函数没有返回值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPickupForPlayer.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPickupForPlayer.md index 8f0d7b7ac2a..61a085e59f3 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPickupForPlayer.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPickupForPlayer.md @@ -9,7 +9,7 @@ tags: ["玩家", "拾取物"] :::warning -该函数尚未实现 +此函数尚未实现 ::: @@ -17,7 +17,7 @@ tags: ["玩家", "拾取物"] 为指定玩家调整拾取物的模型、类型和位置。 -| 参数名 | 描述 | +| 参数 | 说明 | | -------- | ------------------------------------ | | playerid | 目标玩家 ID | | pickupid | 要调整的拾取物 ID | @@ -29,7 +29,7 @@ tags: ["玩家", "拾取物"] ## 返回值 -该函数始终返回 **true** +此函数始终返回 **true** ## 示例代码 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPickupModel.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPickupModel.md index 3fbf9b4bfd0..eb9c0ba1c96 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPickupModel.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPickupModel.md @@ -11,7 +11,7 @@ tags: ["拾取物"] 设置拾取物的模型。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------------ | -------------------------------------- | | pickupid | 要设置的拾取物 ID | | model | 要设置的[模型](../resources/pickupids) | @@ -19,7 +19,7 @@ tags: ["拾取物"] ## 返回值 -本函数永远返回 **true**。 +此函数永远返回 **true**。 ## 示例代码 @@ -53,7 +53,3 @@ public OnGameModeInit() - [ShowPickupForPlayer](ShowPickupForPlayer): 对玩家显示拾取物 - [HidePickupForPlayer](HidePickupForPlayer): 对玩家隐藏拾取物 - [SetPickupForPlayer](SetPickupForPlayer): 为玩家单独配置拾取物属性 - -``` - -``` diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPickupPos.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPickupPos.md index 5f9a597aa81..3cf497c28ba 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPickupPos.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPickupPos.md @@ -11,7 +11,7 @@ tags: ["拾取物"] 设置拾取物的位置 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------------ | --------------------------------------------- | | pickupid | 要设置的拾取物 ID | | Float:x | 拾取物新的 X 坐标 | @@ -21,7 +21,7 @@ tags: ["拾取物"] ## 返回值 -本函数始终返回 **true** +此函数始终返回 **true** ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPickupType.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPickupType.md index 5cb749ae0eb..fd8556a277b 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPickupType.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPickupType.md @@ -19,7 +19,7 @@ tags: ["拾取物"] ## 返回值 -该函数总是返回 **true**。 +此函数总是返回 **true**。 ## 示例代码 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPickupVirtualWorld.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPickupVirtualWorld.md index 87a1ed2c620..d82828612c4 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPickupVirtualWorld.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPickupVirtualWorld.md @@ -18,7 +18,7 @@ tags: ["拾取物"] ## 返回值 -该函数总是返回 **true**。 +此函数总是返回 **true**。 ## 示例代码 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayer3DTextLabelVirtualWorld.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayer3DTextLabelVirtualWorld.md index 87d3a82db24..7712e4998fa 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayer3DTextLabelVirtualWorld.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayer3DTextLabelVirtualWorld.md @@ -11,7 +11,7 @@ tags: ["玩家", "3D文本标签"] 设置玩家专属 3D 文本标签的虚拟世界 ID -| 参数名 | 说明 | +| 参数 | 说明 | | ------------------- | ----------------------------------- | | playerid | 要设置的目标玩家 ID | | PlayerText3D:textid | 要设置的玩家专属 3D 文本标签 ID | @@ -34,7 +34,7 @@ SetPlayer3DTextLabelVirtualWorld(playerid, playerTextId, 60); :::warning 玩家专属 3D 文本标签暂不支持虚拟世界功能 -本函数实际无效且存在底层实现缺陷！ +此函数实际无效且存在底层实现缺陷！ ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerAdmin.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerAdmin.md index bd5c955377b..be0c6240c9e 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerAdmin.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerAdmin.md @@ -2,7 +2,7 @@ title: SetPlayerAdmin sidebar_label: SetPlayerAdmin description: 设置玩家为RCON管理员。 -tags: ["玩家", "rcon", "管理"] +tags: ["玩家", "远程控制台", "管理"] --- @@ -11,14 +11,14 @@ tags: ["玩家", "rcon", "管理"] 设置玩家为 RCON 管理员。 -| 参数名 | 说明 | +| 参数 | 说明 | | ---------- | --------------------------------------------- | | playerid | 要设置的玩家 ID | | bool:admin | **true**设置为 RCON 管理员，**false**移除权限 | ## 返回值 -本函数没有返回值。 +此函数不返回特定值。 ## 示例代码 @@ -28,7 +28,7 @@ public OnPlayerCommandText(playerid, cmdtext[]) if (!strcmp(cmdtext, "/admin", true)) { SetPlayerAdmin(playerid, true); - SendClientMessage(playerid, -1, "SERVER: You are now RCON admin!"); + SendClientMessage(playerid, -1, "服务器：你现在是RCON管理员了！"); return 1; } return 0; @@ -41,8 +41,4 @@ public OnPlayerCommandText(playerid, cmdtext[]) ## 相关回调 -- [OnRconLoginAttempt](OnRconLoginAttempt): RCON 登录尝试回调 - -``` - -``` +- [OnRconLoginAttempt](../callbacks/OnRconLoginAttempt): RCON 登录尝试回调 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerArmedWeapon.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerArmedWeapon.md index eca537bc37e..9bef3f1d39d 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerArmedWeapon.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerArmedWeapon.md @@ -9,7 +9,7 @@ tags: ["玩家"] 设置玩家当前手持的武器（必须是玩家已拥有的武器） -| 参数名 | 说明 | +| 参数 | 说明 | | --------------- | -------------------------------------------- | | playerid | 要设置武器的玩家 ID | | WEAPON:weaponid | 玩家应持有的[武器](../resources/weaponids)ID | @@ -49,7 +49,7 @@ public OnPlayerStateChange(playerid, PLAYER_STATE:newstate, PLAYER_STATE:oldstat :::tip -该函数仅切换玩家已持有的武器，不会给予新武器。具体给予武器功能请参考 GivePlayerWeapon +此函数仅切换玩家已持有的武器，不会给予新武器。具体给予武器功能请参考 GivePlayerWeapon ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerArmour.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerArmour.md index b15b9cda3e0..f3ed43fcf2b 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerArmour.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerArmour.md @@ -9,7 +9,7 @@ tags: ["玩家"] 设置玩家的护甲等级。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------ | -------------------------------------------------------------------------- | | playerid | 要设置护甲的玩家 ID | | Float:armour | 设置的护甲值（浮点数百分比）。超过 100 的值有效，但不会在 HUD 护甲条中显示 | @@ -35,7 +35,7 @@ public OnPlayerSpawn(playerid) :::tip -本函数使用英式拼写"armour"而非美式"armor"，与 SA-MP 其他函数存在拼写差异 +此函数使用英式拼写"护甲值"而非美式"armor"，与 SA-MP 其他函数存在拼写差异 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerAttachedObject.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerAttachedObject.md index 5ad5438562d..5347da8e7e7 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerAttachedObject.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerAttachedObject.md @@ -2,14 +2,14 @@ title: SetPlayerAttachedObject sidebar_label: SetPlayerAttachedObject description: 将物体附加到玩家指定骨骼上。 -tags: ["玩家", "物体", "附加物"] +tags: ["玩家", "物体", "附加"] --- ## 描述 将物体附加到玩家指定骨骼上。 -| 参数名 | 说明 | +| 参数 | 说明 | | --------------- | ------------------------------------------------- | | playerid | 目标玩家 ID | | index | 附加槽位索引（0-9） | @@ -49,7 +49,7 @@ public OnPlayerSpawn(playerid) :::tip -本函数与 CreateObject/CreatePlayerObject 物体池相互独立 +此函数与 CreateObject/CreatePlayerObject 物体池相互独立 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerCameraLookAt.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerCameraLookAt.md index bd0fa24b07b..5b25c1e4887 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerCameraLookAt.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerCameraLookAt.md @@ -9,12 +9,12 @@ tags: ["玩家", "视角"] 设置玩家视角的观察方向。通常需与 SetPlayerCameraPos 配合使用。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------ | --------------------------------------------------------------------------------- | | playerid | 目标玩家 ID | -| Float:x | 视角观察点的 X 坐标 | -| Float:y | 视角观察点的 Y 坐标 | -| Float:z | 视角观察点的 Z 坐标 | +| Float:x | 视角观察点的 X 坐标 | +| Float:y | 视角观察点的 Y 坐标 | +| Float:z | 视角观察点的 Z 坐标 | | CAM_MOVE:cut | [视角切换风格](../resources/cameracutstyles)。可使用 CAMERA_MOVE 实现视角渐变效果 | ## 返回值 @@ -34,7 +34,7 @@ SetPlayerCameraLookAt(playerid, 324.34, 54.122, 173.35); :::warning -在启用观察者模式后立即使用本函数将无法生效 +在启用观察者模式后立即使用此函数将无法生效 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerCameraPos.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerCameraPos.md index ab913bcc9d6..8f7c186ef2f 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerCameraPos.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerCameraPos.md @@ -9,9 +9,9 @@ tags: ["玩家", "视角"] 设置玩家的视角到指定位置 -| 参数名 | 说明 | -| -------- | ----------------------------- | -| playerid | 要设置的目标玩家 ID | +| 参数名 | 说明 | +| -------- | --------------------------- | +| playerid | 要设置的目标玩家 ID | | Float:x | 视角设定的 X 坐标（浮点型） | | Float:y | 视角设定的 Y 坐标（浮点型） | | Float:z | 视角设定的 Z 坐标（浮点型） | @@ -39,7 +39,7 @@ SetPlayerCameraPos(playerid, 652.23, 457.21, 10.84); :::warning -在启用观战模式后立即调用本函数无效 +在启用观战模式后立即调用此函数无效 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerChatBubble.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerChatBubble.md index 14da0d8b495..86b9593e1b0 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerChatBubble.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerChatBubble.md @@ -20,7 +20,7 @@ tags: ["玩家"] ## 返回值 -该函数没有特定返回值。 +此函数不返回特定值。 ## 示例代码 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerCheckpoint.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerCheckpoint.md index 7f617eb6ba5..99f42bafdc5 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerCheckpoint.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerCheckpoint.md @@ -9,7 +9,7 @@ tags: ["玩家", "检查点"] 为玩家设置检查点（红色圆柱体），同时在小地图显示红色标记。当玩家进入检查点时，将触发 OnPlayerEnterCheckpoint 回调并执行相关操作。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------- | --------------------- | | playerid | 要设置检查点的玩家 ID | | Float:centreX | 检查点中心 X 坐标 | @@ -54,7 +54,7 @@ public OnPlayerEnterCheckpoint(playerid) :::warning -检查点是异步的，同一时间只能显示一个。要实现"流式加载"效果（仅在玩家接近时显示），请使用检查点流式加载器 +检查点是异步的，同一时间只能显示一个。要实现"流加载"效果（仅在玩家接近时显示），请使用检查点流加载器 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerColor.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerColor.md index b8cd9a12098..097c4dce790 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerColor.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerColor.md @@ -16,7 +16,7 @@ tags: ["玩家"] ## 返回值 -本函数没有特定返回值 +此函数不返回特定值。 ## 示例 @@ -32,7 +32,7 @@ SetPlayerColor(playerid, 4278190335); :::tip -- 本函数将全局修改玩家颜色，即使其他玩家通过 SetPlayerMarkerForPlayer 设置了不同颜色 +- 此函数将全局修改玩家颜色，即使其他玩家通过 SetPlayerMarkerForPlayer 设置了不同颜色 - 在 OnPlayerConnect 回调中使用时，被设置玩家在 TAB 列表中将看不到颜色变化 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerFacingAngle.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerFacingAngle.md index 62ef9428f0b..b1abf6ae8c5 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerFacingAngle.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerFacingAngle.md @@ -9,7 +9,7 @@ tags: ["玩家"] 设置玩家的朝向角度（Z 轴旋转） -| 参数名 | 说明 | +| 参数 | 说明 | | ----------- | ---------------------------- | | playerid | 要设置朝向角度的玩家 ID | | Float:angle | 玩家应朝向的角度值（浮点型） | @@ -39,9 +39,10 @@ SetPlayerFacingAngle(playerid, 0.0); // 玩家面向北方 :::warning GTA:SA 中的角度方向与现实世界相反： + - 现实中的 90 度对应东方，但在游戏中对应西方 - 北方和南方仍保持 0/360 度和 180 度 -转换公式：游戏角度 = 360 - 实际角度 + 转换公式：游戏角度 = 360 - 实际角度 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerFightingStyle.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerFightingStyle.md index 93c9ba0d499..e4d9e7b1ed9 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerFightingStyle.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerFightingStyle.md @@ -9,14 +9,14 @@ tags: ["玩家"] 设置玩家的特殊战斗风格。需在游戏中瞄准后按下"次要攻击键"（默认 ENTER 键）触发。 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------------- | ----------------------------------------------- | | playerid | 要设置的玩家 ID | | FIGHT_STYLE:style | 要设置的[战斗风格](../resources/fightingstyles) | ## 返回值 -本函数没有返回值。 +此函数不返回特定值。 ## 示例代码 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerHealth.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerHealth.md index d0a8c55d55a..9c8aa93c827 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerHealth.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerHealth.md @@ -9,7 +9,7 @@ tags: ["玩家"] 设置玩家的生命值 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------ | ---------------------------------------------------------------- | | playerid | 要设置生命值的玩家 ID | | Float:health | 要设置的生命值。游戏界面显示的最大生命值为 100，但可设置更高数值 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerHoldingObject.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerHoldingObject.md index 34f1770f8de..7a4e92c3485 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerHoldingObject.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerHoldingObject.md @@ -39,13 +39,13 @@ public OnPlayerSpawn(playerid) :::tip -每个玩家只能附加一个物体。本函数与 CreateObject/CreatePlayerObject 物体池相互独立 +每个玩家只能附加一个物体。此函数与 CreateObject/CreatePlayerObject 物体池相互独立 ::: :::warning -该函数已在 SA-MP 0.3c 版本移除，请使用[SetPlayerAttachedObject](SetPlayerAttachedObject) +此函数已在 SA-MP 0.3c 版本移除，请使用[SetPlayerAttachedObject](SetPlayerAttachedObject) ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerMapIcon.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerMapIcon.md index 5441786d24c..beae7960f1d 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerMapIcon.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerMapIcon.md @@ -9,7 +9,7 @@ tags: ["玩家"] 在玩家地图上放置图标/标记。可用于标记银行、医院等重要位置。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------- | ---------------------------------------------------------------------------------------------- | | playerid | 目标玩家 ID | | iconid | 图标 ID（0-99），单个玩家最多 100 个图标。可通过[RemovePlayerMapIcon](RemovePlayerMapIcon)移除 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerMarkerForPlayer.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerMarkerForPlayer.md index ce23e418bd1..385aa2b814e 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerMarkerForPlayer.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerMarkerForPlayer.md @@ -17,7 +17,7 @@ tags: ["玩家"] ## 返回值 -该函数没有特定返回值。 +此函数不返回特定值。 ## 示例代码 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerName.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerName.md index 7541eba9ed5..29c269bdd32 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerName.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerName.md @@ -9,7 +9,7 @@ tags: ["玩家"] 设置玩家的昵称 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------ | --------------------------------------------------------------------------------------- | | playerid | 要设置昵称的玩家 ID | | const name[] | 新昵称。长度需为 1-24 个字符，且仅包含有效字符（0-9, a-z, A-Z, [], (), \$ @ . \_ 和 =） | @@ -47,7 +47,7 @@ if (strcmp(cmdtext, "/superman", true) == 0) } case 1: { - SendClientMessage(playerid, 0x00FF00FF, "您已成功更名为'Superman'"); + SendClientMessage(playerid, 0x00FF00FF, "你已成功更名为'Superman'"); } } return 1; @@ -61,7 +61,7 @@ if (strcmp(cmdtext, "/superman", true) == 0) - 仅修改大小写的昵称变更无效（如"John"改为"JOHN"） - 在 [OnPlayerConnect](../callbacks/OnPlayerConnect) 回调中使用时，新昵称对连接中的玩家不可见 - 传递空字符串作为新昵称会导致服务器崩溃（open.mp 版本已修复） -- 通过本函数最多可设置 24 字符昵称，但玩家通过 SA-MP 服务器浏览器加入时昵称不得超过 20 字符 +- 通过此函数最多可设置 24 字符昵称，但玩家通过 SA-MP 服务器浏览器加入时昵称不得超过 20 字符 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerObjectMaterial.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerObjectMaterial.md index 1e275f6d575..fad95d06a2e 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerObjectMaterial.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerObjectMaterial.md @@ -9,7 +9,7 @@ tags: ["玩家", "物体", "玩家物体"] 将玩家专属物体的纹理替换为游戏内其他模型的纹理 -| 参数名 | 说明 | +| 参数 | 说明 | | ---------------------- | ---------------------------------------------------------------------- | | playerid | 所属玩家 ID | | objectid | 要替换纹理的物体 ID | @@ -21,7 +21,7 @@ tags: ["玩家", "物体", "玩家物体"] ## 返回值 -本函数没有特定返回值 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerObjectMaterialText.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerObjectMaterialText.md index d5ff20de482..551026a7948 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerObjectMaterialText.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerObjectMaterialText.md @@ -9,7 +9,7 @@ tags: ["玩家", "物体", "玩家物体"] 将玩家物体的材质替换为文本。 -| 参数名 | 说明 | +| 参数 | 说明 | | ---------------------------------------- | -------------------------------------------------------------- | | playerid | 目标玩家 ID | | objectid | 要设置文本的物体 ID | @@ -26,7 +26,7 @@ tags: ["玩家", "物体", "玩家物体"] ## 返回值 -本函数没有返回值。 +此函数不返回特定值。 ## 示例代码 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerObjectNoCameraCol.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerObjectNoCameraCol.md index 0af523797e1..fb426119a1d 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerObjectNoCameraCol.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerObjectNoCameraCol.md @@ -41,7 +41,7 @@ public OnPlayerObjectMoved(playerid, objectid) :::tip -在正常圣安地列斯地图边界内此功能无效 +在正常圣安地列斯地图边界内此函数无效 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerObjectNoCameraCollision.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerObjectNoCameraCollision.md index 1c695ca348a..0b59f5dfbb2 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerObjectNoCameraCollision.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerObjectNoCameraCollision.md @@ -41,7 +41,7 @@ public OnPlayerObjectMoved(playerid, objectid) :::tip -注意：在正常 SA 地图边界内此功能无效 +注意：在正常 SA 地图边界内此函数无效 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerObjectRot.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerObjectRot.md index bd35a501691..724b7a7e6c9 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerObjectRot.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerObjectRot.md @@ -9,7 +9,7 @@ tags: ["玩家", "物体", "玩家物体"] 设置物体在 X、Y 和 Z 轴上的旋转角度。 -| 参数名 | 描述 | +| 参数 | 说明 | | --------------- | --------------------------- | | playerid | 需要旋转其玩家物体的玩家 ID | | objectid | 需要旋转的玩家物体 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerPickupModel.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerPickupModel.md index 4b248235ecf..8bec6b0670f 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerPickupModel.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerPickupModel.md @@ -11,7 +11,7 @@ tags: ["玩家", "拾取物", "玩家拾取物"] 设置玩家拾取物的模型。 -| 名称 | 说明 | +| 参数 | 说明 | | ------------------ | -------------------------------------- | | playerid | 玩家的 ID。 | | pickupid | 玩家拾取物的 ID。 | @@ -20,7 +20,7 @@ tags: ["玩家", "拾取物", "玩家拾取物"] ## 返回值 -本函数总是返回 **true**。 +此函数总是返回 **true**。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerPickupPos.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerPickupPos.md index 0bd483690b7..c705fc8f1c7 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerPickupPos.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerPickupPos.md @@ -2,7 +2,7 @@ title: SetPlayerPickupPos sidebar_label: SetPlayerPickupPos description: 设置玩家专属拾取物的位置。 -tags: ["玩家", "拾取物", "玩家专属拾取物"] +tags: ["玩家", "拾取物", "玩家拾取物"] --- @@ -11,7 +11,7 @@ tags: ["玩家", "拾取物", "玩家专属拾取物"] 设置玩家专属拾取物的位置。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------------ | ----------------------------------------- | | playerid | 玩家的 ID | | pickupid | 玩家专属拾取物的 ID | @@ -22,7 +22,7 @@ tags: ["玩家", "拾取物", "玩家专属拾取物"] ## 返回值 -本函数总是返回 **true**。 +此函数总是返回 **true**。 ## 示例代码 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerPickupType.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerPickupType.md index 63ae8736fdd..43abf04133c 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerPickupType.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerPickupType.md @@ -11,7 +11,7 @@ tags: ["玩家", "拾取物", "玩家拾取物"] 设置玩家专属拾取物的类型。 -| 参数名 | 描述 | +| 参数 | 说明 | | ------------------ | -------------------------------------------- | | playerid | 玩家 ID | | pickupid | 玩家拾取物 ID | @@ -20,7 +20,7 @@ tags: ["玩家", "拾取物", "玩家拾取物"] ## 返回值 -本函数始终返回 **true**。 +此函数始终返回 **true**。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerPickupVirtualWorld.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerPickupVirtualWorld.md index 66dfb550bf6..f5579a48d41 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerPickupVirtualWorld.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerPickupVirtualWorld.md @@ -2,7 +2,7 @@ title: SetPlayerPickupVirtualWorld sidebar_label: SetPlayerPickupVirtualWorld description: 设置玩家专属拾取物的虚拟世界ID。 -tags: ["玩家", "拾取物", "玩家专属拾取物"] +tags: ["玩家", "拾取物", "玩家拾取物"] --- @@ -11,7 +11,7 @@ tags: ["玩家", "拾取物", "玩家专属拾取物"] 设置玩家专属拾取物的虚拟世界 ID。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------ | ------------------- | | playerid | 玩家的 ID | | pickupid | 玩家专属拾取物的 ID | @@ -19,7 +19,7 @@ tags: ["玩家", "拾取物", "玩家专属拾取物"] ## 返回值 -本函数总是返回 **true**。 +此函数总是返回 **true**。 ## 示例代码 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerPos.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerPos.md index f477c1dfafd..42400298c82 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerPos.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerPos.md @@ -9,7 +9,7 @@ tags: ["玩家"] 设置玩家的位置。 -| 名称 | 说明 | +| 参数 | 说明 | | -------- | --------------------- | | playerid | 要设置位置的玩家 ID。 | | Float:x | 玩家位置的 X 坐标。 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerPosFindZ.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerPosFindZ.md index 5fb9863865d..dd0e86febfe 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerPosFindZ.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerPosFindZ.md @@ -40,6 +40,6 @@ SetPlayerPosFindZ(playerid, 1234.5, 1234.5, 1000.0); - [SetPlayerPos](SetPlayerPos): 直接设置玩家三维坐标 -## 相关回调函数 +## 相关回调 - [OnPlayerClickMap](../callbacks/OnPlayerClickMap): 当玩家在暂停菜单地图上设置路径点时触发 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerRaceCheckpoint.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerRaceCheckpoint.md index 9142003cfc5..096860bb957 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerRaceCheckpoint.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerRaceCheckpoint.md @@ -9,7 +9,7 @@ tags: ["玩家", "检查点", "竞速检查点"] 创建竞速检查点。当玩家进入时，将触发 OnPlayerEnterRaceCheckpoint 回调。 -| 名称 | 说明 | +| 参数 | 说明 | | ------------- | ---------------------------------------------------- | | playerid | 要设置检查点的玩家 ID | | CP_TYPE:type | [竞速检查点类型](../resources/race-checkpoint-types) | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerScore.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerScore.md index 824f452a6e2..5f24cf382ec 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerScore.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerScore.md @@ -9,7 +9,7 @@ tags: ["玩家"] 设置玩家的分数。玩家的分数会显示在积分板中（通过按住 TAB 键查看）。 -| 参数名 | 描述 | +| 参数 | 说明 | | -------- | ------------------- | | playerid | 要设置分数的玩家 ID | | score | 要设置的分数值 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerShopName.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerShopName.md index 191988c21d4..6880f91cf74 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerShopName.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerShopName.md @@ -9,14 +9,14 @@ tags: ["玩家"] 加载或卸载玩家的室内脚本（例如武器店菜单）。 -| 名称 | 说明 | +| 参数 | 说明 | | ---------------- | ------------------------------------------------------------------ | | playerid | 要加载室内脚本的玩家 ID | | const shopname[] | 要加载的[商店脚本](../resources/shopnames)。留空("")可卸载当前脚本 | ## 返回值 -本函数不返回任何特定值。 +此函数不返回特定值。 ## 示例 @@ -39,7 +39,7 @@ public OnPlayerCommandText(playerid, cmdtext[]) :::tip -本函数不支持赌场脚本。 +此函数不支持赌场脚本。 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerSkillLevel.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerSkillLevel.md index f0b6482eca4..fb7010778f2 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerSkillLevel.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerSkillLevel.md @@ -9,7 +9,7 @@ tags: ["玩家"] 设置玩家特定武器类型的技能等级。 -| 参数名 | 描述 | +| 参数 | 说明 | | ----------------- | ------------------------------------------------- | | playerid | 要设置武器技能的玩家 ID | | WEAPONSKILL:skill | 要设置的[武器技能类型](../resources/weaponskills) | @@ -17,7 +17,7 @@ tags: ["玩家"] ## 返回值 -本函数没有返回值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerSpecialAction.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerSpecialAction.md index 326eecd49f0..710a6ce66d6 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerSpecialAction.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerSpecialAction.md @@ -9,7 +9,7 @@ tags: ["玩家"] 设置玩家执行特殊动作。 -| 参数名 | 描述 | +| 参数 | 说明 | | ----------------------- | --------------------------------------------------- | | playerid | 要执行特殊动作的玩家 ID | | SPECIAL_ACTION:actionid | 要执行的[特殊动作类型](../resources/specialactions) | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerTeam.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerTeam.md index 0f0d7b87caa..702a6f2a190 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerTeam.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerTeam.md @@ -16,7 +16,7 @@ tags: ["玩家"] ## 返回值 -本函数没有特定返回值。 +此函数不返回特定值。 ## 示例代码 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerTime.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerTime.md index fd9b1caea5c..99f1c93ac7c 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerTime.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerTime.md @@ -9,7 +9,7 @@ tags: ["玩家"] 设置玩家的游戏时间。若玩家时钟已启用([TogglePlayerClock](TogglePlayerClock))，其显示的时间将自动更新。 -| 名称 | 说明 | +| 参数 | 说明 | | -------- | ----------------------- | | playerid | 要设置游戏时间的玩家 ID | | hour | 小时值 (0-23) | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerVelocity.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerVelocity.md index 5532f43aeb0..220e212ce0b 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerVelocity.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerVelocity.md @@ -9,7 +9,7 @@ tags: ["玩家"] 在 X、Y、Z 轴上设置玩家的速度。 -| 名称 | 说明 | +| 参数 | 说明 | | -------- | ------------------- | | playerid | 要设置速度的玩家 ID | | Float:x | X 轴方向的速度 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerVirtualWorld.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerVirtualWorld.md index d49bc70c36d..93084ca8a42 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerVirtualWorld.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerVirtualWorld.md @@ -9,7 +9,7 @@ tags: ["玩家"] 设置玩家所在的虚拟世界。玩家只能看到同属该虚拟世界的其他玩家和车辆。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------ | ------------------------- | | playerid | 需要设置虚拟世界的玩家 ID | | virtualWorld | 目标虚拟世界 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerWantedLevel.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerWantedLevel.md index ea365524ba0..64c139841e1 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerWantedLevel.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerWantedLevel.md @@ -9,7 +9,7 @@ tags: ["玩家"] 设置玩家的通缉等级（HUD 下方显示 6 颗棕色通缉星）。 -| 参数名 | 描述 | +| 参数 | 说明 | | -------- | ----------------------- | | playerid | 要设置通缉等级的玩家 ID | | level | 要设置的通缉等级（0-6） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerWeather.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerWeather.md index 8c9ac98554e..856f8aebde7 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerWeather.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerWeather.md @@ -9,14 +9,14 @@ tags: ["玩家"] 设置玩家的天气。 -| 名称 | 说明 | +| 参数 | 说明 | | -------- | -------------------------------------- | | playerid | 要设置天气的玩家 ID | | weather | 要设置的[天气](../resources/weatherid) | ## 返回值 -本函数不返回任何特定值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerWorldBounds.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerWorldBounds.md index be2bf3b0432..974fdd998fc 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerWorldBounds.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerWorldBounds.md @@ -9,7 +9,7 @@ tags: ["玩家"] 设置玩家的世界边界。玩家无法越出边界（越界时将被推回）。 -| 名称 | 说明 | +| 参数 | 说明 | | ---------- | ----------------------- | | playerid | 要设置边界的玩家 ID | | Float:maxX | 玩家可到达的最大 X 坐标 | @@ -19,7 +19,7 @@ tags: ["玩家"] ## 返回值 -本函数不返回任何特定值。 +此函数不返回特定值。 ## 示例 @@ -53,7 +53,7 @@ public OnPlayerSpawn(playerid) :::warning -本函数在室内环境中无效！ +此函数在室内环境中无效！ ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetSVarFloat.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetSVarFloat.md index d131dd208b2..702c4b7b614 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetSVarFloat.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetSVarFloat.md @@ -2,7 +2,7 @@ title: SetSVarFloat sidebar_label: SetSVarFloat description: 设置浮点型服务器变量。 -tags: ["服务器变量", "svar"] +tags: ["服务器变量"] --- @@ -11,7 +11,7 @@ tags: ["服务器变量", "svar"] 设置浮点型服务器变量。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------ | ---------------- | | const svar[] | 服务器变量名称 | | Float:value | 要设置的浮点数值 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetSVarInt.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetSVarInt.md index 4d70e8b4f30..c63ce3a02f3 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetSVarInt.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetSVarInt.md @@ -2,7 +2,7 @@ title: SetSVarInt sidebar_label: SetSVarInt description: 设置整型服务器变量。 -tags: ["服务器变量", "svar"] +tags: ["服务器变量"] --- @@ -11,7 +11,7 @@ tags: ["服务器变量", "svar"] 设置整型服务器变量。 -| 参数名 | 描述 | +| 参数 | 说明 | | ------------ | -------------- | | const svar[] | 服务器变量名称 | | value | 要设置的整数值 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetSVarString.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetSVarString.md index f2b90fe6a97..b4e04c88dd9 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetSVarString.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetSVarString.md @@ -2,7 +2,7 @@ title: SetSVarString sidebar_label: SetSVarString description: 设置字符串型服务器变量。 -tags: ["服务器变量", "svar"] +tags: ["服务器变量"] --- @@ -11,7 +11,7 @@ tags: ["服务器变量", "svar"] 设置字符串型服务器变量。 -| 名称 | 说明 | +| 参数 | 说明 | | ---------------- | -------------------------- | | const svar[] | 服务器变量名称 | | const value[] | 要设置的字符串值 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetServerRule.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetServerRule.md index f487add2712..c78a418cef9 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetServerRule.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetServerRule.md @@ -13,7 +13,7 @@ tags: ["规则"] ## 参数 -| 名称 | 说明 | +| 参数 | 说明 | | ---------------- | -------------------------- | | const rule[] | 要添加的服务器规则名称 | | const format[] | 服务器规则的值 | @@ -37,7 +37,7 @@ public OnGameModeInit() :::tip -本函数与[AddServerRule](AddServerRule)功能相同。 +此函数与[AddServerRule](AddServerRule)功能相同。 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetServerRuleFlags.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetServerRuleFlags.md index 716c7a481f3..2ca1f227adc 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetServerRuleFlags.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetServerRuleFlags.md @@ -9,7 +9,7 @@ tags: ["规则"] :::warning -该函数暂未实现。 +此函数暂未实现。 ::: @@ -19,7 +19,7 @@ tags: ["规则"] ## 参数 -| 参数名 | 描述 | +| 参数 | 说明 | | ------------------------- | -------------- | | const rule[] | 服务器规则名称 | | E_SERVER_RULE_FLAGS:flags | 要设置的标志位 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetSpawnInfo.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetSpawnInfo.md index bb93a3d43e7..d2b9542156f 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetSpawnInfo.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetSpawnInfo.md @@ -7,9 +7,9 @@ tags: ["玩家"] ## 描述 -该函数用于设置指定玩家的生成信息，可配置生成时的武器、队伍、皮肤及坐标。适用于迷你游戏或自动生成系统，相比在[OnPlayerSpawn](../callbacks/OnPlayerSpawn)或[OnPlayerRequestClass](../callbacks/OnPlayerRequestClass)中使用[SetPlayerSkin](SetPlayerSkin)更稳定。 +此函数用于设置指定玩家的生成信息，可配置生成时的武器、队伍、皮肤及坐标。适用于迷你游戏或自动生成系统，相比在[OnPlayerSpawn](../callbacks/OnPlayerSpawn)或[OnPlayerRequestClass](../callbacks/OnPlayerRequestClass)中使用[SetPlayerSkin](SetPlayerSkin)更稳定。 -| 参数名 | 说明 | +| 参数 | 说明 | | -------------- | ----------------------------------------- | | playerid | 需要设置生成信息的玩家 ID | | team | 玩家所属队伍 ID | @@ -27,7 +27,7 @@ tags: ["玩家"] ## 返回值 -本函数没有特定返回值。 +此函数不返回特定值。 ## 示例代码 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetTeamCount.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetTeamCount.md index 9c772ce4a49..2d6541ac316 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetTeamCount.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetTeamCount.md @@ -1,21 +1,21 @@ --- title: SetTeamCount sidebar_label: SetTeamCount -description: 该函数用于设置游戏模式中使用的队伍数量。 +description: 此函数用于设置游戏模式中使用的队伍数量。 tags: [] --- ## 描述 -该函数用于设置游戏模式中使用的队伍数量。虽然无实际效果，但可用于优化内部队伍管理机制。应仅在 OnGameModeInit 回调函数中使用。重要提示：可传入任意数值（如 20 亿），本函数不会产生任何实际影响。 +此函数用于设置游戏模式中使用的队伍数量。虽然无实际效果，但可用于优化内部队伍管理机制。应仅在 OnGameModeInit 回调函数中使用。重要提示：可传入任意数值（如 20 亿），此函数不会产生任何实际影响。 -| 参数名 | 描述 | -| ------ | -------------------- | -| count | 游戏模式预设队伍数量 | +| 参数 | 说明 | +| ----- | -------------------- | +| count | 游戏模式预设队伍数量 | ## 返回值 -本函数没有返回值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetTimer.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetTimer.md index 3146a981e6f..3684513ccef 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetTimer.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetTimer.md @@ -9,7 +9,7 @@ tags: ["定时器"] 设置定时器在指定时间间隔后触发函数调用，可配置是否重复执行。 -| 参数名 | 说明 | +| 参数 | 说明 | | -------------------- | ------------------------------------------------------------ | | const functionName[] | 要调用的公共函数名称（需预先声明）。空字符串会导致服务器崩溃 | | interval | 触发间隔（毫秒） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetTimerEx.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetTimerEx.md index db615d562af..8aefeac93c0 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetTimerEx.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetTimerEx.md @@ -9,7 +9,7 @@ tags: ["定时器"] 设置定时器以在指定间隔后调用函数。此变体 ('Ex') 可向目标函数传递参数（如玩家 ID）。 -| 名称 | 说明 | +| 参数 | 说明 | | -------------------- | ---------------------------------------------------------------------------------------- | | const functionName[] | 定时器到期时调用的公共函数名称 | | interval | 时间间隔（单位：毫秒，1 秒=1000 毫秒） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleAngularVelocity.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleAngularVelocity.md index 125c25054b2..da4b09c32f3 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleAngularVelocity.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleAngularVelocity.md @@ -7,7 +7,7 @@ tags: ["车辆"] :::info -本函数基于世界坐标系而非局部坐标系。如需进行局部坐标系角速度调整，必须基于[车辆旋转四元数](GetVehicleRotationQuat)应用旋转矩阵。 +此函数基于世界坐标系而非局部坐标系。如需进行局部坐标系角速度调整，必须基于[GetVehicleRotationQuat](GetVehicleRotationQuat)应用旋转矩阵。 ::: @@ -15,7 +15,7 @@ tags: ["车辆"] 设置车辆在 X、Y、Z 轴上的角速度 -| 名称 | 说明 | +| 参数 | 说明 | | --------- | --------------------- | | vehicleid | 要设置角速度的车辆 ID | | Float:x | X 轴方向的角速度量 | @@ -48,7 +48,7 @@ public OnPlayerCommandText(playerid, cmdtext[]) :::warning -本函数对无人车辆无效且不影响火车。 +此函数对无人车辆无效且不影响火车。 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleBeenOccupied.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleBeenOccupied.md index a6f6a2d1e21..6c4d04cef91 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleBeenOccupied.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleBeenOccupied.md @@ -9,7 +9,7 @@ tags: ["车辆"] :::warning -该功能在当前版本中尚未实现 +此函数在当前版本中尚未实现 ::: @@ -19,7 +19,7 @@ tags: ["车辆"] ## 参数说明 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------- | ---------------------------------------- | | vehicleid | 目标车辆的 ID | | bool:occupied | **true**标记为占用 **false**清除占用标记 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleDead.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleDead.md index 5b1b385476c..3b79138d651 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleDead.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleDead.md @@ -9,7 +9,7 @@ tags: ["车辆"] :::warning -该函数暂未实现。 +此函数暂未实现。 ::: @@ -19,7 +19,7 @@ tags: ["车辆"] ## 参数 -| 参数名 | 描述 | +| 参数 | 说明 | | --------- | ------------------------------------------- | | vehicleid | 要设置的车辆 ID | | bool:dead | **true**表示损毁状态，**false**表示正常状态 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleHealth.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleHealth.md index c98a825bf6c..dd520b61aeb 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleHealth.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleHealth.md @@ -11,7 +11,7 @@ tags: ["车辆"] 设置车辆的生命值。当生命值降低时，引擎会先冒烟，当生命值低于 250（25%）时会出现火焰。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------ | ---------------------- | | vehicleid | 要设置生命值的车辆 ID | | Float:health | 以浮点数值表示的生命值 | @@ -56,7 +56,7 @@ public OnPlayerCommandText(playerid, cmdtext[]) - [RepairVehicle](RepairVehicle): 完全修复车辆 - [SetPlayerHealth](SetPlayerHealth): 设置玩家生命值 -## 相关回调函数 +## 相关回调 - [OnVehicleDeath](../callbacks/OnVehicleDeath): 车辆被摧毁时触发 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleNumberPlate.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleNumberPlate.md index 90f9e76e73d..12d140574e4 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleNumberPlate.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleNumberPlate.md @@ -9,7 +9,7 @@ tags: ["车辆"] 设置车辆的车牌。 -| 名称 | 说明 | +| 参数 | 说明 | | ------------------- | -------------------- | | vehicleid | 要设置车牌的车辆 ID | | const numberPlate[] | 要在车牌上显示的文本 | @@ -32,7 +32,7 @@ SetVehicleNumberPlate(vehicleid, "ABCD 123"); // 设置车牌号为ABCD 123 :::tip -- 本函数不会进行内置错误校验 +- 此函数不会进行内置错误校验 - 请勿为无车牌车辆（船只、飞机等）设置自定义车牌，这会导致不必要的客户端处理 - 需重新生成或重新流加载车辆才能使更改生效 - 车牌文本最大支持 32 字符（含颜色代码） diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleOccupiedTick.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleOccupiedTick.md index 6da05b2550f..9b6217d89d7 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleOccupiedTick.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleOccupiedTick.md @@ -9,7 +9,7 @@ tags: ["车辆"] :::warning -该函数暂未实现。 +此函数暂未实现。 ::: @@ -19,7 +19,7 @@ tags: ["车辆"] ## 参数 -| 参数名 | 描述 | +| 参数 | 说明 | | --------- | ------------------ | | vehicleid | 要设置的车辆 ID | | ticks | 要设置的时间戳数值 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleParamsCarDoors.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleParamsCarDoors.md index 7e6db4edc0e..61584812f1a 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleParamsCarDoors.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleParamsCarDoors.md @@ -11,7 +11,7 @@ tags: ["车辆"] 控制车辆车门的开关状态。 -| 参数名 | 描述 | +| 参数 | 说明 | | --------------- | --------------------------------------- | | vehicleid | 要设置车门状态的车辆 ID | | bool:frontLeft | 驾驶座车门状态（1 开启/0 关闭） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleParamsCarWindows.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleParamsCarWindows.md index 8b8f2ee9cc4..1dcc51ff07a 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleParamsCarWindows.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleParamsCarWindows.md @@ -11,7 +11,7 @@ tags: ["车辆"] 控制车辆车窗的开关状态。 -| 名称 | 说明 | +| 参数 | 说明 | | --------------- | -------------------------------------- | | vehicleid | 要设置车窗的车辆 ID | | bool:frontLeft | 驾驶座车窗状态（0=开启，1=关闭） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleParamsEx.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleParamsEx.md index 8c66dce9ad8..3b43a2c30ea 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleParamsEx.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleParamsEx.md @@ -9,7 +9,7 @@ tags: ["车辆"] 设置车辆的全局参数，对所有玩家生效。 -| 参数名 | 说明 | +| 参数 | 说明 | | -------------- | ------------------------------ | | vehicleid | 目标车辆的 ID | | bool:engine | 引擎状态（0=关闭，1=启动） | @@ -80,7 +80,7 @@ public DisableVehicleAlarm(vehicleid) :::tip -- 警报触发后不会自动停止，需手动调用本函数关闭 +- 警报触发后不会自动停止，需手动调用此函数关闭 - 启用[ManualVehicleEngineAndLights](ManualVehicleEngineAndLights)后，车灯在白天也会保持开启状态 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleParamsForPlayer.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleParamsForPlayer.md index 3c34995b1e1..4f002d30f11 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleParamsForPlayer.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleParamsForPlayer.md @@ -9,7 +9,7 @@ tags: ["玩家", "车辆"] 为指定玩家设置车辆的专属参数。 -| 参数名 | 说明 | +| 参数 | 说明 | | ---------------- | ------------------------------------------------- | | vehicle | 目标车辆的 ID | | playerid | 需要设置参数的玩家 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleParamsSirenState.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleParamsSirenState.md index 52955c00454..1e34b5cf9cd 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleParamsSirenState.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleParamsSirenState.md @@ -1,7 +1,7 @@ --- title: SetVehicleParamsSirenState sidebar_label: SetVehicleParamsSirenState -description: 控制车辆警笛的开启与关闭状态。 +description: 控制车辆警报器的开启与关闭状态。 tags: ["车辆"] --- @@ -9,14 +9,14 @@ tags: ["车辆"] ## 描述 -控制车辆警笛的开启与关闭状态。 +控制车辆警报器的开启与关闭状态。 ## 参数 -| 参数名 | 描述 | -| ------------ | ------------------------------------------- | -| vehicleid | 要操作的车辆 ID | -| bool:enabled | **true**表示开启警笛，**false**表示关闭警笛 | +| 参数 | 说明 | +| ------------ | ----------------------------------------------- | +| vehicleid | 要操作的车辆 ID | +| bool:enabled | **true**表示开启警报器，**false**表示关闭警报器 | ## 示例 @@ -26,6 +26,6 @@ SetVehicleParamsSirenState(vehicleid, true); ## 相关函数 -- [GetVehicleParamsSirenState](GetVehicleParamsSirenState): 获取车辆警笛状态 -- [GetVehicleSirenState](GetVehicleSirenState): 获取车辆警笛激活状态 -- [GetPlayerSirenState](GetPlayerSirenState): 获取玩家车辆警笛状态 +- [GetVehicleParamsSirenState](GetVehicleParamsSirenState): 获取车辆警报器状态 +- [GetVehicleSirenState](GetVehicleSirenState): 获取车辆警报器激活状态 +- [GetPlayerSirenState](GetPlayerSirenState): 获取玩家车辆警报器状态 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehiclePos.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehiclePos.md index 15d139e153a..9d677294193 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehiclePos.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehiclePos.md @@ -9,7 +9,7 @@ tags: ["车辆"] 设置车辆的位置。 -| 名称 | 说明 | +| 参数 | 说明 | | --------- | ------------------- | | vehicleid | 要设置位置的车辆 ID | | Float:x | 车辆位置的 X 坐标 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleRespawnDelay.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleRespawnDelay.md index 254a685f5cd..b6f1929c244 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleRespawnDelay.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleRespawnDelay.md @@ -13,7 +13,7 @@ tags: ["车辆"] ## 参数说明 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------ | -------------------------------- | | vehicleid | 目标车辆的 ID | | respawnDelay | 要设置的重生延迟时间（单位：秒） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleRespawnTick.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleRespawnTick.md index 07167be658b..26352d034dd 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleRespawnTick.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleRespawnTick.md @@ -9,7 +9,7 @@ tags: ["车辆"] :::warning -本函数暂未实现。 +此函数暂未实现。 ::: @@ -19,7 +19,7 @@ tags: ["车辆"] ## 参数 -| 名称 | 说明 | +| 参数 | 说明 | | --------- | -------------- | | vehicleid | 目标车辆 ID | | ticks | 要设置的滴答数 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleSpawnInfo.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleSpawnInfo.md index 273966eeabe..b5cfe47cf2b 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleSpawnInfo.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleSpawnInfo.md @@ -13,7 +13,7 @@ tags: ["车辆"] ## 参数 -| 参数名 | 描述 | +| 参数 | 说明 | | ----------------- | --------------------------------------------- | | vehicleid | 要配置的车辆 ID | | modelid | 要设置的[车辆模型 ID](../resources/vehicleid) | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleToRespawn.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleToRespawn.md index 8bfff9af9f7..2282b2a08c2 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleToRespawn.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleToRespawn.md @@ -9,7 +9,7 @@ tags: ["车辆"] 将车辆重置到其创建时的位置。 -| 名称 | 说明 | +| 参数 | 说明 | | --------- | --------------- | | vehicleid | 要重置的车辆 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleVelocity.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleVelocity.md index 13d637287f4..f9d3e63b3ea 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleVelocity.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleVelocity.md @@ -9,7 +9,7 @@ tags: ["车辆"] 设置车辆在 X、Y、Z 三个坐标轴方向的瞬时运动速度。 -| 参数名 | 说明 | +| 参数 | 说明 | | --------- | ----------------------------------- | | vehicleid | 目标车辆的 ID | | Float:x | X 轴方向的速度（单位：游戏单位/秒） | @@ -43,7 +43,7 @@ public OnPlayerCommandText(playerid, cmdtext[]) :::warning -- 本函数仅对玩家驾驶的车辆有效 +- 此函数仅对玩家驾驶的车辆有效 - 无法作用于火车类车辆 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleVirtualWorld.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleVirtualWorld.md index 836f9d84b98..f9327751c82 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleVirtualWorld.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleVirtualWorld.md @@ -9,14 +9,14 @@ tags: ["车辆"] 设置车辆所属的虚拟世界。玩家仅能看见与其处于同一虚拟世界中的车辆。 -| 参数名 | 描述 | +| 参数 | 说明 | | ------------ | ----------------------- | | vehicleid | 要设置虚拟世界的车辆 ID | | virtualWorld | 要设置的虚拟世界 ID | ## 返回值 -本函数没有返回值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleZAngle.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleZAngle.md index 12af4ac391b..762871d49be 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleZAngle.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetVehicleZAngle.md @@ -9,7 +9,7 @@ tags: ["车辆"] 设置车辆 Z 轴旋转角度（偏航角）。 -| 参数名 | 描述 | +| 参数 | 说明 | | ----------- | --------------------------------- | | vehicleid | 要设置旋转角度的车辆 ID | | Float:angle | 要设置的 Z 轴旋转角度（单位：度） | @@ -35,7 +35,7 @@ public OnPlayerCommandText(playerid, cmdtext[]) GetVehicleZAngle(vehicleid, angle); SetVehicleZAngle(vehicleid, angle); - SendClientMessage(playerid, 0xFFFFFFFF, "您的车辆已复位角度"); + SendClientMessage(playerid, 0xFFFFFFFF, "你的车辆已复位角度"); return 1; } return 0; @@ -46,9 +46,9 @@ public OnPlayerCommandText(playerid, cmdtext[]) :::tip -- 使用本函数将重置车辆的 X/Y 轴旋转（俯仰和横滚） -- X/Y 轴旋转角度不可通过本函数设置 -- 本函数对无人驾驶的车辆无效（GTA 引擎原生限制） +- 使用此函数将重置车辆的 X/Y 轴旋转（俯仰和横滚） +- X/Y 轴旋转角度不可通过此函数设置 +- 此函数对无人驾驶的车辆无效（GTA 引擎原生限制） ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetWeather.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetWeather.md index 593f1425ffd..2947d3f2a9a 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetWeather.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetWeather.md @@ -9,13 +9,13 @@ tags: [] 为所有玩家设置全局天气效果。 -| 参数名 | 说明 | +| 参数 | 说明 | | --------- | ----------------------------------------- | | weatherid | 要设置的[天气 ID](../resources/weatherid) | ## 返回值 -本函数没有特定返回值。 +此函数不返回特定值。 ## 示例代码 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetWorldTime.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetWorldTime.md index e2e03238ead..637d25ae19b 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetWorldTime.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/SetWorldTime.md @@ -1,21 +1,21 @@ --- title: SetWorldTime sidebar_label: SetWorldTime -description: 为所有玩家设置全局时间至指定小时。 -tags: ["全局时间"] +description: 为所有玩家设置世界时间至指定小时。 +tags: ["世界时间"] --- ## 描述 -为所有玩家设置全局时间至指定小时。 +为所有玩家设置世界时间至指定小时。 -| 名称 | 说明 | +| 参数 | 说明 | | ---- | ---------------------- | | hour | 要设置的小时值（0-23） | ## 返回值 -本函数不返回任何特定值。 +此函数不返回特定值。 ## 示例 @@ -28,7 +28,7 @@ SetWorldTime(12); :::tip -本函数仅对未启用动态时钟的玩家生效（参见[TogglePlayerClock](TogglePlayerClock)）。 +此函数仅对未启用动态时钟的玩家生效（参见[TogglePlayerClock](TogglePlayerClock)）。 ::: @@ -40,7 +40,7 @@ SetWorldTime(12); ## 相关函数 -- [GetWorldTime](GetWorldTime): 获取当前全局时间 +- [GetWorldTime](GetWorldTime): 获取当前世界时间 - [SetPlayerTime](SetPlayerTime): 设置玩家时间 - [SetWeather](SetWeather): 设置全局天气 - [SetGravity](SetGravity): 设置全局重力 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ShowMenuForPlayer.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ShowMenuForPlayer.md index 4a4e4ccb95d..26b6009f906 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ShowMenuForPlayer.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ShowMenuForPlayer.md @@ -9,7 +9,7 @@ tags: ["玩家", "菜单"] 向指定玩家显示已创建的菜单界面。 -| 参数名 | 描述 | +| 参数 | 说明 | | ----------- | --------------------------------------- | | Menu:menuid | 要显示的菜单 ID（通过 CreateMenu 创建） | | playerid | 目标玩家 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ShowNameTags.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ShowNameTags.md index 8cae7a650d9..a8b63d89307 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ShowNameTags.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ShowNameTags.md @@ -9,13 +9,13 @@ tags: [] 控制是否显示玩家头顶的名称标签、生命值条和护甲条。 -| 名称 | 说明 | +| 参数 | 说明 | | --------- | ------------------------------------------- | | bool:显示 | 'false'禁用显示，'true'启用显示（默认启用） | ## 返回值 -本函数不返回任何特定值。 +此函数不返回特定值。 ## 示例 @@ -32,7 +32,7 @@ public OnGameModeInit() :::warning -本函数只能在[OnGameModeInit](OnGameModeInit)回调中使用。其他场景请使用[ShowPlayerNameTagForPlayer](ShowPlayerNameTagForPlayer)。 +此函数只能在[OnGameModeInit](OnGameModeInit)回调中使用。其他场景请使用[ShowPlayerNameTagForPlayer](ShowPlayerNameTagForPlayer)。 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ShowObjectForPlayer.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ShowObjectForPlayer.md index 26eecdb64c5..ad88f24a9fb 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ShowObjectForPlayer.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ShowObjectForPlayer.md @@ -13,7 +13,7 @@ tags: ["玩家", "物体"] ## 参数 -| 名称 | 说明 | +| 参数 | 说明 | | -------- | ----------------------- | | playerid | 玩家的 ID。 | | objectid | 要显示给玩家的物体 ID。 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ShowPickupForPlayer.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ShowPickupForPlayer.md index 63d231eff97..3c9d00b0ff5 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ShowPickupForPlayer.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ShowPickupForPlayer.md @@ -18,7 +18,7 @@ tags: ["玩家", "拾取物"] ## 返回值 -本函数始终返回 **true**。 +此函数始终返回 **true**。 ## 示例代码 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ShowPlayerMarkers.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ShowPlayerMarkers.md index 23e01b750d4..bed52fe2f96 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ShowPlayerMarkers.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ShowPlayerMarkers.md @@ -9,13 +9,13 @@ tags: ["玩家"] 切换玩家雷达标记（小地图上的光点显示状态）。必须在服务器启动时调用（OnGameModeInit 回调中）。如需运行时控制，请使用[SetPlayerMarkerForPlayer](SetPlayerMarkerForPlayer)。 -| 参数名称 | 说明 | -| ------------------------ | -------------------------------------------------------------------------------- | -| PLAYER_MARKERS_MODE:mode | 使用的[标记模式](../resources/markermodes)。支持流式加载模式，仅对附近玩家可见。 | +| 参数名称 | 说明 | +| ------------------------ | ------------------------------------------------------------------------------ | +| PLAYER_MARKERS_MODE:mode | 使用的[标记模式](../resources/markermodes)。支持流加载模式，仅对附近玩家可见。 | ## 返回值 -本函数不返回特定值。 +此函数不返回特定值。 ## 示例代码 @@ -29,11 +29,11 @@ public OnGameModeInit() ## 标记模式对照表 -| ID | 模式标识符 | -| --- | ---------------------------------------- | -| 0 | PLAYER_MARKERS_MODE_OFF（禁用标记） | -| 1 | PLAYER_MARKERS_MODE_GLOBAL（全局显示） | -| 2 | PLAYER_MARKERS_MODE_STREAMED（流式加载） | +| ID | 模式标识符 | +| --- | -------------------------------------- | +| 0 | PLAYER_MARKERS_MODE_OFF（禁用标记） | +| 1 | PLAYER_MARKERS_MODE_GLOBAL（全局显示） | +| 2 | PLAYER_MARKERS_MODE_STREAMED（流加载） | ## 注意事项 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ShowPlayerNameTagForPlayer.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ShowPlayerNameTagForPlayer.md index e14a8814b6e..0ff2df2e6d6 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ShowPlayerNameTagForPlayer.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ShowPlayerNameTagForPlayer.md @@ -1,13 +1,13 @@ --- title: ShowPlayerNameTagForPlayer sidebar_label: ShowPlayerNameTagForPlayer -description: 此函数允许您切换玩家头顶显示的玩家名称标签、生命条和护甲条的绘制。 +description: 此函数允许你切换玩家头顶显示的玩家名称标签、生命条和护甲条的绘制。 tags: ["玩家"] --- ## 描述 -此函数允许您切换玩家头顶显示的玩家名称标签、生命条和护甲条的绘制。若需全局控制类似功能，请使用[ShowNameTags](ShowNameTags)函数。 +此函数允许你切换玩家头顶显示的玩家名称标签、生命条和护甲条的绘制。若需全局控制类似功能，请使用[ShowNameTags](ShowNameTags)函数。 | 参数 | 说明 | | --------- | ------------------------------------- | @@ -44,7 +44,7 @@ public OnPlayerCommandText(playerid, cmdtext[]) :::tip -需先通过[ShowNameTags](ShowNameTags)启用全局名称标签显示，本函数才能生效。建议在玩家流加载时（[OnPlayerStreamIn](../callbacks/OnPlayerStreamIn)回调）预先设置 ShowPlayerNameTagForPlayer(forplayerid, playerid, 0)。 +需先通过[ShowNameTags](ShowNameTags)启用全局名称标签显示，此函数才能生效。建议在玩家流加载时（[OnPlayerStreamIn](../callbacks/OnPlayerStreamIn)回调）预先设置 ShowPlayerNameTagForPlayer(forplayerid, playerid, 0)。 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ShowVehicle.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ShowVehicle.md index b22cfd2949f..ce86b5b9d6c 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ShowVehicle.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ShowVehicle.md @@ -9,7 +9,7 @@ tags: ["车辆"] :::warning -警告：此功能尚未实现。 +警告：此函数尚未实现。 ::: @@ -19,7 +19,7 @@ tags: ["车辆"] ## 参数 -| 名称 | 说明 | +| 参数 | 说明 | | --------- | ----------------- | | vehicleid | 要显示的车辆 ID。 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/StartRecordingPlayback.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/StartRecordingPlayback.md index 65fa7f4662d..160f2ba782d 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/StartRecordingPlayback.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/StartRecordingPlayback.md @@ -5,11 +5,17 @@ description: 加载并运行存储在npcmodes/recordings目录下的.rec文件 tags: [] --- +:::warning + +此函数已弃用，请使用 [NPC_StartPlayback](NPC_StartPlayback)。 + +::: + ## 描述 加载并运行存储在 npcmodes/recordings 目录下的.rec 文件。这些录制文件允许 NPC 执行特定动作，可通过手动录制生成。更多信息请参考相关函数。 -| 名称 | 说明 | +| 参数 | 说明 | | ------------ | -------------------------------------------- | | playbacktype | 要加载的录制[类型](../resources/recordtypes) | | recordname[] | 要加载的文件名（无需包含.rec 扩展名） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/StartRecordingPlayerData.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/StartRecordingPlayerData.md index 2dfa135fedc..eccb340a79c 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/StartRecordingPlayerData.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/StartRecordingPlayerData.md @@ -17,7 +17,7 @@ tags: ["玩家"] ## 返回值 -本函数不返回特定值。 +此函数不返回特定值。 ## 示例代码 @@ -32,7 +32,7 @@ if (!strcmp("/recordme", cmdtext)) { StartRecordingPlayerData(playerid, PLAYER_RECORDING_TYPE_DRIVER, "MyFile"); } - SendClientMessage(playerid, 0xFFFFFFFF, "您的所有移动轨迹正在被录制！"); + SendClientMessage(playerid, 0xFFFFFFFF, "你的所有移动轨迹正在被录制！"); return 1; } ``` diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/StopAudioStreamForPlayer.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/StopAudioStreamForPlayer.md index d3b2f7626d3..94d1eb39d36 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/StopAudioStreamForPlayer.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/StopAudioStreamForPlayer.md @@ -11,13 +11,13 @@ tags: ["玩家"] ## 参数 -| 名称 | 说明 | +| 参数 | 说明 | | -------- | ----------------------- | | playerid | 要停止音频流的玩家 ID。 | ## 返回值 -此函数不返回任何特定值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/StopObject.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/StopObject.md index 3d88b9791fd..d75b6ae59f8 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/StopObject.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/StopObject.md @@ -15,7 +15,7 @@ tags: ["物体"] ## 返回值 -本函数不返回特定值。 +此函数不返回特定值。 ## 示例代码 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/StopPlayerHoldingObject.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/StopPlayerHoldingObject.md index c8434a931f4..f5f3a69f2f4 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/StopPlayerHoldingObject.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/StopPlayerHoldingObject.md @@ -34,7 +34,7 @@ public OnPlayerDeath(playerid, killerid, WEAPON:reason) :::warning -该函数已在 SA-MP 0.3c 版本中移除。请使用[RemovePlayerAttachedObject](RemovePlayerAttachedObject) +此函数已在 SA-MP 0.3c 版本中移除。请使用[RemovePlayerAttachedObject](RemovePlayerAttachedObject) ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/StopPlayerObject.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/StopPlayerObject.md index ee40eae031f..f2171678aff 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/StopPlayerObject.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/StopPlayerObject.md @@ -11,14 +11,14 @@ tags: ["玩家"] ## 参数 -| 名称 | 说明 | +| 参数 | 说明 | | -------- | ------------------------- | | playerid | 目标玩家的 ID。 | | objectid | 要停止移动的玩家物体 ID。 | ## 返回值 -此函数不返回任何特定值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/StopRecordingPlayback.MD b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/StopRecordingPlayback.md similarity index 74% rename from frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/StopRecordingPlayback.MD rename to frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/StopRecordingPlayback.md index cd5fcd75b13..d112996d20f 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/StopRecordingPlayback.MD +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/StopRecordingPlayback.md @@ -5,6 +5,12 @@ description: 停止NPC当前正在运行的.rec文件，使其保持空闲状态 tags: [] --- +:::warning + +此函数已弃用，请使用 [NPC_StopPlayback](NPC_StopPlayback)。 + +::: + ## 描述 停止 NPC 当前正在运行的.rec 文件，使其保持空闲状态直到接收到其他指令。 @@ -20,4 +26,4 @@ public OnNPCExitVehicle(vehicleid, seatid) ## 相关函数 -- [StartRecordingPlayback](StartRecordingPlayback): 开始播放.rec 文件 +- [StartRecordingPlayback](StartRecordingPlayback): 开始回放.rec 文件 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/StopRecordingPlayerData.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/StopRecordingPlayerData.md index bad11347248..175021abe0e 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/StopRecordingPlayerData.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/StopRecordingPlayerData.md @@ -15,7 +15,7 @@ tags: ["玩家"] ## 返回值 -本函数不返回特定值。 +此函数不返回特定值。 ## 示例代码 @@ -25,7 +25,7 @@ public OnPlayerCommandText(playerid, cmdtext[]) if (!strcmp("/stoprecording", cmdtext)) { StopRecordingPlayerData(playerid); - SendClientMessage(playerid, 0xFFFFFFFF, "您的录制文件已保存至scriptfiles目录！"); + SendClientMessage(playerid, 0xFFFFFFFF, "你的录制文件已保存至scriptfiles目录！"); return 1; } } diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawAlignment.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawAlignment.md index b5cd062f728..e13a3df6b0f 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawAlignment.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawAlignment.md @@ -16,7 +16,7 @@ tags: ["文本绘图"] ## 返回值 -本函数不返回特定值。 +此函数不返回特定值。 ## 示例代码 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawBackgroundColor.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawBackgroundColor.md index a2af986c4a5..da1ba1092d3 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawBackgroundColor.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawBackgroundColor.md @@ -16,7 +16,7 @@ tags: ["文本绘图"] ## 返回值 -本函数不返回特定值。 +此函数不返回特定值。 ## 示例代码 @@ -36,7 +36,7 @@ public OnGameModeInit() :::tip -- 当使用[TextDrawSetOutline](TextDrawSetOutline)且尺寸>0 时，轮廓颜色将与本函数设置的颜色一致 +- 当使用[TextDrawSetOutline](TextDrawSetOutline)且尺寸>0 时，轮廓颜色将与此函数设置的颜色一致 - 修改颜色值会影响[TextDrawColor](TextDrawColor)的文本颜色表现 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawBackgroundColour.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawBackgroundColour.md index d9f63234808..d44a57490f0 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawBackgroundColour.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawBackgroundColour.md @@ -13,14 +13,14 @@ tags: ["文本绘图"] ## 参数 -| 名称 | 说明 | +| 参数 | 说明 | | ---------------- | -------------------------- | | Text:textid | 目标文本绘图的 ID | | backgroundColour | 要设置的背景颜色值（RGBA） | ## 返回值 -此函数不返回任何特定值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawBoxColor.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawBoxColor.md index 87fdc942b55..b4e0a4ddfbf 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawBoxColor.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawBoxColor.md @@ -9,14 +9,14 @@ tags: ["文本绘图"] 调整文本框颜色（仅在 TextDrawUseBox 的'use'参数为'true'时生效）。 -| 名称 | 说明 | +| 参数 | 说明 | | ----------- | --------------------------------------------------------------------------------------------------------------- | | Text:textid | 需要修改的文本绘图 | | boxColour | 颜色值。透明度由颜色的 alpha 通道决定（例如 0x000000FF 表示完全不透明的黑色，而 0x000000AA 表示半透明的黑色）。 | ## 返回值 -该函数不返回任何特定值。 +此函数不返回特定值。 ## 示例 @@ -36,7 +36,7 @@ public OnGameModeInit() :::tip -如果您想更改已显示的文本绘图的框颜色，无需重新创建。只需在修改后使用[TextDrawShowForPlayer](TextDrawShowForPlayer)/[TextDrawShowForAll](TextDrawShowForAll)即可立即生效。 +如果你想更改已显示的文本绘图的框颜色，无需重新创建。只需在修改后使用[TextDrawShowForPlayer](TextDrawShowForPlayer)/[TextDrawShowForAll](TextDrawShowForAll)即可立即生效。 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawBoxColour.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawBoxColour.md index 46cb5ba58c9..97e6339c047 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawBoxColour.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawBoxColour.md @@ -11,14 +11,14 @@ tags: ["文本绘图"] 调整文本绘图的方框颜色（仅在 TextDrawUseBox 的 'enableBox' 参数设置为 'true' 时生效）。 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------- | ---------------------------------------------------------------------------------------------------------------------- | | Text:textid | 需要修改的文本绘图 | | boxColour | 方框颜色。透明度由颜色的 alpha 通道决定（例如 0x000000FF 表示完全不透明的黑色方框，0x000000AA 表示半透明的黑色方框）。 | ## 返回值 -该函数没有特定返回值。 +此函数不返回特定值。 ## 示例 @@ -57,7 +57,7 @@ public OnGameModeInit() - [TextDrawSetProportional](TextDrawSetProportional): 启用文本字符的比例间距 - [TextDrawUseBox](TextDrawUseBox): 控制文本绘图方框的显示开关 - [TextDrawSetString](TextDrawSetString): 修改现有文本绘图的文字内容 -- [玩家文本绘图显示](TextDrawShowForPlayer): 向指定玩家显示文本绘图 +- [TextDrawShowForPlayer](TextDrawShowForPlayer): 向指定玩家显示文本绘图 - [TextDrawShowForPlayer](TextDrawHideForPlayer): 对指定玩家隐藏文本绘图 - [TextDrawShowForAll](TextDrawShowForAll): 向所有在线玩家显示文本绘图 - [TextDrawHideForAll](TextDrawHideForAll): 全局隐藏指定文本绘图 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawColor.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawColor.md index 0b851583864..b336a3fafe7 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawColor.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawColor.md @@ -9,14 +9,14 @@ tags: ["文本绘图"] 设置文本绘图的文字颜色 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------- | ------------------------------- | | Text:textid | 需要修改颜色的文本绘图 ID | | textColour | 要设置的文字颜色值（RGBA 格式） | ## 返回值 -该函数不返回任何特定值 +此函数不返回特定值 ## 示例 @@ -35,7 +35,7 @@ public OnGameModeInit() :::tip -若文本绘图已显示，必须重新显示（[TextDrawShowForAll](TextDrawShowForAll)/[TextDrawShowForPlayer](TextDrawShowForPlayer)）才能使本函数修改生效 +若文本绘图已显示，必须重新显示（[TextDrawShowForAll](TextDrawShowForAll)/[TextDrawShowForPlayer](TextDrawShowForPlayer)）才能使此函数修改生效 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawColour.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawColour.md index 308a14edfe2..955400b91ba 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawColour.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawColour.md @@ -11,14 +11,14 @@ tags: ["文本绘图"] 设置文本绘图的文字颜色 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------- | ------------------------------- | | Text:textid | 需要修改颜色的文本绘图 ID | | textColour | 要设置的文字颜色值（RGBA 格式） | ## 返回值 -该函数不返回任何特定值 +此函数不返回特定值 ## 示例 @@ -37,7 +37,7 @@ public OnGameModeInit() :::tip -若文本绘图已显示，必须重新显示（[TextDrawShowForAll](TextDrawShowForAll)/[TextDrawShowForPlayer](TextDrawShowForPlayer)）才能使本函数修改生效 +若文本绘图已显示，必须重新显示（[TextDrawShowForAll](TextDrawShowForAll)/[TextDrawShowForPlayer](TextDrawShowForPlayer)）才能使此函数修改生效 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawCreate.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawCreate.md index 30754e623bb..8721112d37f 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawCreate.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawCreate.md @@ -9,7 +9,7 @@ tags: ["文本绘图"] 创建文本绘图。文本绘图（正如其名）是绘制在玩家屏幕上的文字元素（主要形式），也可包含方框、精灵和模型预览（皮肤/车辆/武器/物体等）。详见[文本绘图专题页面](../resources/textdrawsprites)获取详细信息。 -| 参数名 | 说明 | +| 参数 | 说明 | | ---------------- | --------------------------------------------- | | Float:x | 文本绘图的横向坐标（基于 640x480 基准坐标系） | | Float:y | 文本绘图的纵向坐标（基于 640x480 基准坐标系） | @@ -49,7 +49,7 @@ public OnPlayerConnect(playerid) - `x, y`坐标基于 640x480 虚拟画布定位（与屏幕分辨率无关），表示文本区域左上角坐标 - 若使用[TextDrawAlignment](TextDrawAlignment)设置右对齐（`TEXT_DRAW_ALIGN_RIGHT`），`x, y`将作为文本区域的右上角坐标 -- 本函数仅创建文本绘图，需调用[TextDrawShowForPlayer](TextDrawShowForPlayer)或[TextDrawShowForAll](TextDrawShowForAll)方可显示 +- 此函数仅创建文本绘图，需调用[TextDrawShowForPlayer](TextDrawShowForPlayer)或[TextDrawShowForAll](TextDrawShowForAll)方可显示 - 建议使用整数值而非小数坐标，以确保不同分辨率下的显示兼容性 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawDestroy.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawDestroy.md index 9fcd67720e4..00e98ceb628 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawDestroy.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawDestroy.md @@ -9,13 +9,13 @@ tags: ["文本绘图"] 销毁先前创建的文本绘图。 -| 名称 | 说明 | +| 参数 | 说明 | | ----------- | --------------------------------------------- | | Text:textid | 需要销毁的文本绘图 ID，由 TextDrawCreate 返回 | ## 返回值 -该函数不返回任何特定值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawFont.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawFont.md index abb997c37f9..247a5a89539 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawFont.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawFont.md @@ -9,9 +9,9 @@ tags: ["文本绘图"] 更改文本绘图的字体样式 -| 参数名 | 说明 | -| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Text:textid | 需要修改的文本绘图 ID | +| 参数 | 说明 | +| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Text:textid | 需要修改的文本绘图 ID | | TEXT_DRAW_FONT:font | SA-MP 提供四种字体样式选择机制：1. ​**字体值 4** 表示使用 txd 精灵图字体 2. ​**字体值 5** 用于 3D 模型预览显示功能 3. ​**字体值 >5** 时文本内容将不可见 4. ​**字体值 >16** 会导致客户端程序崩溃 | 可用样式预览： @@ -22,7 +22,7 @@ tags: ["文本绘图"] ## 返回值 -该函数不返回任何特定值 +此函数不返回特定值 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetAlignment.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetAlignment.md index 7ebb14b280d..ead4ac83d59 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetAlignment.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetAlignment.md @@ -11,7 +11,7 @@ tags: ["文本绘图"] 获取文本绘图的文本对齐方式。 -| 名称 | 说明 | +| 参数 | 说明 | | ----------- | ----------------------------- | | Text:textid | 需要获取对齐方式的文本绘图 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetBackgroundColor.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetBackgroundColor.md index 684d08ea11e..6971fdb0340 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetBackgroundColor.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetBackgroundColor.md @@ -11,7 +11,7 @@ tags: ["文本绘图"] 获取指定文本绘图的背景颜色 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------- | ----------------------------- | | Text:textid | 需要获取背景颜色的文本绘图 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetBackgroundColour.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetBackgroundColour.md index 918846d2010..fcd1529ae58 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetBackgroundColour.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetBackgroundColour.md @@ -11,7 +11,7 @@ tags: ["文本绘图"] 获取指定文本绘图的背景颜色 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------- | ----------------------------- | | Text:textid | 需要获取背景颜色的文本绘图 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetBoxColor.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetBoxColor.md index 6b33c68a164..47e71583f59 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetBoxColor.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetBoxColor.md @@ -11,7 +11,7 @@ tags: ["文本绘图"] 获取文本绘图的文本框颜色。 -| 名称 | 说明 | +| 参数 | 说明 | | ----------- | ------------------------- | | Text:textid | 需要获取颜色的文本绘图 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetBoxColour.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetBoxColour.md index 4c047bf4540..34d9d6f840b 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetBoxColour.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetBoxColour.md @@ -11,7 +11,7 @@ tags: ["文本绘图"] 获取文本绘图方框的颜色值 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------- | ----------------------------- | | Text:textid | 需要获取方框颜色的文本绘图 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetColor.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetColor.md index 091d883f887..d6b45508d9f 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetColor.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetColor.md @@ -11,7 +11,7 @@ tags: ["文本绘图"] 获取文本绘图的字体颜色。 -| 名称 | 说明 | +| 参数 | 说明 | | ----------- | ------------------------- | | Text:textid | 需要获取颜色的文本绘图 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetColour.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetColour.md index f325428b143..4cb23376765 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetColour.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetColour.md @@ -11,7 +11,7 @@ tags: ["文本绘图"] 获取指定文本绘图的文字颜色 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------- | ----------------------------- | | Text:textid | 需要获取文字颜色的文本绘图 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetFont.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetFont.md index 8ae1a4546a8..fcff908efcd 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetFont.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetFont.md @@ -11,7 +11,7 @@ tags: ["文本绘图"] 获取文本绘图的字体样式 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------- | ------------------------- | | Text:textid | 需要获取字体的文本绘图 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetLetterSize.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetLetterSize.md index 40234fe04c7..6c23c1f6a33 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetLetterSize.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetLetterSize.md @@ -11,7 +11,7 @@ tags: ["文本绘图"] 获取字符的宽度和高度。 -| 名称 | 说明 | +| 参数 | 说明 | | ------------- | ------------------------------------ | | Text:textid | 需要获取字符尺寸的文本绘图 ID | | &Float:width | 用于存储宽度的浮点变量（按引用传递） | @@ -19,7 +19,7 @@ tags: ["文本绘图"] ## 返回值 -该函数不返回任何特定值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetOutline.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetOutline.md index 19c50c44113..1fb3a29f69d 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetOutline.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetOutline.md @@ -11,7 +11,7 @@ tags: ["文本绘图"] 获取文本绘图文字描边的厚度值 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------- | ----------------------------- | | Text:textid | 需要获取描边厚度的文本绘图 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetPos.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetPos.md index cf8fe736867..9ff6ee80cd4 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetPos.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetPos.md @@ -11,7 +11,7 @@ tags: ["文本绘图"] 获取文本绘图在屏幕中的坐标位置（X 轴与 Y 轴） -| 参数名 | 说明 | +| 参数 | 说明 | | ----------- | --------------------------------------- | | Text:textid | 需要获取位置的文本绘图 ID | | &Float:x | 用于存储 X 坐标的浮点变量（按引用传递） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetPreviewModel.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetPreviewModel.md index 1e4d5306d63..4c22cedeaad 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetPreviewModel.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetPreviewModel.md @@ -11,7 +11,7 @@ tags: ["文本绘图"] 获取 3D 预览文本绘图所使用的模型 ID -| 参数名 | 说明 | +| 参数 | 说明 | | ----------- | --------------------------------- | | Text:textid | 需要获取模型的 3D 预览文本绘图 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetPreviewRot.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetPreviewRot.md index 602741b49df..bb31a68e3d4 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetPreviewRot.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetPreviewRot.md @@ -11,7 +11,7 @@ tags: ["文本绘图"] 获取 3D 模型预览文本绘图的旋转角度与缩放比例 -| 参数名 | 说明 | +| 参数 | 说明 | | ---------------- | ----------------------------------------- | | Text:textid | 需要获取参数的 3D 模型预览文本绘图 ID | | &Float:rotationX | 存储 X 轴旋转角度的浮点变量（按引用传递） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetPreviewVehCol.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetPreviewVehCol.md index 819ef82ac5e..647b1edff5f 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetPreviewVehCol.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetPreviewVehCol.md @@ -11,7 +11,7 @@ tags: ["文本绘图"] 获取 3D 预览文本绘图的车辆颜色。 -| 名称 | 说明 | +| 参数 | 说明 | | ----------- | ---------------------------------- | | Text:textid | 需要获取车辆颜色的文本绘图 ID | | &colour1 | 用于存储主颜色的变量（按引用传递） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetPreviewVehicleColours.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetPreviewVehicleColours.md index e338958dbec..0b4bbaf2ba0 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetPreviewVehicleColours.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetPreviewVehicleColours.md @@ -11,7 +11,7 @@ tags: ["文本绘图"] 获取 3D 预览文本绘图所使用的车辆颜色参数 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------- | ------------------------------------ | | Text:textid | 需要获取配色的 3D 预览文本绘图 ID | | &colour1 | 用于存储车辆主色的变量（按引用传递） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetShadow.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetShadow.md index f27285c3ff9..ac0177e179c 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetShadow.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetShadow.md @@ -11,7 +11,7 @@ tags: ["文本绘图"] 获取文本绘图文字的阴影尺寸 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------- | ----------------------------- | | Text:textid | 需要获取阴影尺寸的文本绘图 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetString.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetString.md index c484a459f02..4c6cda738bc 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetString.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetString.md @@ -11,7 +11,7 @@ tags: ["文本绘图"] 获取指定文本绘图的文字内容 -| 参数名 | 说明 | +| 参数 | 说明 | | ---------------------------- | ------------------------------------ | | Text:textid | 需要获取文字的文本绘图 ID | | string[] | 存储文本内容的字符数组（按引用传递） | @@ -19,7 +19,7 @@ tags: ["文本绘图"] ## 返回值 -该函数没有特定返回值 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetTextSize.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetTextSize.md index 3d380660acc..dde40d84b8a 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetTextSize.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawGetTextSize.md @@ -11,7 +11,7 @@ tags: ["文本绘图"] 获取文本绘图的 X 轴和 Y 轴尺寸。 -| 名称 | 说明 | +| 参数 | 说明 | | ------------- | ------------------------------------ | | Text:textid | 需要获取尺寸的文本绘图 ID | | &Float:width | 用于存储宽度的浮点变量（按引用传递） | @@ -19,7 +19,7 @@ tags: ["文本绘图"] ## 返回值 -该函数不返回任何特定值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawHideForAll.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawHideForAll.md index 375799f7594..6680a962218 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawHideForAll.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawHideForAll.md @@ -9,13 +9,13 @@ tags: ["文本绘图"] 隐藏指定文本绘图对所有玩家的显示 -| 参数名 | 说明 | -| ----------- | ------------------------------------------------------------------------- | -| Text:textid | 需要隐藏的文本绘图 ID
该 ID 由[创建文本绘图](TextDrawCreate)函数返回 | +| 参数 | 说明 | +| ----------- | --------------------------------------------------------------------------- | +| Text:textid | 需要隐藏的文本绘图 ID
该 ID 由[TextDrawCreate](TextDrawCreate)函数返回 | ## 返回值 -该函数没有特定返回值 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawHideForPlayer.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawHideForPlayer.md index 66ec0507f9a..3fe7bf74828 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawHideForPlayer.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawHideForPlayer.md @@ -9,14 +9,14 @@ tags: ["玩家", "文本绘图"] 对指定玩家隐藏文本绘图。 -| 名称 | 说明 | +| 参数 | 说明 | | ----------- | ------------------------- | | playerid | 需要隐藏文本绘图的玩家 ID | | Text:textid | 需要隐藏的文本绘图 ID | ## 返回值 -该函数不返回任何特定值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawIsBox.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawIsBox.md index 9187f2429a7..a1b5da1c4fa 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawIsBox.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawIsBox.md @@ -13,7 +13,7 @@ tags: ["文本绘图"] ## 参数 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------- | --------------------- | | Text:textid | 需要检测的文本绘图 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawIsProportional.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawIsProportional.md index d2bc9e78af6..5ae0a4227b2 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawIsProportional.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawIsProportional.md @@ -13,7 +13,7 @@ tags: ["文本绘图"] ## 参数 -| 名称 | 说明 | +| 参数 | 说明 | | ----------- | --------------------- | | Text:textid | 需要检查的文本绘图 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawIsSelectable.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawIsSelectable.md index f6a0c731494..0ea46356060 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawIsSelectable.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawIsSelectable.md @@ -13,7 +13,7 @@ tags: ["文本绘图"] ## 参数说明 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------- | --------------------- | | Text:textid | 需要检测的文本绘图 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawLetterSize.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawLetterSize.md index 6d551c9760b..3b906a5b883 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawLetterSize.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawLetterSize.md @@ -9,7 +9,7 @@ tags: ["文本绘图"] 设置文本绘图中字符的宽度和高度比例 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------ | --------------------- | | Text:textid | 需要修改的文本绘图 ID | | Float:width | 单个字符的宽度比例 | @@ -17,7 +17,7 @@ tags: ["文本绘图"] ## 返回值 -该函数不返回任何特定值 +此函数不返回特定值 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawSetOutline.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawSetOutline.md index e394cbf7f09..fa175c82cac 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawSetOutline.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawSetOutline.md @@ -9,14 +9,14 @@ tags: ["文本绘图"] 设置文本绘图文本的描边粗细。可通过 TextDrawBackgroundColor 修改描边颜色。 -| 名称 | 说明 | +| 参数 | 说明 | | ----------- | ---------------------------------- | | Text:textid | 需要设置描边的文本绘图 ID | | outlineSize | 描边粗细（整数形式），0 表示无描边 | ## 返回值 -该函数不返回任何特定值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawSetPos.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawSetPos.md index 3532ad70d02..1242501c190 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawSetPos.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawSetPos.md @@ -11,7 +11,7 @@ tags: ["文本绘图"] 设置文本绘图在屏幕中的坐标位置（X 轴与 Y 轴） -| 参数名 | 说明 | +| 参数 | 说明 | | ----------- | ------------------------- | | Text:textid | 需要设置位置的文本绘图 ID | | Float:x | 浮点型 X 坐标值 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawSetPreviewModel.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawSetPreviewModel.md index 5b048bb0e7d..179675f39bd 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawSetPreviewModel.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawSetPreviewModel.md @@ -9,7 +9,7 @@ tags: ["文本绘图"] 设置用于文本绘图模型预览的 3D 模型。 -| 名称 | 描述 | +| 参数 | 说明 | | ----------- | ---------------------------------- | | Text:textid | 需要显示 3D 预览的文本绘图 ID。 | | model | 要显示的 GTA SA 或 SA:MP 模型 ID。 | @@ -50,7 +50,7 @@ public OnGameModeInit() :::warning -文本绘图必须使用`TEXT_DRAW_FONT_MODEL_PREVIEW`字体类型才能使本函数生效。 +文本绘图必须使用`TEXT_DRAW_FONT_MODEL_PREVIEW`字体类型才能使此函数生效。 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawSetPreviewRot.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawSetPreviewRot.md index c3dd057d420..18c15f1ce55 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawSetPreviewRot.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawSetPreviewRot.md @@ -9,17 +9,17 @@ tags: ["文本绘图"] 设置 3D 模型预览文本绘图的旋转角度和缩放比例。 -| 名称 | 描述 | -| --------------- | -------------------------------------------------------------------------------------- | -| Text:textid | 要更改的文本绘图 ID | -| Float:rotationX | X 轴旋转角度值 | -| Float:rotationY | Y 轴旋转角度值 | -| Float:rotationZ | Z 轴旋转角度值 | +| 参数 | 说明 | +| --------------- | ---------------------------------------------------------------------------------- | +| Text:textid | 要更改的文本绘图 ID | +| Float:rotationX | X 轴旋转角度值 | +| Float:rotationY | Y 轴旋转角度值 | +| Float:rotationZ | Z 轴旋转角度值 | | Float:zoom | 缩放值（默认 1.0），小于 1.0 的值会使视角更靠近模型，大于 1.0 的值会使视角远离模型 | ## 返回值 -该函数不返回特定值。 +此函数不返回特定值。 ## 示例 @@ -45,7 +45,7 @@ public OnGameModeInit() :::warning -文本绘图必须使用`TEXT_DRAW_FONT_MODEL_PREVIEW`字体类型且已设置预览模型，该函数才能生效。 +文本绘图必须使用`TEXT_DRAW_FONT_MODEL_PREVIEW`字体类型且已设置预览模型，此函数才能生效。 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawSetPreviewVehCol.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawSetPreviewVehCol.md index f7e1e102a77..9e6ccc19a40 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawSetPreviewVehCol.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawSetPreviewVehCol.md @@ -1,15 +1,15 @@ --- title: TextDrawSetPreviewVehCol sidebar_label: TextDrawSetPreviewVehCol -description: 若在3D预览文本绘图中使用车辆模型，本函数用于设置该车辆的两个颜色值。 +description: 若在3D预览文本绘图中使用车辆模型，此函数用于设置该车辆的两个颜色值。 tags: ["文本绘图"] --- ## 描述 -若在 3D 预览文本绘图中使用车辆模型，本函数用于设置该车辆的两个颜色值。 +若在 3D 预览文本绘图中使用车辆模型，此函数用于设置该车辆的两个颜色值。 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------- | ----------------------------------------- | | Text:textid | 已设置为显示 3D 车辆模型预览的文本绘图 ID | | colour1 | 车辆主颜色 ID | @@ -17,7 +17,7 @@ tags: ["文本绘图"] ## 返回值 -本函数不返回特定值。 +此函数不返回特定值。 ## 示例代码 @@ -43,7 +43,7 @@ public OnGameModeInit() :::warning -文本绘图必须使用字体类型`TEXT_DRAW_FONT_MODEL_PREVIEW`，否则本函数将无效。 +文本绘图必须使用字体类型`TEXT_DRAW_FONT_MODEL_PREVIEW`，否则此函数将无效。 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawSetPreviewVehicleColours.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawSetPreviewVehicleColours.md index 4ccf2416c15..096abe27d39 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawSetPreviewVehicleColours.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawSetPreviewVehicleColours.md @@ -11,7 +11,7 @@ tags: ["文本绘图"] 当 3D 预览文本绘图使用车辆模型时，设置该车辆的两个颜色值。 -| 名称 | 描述 | +| 参数 | 说明 | | ----------- | ----------------------------------------- | | Text:textid | 已设置为显示 3D 车辆模型预览的文本绘图 ID | | colour1 | 要设置的主颜色 ID | @@ -19,7 +19,7 @@ tags: ["文本绘图"] ## 返回值 -该函数不返回特定值。 +此函数不返回特定值。 ## 示例 @@ -45,7 +45,7 @@ public OnGameModeInit() :::warning -文本绘图必须使用`TEXT_DRAW_FONT_MODEL_PREVIEW`字体类型，该函数才能生效。 +文本绘图必须使用`TEXT_DRAW_FONT_MODEL_PREVIEW`字体类型，此函数才能生效。 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawSetProportional.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawSetProportional.md index b1e1e8ae5db..df0fdf04dce 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawSetProportional.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawSetProportional.md @@ -1,22 +1,22 @@ --- title: TextDrawSetProportional sidebar_label: TextDrawSetProportional -description: 该函数用于将文本间距按比例缩放。 +description: 此函数用于将文本间距按比例缩放。 tags: ["文本绘图"] --- ## 描述 -该函数用于将文本间距按比例缩放。当使用 TextDrawLetterSize 时特别有用，可确保字符间距均匀分布。 +此函数用于将文本间距按比例缩放。当使用 TextDrawLetterSize 时特别有用，可确保字符间距均匀分布。 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------------- | ----------------------------------- | | Text:textid | 需要设置比例缩放的文本绘图 ID | | bool:proportional | 设为'true'启用比例缩放，'false'禁用 | ## 返回值 -本函数不返回特定值。 +此函数不返回特定值。 ## 示例代码 @@ -35,7 +35,7 @@ public OnGameModeInit() :::tip -- 比例缩放默认启用（设为**true**），若不需要禁用可跳过本函数 +- 比例缩放默认启用（设为**true**），若不需要禁用可跳过此函数 - 修改已显示的文本绘图比例时无需重建，只需通过[TextDrawShowForPlayer](TextDrawShowForPlayer)/[TextDrawShowForAll](TextDrawShowForAll)刷新即可生效 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawSetSelectable.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawSetSelectable.md index 10c3146bc8e..ac2deee107a 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawSetSelectable.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawSetSelectable.md @@ -9,7 +9,7 @@ tags: ["文本绘图"] 设置文本绘图是否可被选中（点击） -| 名称 | 描述 | +| 参数 | 说明 | | --------------- | --------------------------------------- | | Text:textid | 需要设置可选中状态的文本绘图 ID。 | | bool:selectable | 'true'表示可选中，'false'表示不可选中。 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawSetShadow.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawSetShadow.md index 9a8e2c7a5c0..9fcbaeda417 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawSetShadow.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawSetShadow.md @@ -9,7 +9,7 @@ tags: ["文本绘图"] 设置文本绘图中文本阴影的大小。 -| 名称 | 描述 | +| 参数 | 说明 | | ----------- | ------------------------------------------------------- | | Text:textid | 要设置阴影大小的文本绘图 ID | | shadowSize | 阴影的大小。通常 1 表示标准阴影尺寸，0 表示完全禁用阴影 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawSetString.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawSetString.md index 80f50782164..a3f2eb6bc80 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawSetString.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawSetString.md @@ -9,7 +9,7 @@ tags: ["文本绘图"] 修改文本绘图中的文字内容。 -| 名称 | 描述 | +| 参数 | 说明 | | ---------------- | ---------------------------------- | | Text:textid | 需要修改的文本绘图 ID | | const format[] | 新的字符串内容 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawSetStringForPlayer.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawSetStringForPlayer.md index 115243d40bb..124293dab70 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawSetStringForPlayer.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawSetStringForPlayer.md @@ -11,7 +11,7 @@ tags: ["文本绘图"] 为特定玩家动态修改文本绘图显示内容。 -| 参数名 | 说明 | +| 参数 | 说明 | | ---------------- | ---------------------- | | Text:textid | 需修改的文本绘图 ID | | playerid | 目标玩家 ID | @@ -20,7 +20,7 @@ tags: ["文本绘图"] ## 返回值 -本函数不返回特定值。 +此函数不返回特定值。 ## 示例代码 @@ -55,7 +55,7 @@ public OnPlayerConnect(playerid) public OnPlayerRequestClass(playerid, classid) { - TextDrawSetStringForPlayer(gMyTextdraw, playerid, "您选择了%d号职业", classid); + TextDrawSetStringForPlayer(gMyTextdraw, playerid, "你选择了%d号职业", classid); return 1; } ``` diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawShowForAll.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawShowForAll.md index 877e89b3f3e..ff44d136ffa 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawShowForAll.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawShowForAll.md @@ -9,7 +9,7 @@ tags: ["文本绘图"] 为所有玩家显示指定的文本绘图。 -| 名称 | 描述 | +| 参数 | 说明 | | ----------- | ----------------------------------------------------------------------------- | | Text:textid | 需要显示的文本绘图 ID
由[TextDrawCreate](TextDrawCreate)函数创建时返回。 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawShowForPlayer.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawShowForPlayer.md index 55f58f8522b..6ff11a71a91 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawShowForPlayer.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawShowForPlayer.md @@ -9,7 +9,7 @@ tags: ["玩家", "文本绘图"] 为特定玩家显示文本绘图。 -| 名称 | 描述 | +| 参数 | 说明 | | ----------- | ------------------------------------------------------------------- | | playerid | 要显示文本绘图的玩家 ID | | Text:textid | 要显示的文本绘图 ID
由[TextDrawCreate](TextDrawCreate)创建返回 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawTextSize.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawTextSize.md index 98377969072..fe1209f3447 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawTextSize.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawTextSize.md @@ -9,7 +9,7 @@ tags: ["文本绘图"] 调整文本绘图的尺寸（当启用[TextDrawUseBox](TextDrawUseBox)时控制文本框大小，或配合[TextDrawSetSelectable](TextDrawSetSelectable)定义可点击区域）。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------------ | --------------------------------------------------------------------- | | Text:textid | 需要调整尺寸的文本绘图 ID | | Float:width | X 轴尺寸（左右方向），使用与 TextDrawCreate 相同的 640x480 网格坐标系 | @@ -17,7 +17,7 @@ tags: ["文本绘图"] ## 返回值 -本函数不返回特定值。 +此函数不返回特定值。 ## 示例代码 @@ -37,15 +37,15 @@ public OnGameModeInit() :::tip - 不同 TextDrawAlignment 值对坐标系的解释差异： -1（左对齐）：参数值为文本框右侧边界的绝对坐标 -2（居中对齐）：需交换 X/Y 参数顺序，X 值代表整体宽度 -3（右对齐）：参数值为文本框左侧边界的绝对坐标 + 1（左对齐）：参数值为文本框右侧边界的绝对坐标 + 2（居中对齐）：需交换 X/Y 参数顺序，X 值代表整体宽度 + 3（右对齐）：参数值为文本框左侧边界的绝对坐标 -- 使用 4 号字体（精灵）和 5 号字体（模型预览）时，本函数参数将转换为宽高偏移量 +- 使用 4 号字体（精灵）和 5 号字体（模型预览）时，此函数参数将转换为宽高偏移量 - 文本框坐标系原点（TextDrawCreate 设定坐标）向左偏移 5.0 单位，向上偏移 10.0 单位 -- 本函数定义的可点击区域在启用 TextDrawSetSelectable 时生效，无论是否显示文本框 +- 此函数定义的可点击区域在启用 TextDrawSetSelectable 时生效，无论是否显示文本框 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawUseBox.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawUseBox.md index 78e8c5d0dae..810befea4cc 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawUseBox.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TextDrawUseBox.md @@ -9,7 +9,7 @@ tags: ["文本绘图"] 控制文本绘图是否显示背景文本框。 -| 参数名 | 说明 | +| 参数 | 说明 | | -------------- | --------------------------------- | | Text:textid | 需操作的文本绘图 ID | | bool:enableBox | 设为'true'启用文本框，'false'禁用 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ToggleChatTextReplacement.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ToggleChatTextReplacement.md index 925cd44b518..86eed0ce2dc 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ToggleChatTextReplacement.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ToggleChatTextReplacement.md @@ -13,13 +13,13 @@ tags: [] 禁用后可允许在聊天中使用%等特殊字符。 -| 名称 | 描述 | +| 参数 | 说明 | | ----------- | ----------------------------------- | | bool:enable | 'true'启用过滤器，'false'禁用过滤器 | ## 返回值 -此函数不返回任何特定值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TogglePlayerClock.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TogglePlayerClock.md index 54b7eed2ddb..bc5528129a6 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TogglePlayerClock.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TogglePlayerClock.md @@ -9,7 +9,7 @@ tags: ["玩家"] 切换指定玩家的游戏内时钟显示（位于右上角）。启用后，游戏时间将以每分钟对应现实一秒的速度推进。使用[SetWeather](SetWeather)/[SetPlayerWeather](SetPlayerWeather)设置天气时，天气效果将呈现渐变过渡。 -| 名称 | 描述 | +| 参数 | 说明 | | ----------- | ----------------------------------------------- | | playerid | 需要启用/禁用时钟的玩家 ID | | bool:toggle | 显示时钟设为'true'，隐藏设为'false'（默认隐藏） | @@ -43,4 +43,4 @@ public OnPlayerConnect(playerid) - [GetPlayerTime](GetPlayerTime): 获取玩家的当前时间 - [SetPlayerTime](SetPlayerTime): 设置玩家的个性化时间 -- [SetWorldTime](SetWorldTime): 设置服务器全局时间 +- [SetWorldTime](SetWorldTime): 设置服务器全局世界时间 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TogglePlayerControllable.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TogglePlayerControllable.md index c29e5773acb..ec5479a71e2 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TogglePlayerControllable.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TogglePlayerControllable.md @@ -9,7 +9,7 @@ tags: ["玩家"] 切换玩家是否能够控制其角色。该操作同时会禁用视角转动功能。 -| 名称 | 描述 | +| 参数 | 说明 | | ----------------- | ------------------------------- | | playerid | 需要设置控制状态的玩家 ID | | bool:controllable | 'false'禁用控制，'true'启用控制 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TogglePlayerGhostMode.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TogglePlayerGhostMode.md index 56977d4d8e2..01a42ecf035 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TogglePlayerGhostMode.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TogglePlayerGhostMode.md @@ -11,14 +11,14 @@ tags: ["玩家"] 切换玩家的幽灵模式状态。该模式启用后将禁用玩家模型之间的物理碰撞。 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------- | ----------------------------------- | | playerid | 需切换模式的玩家 ID | | bool:toggle | 设为'true'启用幽灵模式，'false'禁用 | ## 返回值 -本函数始终返回 true（真值）。 +此函数始终返回 true（真值）。 ## 示例代码 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TogglePlayerSpectating.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TogglePlayerSpectating.md index 34af42eb444..ad75bf8b124 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TogglePlayerSpectating.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TogglePlayerSpectating.md @@ -9,7 +9,7 @@ tags: ["玩家"] 切换玩家是否处于观察者模式。在该模式下可观察其他玩家或车辆，使用后需配合[PlayerSpectatePlayer](PlayerSpectatePlayer)或[PlayerSpectateVehicle](PlayerSpectateVehicle)实现观察功能。 -| 名称 | 描述 | +| 参数 | 说明 | | ----------- | ------------------------------- | | playerid | 需要设置观察模式的玩家 ID | | bool:toggle | 'true'启用观察模式，'false'禁用 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TogglePlayerWidescreen.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TogglePlayerWidescreen.md index fe282d96644..6e819a57205 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TogglePlayerWidescreen.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/TogglePlayerWidescreen.md @@ -11,7 +11,7 @@ tags: ["玩家"] 动态切换玩家的宽屏显示状态，控制游戏画面比例。 -| 参数名 | 说明 | +| 参数 | 说明 | | --------- | ----------------------------------------------- | | playerid | 需操作的玩家 ID | | bool:wide | 设为**true**启用宽屏模式，**false**恢复默认比例 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ToggleVehicleSirenEnabled.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ToggleVehicleSirenEnabled.md index deb4a8dd021..1886d30757e 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ToggleVehicleSirenEnabled.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ToggleVehicleSirenEnabled.md @@ -1,7 +1,7 @@ --- title: ToggleVehicleSirenEnabled sidebar_label: ToggleVehicleSirenEnabled -description: 切换车辆警笛的启用状态。 +description: 切换车辆警报器的启用状态。 tags: ["车辆"] --- @@ -9,11 +9,11 @@ tags: ["车辆"] ## 描述 -切换车辆警笛的启用状态。 +切换车辆警报器的启用状态。 ## 参数 -| 名称 | 描述 | +| 参数 | 说明 | | ------------ | -------------------------------- | | vehicleid | 目标车辆的 ID | | bool:enabled | **true**: 启用 - **false**: 禁用 | @@ -26,5 +26,5 @@ ToggleVehicleSirenEnabled(vehicleid, true); ## 相关函数 -- [GetVehicleSirenState](GetVehicleSirenState): 获取车辆的警笛状态 -- [GetPlayerSirenState](GetPlayerSirenState): 获取玩家所在车辆的警笛状态 +- [GetVehicleSirenState](GetVehicleSirenState): 获取车辆的警报器状态 +- [GetPlayerSirenState](GetPlayerSirenState): 获取玩家所在车辆的警报器状态 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/UnBlockIpAddress.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/UnBlockIpAddress.md index 333f14cf45f..f47bf06ee08 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/UnBlockIpAddress.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/UnBlockIpAddress.md @@ -9,7 +9,7 @@ tags: ["管理", "IP地址"] 解除通过[BlockIpAddress](BlockIpAddress)封禁的 IP 地址。 -| 名称 | 描述 | +| 参数 | 说明 | | ----------------- | ---------------------- | | const ipAddress[] | 需要解除封禁的 IP 地址 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Update3DTextLabelText.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Update3DTextLabelText.md index dda6452e330..4d6a3331ba1 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Update3DTextLabelText.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/Update3DTextLabelText.md @@ -9,7 +9,7 @@ tags: ["3D文本标签"] 动态修改已创建的 3D 文本标签显示内容及颜色配置。 -| 参数名 | 说明 | +| 参数 | 说明 | | ---------------- | ------------------------------------ | | Text3D:textid | 需要更新的 3D 文本标签 ID | | colour | 新的 ARGB 颜色值（格式：0xAARRGGBB） | @@ -18,7 +18,7 @@ tags: ["3D文本标签"] ## 返回值 -本函数不返回特定值。 +此函数不返回特定值。 ## 示例代码 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/UpdatePlayer3DTextLabelText.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/UpdatePlayer3DTextLabelText.md index e0928ae3e8c..cae609ade88 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/UpdatePlayer3DTextLabelText.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/UpdatePlayer3DTextLabelText.md @@ -9,7 +9,7 @@ tags: ["玩家", "3D文本标签"] 更新指定玩家 3D 文本标签的文本内容及颜色。 -| 名称 | 描述 | +| 参数 | 说明 | | ------------------- | -------------------------------------------- | | playerid | 创建该 3D 文本标签的玩家 ID | | PlayerText3D:textid | 需要更新的 3D 文本标签 ID | @@ -19,7 +19,7 @@ tags: ["玩家", "3D文本标签"] ## 返回值 -该函数不返回特定值。 +此函数不返回特定值。 ## 注意事项 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/UpdateVehicleDamageStatus.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/UpdateVehicleDamageStatus.md index 20415cb3d17..c0f46ef5550 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/UpdateVehicleDamageStatus.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/UpdateVehicleDamageStatus.md @@ -15,7 +15,7 @@ tags: ["车辆"] 设置车辆的各类视觉损坏状态，包括爆胎、车灯破损和车身面板损伤。 -| 名称 | 描述 | +| 参数 | 说明 | | --------------------------- | ------------------------- | | vehicleid | 需要设置损坏状态的车辆 ID | | VEHICLE_PANEL_STATUS:panels | 包含面板损坏状态的位集合 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/UseGangZoneCheck.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/UseGangZoneCheck.md index 08d1db1a700..edb8a868701 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/UseGangZoneCheck.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/UseGangZoneCheck.md @@ -11,7 +11,7 @@ tags: ["玩家", "帮派区域"] 启用当玩家进入/离开指定帮派区域时的回调触发功能。 -| 名称 | 描述 | +| 参数 | 说明 | | ----------- | ---------------------------------------------- | | zoneid | 需要启用区域检测的帮派区域 ID | | bool:enable | 是否启用区域检测功能（`true`启用/`false`停用） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/UsePlayerGangZoneCheck.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/UsePlayerGangZoneCheck.md index 42f8dcf7d47..32247fb9d39 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/UsePlayerGangZoneCheck.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/UsePlayerGangZoneCheck.md @@ -2,7 +2,7 @@ title: UsePlayerGangZoneCheck sidebar_label: UsePlayerGangZoneCheck description: 启用玩家进出区域时的回调触发 -tags: ["玩家", "帮派区域", "玩家专属帮派区域"] +tags: ["玩家", "帮派区域", "玩家帮派区域"] --- @@ -11,7 +11,7 @@ tags: ["玩家", "帮派区域", "玩家专属帮派区域"] 启用当玩家进入/离开指定区域时的回调触发。 -| 名称 | 描述 | +| 参数 | 说明 | | ----------- | --------------------------------- | | playerid | 需要启用区域检测的玩家 ID | | zoneid | 需要启用检测的玩家专属帮派区域 ID | @@ -44,7 +44,7 @@ public OnPlayerEnterPlayerGangZone(playerid, zoneid) if (zoneid == gGangZoneID[playerid]) { new string[64]; - format(string, sizeof(string), "您正在进入玩家专属帮派区域 %i", zoneid); + format(string, sizeof(string), "你正在进入玩家专属帮派区域 %i", zoneid); SendClientMessage(playerid, 0xFFFFFFFF, string); } return 1; @@ -55,7 +55,7 @@ public OnPlayerLeavePlayerGangZone(playerid, zoneid) if (zoneid == gGangZoneID[playerid]) { new string[64]; - format(string, sizeof(string), "您正在离开玩家专属帮派区域 %i", zoneid); + format(string, sizeof(string), "你正在离开玩家专属帮派区域 %i", zoneid); SendClientMessage(playerid, 0xFFFFFFFF, string); } return 1; @@ -64,14 +64,14 @@ public OnPlayerLeavePlayerGangZone(playerid, zoneid) ## 相关回调 -以下回调函数与此功能相关： +以下回调函数与此函数相关： - [OnPlayerEnterPlayerGangZone](../callbacks/OnPlayerEnterPlayerGangZone): 玩家进入专属帮派区域时触发 - [OnPlayerLeavePlayerGangZone](../callbacks/OnPlayerLeavePlayerGangZone): 玩家离开专属帮派区域时触发 ## 相关函数 -以下函数与此功能相关： +以下函数与此函数相关： - [CreatePlayerGangZone](CreatePlayerGangZone): 创建玩家专属帮派区域 - [PlayerGangZoneDestroy](PlayerGangZoneDestroy): 销毁玩家专属帮派区域 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/UsePlayerPedAnims.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/UsePlayerPedAnims.md index b49275e2729..7bceb800bf6 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/UsePlayerPedAnims.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/UsePlayerPedAnims.md @@ -23,7 +23,7 @@ public OnGameModeInit() :::tip -- 本函数必须置于[OnGameModeInit](../callbacks/OnGameModeInit)回调中才能生效 +- 此函数必须置于[OnGameModeInit](../callbacks/OnGameModeInit)回调中才能生效 - 未启用时，部分双手持武器（非双持武器）可能错误显示为单手持握状态 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/VectorSize.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/VectorSize.md index 6f5ba94bdc1..bd83fb1d8ff 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/VectorSize.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/VectorSize.md @@ -9,7 +9,7 @@ tags: ["数学"] 返回指定向量的范数（长度）。 -| 名称 | 说明 | +| 参数 | 说明 | | ------- | ------------------- | | Float:x | 向量在 X 轴的分量值 | | Float:y | 向量在 Y 轴的分量值 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/VehicleCanHaveComponent.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/VehicleCanHaveComponent.md index 42c9debcff1..652f408784a 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/VehicleCanHaveComponent.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/VehicleCanHaveComponent.md @@ -11,7 +11,7 @@ tags: ["车辆"] 检测指定车辆组件是否可合法安装在特定车辆模型上。 -| 参数名 | 说明 | +| 参数 | 说明 | | ---------------------------------------- | --------------- | | [modelid](../resources/vehicleid) | 车辆模型 ID | | [component](../resources/carcomponentid) | 待检测的组件 ID | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/VehicleColourIndexToColour.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/VehicleColourIndexToColour.md index bf93d718245..7b79f08ded1 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/VehicleColourIndexToColour.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/VehicleColourIndexToColour.md @@ -13,7 +13,7 @@ tags: ["车辆"] ## 参数 -| 名称 | 描述 | +| 参数 | 说明 | | ------------ | ------------------------------------------- | | index | [车辆颜色索引](../resources/vehiclecolorid) | | alpha = 0xFF | Alpha 通道（默认值为 0xFF） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/acos.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/acos.md index d359c5c7f05..d409a029019 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/acos.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/acos.md @@ -11,7 +11,7 @@ tags: ["数学"] 获取余弦值的反函数角度（以度为单位）。在三角函数中，反余弦是余弦的逆运算。 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------- | ----------------------------------------- | | Float:value | 需要计算反余弦的数值，取值范围为[-1,+1]。 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/argindex.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/argindex.md index e16223d5a0c..a3d80f5cbc8 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/argindex.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/argindex.md @@ -9,7 +9,7 @@ tags: ["参数", "命令行参数"] 获取通过双破折号(--)传递的指定索引位置的参数名称。 -| 参数名 | 说明 | +| 参数 | 说明 | | --------------------- | --------------------------------- | | index | 基于零的偏移索引（从 0 开始计数） | | value[] | 用于存储参数名称的字符串缓冲区 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/argstr.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/argstr.md index d427e7b34da..a3aedfa43cc 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/argstr.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/argstr.md @@ -9,10 +9,10 @@ tags: ["参数", "命令行参数"] 根据参数名称获取对应的字符串值。 -| 参数名 | 说明 | +| 参数 | 说明 | | --------------------- | -------------------------------- | | skip = 0 | 需要跳过的同名参数数量（默认 0） | -| const argument[] = "" | 参数名称（包含`-`或`/`前缀） | +| const argument[] = "" | 参数称（包含`-`或`/`前缀） | | value[] = "" | 存储参数值的字符串缓冲区 | | size = sizeof (value) | 目标缓冲区容量 | | bool:pack = false | 是否对返回值进行打包 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/argvalue.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/argvalue.md index afb39d61d12..8b7734945cf 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/argvalue.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/argvalue.md @@ -9,10 +9,10 @@ tags: ["参数", "命令行参数"] 获取通过双破折号(--)传递的数值类型参数值。 -| 参数名 | 说明 | +| 参数 | 说明 | | --------------------- | ------------------------------------------------- | | skip = 0 | 需要跳过的同名参数数量（默认 0） | -| const argument[] = "" | 参数名称（包含`-`或`/`前缀） | +| const argument[] = "" | 参数称（包含`-`或`/`前缀） | | &value = cellmin | 存储参数值的整型变量（默认 cellmin 表示未初始化） | ## 返回值 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/asin.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/asin.md index 6dcff8a77a9..ab8752d895a 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/asin.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/asin.md @@ -11,7 +11,7 @@ tags: ["数学"] 计算指定正弦值的反正弦角度（以度为单位）。在三角函数中，反正弦是正弦的逆运算。 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------- | ---------------------------------------- | | Float:value | 需要计算反正弦值的数值，取值范围[-1, +1] | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/atan.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/atan.md index fae0bbf2a02..600df0fa909 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/atan.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/atan.md @@ -9,9 +9,9 @@ tags: ["数学"] ## 描述 -计算指定正切值的单值反正切角度（以度为单位）。在三角函数中，反正切是正切的逆运算。注意由于符号歧义，本函数无法单独确定角度所在象限。建议需要精确判断时使用[atan2](多值反正切)函数。 +计算指定正切值的单值反正切角度（以度为单位）。在三角函数中，反正切是正切的逆运算。注意由于符号歧义，此函数无法单独确定角度所在象限。建议需要精确判断时使用[atan2](多值反正切)函数。 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------- | ---------------------- | | Float:value | 需要计算反正切值的数值 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/atan2.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/atan2.md index 7c8e40978c7..3a48b97715f 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/atan2.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/atan2.md @@ -15,7 +15,7 @@ tags: ["数学"] ## 描述 -计算基于两个坐标值的多值反正切角度（以度为单位）。本函数通过考虑 x 和 y 的符号来精确判断角度所在的象限。 +计算基于两个坐标值的多值反正切角度（以度为单位）。此函数通过考虑 x 和 y 的符号来精确判断角度所在的象限。 | 参数名 | 说明 | | ------- | --------------------- | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/clamp.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/clamp.md index 342f3d522f3..32afe15e7cb 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/clamp.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/clamp.md @@ -2,7 +2,7 @@ title: clamp sidebar_label: clamp description: 将数值强制限制在指定范围内 -tags: ["核心功能"] +tags: ["核心"] --- @@ -11,11 +11,11 @@ tags: ["核心功能"] 将输入的数值强制限制在指定的区间范围内 -| 参数名 | 说明 | -| ------ | --------------------------------------- | -| value | 需要限制范围的数值 | -| min | 区间下限值（可选参数，默认值：cellmin） | -| max | 区间上限值（可选参数，默认值：cellmax） | +| 参数 | 说明 | +| ----- | --------------------------------------- | +| value | 需要限制范围的数值 | +| min | 区间下限值（可选参数，默认值：cellmin） | +| max | 区间上限值（可选参数，默认值：cellmax） | ## 返回值 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_close.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_close.md index fbc0cfb02f7..27d2b23c81f 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_close.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_close.md @@ -2,8 +2,6 @@ title: db_close sidebar_label: db_close description: 关闭通过`db_open`打开的SQLite数据库连接。 -keywords: - - sqlite tags: ["sqlite"] --- @@ -13,9 +11,9 @@ tags: ["sqlite"] 关闭通过[db_open](db_open)建立的 SQLite 数据库连接。 -| 参数名 | 说明 | -| ------ | -------------------------------------------------- | -| DB:db | 要关闭的数据库连接句柄（由[db_open](db_open)返回） | +| 参数 | 说明 | +| ----- | -------------------------------------------------- | +| DB:db | 要关闭的数据库连接句柄（由[db_open](db_open)返回） | ## 返回值 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_debug_openfiles.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_debug_openfiles.md index ad98ce50177..a8d30d67d55 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_debug_openfiles.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_debug_openfiles.md @@ -2,18 +2,23 @@ title: db_debug_openfiles sidebar_label: db_debug_openfiles description: 调试用-获取已打开的数据库连接数量。 -keywords: - - sqlite +tags: ["sqlite"] --- +:::warning + +此函数已弃用，请使用 [DB_GetDatabaseConnectionCount](DB_GetDatabaseConnectionCount)。 + +::: + ## 描述 此函数用于调试目的，获取当前已打开的数据库连接数量。 -| 参数名 | 说明 | -| ------ | ---- | +| 参数 | 说明 | +| ---- | ---- | ## 相关函数 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_debug_openresults.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_debug_openresults.md index a3227f3139f..4c19ac69ed5 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_debug_openresults.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_debug_openresults.md @@ -2,18 +2,23 @@ title: db_debug_openresults sidebar_label: db_debug_openresults description: 调试用-获取已打开的数据库查询结果数量 -keywords: - - sqlite +tags: ["sqlite"] --- +:::warning + +此函数已弃用，请使用 [DB_GetDatabaseResultSetCount](DB_GetDatabaseResultSetCount)。 + +::: + ## 描述 此函数用于调试目的，获取当前已打开的数据库查询结果数量。 -| 参数名 | 说明 | -| ------ | ---- | +| 参数 | 说明 | +| ---- | ---- | ## 相关函数 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_field_name.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_field_name.md index 22e28111df7..4d9cd2a883e 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_field_name.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_field_name.md @@ -2,17 +2,22 @@ title: db_field_name sidebar_label: db_field_name description: 返回指定索引处的字段名称。 -keywords: - - sqlite +tags: ["sqlite"] --- +:::warning + +此函数已弃用，请使用 [DB_GetFieldName](DB_GetFieldName)。 + +::: + ## 描述 通过字段索引获取查询结果中的字段名称。 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------------- | ------------------------------------------ | | DBResult:dbresult | 查询结果句柄（由[db_query](db_query)返回） | | field | 要获取的字段索引（从 0 开始） | @@ -36,6 +41,7 @@ public OnGameModeInit() // 建立数据库连接 gDBConnectionHandle = db_open("example.db"); + // 检测数据库连接状态 if (gDBConnectionHandle) { // 从'join_log'表中选择第一条记录 @@ -74,7 +80,8 @@ public OnGameModeExit() // 关闭数据库连接 if (db_close(gDBConnectionHandle)) { - gDBConnectionHandle = DB:0; // 重置句柄 + // 重置句柄 + gDBConnectionHandle = DB:0; } return 1; } diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_free_result.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_free_result.md index df5b2ee05c7..b89807eda6e 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_free_result.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_free_result.md @@ -2,17 +2,22 @@ title: db_free_result sidebar_label: db_free_result description: 释放由db_query分配的查询结果内存。 -keywords: - - sqlite +tags: ["sqlite"] --- +:::warning + +此函数已弃用，请使用 [DB_FreeResultSet](DB_FreeResultSet)。 + +::: + ## 描述 释放由[db_query](db_query)分配的查询结果内存。 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------------- | -------------------------------------------------- | | DBResult:dbresult | 要释放的查询结果句柄（由[db_query](db_query)分配） | @@ -58,6 +63,7 @@ public OnGameModeInit() // 建立数据库连接 gDBConnectionHandle = db_open("example.db"); + // 检测数据库连接状态 if (gDBConnectionHandle) { print("成功连接数据库 \"example.db\""); @@ -76,7 +82,8 @@ public OnGameModeExit() // 关闭数据库连接 if (db_close(gDBConnectionHandle)) { - gDBConnectionHandle = DB:0; // 重置句柄 + // 重置句柄 + gDBConnectionHandle = DB:0; } return 1; } diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_get_field.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_get_field.md index 2694de26cdb..49dec3565dd 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_get_field.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_get_field.md @@ -2,17 +2,22 @@ title: db_get_field sidebar_label: db_get_field description: 从db_query结果中获取字段内容 -keywords: - - sqlite +tags: ["sqlite"] --- +:::warning + +此函数已弃用，请使用 [DB_GetFieldString](DB_GetFieldString)。 + +::: + ## 描述 从[db_query](db_query)结果集中获取指定字段的内容。 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------------- | ------------------------------------------ | | DBResult:dbresult | 查询结果句柄（由[db_query](db_query)返回） | | field | 目标字段索引 | @@ -27,7 +32,7 @@ keywords: ## 示例 ```c -// 示例模块 +// examples.inc // ... @@ -91,7 +96,7 @@ Examples_ListNames(DB:dbConnectionHandle) ``` ```c -// 主游戏模式文件 +// mode.pwn // ... @@ -108,6 +113,7 @@ public OnGameModeInit() // 建立数据库连接 gDBConnectionHandle = db_open("example.db"); + // 检测数据库连接状态 if (gDBConnectionHandle) { print("成功连接数据库 \"example.db\""); diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_get_field_assoc.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_get_field_assoc.md index edc6777ffcc..78a049c7a1c 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_get_field_assoc.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_get_field_assoc.md @@ -2,17 +2,22 @@ title: db_get_field_assoc sidebar_label: db_get_field_assoc description: 通过字段名称获取当前结果行的字符串内容。 -keywords: - - sqlite +tags: ["sqlite"] --- +:::warning + +此函数已弃用，请使用 [DB_GetFieldStringByName](DB_GetFieldStringByName)。 + +::: + ## 描述 通过字段名称获取当前结果行的字符串内容。 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------------- | ------------------------------------------ | | DBResult:dbresult | 查询结果句柄（由[db_query](db_query)返回） | | field[] | 目标字段名称 | @@ -27,7 +32,7 @@ keywords: ## 示例 ```c -// 示例模块 +// examples.inc // ... @@ -56,7 +61,7 @@ Examples_ListNames(DB:dbConnectionHandle) ``` ```c -// 主游戏模式文件 +// mode.pwn // ... @@ -73,6 +78,7 @@ public OnGameModeInit() // 建立数据库连接 gDBConnectionHandle = db_open("example.db"); + // 检测数据库连接状态 if (gDBConnectionHandle) { print("成功连接数据库 \"example.db\""); diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_get_field_assoc_float.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_get_field_assoc_float.md index e6d51b0fdf4..7fa2ba0f42a 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_get_field_assoc_float.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_get_field_assoc_float.md @@ -2,17 +2,22 @@ title: db_get_field_assoc_float sidebar_label: db_get_field_assoc_float description: 通过字段名称获取当前结果行的浮点数值。 -keywords: - - sqlite +tags: ["sqlite"] --- +:::warning + +此函数已弃用，请使用 [DB_GetFieldFloatByName](DB_GetFieldFloatByName)。 + +::: + ## 描述 通过字段名称从当前结果行中获取浮点数值。 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------------- | ------------------------------------------ | | DBResult:dbresult | 查询结果句柄（由[db_query](db_query)返回） | | field[] | 目标字段名称 | @@ -24,7 +29,7 @@ keywords: ## 示例 ```c -// 示例模块 +// examples.inc // ... @@ -55,7 +60,7 @@ Float:Examples_CalculateSum(DB:dbConnectionHandle) ``` ```c -// 主游戏模式文件 +// mode.pwn // ... @@ -72,6 +77,7 @@ public OnGameModeInit() // 建立数据库连接 gDBConnectionHandle = db_open("example.db"); + // 检测数据库连接状态 if (gDBConnectionHandle) { print("成功连接数据库 \"example.db\""); diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_get_field_assoc_int.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_get_field_assoc_int.md index 7f39d91b57f..b3b3d25b282 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_get_field_assoc_int.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_get_field_assoc_int.md @@ -2,17 +2,22 @@ title: db_get_field_assoc_int sidebar_label: db_get_field_assoc_int description: 通过字段名称获取当前结果行的整数值。 -keywords: - - sqlite +tags: ["sqlite"] --- +:::warning + +此函数已弃用，请使用 [DB_GetFieldIntByName](DB_GetFieldIntByName)。 + +::: + ## 描述 通过字段名称从当前结果行中获取整数值。 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------------- | ------------------------------------------ | | DBResult:dbresult | 查询结果句柄（由[db_query](db_query)返回） | | field[] | 目标字段名称 | @@ -24,7 +29,7 @@ keywords: ## 示例 ```c -// 示例模块 +// examples.inc // ... @@ -55,7 +60,7 @@ Examples_CalculateSum(DB:dbConnectionHandle) ``` ```c -// 主游戏模式文件 +// mode.pwn // ... @@ -72,6 +77,7 @@ public OnGameModeInit() // 建立数据库连接 gDBConnectionHandle = db_open("example.db"); + // 检测数据库连接状态 if (gDBConnectionHandle) { print("成功连接数据库 \"example.db\""); diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_get_field_float.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_get_field_float.md index 919c3243325..55dfb4dccde 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_get_field_float.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_get_field_float.md @@ -2,17 +2,22 @@ title: db_get_field_float sidebar_label: db_get_field_float description: 通过字段索引获取当前结果行的浮点数值。 -keywords: - - sqlite +tags: ["sqlite"] --- +:::warning + +此函数已弃用，请使用 [DB_GetFieldFloat](DB_GetFieldFloat)。 + +::: + ## 描述 通过字段索引从当前结果行中获取浮点数值。 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------------- | ------------------------------------------ | | DBResult:dbresult | 查询结果句柄（由[db_query](db_query)返回） | | field = 0 | 目标字段索引（默认 0） | @@ -24,7 +29,7 @@ keywords: ## 示例 ```c -// 示例模块 +// examples.inc // ... @@ -89,7 +94,7 @@ Float:Examples_CalculateSum(DB:dbConnectionHandle) ``` ```c -// 主游戏模式文件 +// mode.pwn // ... @@ -106,6 +111,7 @@ public OnGameModeInit() // 建立数据库连接 gDBConnectionHandle = db_open("example.db"); + // 检测数据库连接状态 if (gDBConnectionHandle) { print("成功连接数据库 \"example.db\""); diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_get_field_int.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_get_field_int.md index 15a08f2a3b3..fb42c3542c3 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_get_field_int.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_get_field_int.md @@ -2,17 +2,22 @@ title: db_get_field_int sidebar_label: db_get_field_int description: 通过字段索引从db_query结果中获取整数值。 -keywords: - - sqlite +tags: ["sqlite"] --- +:::warning + +此函数已弃用，请使用 [DB_GetFieldInt](DB_GetFieldInt)。 + +::: + ## 描述 通过字段索引从[db_query](db_query)结果中获取整数值。 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------------- | ------------------------------------------ | | DBResult:dbresult | 查询结果句柄（由[db_query](db_query)返回） | | field = 0 | 目标字段索引（默认 0） | @@ -24,7 +29,7 @@ keywords: ## 示例 ```c -// 示例模块 +// examples.inc // ... @@ -89,7 +94,7 @@ Examples_CalculateSum(DB:dbConnectionHandle) ``` ```c -// 主游戏模式文件 +// mode.pwn // ... @@ -106,6 +111,7 @@ public OnGameModeInit() // 建立数据库连接 gDBConnectionHandle = db_open("example.db"); + // 检测数据库连接状态 if (gDBConnectionHandle) { print("成功连接数据库 \"example.db\""); diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_get_mem_handle.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_get_mem_handle.md index 4fd7f23c6fd..b10a24bccd3 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_get_mem_handle.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_get_mem_handle.md @@ -2,21 +2,26 @@ title: db_get_mem_handle sidebar_label: db_get_mem_handle description: 获取通过`db_open`建立的SQLite数据库连接的内存句柄。 -keywords: - - sqlite +tags: ["sqlite"] --- +:::warning + +此函数已弃用，请使用 [DB_GetMemHandle](DB_GetMemHandle)。 + +::: + ## 描述 获取通过[db_open](db_open)建立的 SQLite 数据库连接的内存句柄。 -| 参数名 | 说明 | -| ------ | ------------------------------------------ | -| DB:db | 数据库连接句柄（由[db_open](db_open)返回） | +| 参数 | 说明 | +| ----- | ------------------------------------------ | +| DB:db | 数据库连接句柄（由[db_open](db_open)返回） | ## 返回值 @@ -36,6 +41,7 @@ public OnGameModeInit() // 建立数据库连接 gDBConnectionHandle = db_open("example.db"); + // 检测数据库连接状态 if (gDBConnectionHandle) { print("成功连接数据库 \"example.db\""); diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_get_result_mem_handle.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_get_result_mem_handle.md index 092b1906425..4d056bdab9e 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_get_result_mem_handle.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_get_result_mem_handle.md @@ -2,21 +2,26 @@ title: db_get_result_mem_handle sidebar_label: db_get_result_mem_handle description: 获取通过`db_query`分配的SQLite数据库结果集内存句柄。 -keywords: - - sqlite +tags: ["sqlite"] --- +:::warning + +此函数已弃用，请使用 [DB_GetLegacyDBResult](DB_GetLegacyDBResult)。 + +::: + ## 描述 -该函数用于获取通过[db_query](db_query)分配的 SQLite 数据库结果集内存句柄。 +此函数用于获取通过[db_query](db_query)分配的 SQLite 数据库结果集内存句柄。 -| 参数名 | 说明 | -| ------ | -------------------------------------------- | -| DB:db | 数据库查询句柄（由[db_query](db_query)返回） | +| 参数 | 说明 | +| ----- | -------------------------------------------- | +| DB:db | 数据库查询句柄（由[db_query](db_query)返回） | ## 返回值 @@ -36,6 +41,7 @@ public OnGameModeInit() // 建立数据库连接 gDBConnectionHandle = db_open("example.db"); + // 检测数据库连接状态 if (gDBConnectionHandle) { // 执行数据库查询 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_next_row.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_next_row.md index 7cc803cd55b..f6ca814a898 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_next_row.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_next_row.md @@ -2,17 +2,22 @@ title: db_next_row sidebar_label: db_next_row description: 跳转到通过db_query分配的结果集的下一行。 -keywords: - - sqlite +tags: ["sqlite"] --- +:::warning + +此函数已弃用，请使用 [DB_SelectNextRow](DB_SelectNextRow)。 + +::: + ## 描述 -该函数用于跳转到通过[db_query](db_query)分配的查询结果集的下一行。 +此函数用于跳转到通过[db_query](db_query)分配的查询结果集的下一行。 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------------- | ------------------------------------------ | | DBResult:dbresult | 查询结果句柄（由[db_query](db_query)返回） | @@ -24,7 +29,7 @@ keywords: ## 示例 ```c -// 示例模块 +// examples.inc // ... @@ -53,7 +58,7 @@ Examples_ListNames(DB:dbConnectionHandle) ``` ```c -// 主游戏模式文件 +// mode.pwn // ... @@ -70,6 +75,7 @@ public OnGameModeInit() // 建立数据库连接 gDBConnectionHandle = db_open("example.db"); + // 检测数据库连接状态 if (gDBConnectionHandle) { print("成功连接数据库 \"example.db\""); diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_num_fields.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_num_fields.md index 1ee95cb4894..f85378310c3 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_num_fields.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_num_fields.md @@ -2,17 +2,22 @@ title: db_num_fields sidebar_label: db_num_fields description: 获取通过`db_query`分配的结果集中的字段数量。 -keywords: - - sqlite +tags: ["sqlite"] --- +:::warning + +此函数已弃用，请使用 [DB_GetFieldCount](DB_GetFieldCount)。 + +::: + ## 描述 -该函数用于获取通过[db_query](db_query)分配的查询结果集中的字段总数。 +此函数用于获取通过[db_query](db_query)分配的查询结果集中的字段总数。 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------------- | ------------------------------------------ | | DBResult:dbresult | 查询结果句柄（由[db_query](db_query)返回） | @@ -23,7 +28,7 @@ keywords: ## 示例 ```c -// 示例模块 +// examples.inc // ... @@ -89,7 +94,7 @@ Float:Examples_CalculateSum(DB:dbConnectionHandle) ``` ```c -// 主游戏模式文件 +// mode.pwn // ... @@ -106,6 +111,7 @@ public OnGameModeInit() // 建立数据库连接 gDBConnectionHandle = db_open("example.db"); + // 检测数据库连接状态 if (gDBConnectionHandle) { print("成功连接数据库 \"example.db\""); diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_num_rows.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_num_rows.md index 2ae9b644027..b9ae5c8abb1 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_num_rows.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_num_rows.md @@ -2,17 +2,22 @@ title: db_num_rows sidebar_label: db_num_rows description: 返回通过db_query执行的查询结果中的行数。 -keywords: - - sqlite +tags: ["sqlite"] --- +:::warning + +此函数已弃用，请使用 [DB_GetRowCount](DB_GetRowCount)。 + +::: + ## 描述 -该函数用于获取通过[db_query](db_query)执行的查询结果中的行数。 +此函数用于获取通过[db_query](db_query)执行的查询结果中的行数。 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------------- | ------------------------------------------ | | DBResult:dbresult | 查询结果句柄（由[db_query](db_query)返回） | @@ -23,7 +28,7 @@ keywords: ## 示例 ```c -// 示例模块 +// examples.inc // ... @@ -56,7 +61,7 @@ Examples_ListNames(DB:dbConnectionHandle) ``` ```c -// 主游戏模式文件 +// mode.pwn // ... @@ -73,6 +78,7 @@ public OnGameModeInit() // 建立数据库连接 gDBConnectionHandle = db_open("example.db"); + // 检测数据库连接状态 if (gDBConnectionHandle) { print("成功连接数据库 \"example.db\""); @@ -91,7 +97,8 @@ public OnGameModeExit() // 关闭数据库连接 if (db_close(gDBConnectionHandle)) { - gDBConnectionHandle = DB:0; // 重置句柄 + // 重置句柄 + gDBConnectionHandle = DB:0; } return 1; } diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_open.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_open.md index febce6c0d9e..2019c4cbeb4 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_open.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_open.md @@ -1,9 +1,7 @@ --- title: db_open sidebar_label: db_open -description: 该函数用于建立与`/scriptfiles`目录下的SQLite数据库文件的连接。 -keywords: - - sqlite +description: 此函数用于建立与`/scriptfiles`目录下的SQLite数据库文件的连接。 tags: ["sqlite"] --- @@ -11,9 +9,9 @@ tags: ["sqlite"] ## 描述 -该函数用于建立与`/scriptfiles`目录下的 SQLite 数据库文件的连接。 +此函数用于建立与`/scriptfiles`目录下的 SQLite 数据库文件的连接。 -| 参数名 | 描述 | +| 参数 | 说明 | | ------------------------------------------------------------------- | ------------------------------------------ | | const name[] | 数据库文件名（不含路径） | | SQLITE_OPEN:flags = SQLITE_OPEN_READWRITE | SQLITE_OPEN_CREATE | [权限标志](../resources/sqlite-open-flags) | @@ -36,7 +34,7 @@ public OnGameModeInit() // 建立数据库连接 gDBConnectionHandle = db_open("example.db"); - // 验证连接状态 + // 检测数据库连接状态 if (gDBConnectionHandle) { print("成功连接数据库 \"example.db\""); diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_query.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_query.md index 364254d8619..383f5e88c51 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_query.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/db_query.md @@ -2,17 +2,22 @@ title: db_query sidebar_label: db_query description: 在已打开的SQLite数据库上执行SQL查询语句。 -keywords: - - sqlite +tags: ["sqlite"] --- +:::warning + +此函数已弃用，请使用 [DB_ExecuteQuery](DB_ExecuteQuery)。 + +::: + ## 描述 -该函数用于在已建立的 SQLite 数据库连接上执行 SQL 查询。 +此函数用于在已建立的 SQLite 数据库连接上执行 SQL 查询。 -| 参数名 | 描述 | +| 参数 | 说明 | | ------- | --------------------- | | DB:db | 数据库连接句柄 | | query[] | 要执行的 SQL 查询语句 | @@ -59,6 +64,7 @@ public OnGameModeInit() // 建立数据库连接 gDBConnectionHandle = db_open("example.db"); + // 检测数据库连接状态 if (gDBConnectionHandle) { print("成功连接数据库 \"example.db\""); diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/deleteproperty.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/deleteproperty.md index 3dd6214b861..5fd9c81c914 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/deleteproperty.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/deleteproperty.md @@ -11,7 +11,7 @@ tags: ["核心", "属性"] 删除先前设置的属性（[setproperty](setproperty)）。 -| 参数名 | 说明 | +| 参数 | 说明 | | ------ | ----------------------------------------------------------------- | | id | 使用的虚拟机 ID。应保持该值为零。_(optional=0)_ | | name[] | 属性名称，应保持为空字符串（""）。 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/diskfree.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/diskfree.md index f95d084ee7b..e0ce11a5504 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/diskfree.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/diskfree.md @@ -9,7 +9,7 @@ tags: ["文件管理"] :::warning -该函数尚未实现。 +此函数尚未实现。 ::: @@ -19,7 +19,7 @@ tags: ["文件管理"] 返回可用磁盘空间。 -| 名称 | 描述 | +| 参数 | 说明 | | ------------------- | ------------------------------------------------------ | | const volume[] = "" | 多磁盘系统或存储卡设备的卷名称（单卷系统下此参数可选） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/existproperty.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/existproperty.md index a7f7cae4d58..a728cf8a3a4 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/existproperty.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/existproperty.md @@ -11,7 +11,7 @@ tags: ["核心", "属性"] 检查指定属性是否存在。 -| 名称 | 描述 | +| 参数 | 说明 | | ------ | ------------------------------------------------------ | | id | 使用的虚拟机 ID，应保持为 0 _(可选=0)_ | | name[] | 属性名称，应保持为空字符串 "" | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/existpubvar.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/existpubvar.md index 9183ebffb30..143411438bb 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/existpubvar.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/existpubvar.md @@ -11,7 +11,7 @@ tags: ["核心", "公共变量"] 检查当前脚本中是否存在特定公共变量。 -| 名称 | 描述 | +| 参数 | 说明 | | ------------ | -------------------- | | const name[] | 要检查的公共变量名称 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fattrib.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fattrib.md index 650db1fb92b..23507ae4fd2 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fattrib.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fattrib.md @@ -13,7 +13,7 @@ tags: ["文件管理"] 设置文件属性参数。 -| 名称 | 描述 | +| 参数 | 说明 | | ---------------- | ------------------------------------------------------ | | const filename[] | 目标文件名 | | timestamp = 0 | 文件最后修改时间（UNIX 时间戳），设为 0 时保留原时间戳 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fblockread.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fblockread.md index 4d2065b234a..a51d4c7eb9d 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fblockread.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fblockread.md @@ -9,9 +9,9 @@ tags: ["文件管理"] ## 描述 -该函数允许从文件中读取原始数据块（不处理编码和行终止符）。 +此函数允许从文件中读取原始数据块（不处理编码和行终止符）。 -| 名称 | 描述 | +| 参数 | 说明 | | ---------------------- | -------------------------------------- | | File:handle | 通过 fopen()打开的文件句柄 | | buffer | 存储读取数据的缓冲区 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fblockwrite.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fblockwrite.md index 95fdf7b10ab..848cb116c4b 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fblockwrite.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fblockwrite.md @@ -11,7 +11,7 @@ tags: ["文件管理"] 将数据以二进制格式写入文件，不处理换行符和字符编码。 -| 名称 | 描述 | +| 参数 | 说明 | | ---------------------- | -------------------------------------- | | File:handle | 通过 fopen()打开的文件句柄 | | const buffer[] | 要写入文件的数据缓冲区 | @@ -19,7 +19,7 @@ tags: ["文件管理"] ## 返回值 -该函数不返回特定值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fclose.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fclose.md index 6f64dc187b4..b262982a6e5 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fclose.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fclose.md @@ -11,7 +11,7 @@ tags: ["文件管理"] 关闭一个文件。当脚本不再需要某个文件时（读取/写入后），应当始终关闭该文件。 -| 名称 | 描述 | +| 参数 | 说明 | | ----------- | ------------------------------------------ | | File:handle | 要关闭的文件句柄。由 [fopen](fopen) 返回。 | @@ -77,7 +77,3 @@ else - [diskfree](diskfree): 返回磁盘剩余空间 - [fattrib](fattrib): 设置文件属性 - [fcreatedir](fcreatedir): 创建目录 - -``` - -``` diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fcopy.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fcopy.md index c19c74555a9..d086e504daa 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fcopy.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fcopy.md @@ -13,7 +13,7 @@ tags: ["文件管理"] 复制文件。 -| 名称 | 描述 | +| 参数 | 说明 | | -------------- | ------------------------------------------ | | const source[] | 需要复制的（已存在的）文件名，可包含路径。 | | const target[] | 新文件的名称，可包含完整路径。 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fcreatedir.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fcreatedir.md index eb70d2cfe9b..6ad36d92fcc 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fcreatedir.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fcreatedir.md @@ -13,7 +13,7 @@ tags: ["文件管理"] 创建目录。 -| 名称 | 描述 | +| 参数 | 说明 | | --------------- | ---------------------------------- | | const dirname[] | 要创建的目录名称，可包含完整路径。 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fexist.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fexist.md index c348e2c41b4..054542b58f8 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fexist.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fexist.md @@ -11,7 +11,7 @@ tags: ["文件管理"] 检查指定文件是否存在于 scriptfiles 目录中。 -| 名称 | 描述 | +| 参数 | 说明 | | ---------------- | ------ | | const filename[] | 文件名 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fflush.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fflush.md index ade81b37280..c21b531d9fe 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fflush.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fflush.md @@ -11,9 +11,9 @@ tags: ["文件管理"] ## 描述 -将文件刷入磁盘（确保所有写入完成）。实际调用 [flength](flength) 函数实现，因为该函数需要强制刷新以确保准确性。 +将文件刷入磁盘（确保所有写入完成）。实际调用 [flength](flength) 函数实现，因为此函数需要强制刷新以确保准确性。 -| 名称 | 描述 | +| 参数 | 说明 | | ----------- | ------------------------------------ | | File:handle | 文件句柄（由 [fopen](fopen) 返回）。 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fgetchar.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fgetchar.md index e41af61b98d..e68f61dc466 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fgetchar.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fgetchar.md @@ -11,7 +11,7 @@ tags: ["文件管理"] 从文件中读取单个字符。 -| 名称 | 描述 | +| 参数 | 说明 | | ----------- | ---------------------------------------------------------------------------- | | File:handle | 文件句柄（由 [fopen](fopen) 返回） | | value | 此参数无实际作用，保持为 "0" 即可 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/filecrc.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/filecrc.md index 3ce8ad7772c..25720962af3 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/filecrc.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/filecrc.md @@ -13,7 +13,7 @@ tags: ["文件管理"] 返回文件的 32 位 CRC 值。 -| 名称 | 描述 | +| 参数 | 说明 | | ---------------- | ------ | | const filename[] | 文件名 | @@ -43,7 +43,7 @@ else :::tip - CRC 值是校验文件在传输过程中是否被修改的有效指标（需事先保存原始文件的 CRC 值） -- 本函数返回的 CRC 值与 ZIP 归档工具（PKZip/WinZip）及 SFV 校验工具使用的标准完全一致 +- 此函数返回的 CRC 值与 ZIP 归档工具（PKZip/WinZip）及 SFV 校验工具使用的标准完全一致 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/flength.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/flength.md index 9f5807ab39f..49ecf12eace 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/flength.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/flength.md @@ -11,7 +11,7 @@ tags: ["文件管理"] 返回文件的长度（以字节为单位）。 -| 名称 | 描述 | +| 参数 | 说明 | | ----------- | -------------------------------------------------- | | File:handle | 由 [fopen](fopen) 或 [ftemp](ftemp) 返回的文件句柄 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/float.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/float.md index a149debf4c6..ef5fc58b80b 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/float.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/float.md @@ -11,7 +11,7 @@ tags: ["浮点数"] 将整数转换为浮点数。 -| 名称 | 描述 | +| 参数 | 说明 | | ----- | ------------------ | | value | 需要转换的整数数值 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/floatabs.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/floatabs.md index e00dd69222a..f1489051a1d 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/floatabs.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/floatabs.md @@ -11,7 +11,7 @@ tags: ["数学", "浮点数"] 返回指定浮点数的绝对值。 -| 名称 | 描述 | +| 参数 | 说明 | | ----------- | ---------------------- | | Float:value | 要计算绝对值的浮点数值 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/floatadd.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/floatadd.md index e38ad03827b..8b3b9bced42 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/floatadd.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/floatadd.md @@ -11,7 +11,7 @@ tags: ["数学", "浮点数"] 将两个浮点数相加。此函数功能与标准运算符(+)重复。 -| 名称 | 描述 | +| 参数 | 说明 | | ------------- | ------------ | | Float:Number1 | 第一个浮点数 | | Float:Number2 | 第二个浮点数 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/floatcmp.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/floatcmp.md index ed17494960f..a2b21e4d616 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/floatcmp.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/floatcmp.md @@ -9,9 +9,9 @@ tags: ["数学", "浮点数"] ## 描述 -该函数用于比较两个浮点数值，验证它们的比较关系。 +此函数用于比较两个浮点数值，验证它们的比较关系。 -| 名称 | 描述 | +| 参数 | 说明 | | ----------- | ---------------------- | | Float:oper1 | 要比较的第一个浮点数值 | | Float:oper2 | 要比较的第二个浮点数值 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/floatcos.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/floatcos.md index 11c36a2da8c..ce479b44df7 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/floatcos.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/floatcos.md @@ -2,7 +2,7 @@ title: floatcos sidebar_label: floatcos description: 获取指定角度的余弦值 -tags: ["math", "floating-point"] +tags: ["数学", "浮点"] --- @@ -11,7 +11,7 @@ tags: ["math", "floating-point"] 获取指定角度的余弦值。输入角度可使用弧度、角度或梯度单位。 -| 参数名 | 说明 | +| 参数 | 说明 | | -------------- | ----------------------------------------------------------------------------- | | Float:value | 需要计算余弦值的角度 | | anglemode:mode | 使用的[角度模式](../resources/anglemodes)，根据输入值的单位而定（默认：弧度） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/floatdiv.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/floatdiv.md index 4b9f2e90f8d..3f43b5e8097 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/floatdiv.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/floatdiv.md @@ -11,7 +11,7 @@ tags: ["数学", "浮点数"] 将一个浮点数除以另一个浮点数。此函数功能与除法运算符(/)重复。 -| 名称 | 描述 | +| 参数 | 说明 | | -------------- | ---------------- | | Float:dividend | 被除数的浮点数值 | | Float:divisor | 除数的浮点数值 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/floatfract.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/floatfract.md index 1b1100e9ec4..0afb96170c0 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/floatfract.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/floatfract.md @@ -11,7 +11,7 @@ tags: ["数学", "浮点数"] 获取浮点数的小数部分，即小数点后的数值部分。 -| 名称 | 描述 | +| 参数 | 说明 | | ----------- | -------------------------- | | Float:value | 需要获取小数部分的浮点数值 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/floatlog.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/floatlog.md index 2edbba2652b..d1b240b6c41 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/floatlog.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/floatlog.md @@ -9,9 +9,9 @@ tags: ["数学", "浮点数"] ## 描述 -该函数用于计算以指定底数的浮点数对数。 +此函数用于计算以指定底数的浮点数对数。 -| 名称 | 描述 | +| 参数 | 说明 | | ----------- | ---------------------- | | Float:value | 需要计算对数的浮点数值 | | Float:base | 对数的底数 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/floatmul.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/floatmul.md index 2c6f091ab42..a6094497c66 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/floatmul.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/floatmul.md @@ -11,7 +11,7 @@ tags: ["数学", "浮点数"] 将两个浮点数相乘。 -| 名称 | 描述 | +| 参数 | 说明 | | ----------- | ---------------------- | | Float:oper1 | 第一个浮点数（被乘数） | | Float:oper2 | 第二个浮点数（乘数） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/floatpower.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/floatpower.md index 31712a487f1..a2ac7cbdce4 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/floatpower.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/floatpower.md @@ -11,7 +11,7 @@ tags: ["数学", "浮点数"] 对指定浮点数值进行幂运算，将其提升至给定指数次方。 -| 名称 | 描述 | +| 参数 | 说明 | | -------------- | ---------------------------------- | | Float:value | 需要进行幂运算的浮点基数值 | | Float:exponent | 指数值（浮点数类型，允许零或负值） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/floatround.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/floatround.md index 59bc24aa01c..e0063888004 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/floatround.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/floatround.md @@ -11,7 +11,7 @@ tags: ["数学", "浮点数"] 将浮点数按照指定模式舍入为整数值。 -| 名称 | 描述 | +| 参数 | 说明 | | ---------------------- | ------------------------------------------------------------------------------------------ | | Float:数值 | 需要进行舍入的浮点数值 | | floatround_method:模式 | 使用的[舍入模式](../resources/floatroundmodes)
默认值：`floatround_round`（四舍五入） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/floatsin.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/floatsin.md index 283349a5722..9d7669106e5 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/floatsin.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/floatsin.md @@ -11,7 +11,7 @@ tags: ["数学", "浮点数"] 获取指定角度的正弦值。输入角度可使用弧度、角度或梯度单位。 -| 参数名 | 说明 | +| 参数 | 说明 | | -------------- | ----------------------------------------------------------------------------- | | Float:value | 需要计算正弦值的角度 | | anglemode:mode | 使用的[角度模式](../resources/anglemodes)，根据输入值的单位而定（默认：弧度） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/floatsqroot.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/floatsqroot.md index ef026adebb1..89985e01d9c 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/floatsqroot.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/floatsqroot.md @@ -11,7 +11,7 @@ tags: ["数学", "浮点数"] 计算指定浮点数的平方根。 -| 名称 | 描述 | +| 参数 | 说明 | | ---------- | ------------------------ | | Float:数值 | 需要计算平方根的浮点数值 | @@ -29,7 +29,7 @@ new Float:sqroot = floatsqroot(25.0); // 返回5.0，因为5x5=25 :::tip -当输入值为负数时，该函数会引发"定义域(domain)"错误。建议使用 [floatabs](floatabs) 获取绝对值（正数值）。 +当输入值为负数时，此函数会引发"定义域(domain)"错误。建议使用 [floatabs](floatabs) 获取绝对值（正数值）。 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/floatstr.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/floatstr.md index ccf00b4b9a2..36c7488bc11 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/floatstr.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/floatstr.md @@ -11,7 +11,7 @@ tags: ["字符串", "浮点数"] 将字符串转换为浮点数。 -| 名称 | 描述 | +| 参数 | 说明 | | -------------- | ---------------- | | const string[] | 需要转换的字符串 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/floatsub.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/floatsub.md index f2f7dbca0d0..0ebd40e8547 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/floatsub.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/floatsub.md @@ -11,7 +11,7 @@ tags: ["数学", "浮点数"] 执行浮点数减法运算。注意：此函数实际用途有限，因为可以直接使用标准减法运算符(-)替代。 -| 名称 | 描述 | +| 参数 | 说明 | | ----------- | ---------------------- | | Float:oper1 | 第一个浮点数（被减数） | | Float:oper2 | 第二个浮点数（减数） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/floattan.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/floattan.md index 766c6bb86f3..e554b090b39 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/floattan.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/floattan.md @@ -2,7 +2,7 @@ title: floattan sidebar_label: floattan description: 获取指定角度的正切值 -tags: ["math", "floating-point"] +tags: ["数学", "浮点"] --- @@ -11,7 +11,7 @@ tags: ["math", "floating-point"] 获取指定角度的正切值。输入角度可使用弧度、角度或梯度单位。 -| 参数名 | 说明 | +| 参数 | 说明 | | ----------- | ----------------------------------------------------------------------------- | | Float:value | 需要计算正切值的角度 | | anglemode | 使用的[角度模式](../resources/anglemodes)，根据输入值的单位而定（默认：弧度） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fmatch.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fmatch.md index cc4a5b3bda0..42fce03e85a 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fmatch.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fmatch.md @@ -11,7 +11,7 @@ tags: ["文件管理"] 根据通配符模式查找匹配的文件名。 -| 名称 | 描述 | +| 参数 | 说明 | | ------------------------ | ------------------------------------------ | | const filename[] | 存储匹配结果的字符串（返回压缩字符串格式） | | const pattern[] | 匹配模式（支持通配符） | @@ -41,7 +41,7 @@ else :::warning -本函数在 open.mp 服务器可用，SA:MP 服务器不支持。 +此函数在 open.mp 服务器可用，SA:MP 服务器不支持。 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fopen.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fopen.md index fa6db117ed1..76d894c6e9c 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fopen.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fopen.md @@ -11,7 +11,7 @@ tags: ["文件管理"] 打开文件以便进行读写操作。 -| 名称 | 描述 | +| 参数 | 说明 | | ---------------------------------------- | ------------------------------------------------------------- | | const filename[] | 文件路径（若仅指定文件名，则默认在'scriptfiles'文件夹中查找） | | [filemode:mode](../resources/file-modes) | 文件打开模式（默认值：io_readwrite） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/format.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/format.md index db3e424f0c1..07df9fdf84b 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/format.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/format.md @@ -9,9 +9,9 @@ tags: ["字符串处理"] ## 描述 -该函数用于格式化字符串，支持将变量和其他字符串嵌入目标字符串。 +此函数用于格式化字符串，支持将变量和其他字符串嵌入目标字符串。 -| 参数名 | 描述 | +| 参数 | 说明 | | ----------------- | ---------------------------------- | | output[] | 存储格式化结果的字符串缓冲区 | | len | 输出缓冲区的最大容量（包含终止符） | @@ -59,7 +59,7 @@ format(result, sizeof(result), "这是%s，包含数值%i。", string, number); ```c new string[64]; -format(string, sizeof(string), "您的得分：%d", GetPlayerScore(playerid)); +format(string, sizeof(string), "你的得分：%d", GetPlayerScore(playerid)); SendClientMessage(playerid, 0xFF8000FF, string); // 发送橙色消息给玩家 ``` @@ -85,11 +85,11 @@ SendClientMessage(playerid, 0xFF8000FF, string); // 显示"43%的衬衫是黑色 :::warning -- 本函数不支持压缩字符串(packed strings) +- 此函数不支持压缩字符串(packed strings) ::: ## 相关函数 - [print](print): 在服务器日志和控制台中输出基础信息 -- [printf](printf): 在服务器日志和控制台中输出格式化信息 \ No newline at end of file +- [printf](printf): 在服务器日志和控制台中输出格式化信息 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fputchar.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fputchar.md index d827c61554d..1abaa41be04 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fputchar.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fputchar.md @@ -11,7 +11,7 @@ tags: ["文件管理"] 向文件写入单个字符。 -| 名称 | 说明 | +| 参数 | 说明 | | ----------- | ------------------------------------------------------------------------- | | File:handle | 要操作的文件句柄，需预先通过 fopen() 打开。 | | value | 需要写入的字符。 | @@ -19,7 +19,7 @@ tags: ["文件管理"] ## 返回值 -该函数不返回特定值。 +此函数不返回特定值。 ## 示例 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fread.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fread.md index 21b57ba29cc..f5e85f46bac 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fread.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fread.md @@ -11,7 +11,7 @@ tags: ["文件管理"] 从文件中读取单行内容。 -| 名称 | 说明 | +| 参数 | 说明 | | ---------------------- | -------------------------------------- | | File:handle | 要读取的文件句柄（由 fopen 返回）。 | | string[] | 存储读取内容的字符串数组（引用传递）。 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fremove.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fremove.md index 27a8e5e3e26..9fc6a058eb7 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fremove.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fremove.md @@ -11,7 +11,7 @@ tags: ["文件管理"] 删除指定文件。 -| 名称 | 说明 | +| 参数 | 说明 | | ---------------- | ------------------ | | const filename[] | 要删除的文件路径。 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/frename.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/frename.md index c94808f1381..b3e674cb41e 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/frename.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/frename.md @@ -13,7 +13,7 @@ tags: ["文件管理"] 重命名指定文件。 -| 名称 | 说明 | +| 参数 | 说明 | | --------------- | ---------------------------- | | const oldname[] | 原文件名（可包含完整路径）。 | | const newname[] | 新文件名（可包含完整路径）。 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fseek.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fseek.md index 68de2de46af..17f5c53dee2 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fseek.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fseek.md @@ -11,7 +11,7 @@ tags: ["文件管理"] 修改文件指针位置。可在文件中进行正向或反向定位。 -| 名称 | 说明 | +| 参数 | 说明 | | --------------------------------------------------- | -------------------------------------------- | | File:handle | 要操作的文件句柄（由 fopen 返回）。 | | position | 相对于基准位置的偏移量（详见 whence 参数）。 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fstat.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fstat.md index d5d95f15f20..672f9e1e19b 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fstat.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fstat.md @@ -13,7 +13,7 @@ tags: ["文件管理"] 获取文件大小、最后修改时间戳及相关属性信息。 -| 名称 | 说明 | +| 参数 | 说明 | | ---------------- | ------------------------------------------------------------------------------- | | const filename[] | 目标文件名 | | &size | 成功时接收文件大小（单位：字节） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ftell.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ftell.md index 70e9012b9b2..f56b0adb8ea 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ftell.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/ftell.md @@ -13,7 +13,7 @@ tags: ["文件管理"] 获取文件指针的当前位置。 -| 名称 | 说明 | +| 参数 | 说明 | | ----------- | ----------------------------------- | | File:handle | 要操作的文件句柄（由 fopen 返回）。 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/funcidx.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/funcidx.md index 461f4679c5b..7b02b400ec3 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/funcidx.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/funcidx.md @@ -2,7 +2,7 @@ title: funcidx sidebar_label: funcidx description: 通过函数名获取公共函数的ID。 -tags: ["core"] +tags: ["核心"] --- @@ -11,7 +11,7 @@ tags: ["core"] 通过函数名获取公共函数的唯一标识符(ID)。 -| 名称 | 说明 | +| 参数 | 说明 | | ------------ | ---------------------- | | const name[] | 要查询的公共函数名称。 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fwrite.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fwrite.md index 629ff66f7b4..948765e412e 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fwrite.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/fwrite.md @@ -11,7 +11,7 @@ tags: ["文件管理"] 向指定文件写入文本内容。 -| 名称 | 说明 | +| 参数 | 说明 | | -------------- | ----------------------------------- | | File:handle | 要操作的文件句柄（由 fopen 返回）。 | | const string[] | 需要写入的文本字符串。 | @@ -104,7 +104,7 @@ else :::tip -本函数使用 UTF-8 编码写入文件，可能无法支持某些特殊语言符号。 +此函数使用 UTF-8 编码写入文件，可能无法支持某些特殊语言符号。 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/getarg.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/getarg.md index 10eeee1b7de..9973abef118 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/getarg.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/getarg.md @@ -11,10 +11,10 @@ tags: ["核心", "参数"] 获取传递给函数的参数。 -| 参数名 | 说明 | -| ------ | -------------------------------- | -| arg | 参数序号（0 表示第一个参数） | -| index | 数组参数的索引（可选，默认为 0） | +| 参数 | 说明 | +| ----- | -------------------------------- | +| arg | 参数序号（0 表示第一个参数） | +| index | 数组参数的索引（可选，默认为 0） | ## 返回值 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/getproperty.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/getproperty.md index 36bbd9cc7a8..96a0c9df305 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/getproperty.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/getproperty.md @@ -11,7 +11,7 @@ tags: ["核心", "属性"] 从内存中获取特定属性，返回的字符串为打包格式（需使用 strunpack 解包） -| 名称 | 说明 | +| 参数 | 说明 | | -------- | -------------------------------------------------------------- | | id | 使用的虚拟机 ID（应始终保留为 0） _(可选参数=0)_ | | name[] | 属性名称（应保留为空字符串） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/getpubvar.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/getpubvar.md index 6dad3921f83..c05dffa4a87 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/getpubvar.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/getpubvar.md @@ -2,7 +2,7 @@ title: getpubvar sidebar_label: getpubvar description: 获取当前脚本中的特定公共变量 -tags: ["核心", "pubvar", "公共变量"] +tags: ["核心", "公共变量"] --- @@ -11,7 +11,7 @@ tags: ["核心", "pubvar", "公共变量"] 获取当前脚本中声明的特定公共变量值 -| 名称 | 说明 | +| 参数 | 说明 | | ------------ | ---------------- | | const name[] | 目标公共变量名称 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/gettime.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/gettime.md index 2d505891a9a..96a04629b37 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/gettime.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/gettime.md @@ -11,7 +11,7 @@ tags: ["时间"] 获取服务器当前时间，并将小时、分钟和秒存储到指定变量中。 -| 参数名 | 说明 | +| 参数 | 说明 | | --------- | ---------------------------------------- | | &hour=0 | 存储小时的变量（通过引用传递，默认值 0） | | &minute=0 | 存储分钟的变量（通过引用传递，默认值 0） | @@ -39,7 +39,7 @@ printf("自1970年1月1日午夜起的秒数: %d", timestamp); :::tip -本函数通过返回时间戳的特性，特别适合用于测量时间间隔。例如实现指令冷却功能（如某个指令每 30 秒才能执行一次），无需依赖定时器即可实现精准时间控制。 +此函数通过返回时间戳的特性，特别适合用于测量时间间隔。例如实现指令冷却功能（如某个指令每 30 秒才能执行一次），无需依赖定时器即可实现精准时间控制。 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/gpci.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/gpci.md index cc61eca820e..5bee1a4c229 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/gpci.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/gpci.md @@ -19,7 +19,7 @@ tags: [] ## 参数 -| 参数名 | 说明 | +| 参数 | 说明 | | --------------------- | ------------------------------------ | | playerid | 目标玩家的 ID 编号 | | serial[] | 存储 CI 的字符串数组（通过引用传递） | @@ -29,7 +29,7 @@ tags: [] 返回玩家客户端识别码的字符串形式 -## 使用示例 +## 示例 **SA-MP 服务器:** @@ -46,7 +46,7 @@ public OnPlayerConnect(playerid) gpci(playerid, serial, sizeof(serial)); new string[128]; - format(string, sizeof(string), "您的客户端识别码: %s", serial); + format(string, sizeof(string), "你的客户端识别码: %s", serial); SendClientMessage(playerid, -1, string); return 1; } @@ -61,7 +61,7 @@ public OnPlayerConnect(playerid) { new serial[41]; // 40字符长度 + 终止符\0 GPCI(playerid, serial, sizeof(serial)); - SendClientMessage(playerid, -1, "您的客户端识别码: %s", serial); + SendClientMessage(playerid, -1, "你的客户端识别码: %s", serial); return 1; } ``` diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/listenport.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/listenport.md index b13d446c53a..3d75ece28a8 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/listenport.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/listenport.md @@ -2,14 +2,14 @@ title: listenport sidebar_label: listenport description: 设置监听的端口号 -tags: ["数据报文"] +tags: ["数据报"] --- :::warning -该函数已弃用，请使用 [HTTP](HTTP) 插件或 [pawn-requests](https://github.com/Southclaws/pawn-requests) 插件替代 +此函数已弃用，请使用 [HTTP](HTTP) 插件或 [pawn-requests](https://github.com/Southclaws/pawn-requests) 插件替代 ::: @@ -23,7 +23,7 @@ tags: ["数据报文"] ## 返回值 -本函数总是返回 **0** +此函数总是返回 **0** ## 注意事项 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/numargs.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/numargs.md index 583c2ba6f8e..c7d13534f2d 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/numargs.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/numargs.md @@ -2,7 +2,7 @@ title: numargs sidebar_label: numargs description: 获取函数接收的参数数量 -tags: ["核心", "参数", "args"] +tags: ["核心", "参数"] --- diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/print.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/print.md index ac1c6c84973..4504e7e28c9 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/print.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/functions/print.md @@ -11,7 +11,7 @@ tags: ["控制台"] 将字符串输出至服务器控制台（非游戏内聊天框）并记录日志（log.txt）。 -| 名称 | 描述 | +| 参数 | 说明 | | ----------------- | ----------------- | -------------- | | const string[] | 需要输出的字符串 | | + +## 概述 + +`gta3.img`（或任何其他存档）中的 64 个 `nodes*.dat` 文件包含了 GTA SA 的车辆和行人路径及相关信息。从西南角 (-3000, -3000) 开始，每个 750×750 单位方块都有一个文件，按行优先顺序排列。 + +飞机和火车的路径不存储在节点文件中。火车使用四个 `tracks*.dat` 文件。`carrec.img` 中还有一些用于多个任务和混凝土车辆的路径。 + +可以通过脚本使用操作码 01EB 和 03DE 来影响节点。 + +通常，车辆和行人如果以任何方式未链接到脚本或 `carrec.img` 路径，就会使用节点。 + +路径格式有一个[修改版本](https://gtamods.com/wiki/Fastman92_Path_Format)，可与 fastman92 的 Limit Adjuster 一起使用，它移除或扩展了原生格式施加的一些限制。 + +## 用途 + +据信节点文件是在游戏开发期间由某种路径编译器生成的，代表了处理友好的二进制数据结构，否则这些结构会在运行时由游戏先前版本从 `paths.ipl` 等文件生成。此类文件在 SA 中仍然存在，但未被使用。 + +由于内置路径编译器显然已从游戏代码中移除或至少变得无法正常工作，因此需要自定义工具和技术来为 SA 生成新路径。 + +节点文件由游戏流加载——一次只加载活动区域及其周围区域。因此，损坏的文件只有在玩家进入特定区域时才会导致游戏崩溃。 + +`data/paths/` 目录中单独的 `nodes*.dat` 文件被游戏忽略。 + +## 文件格式 + +每个文件以头部开始，后跟 7 个不同的部分。 + +路径以双链接（因此无向）图的形式存储在邻接表表示中。不同区域之间可能存在连接。 + +### 数据类型 + +本文中使用以下数据类型和结构： + +| 类型 | 说明 | 大小 | +| ---------------- | ----------------------- | ------ | +| **INT8/UINT8** | 有符号/无符号 8 位整数 | 1 字节 | +| **INT16/UINT16** | 有符号/无符号 16 位整数 | 2 字节 | +| **INT32/UINT32** | 有符号/无符号 32 位整数 | 4 字节 | +| **FLOAT** | 单精度浮点数 | 4 字节 | + +### 关键概念 + +有几个主要概念对于理解路径文件的工作方式很重要： + +- **"节点"**是空间中的一个单独点，用作路径的锚点 +- **路径**是节点之间的路线。这些在游戏中由行人和车辆追踪，但在编辑器中通常显示为图形线条 +- 两个节点通过一个引用指向另一个的**"链接"**连接 +- 大多数节点链接到另外两个节点，路径每个方向一个，但可能存在更多（如在交叉路口） + +### 头部 + +头部包含文件中各个部分内容的信息。它的大小为 **20 字节**。 + +| 大小 | 类型 | 说明 | +| ---- | ------ | -------------------------- | +| 4b | UINT32 | 节点数量（第 1 部分） | +| 4b | UINT32 | 车辆节点数量（第 1a 部分） | +| 4b | UINT32 | 行人节点数量（第 1b 部分） | +| 4b | UINT32 | 导航节点数量（第 2 部分） | +| 4b | UINT32 | 链接数量（第 3/5/6 部分） | + +:::note +与链接相关的部分（3/5/6）具有相同数量的条目。这些条目属于一起，编辑器可以将其视为一个记录。 +::: + +### 第 1 部分 - 路径节点 + +第一部分包含路径的节点数据。它们按类型分组：车辆节点列表（汽车、船只、赛道）后跟行人节点。每个节点条目的大小为 **28 字节**。 + +| 大小 | 类型 | 说明 | +| ---- | -------- | ----------------------------------------------- | +| 4b | UINT32 | 内存地址，_未使用_ | +| 4b | UINT32 | 始终为零，_未使用_ | +| 6b | INT16[3] | 位置（XYZ），见下文 | +| 2b | INT16 | 启发式成本，始终为 `0x7FFE`，在内部用于计算路线 | +| 2b | UINT16 | 链接 ID | +| 2b | UINT16 | 区域 ID（与文件名中相同） | +| 2b | UINT16 | 节点 ID（递增 1） | +| 1b | UINT8 | 路径宽度 | +| 1b | UINT8 | 洪水填充，用于路线计算 | +| 4b | UINT32 | 标志 | + +#### 字段描述 + +- **内存地址**：这些可能是 R\* 路径编译器内路径段结构的指针。显然游戏忽略了它们，可以设置为零。 +- **位置**：这是节点在世界坐标中的位置。将有符号字转换为浮点值时，将它们除以 8。 +- **链接 ID**：此节点链接到的第一个节点的 ID。链接节点的范围是 _链接 ID ≤ x < (链接 ID + 链接数量)_，其中链接数量由标志的前四位给出。 +- **区域 ID 和节点 ID**：信息数据，用于通过链接连接节点。区域 ID 始终与文件名中的数字相同，节点 ID 用于标识节点。 +- **路径宽度**：这用于修改路径的宽度。默认值为 0（零）。将有符号字转换为浮点值时，将其除以 8。 +- **洪水填充**：用于 NPC 路线计算的洪水 ID。对于正常 NPC 车辆交通，使用值 1，2 用于船只，更高的值分配给断开的路径区域段，例如赛道和其他任务应用。 +- **标志**：前 4 位定义了到相邻节点的链接数量。其他位用于表征节点行为，更多信息请参见下表。 + +#### 路径节点标志 + +_节点标志位，从低到高：_ + +| 位 | 说明 | +| --- | -------- | +| 0-3 | 链接数量 | +| 4-5 | 交通级别 | + +LinkCount 定义了从 LinkID 开始递增的条目数量。TrafficLevel 使用 4 个步骤： + +- 0 = 完整 +- 1 = 高 +- 2 = 中等 +- 3 = 低 + +| 标志 | 位 | 说明 | +| ----- | ----- | ----------------------------------------------------- | +| A | 06 | 路障 | +| B | 07 | 船只 | +| C | 08 | 仅紧急车辆 | +| D | 09 | 零/未使用 | +| E | 10 | 未知，格罗夫房屋入口路径？ | +| F | 11 | 零/未使用 | +| G | 12 | 非高速公路 | +| H | 13 | 是高速公路（行人节点忽略，汽车永远不会是 11 或 00！） | +| I | 14 | 零 | +| J | 15 | 零 | +| K-M | 16-19 | 生成概率（`0x00` 到 `0x0F`） | +| O | 20 | 路障？ | +| P | 21 | 停车 | +| Q | 22 | 零 | +| R | 23 | 路障？ | +| 24-31 | | 零（未使用） | + +以下按路径类型分组的*标志使用统计*可能对进一步研究有用： + +| 标志 | 行人 | 汽车 | 总计 | +| -------- | --------------- | --------------- | ------ | +| **总计** | 37,650 | 30,587 | 68,237 | +| A | 0 | 391 (1.28%) | 391 | +| B | 0 | 1,596 (5.22%) | 1,596 | +| C | 6,019 (15.99%) | 7,669 (25.08%) | 13,688 | +| D | 0 | 0 | 0 | +| E | 17 (0.05%) | 0 | 17 | +| F | 0 | 0 | 0 | +| G | 0 | 27,936 (91.33%) | 27,936 | +| H | 0 | 2,539 (8.3%) | 2,539 | +| I | 0 | 0 | 0 | +| J | 0 | 0 | 0 | +| K | 37,646 (99.98%) | 30,582 (99.98%) | 68,228 | +| L | 36,676 (97.41%) | 30,141 (98.54%) | 66,817 | +| M | 36,676 (97.41%) | 30,136 (98.52%) | 66,812 | +| N | 36,607 (97.22%) | 30,046 (98.23%) | 66,653 | +| O | 0 | 8 (0.03%) | 8 | +| P | 0 | 215 (0.7%) | 215 | +| Q | 0 | 0 | 0 | +| R | 0 | 16 (0.05%) | 16 | + +### 第 2 部分 - 导航节点 + +第二部分包含额外的节点。这些节点是*导航节点*（但在本文中为简洁起见称为"navi 节点"）。每个记录的大小为 **14 字节**。 + +导航节点用于为车辆路径段定义额外信息；行人路径不使用它们。它们通常位于两个相邻车辆节点之间的插值曲线上。 + +如果你没有正确连接导航节点，可能会出现错误。链接总是从具有较高区域/节点 ID 的节点指向具有较低 ID 的节点，因此目标始终是较低的节点。 + +| 大小 | 类型 | 说明 | +| ---- | -------- | ------------------ | +| 4b | INT16[2] | 位置（XY），见下文 | +| 2b | UINT16 | 区域 ID | +| 2b | UINT16 | 节点 ID | +| 2b | INT8[2] | 方向（XY），见下文 | +| 4b | UINT32 | 标志 | + +#### 导航节点字段描述 + +- **位置**：这是导航节点在世界坐标中的位置。将有符号字转换为浮点值时，将它们除以 8。 +- **区域 ID 和节点 ID**：这些标识导航节点附加到的目标节点。 +- **方向**：这是一个指向上述目标节点的归一化向量，从而定义路径段的大致方向。向量分量由有符号字节表示，值在区间 [-100, 100] 内，对应于浮点值范围 [-1.0, 1.0]。 + +#### 导航节点标志 + +这些用于表征路径段行为，更多信息请参见下表。 + +| 位 | 说明 | +| ----- | -------------------------------------------------- | +| 0-7 | 路径节点宽度，通常是链接节点路径宽度的副本（字节） | +| 8-10 | 左车道数量 | +| 11-13 | 右车道数量 | +| 14 | 交通灯方向行为 | +| 15 | 零/未使用 | +| 16,17 | 交通灯行为 | +| 18 | 火车道口 | +| 19-31 | 零/未使用 | + +#### 重要说明 + +- 右（向前）和左（向后）车道是相对于方向向量的。 +- 经验表明，具有跨区域边界附加的导航节点效果不佳。一个可能的解决方案是将它们附加到最后一个节点而不是下一个节点，反转方向并交换车道编号（如果不同）和其他方向相关标志。但是，如果前一个、导航和下一个节点各自位于不同区域，这将永远不会工作。**(\*)** +- *交通灯行为*可以是 0 到 2 的值，其中 0 表示交通灯禁用，1 和 2 用于交通灯，分别是交通灯同步的南北和东西周期。 +- *交通灯方向行为*如果导航节点与交通灯方向相同则为 1，如果导航节点指向其他地方则为 0。 + +:::note +(\*) 在确切了解导航节点如何链接后变得清晰。因此你可以使用它，但这不是义务。 +::: + +### 第 3 部分 - 链接 + +这些是到相邻节点的链接，每个条目 **4 字节**。 + +| 大小 | 类型 | 说明 | +| ---- | ------ | ------- | +| 2b | UINT16 | 区域 ID | +| 2b | UINT16 | 节点 ID | + +### 第 4 部分 - 填充 + +此部分保存恒定大小和内容的数据；其用途未知。这 **768 字节**填充了 192 个重复的模式 `0xFF 0xFF 0x00 0x00`，但也可以用零填充。 + +### 第 5 部分 - 导航链接 + +这些是到相邻导航节点的链接，每个链接（在第 3 部分中）一个，每个条目 **2 字节**。来自行人节点的索引（在第 1b 部分中）为零（未使用）。 + +| 大小 | 类型 | 说明 | +| ---- | ------ | --------------------------------------------- | +| 2b | UINT16 | 低 10 位是导航节点 ID，高 6 位是对应的区域 ID | + +:::warning 重要限制 +**导航节点限制：** + +- 每个区域文件最多 **1024** 个导航节点 +- 总共最多 **64** 个文件/区域 + +**导航节点 ID 说明：** + +- 导航节点 ID 不是第 2 部分中的链接节点 ID，而是导航节点在文件中出现的顺序。 + ::: + +### 第 6 部分 - 链接长度 + +这些是链接节点之间的完整单位距离，每个条目 **1 字节**。它们对于路径查找算法至关重要。 + +| 大小 | 类型 | 说明 | +| ---- | ----- | ---- | +| 1b | UINT8 | 长度 | + +### 第 7 部分 - 路径交叉标志 + +此部分由每个节点地址（即节点链接）的交叉标志值组成。 + +```cpp +class CPathIntersectionInfo +{ +public: + unsigned char m_bRoadCross : 1; + unsigned char m_bPedTrafficLight : 1; +}; +``` + +部分的大小等于节点地址的数量。 +该部分后跟 192 字节的未知数据。 + +## 工具和脚本 + +- [Fastman92 路径格式](https://gtamods.com/wiki/Fastman92_Path_Format) +- [SA 路径编辑器（开发中）](https://gtagmodding.com/1093) 作者：JGuntherS@NL - 仅用于编辑现有路径数据 +- [路径编译器（开发中）](https://gtaforums.com/topic/214901-compiled-path-nodes/?do=findComment&comment=3841297) 作者：ocram88 - 允许通过在游戏内生成路径点来创建线性行人路径 +- [路径工具（开发中）](https://gtaforums.com/topic/214901-compiled-path-nodes/?do=findComment&comment=3936074) 作者：steve-m - 附带 MaxScript，可从 Max 导出行人和车辆路径（通过使用样条线形状） +- [APE v1.1](https://gtaforums.com/topic/295628-ape-v11/) 作者：Aschratt - 基于内存破解并包含反编译器，可以添加路径到现有路径或在游戏内创建全新的路径！ +- [路径脚本](https://gtaforums.com/topic/283684-path-script/) - Deniska 为 3DSMax 编写的脚本，直接创建路径文件 +- [PathViewer](https://gtaforums.com/topic/392955-pathviewer/) - Aschratt 的工具，允许在 3D 中查看路径并突出显示具有特殊标志的节点 +- [fastman92 limit adjuster](https://gtaforums.com/topic/733982-fastman92-limit-adjuster/) - fastman92 的限制调整器，允许增加路径限制 + +## 另请参阅 + +- [编译路径节点](https://gtaforums.com/topic/214901-compiled-path-nodes/) - 原始讨论线程 +- [SA、VC 和 GTA3 的路径文档](https://gtaforums.com/topic/93990-paths-documentation-for-sa-vc-and-gta3/?do=findComment&comment=3813170) diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/pickupids.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/pickupids.md index d51e6e63d5b..68a66ca1e8e 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/pickupids.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/pickupids.md @@ -11,7 +11,7 @@ sidebar_label: 拾取物ID ## 拾取物模型 ID -| ID | 预览图 | 描述 | +| ID | 预览图 | 说明 | | ----- | -------------------------------------------------------------- | ---------------------- | | 954 | ![](https://assets.open.mp/assets/images/pickups/pickup1.png) | 马蹄铁 | | 1210 | ![](https://assets.open.mp/assets/images/pickups/pickup2.png) | 公文包 | @@ -75,7 +75,7 @@ sidebar_label: 拾取物ID ## 武器拾取物 -| ID | 描述 | +| ID | 说明 | | --- | ------------------------- | | 321 | 普通假阳具 | | 322 | 白色假阳具 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/race-checkpoint-types.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/race-checkpoint-types.md index 921389be6e7..dfddfdbc6b9 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/race-checkpoint-types.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/race-checkpoint-types.md @@ -10,7 +10,7 @@ description: 竞速检查点类型定义。 ::: -| 定义 | 值 | 描述 | +| 定义 | 值 | 说明 | | --------------------- | --- | ---------------------------------------- | | UNKNOWN_CP_TYPE | -1 | 未知类型 | | CP_TYPE_GROUND_NORMAL | 0 | 常规地面检查点 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/recordtypes.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/recordtypes.md index 71184b441f1..de3c5a0fe90 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/recordtypes.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/recordtypes.md @@ -11,7 +11,7 @@ tags: ["玩家"] ::: -| 数值 | 宏定义 | 描述 | +| 数值 | 宏定义 | 说明 | | ---- | ---------------------------- | -------------------- | | 0 | PLAYER_RECORDING_TYPE_NONE | 无记录类型 | | 1 | PLAYER_RECORDING_TYPE_DRIVER | 驾驶记录（车辆录制） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/samp_objects.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/samp_objects.md index d4dfc5d99ca..29e852362d0 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/samp_objects.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/samp_objects.md @@ -6,7 +6,7 @@ description: 本页面包含由SA-MP添加的自定义物体列表。 :::info -您可以访问此[网站](https://dev.prineside.com/en/gtasa_samp_model_id/)查看所有支持物体的预览列表及其对应 ID。 +你可以访问此[网站](https://dev.prineside.com/en/gtasa_samp_model_id/)查看所有支持物体的预览列表及其对应 ID。 ::: @@ -299,7 +299,7 @@ description: 本页面包含由SA-MP添加的自定义物体列表。 ### **51 区（69 号基地）建筑群** -这些建筑在保留原外观基础上新增内部空间。可通过"a51_base"滤镜脚本查看基地大门开合示例，脚本位于 Windows 0.3.7 服务端包的"filterscripts"目录。 +这些建筑在保留原外观基础上新增室内场景。可通过"a51_base"滤镜脚本查看基地大门开合示例，脚本位于 Windows 0.3.7 服务端包的"filterscripts"目录。 ``` 19905 A51Building1 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/selectobjecttypes.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/selectobjecttypes.md index 5a6e3ba7400..31d23c8031d 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/selectobjecttypes.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/selectobjecttypes.md @@ -9,7 +9,7 @@ sidebar_label: 选择物体类型 ::: -| 数值 | 宏定义 | 描述 | +| 数值 | 宏定义 | 说明 | | ---- | --------------------------- | -------------------- | | 1 | SELECT_OBJECT_GLOBAL_OBJECT | 全局物体（地图物体） | | 2 | SELECT_OBJECT_PLAYER_OBJECT | 玩家私有物体 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/shopnames.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/shopnames.md index a0f1359e6a7..83ffbc295d9 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/shopnames.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/shopnames.md @@ -9,7 +9,7 @@ sidebar_label: 商店名称 ::: -| 商店名称 | GXT 名称 | 描述 | 坐标 | +| 商店名称 | GXT 名称 | 说明 | 坐标 | | -------- | ------------- | --------------------- | ------------------------------ | | FDPIZA | Pizza Stack | 标准披萨栈室内场景 | 374.0000, -119.6410, 1001.4922 | | FDCHICK | Cluckin' Bell | 标准炸鸡钟室内场景 | 368.7890, -6.8570, 1001.8516 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/sound-ids.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/sound-ids.md index 9b276b60fb0..a51b3716fbf 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/sound-ids.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/sound-ids.md @@ -246,23 +246,23 @@ description: PlayerPlaySound使用的声音ID列表 ``` 5400 - "请下注！" 5401 - "女士们先生们请下注" -5402 - "先生，已为您提供信用额度" -5403 - "赌场愿意为您提供信用额度" +5402 - "先生，已为你提供信用额度" +5403 - "赌场愿意为你提供信用额度" 5404 - "赌场认可先生的信用评级" 5405 - "先生没有足够资金继续下注" -5406 - "抱歉先生，您的资金不足" -5407 - "您的资金似乎不足以继续投注" +5406 - "抱歉先生，你的资金不足" +5407 - "你的资金似乎不足以继续投注" 5408 - "停止下注！" 5409 - "女士们先生们请停止下注" 5410 - "停止接受投注" 5411-5447: 轮盘数字播报，例如"黑色，26号！" -5448 - "您赢了！" +5448 - "你赢了！" 5449 - "恭喜先生获胜" 5450 - "祝贺先生！" 5451 - "抱歉先生，仅限常客" -5452 - "赌场不认可您在本桌的限额" -5453 - "感谢光临，祝您愉快！" -5454 - "感谢您的参与！" +5452 - "赌场不认可你在本桌的限额" +5453 - "感谢光临，祝你愉快！" +5454 - "感谢你的参与！" 5455 - "1美元赔付！" 5456 - "2美元赔付！" 5457 - "5美元赔付！" @@ -271,7 +271,7 @@ description: PlayerPlaySound使用的声音ID列表 5460 - "40美元赔付！" 5461 - "头奖！" 5462 - "先生再次获胜！" -5463 - "恭喜先生，您手气正旺" +5463 - "恭喜先生，你手气正旺" 5464 - "祝先生好运常在！" ``` @@ -283,7 +283,7 @@ description: PlayerPlaySound使用的声音ID列表 6202 - "要通过测试，所有五项考核必须达到铜牌或以上" 6203 - "查看测试演示请使用那边的电视" 6204 - "通过当前测试将解锁后续测试" -6205 - "您可以随时回来查看成绩或进行新测试" +6205 - "你可以随时回来查看成绩或进行新测试" ``` #### 随机/额外音效 @@ -483,7 +483,7 @@ description: PlayerPlaySound使用的声音ID列表 ::: -| 名称 | ID | +| 参数 | ID | | ---------------------------------- | ----------- | | SOUND_CEILING_VENT_LAND | 1002 | | SOUND_BONNET_DENT | 1009 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/specialactions.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/specialactions.md index 58a630bcd8f..28561d29e5b 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/specialactions.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/specialactions.md @@ -13,7 +13,7 @@ tags: ["玩家"] ::: -| ID | 动作名称 | 描述 | +| ID | 动作名称 | 说明 | | --- | ------------------------------- | -------------------------------------------------------------------- | | 0 | SPECIAL_ACTION_NONE | 清除玩家所有特殊动作 | | 2 | SPECIAL_ACTION_USEJETPACK | 使玩家使用喷气背包 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/spectatemodes.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/spectatemodes.md index f7748efb172..2c78038e554 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/spectatemodes.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/spectatemodes.md @@ -11,8 +11,8 @@ tags: [] ::: -| 模式类型 | 效果描述 | -| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 模式类型 | 效果描述 | +| -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | SPECTATE_MODE_NORMAL | 普通旁观模式（第三人称视角）。视角角度不可调整 | | SPECTATE_MODE_FIXED | 使用[SetPlayerCameraPos](../functions/SetPlayerCameraPos)定位玩家视角位置后，该模式会自动追踪通过[PlayerSpectatePlayer](../functions/PlayerSpectatePlayer)/[PlayerSpectateVehicle](../functions/PlayerSpectateVehicle)设置的目标玩家/车辆 | | SPECTATE_MODE_SIDE | 视角将附着在目标玩家/车辆侧面（类似摩托车第一人称视角进行翘轮特技时的观察视角） | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/sqlite-open-flags.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/sqlite-open-flags.md index c65cb0e2820..5c947f32a79 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/sqlite-open-flags.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/sqlite-open-flags.md @@ -10,7 +10,7 @@ description: SQLite 数据库打开标志定义 ::: -| 定义标识符 | 描述 | +| 定义标识符 | 说明 | | ------------------------- | -------------- | | UNKNOWN_SQLITE_OPEN | 未知打开模式 | | SQLITE_OPEN_READONLY | 只读模式 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/start.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/start.md index b94e5ec4a16..7a4370705ed 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/start.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/start.md @@ -1,7 +1,7 @@ --- title: 脚本基础 sidebar_label: 脚本基础 -description: 一份简短教程，引导您了解Pawn语言及SA-MP/open.mp API的基础知识。 +description: 一份简短教程，引导你了解Pawn语言及SA-MP/open.mp API的基础知识。 --- 以下是一个可实现的最基础脚本示例： @@ -41,19 +41,19 @@ main() #include ``` -通过这一行包含指令，您即可使用 SA:MP 中所有功能函数（后续将详述函数概念）。 +通过这一行包含指令，你即可使用 SA:MP 中所有功能函数（后续将详述函数概念）。 --- ## 函数调用 -后续代码包含两个函数调用：main()是您编写的主函数，print(string[])是系统预定义的输出函数。当前脚本会在服务器控制台输出"Hello World!"（遵循编程语言传统）后结束。代码段： +后续代码包含两个函数调用：main()是你编写的主函数，print(string[])是系统预定义的输出函数。当前脚本会在服务器控制台输出"Hello World!"（遵循编程语言传统）后结束。代码段： ```c return 1; ``` -将值 1 返回给调用者以指示执行状态（此处返回值不影响逻辑，但在其他场景中可能有意义）。此时您已创建了首个基础脚本。使用 pawno 的"文件->新建"命令将生成更完整的模板，包含所有回调函数（详见下文）及 main 函数（虽非严格意义上的回调但行为类似）。 +将值 1 返回给调用者以指示执行状态（此处返回值不影响逻辑，但在其他场景中可能有意义）。此时你已创建了首个基础脚本。使用 pawno 的"文件->新建"命令将生成更完整的模板，包含所有回调函数（详见下文）及 main 函数（虽非严格意义上的回调但行为类似）。 --- @@ -117,7 +117,7 @@ printf("Hello World!", 1, 2, 3, 4, 5, 6); ## 自定义函数 -除调用现有函数外，您可创建自定义函数： +除调用现有函数外，你可创建自定义函数： ```c #include @@ -134,7 +134,7 @@ MyFunction() } ``` -此实现与原始脚本功能相同但结构不同。当游戏模式启动时自动调用 main()，后者调用自定义的 MyFunction()。该函数输出信息后返回 1 至 main()，最终传回服务器。等效的简洁写法： +此实现与原始脚此函数相同但结构不同。当游戏模式启动时自动调用 main()，后者调用自定义的 MyFunction()。此函数输出信息后返回 1 至 main()，最终传回服务器。等效的简洁写法： ```c #include @@ -308,7 +308,7 @@ myArray[2] = 7; 0, 0, 7, 0, 0 ``` -您可能会疑惑：为何不是： +你可能会疑惑：为何不是： ``` 0, 7, 0, 0, 0 @@ -320,7 +320,7 @@ myArray[2] = 7; 2, 4, 6, 8 ``` -当遍历该列表时，在数字 2 之后，您已经历了第一个元素（即 2 本身）。这意味着当您到达数字 4 时，实际上已经处于索引位置 1（而非 1 的位置对应数字 2）。因此： +当遍历该列表时，在数字 2 之后，你已经历了第一个元素（即 2 本身）。这意味着当你到达数字 4 时，实际上已经处于索引位置 1（而非 1 的位置对应数字 2）。因此： - 数字 2 位于索引 0 - 数字 4 位于索引 1 @@ -362,7 +362,7 @@ myArray[2]++; ### 示例 -如前所述，MAX_PLAYERS 数组是常见的数组类型。MAX_PLAYERS 并非变量，而是一个宏定义（后续详述），现阶段可将其视为表示服务器最大玩家容量的常量（默认 500，即使您在 server.cfg 文件中修改该数值）。以下代码使用普通变量存储 4 个玩家的数据，并通过函数处理这些玩家数据（为简化示例，假设此时 MAX_PLAYERS 为 4）： +如前所述，MAX_PLAYERS 数组是常见的数组类型。MAX_PLAYERS 并非变量，而是一个宏定义（后续详述），现阶段可将其视为表示服务器最大玩家容量的常量（默认 500，即使你在 server.cfg 文件中修改该数值）。以下代码使用普通变量存储 4 个玩家的数据，并通过函数处理这些玩家数据（为简化示例，假设此时 MAX_PLAYERS 为 4）： ```c new @@ -491,7 +491,7 @@ new 此代码创建仅含单个双引号的字符串。通常双引号会终止字符串定义，但通过转义符可使紧随其后的双引号成为字符串内容，而末尾的双引号则作为字符串终止符。其他特殊转义序列包括： -| Code | 名称 | 用途 | +| Code | 参数 | 用途 | | ------ | ---------- | --------------------------------------------- | | \0 | NULL 字符 | 终止字符串 | | EOS | NULL 字符 | (同上) | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/textdraws.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/textdraws.md index a33cb21ea3f..09e3d1bff38 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/textdraws.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/textdraws.md @@ -150,7 +150,7 @@ new PlayerText:gMyPlayerText = PlayerText:INVALID_TEXT_DRAW; TextDrawCreate(Float:x, Float:y, text[]) -| 参数名 | 说明 | +| 参数 | 说明 | | ------ | ------------------- | | x | 文本绘图的 X 轴坐标 | | y | 文本绘图的 Y 轴坐标 | @@ -199,14 +199,14 @@ SA-MP 0.3d 版本新增第四种字体（ID 4），需配合 [TextDrawCreate](.. TextDrawShowForPlayer(playerid, Text:text) -| 参数名 | 说明 | +| 参数 | 说明 | | -------- | ------------------- | | playerid | 目标玩家 ID | | text | 要显示的文本绘图 ID | **返回值：​** -无特定返回值 +不返回特定值。 实现代码： diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/tirestates.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/tirestates.md index 43757e35c0a..4f7fff37dbb 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/tirestates.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/tirestates.md @@ -230,7 +230,7 @@ x - 爆胎 --- -## 使用示例 +## 示例 设置四轮车辆后两轮爆胎，保持前轮状态： diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/vehicleid.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/vehicleid.md index 14703b7e5f8..b2d3cf26a96 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/vehicleid.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/vehicleid.md @@ -4,7 +4,7 @@ sidebar_label: 车辆ID description: 车辆ID的完整列表 --- -| ID | 描述 | +| ID | 说明 | | ------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- | | ![](https://assets.open.mp/assets/images/vehiclePictures/Vehicle_400.jpg) | 车辆模型 ID: 400
车辆名称: Landstalker
种类: 越野
改装店: Transfender
模型名称: landstal
座位数: 4 | | ![](https://assets.open.mp/assets/images/vehiclePictures/Vehicle_401.jpg) | 车辆模型 ID: 401
车辆名称: Bravura
种类: 轿车
改装店: Transfender
模型名称: bravura
座位数: 2 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/vehicleinformationtypes.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/vehicleinformationtypes.md index 4dcc50dc53e..a6cca77af85 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/vehicleinformationtypes.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/vehicleinformationtypes.md @@ -10,7 +10,7 @@ description: 车辆模型信息类型常量表。 ::: -| 信息类型常量 | 描述 | +| 信息类型常量 | 说明 | | ----------------------------------- | --------------------------------------------------------------------------------------- | | `VEHICLE_MODEL_INFO_SIZE` | 车辆整体尺寸 | | `VEHICLE_MODEL_INFO_FRONTSEAT` | 前座坐标位置 \* | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/vendingmachines.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/vendingmachines.md index 2a83b4a5c55..61d32b3e9f3 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/vendingmachines.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/vendingmachines.md @@ -10,7 +10,7 @@ description: 所有自动售货机位置列表，玩家使用时需保持2单位 ::: -| 模型 ID | 模型名称 | 描述 | +| 模型 ID | 模型名称 | 说明 | | ------- | -------------- | --------------------- | | 1209 | VENDMACH | 红色苏打水自动售货机 | | 1302 | VENDMACHFD | 与 1209 号模型相同 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/weaponstates.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/weaponstates.md index 8fac2a989b7..edb52a8f6dd 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/weaponstates.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/weaponstates.md @@ -6,7 +6,7 @@ description: 武器状态常量。 以下为 [GetPlayerWeaponState](../functions/GetPlayerWeaponState) 函数使用的武器状态定义： -| ID | 定义 | 描述 | +| ID | 定义 | 说明 | | --- | ------------------------ | ------------------------------------------------------------------------------------------------------------- | | -1 | WEAPONSTATE_UNKNOWN | 未知状态（当玩家处于车辆中、观战状态或[玩家状态](../functions/GetPlayerState)为 PLAYER_STATE_SPAWNED 时触发） | | 0 | WEAPONSTATE_NO_BULLETS | 玩家当前武器弹药已耗尽 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/weatherid.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/weatherid.md index 18ad329f22d..32db31f4698 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/weatherid.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/resources/weatherid.md @@ -5,31 +5,31 @@ sidebar_label: 天气ID列表 [SetWeather](../functions/SetWeather) 和 [SetPlayerWeather](../functions/SetPlayerWeather) 函数使用的天气 ID 列表。 -| ID | 名称 | 类型 | 描述（单人模式） | -| --- | ---------------------- | ---------------------- | ---------------------- | -| 0 | EXTRASUNNY_LA | 晴朗 | 洛圣都专属天气 | -| 1 | SUNNY_LA | 晴朗 | 洛圣都专属天气 | -| 2 | EXTRASUNNY_SMOG_LA | 晴朗 | 洛圣都专属天气 | -| 3 | SUNNY_SMOG_LA | 晴朗 | 洛圣都专属天气 | -| 4 | CLOUDY_LA | 晴朗 | 洛圣都专属天气 | -| 5 | SUNNY_SF | 晴朗 | 圣菲耶罗专属天气 | -| 6 | EXTRASUNNY_SF | 晴朗 | 圣菲耶罗专属天气 | -| 7 | CLOUDY_SF | 晴朗 | 圣菲耶罗专属天气 | -| 8 | RAINY_SF | 暴雨 | 圣菲耶罗专属天气 | -| 9 | FOGGY_SF | 多云有雾 | 圣菲耶罗专属天气 | -| 10 | SUNNY_VEGAS | 清澈蓝天 | 拉斯云祖华专属天气 | -| 11 | EXTRASUNNY_VEGAS | 热浪 | 拉斯云祖华专属天气 | -| 12 | CLOUDY_VEGAS | 灰暗单调 | 拉斯云祖华专属天气 | -| 13 | EXTRASUNNY_COUNTRYSIDE | 灰暗单调 | 乡村地区专属天气 | -| 14 | SUNNY_COUNTRYSIDE | 灰暗单调 | 乡村地区专属天气 | -| 15 | CLOUDY_COUNTRYSIDE | 灰暗单调 | 乡村地区专属天气 | -| 16 | RAINY_COUNTRYSIDE | 阴云密布有雨 | 乡村地区专属天气 | -| 17 | EXTRASUNNY_DESERT | 热浪 | 骨镇专属天气 | -| 18 | SUNNY_DESERT | 热浪 | 骨镇专属天气 | -| 19 | SANDSTORM_DESERT | 沙尘暴 | 骨镇专属天气 | +| ID | 参数 | 类型 | 描述（单人模式） | +| --- | ---------------------- | ---------------------- | -------------------- | +| 0 | EXTRASUNNY_LA | 晴朗 | 洛圣都专属天气 | +| 1 | SUNNY_LA | 晴朗 | 洛圣都专属天气 | +| 2 | EXTRASUNNY_SMOG_LA | 晴朗 | 洛圣都专属天气 | +| 3 | SUNNY_SMOG_LA | 晴朗 | 洛圣都专属天气 | +| 4 | CLOUDY_LA | 晴朗 | 洛圣都专属天气 | +| 5 | SUNNY_SF | 晴朗 | 圣菲耶罗专属天气 | +| 6 | EXTRASUNNY_SF | 晴朗 | 圣菲耶罗专属天气 | +| 7 | CLOUDY_SF | 晴朗 | 圣菲耶罗专属天气 | +| 8 | RAINY_SF | 暴雨 | 圣菲耶罗专属天气 | +| 9 | FOGGY_SF | 多云有雾 | 圣菲耶罗专属天气 | +| 10 | SUNNY_VEGAS | 清澈蓝天 | 拉斯云祖华专属天气 | +| 11 | EXTRASUNNY_VEGAS | 热浪 | 拉斯云祖华专属天气 | +| 12 | CLOUDY_VEGAS | 灰暗单调 | 拉斯云祖华专属天气 | +| 13 | EXTRASUNNY_COUNTRYSIDE | 灰暗单调 | 乡村地区专属天气 | +| 14 | SUNNY_COUNTRYSIDE | 灰暗单调 | 乡村地区专属天气 | +| 15 | CLOUDY_COUNTRYSIDE | 灰暗单调 | 乡村地区专属天气 | +| 16 | RAINY_COUNTRYSIDE | 阴云密布有雨 | 乡村地区专属天气 | +| 17 | EXTRASUNNY_DESERT | 热浪 | 骨镇专属天气 | +| 18 | SUNNY_DESERT | 热浪 | 骨镇专属天气 | +| 19 | SANDSTORM_DESERT | 沙尘暴 | 骨镇专属天气 | | 20 | UNDERWATER | 绿色雾状 | 视角在水下时内部使用 | -| 21 | EXTRACOLOURS_1 | 极暗渐变天际线（紫色） | 室内场景专用天气 | -| 22 | EXTRACOLOURS_2 | 极暗渐变天际线（紫色） | 室内场景专用天气 | +| 21 | EXTRACOLOURS_1 | 极暗渐变天际线（紫色） | 室内场景专用天气 | +| 22 | EXTRACOLOURS_2 | 极暗渐变天际线（紫色） | 室内场景专用天气 | 游戏共有 23 个有效天气 ID（0-22），最后两个为特殊色彩天气类型。但游戏本身不限制天气 ID 范围，可使用 0-255 任意数值。超出该范围的数值会进行 256 取模运算（例如天气 ID 300 等价于 ID 44，因为 300 % 256 = 44）。虽然 0-22 号天气能正常运作，但其他 ID 可能导致未定义行为：例如粉红色天空、特定时段纹理闪烁等异常效果。 @@ -37,6 +37,6 @@ sidebar_label: 天气ID列表 - 某些天气在不同时间段会呈现显著差异，可参考[此链接](http://hotmist.ddo.jp/id/weather.html)查看各天气类型的实时表现 -- [GTA 圣安地列斯天气图库](https://dev.prineside.com/en/gtasa_weather_id/)通过可视化形式更直观地展示了天气 ID 的运作机制。您可用其查看特定时段的天气效果，并排查引发异常效果的天气类型 +- [GTA 圣安地列斯天气图库](https://dev.prineside.com/en/gtasa_weather_id/)通过可视化形式更直观地展示了天气 ID 的运作机制。你可用其查看特定时段的天气效果，并排查引发异常效果的天气类型 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/server/CommonServerIssues.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/server/CommonServerIssues.md index b596549efce..b8e210818f6 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/server/CommonServerIssues.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/server/CommonServerIssues.md @@ -9,7 +9,7 @@ sidebar_label: 常见服务器问题 ## 服务器无法运行 - 防火墙已关闭 -您需要进行端口转发以允许玩家加入服务器。推荐使用 [PF Port Checker](https://portforward.com) 进行端口转发。若端口未转发，需在路由器中开启端口。可参考[路由器列表](https://portforward.com/router.htm)。 +你需要进行端口转发以允许玩家加入服务器。推荐使用 [PF Port Checker](https://portforward.com) 进行端口转发。若端口未转发，需在路由器中开启端口。可参考[路由器列表](https://portforward.com/router.htm)。 该网站包含完整的端口转发教程。 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/server/ControllingServer.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/server/ControllingServer.md index 711f9b78ce5..1edf12a3331 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/server/ControllingServer.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/server/ControllingServer.md @@ -152,7 +152,7 @@ unbanip 13.37.13.37 以下是你可以作为管理员使用的功能： -| 命令 | 描述 | +| 命令 | 说明 | | -------------------------------- | ------------------------------------------------------------------------------------------------------------- | | `/rcon cmdlist` | 显示命令列表。 | | `/rcon varlist` | 显示当前变量列表。 | @@ -186,7 +186,7 @@ unbanip 13.37.13.37 | `/rcon playertimeout [限制毫秒]` | 更改玩家在不发送任何数据包时的超时时间（默认 1000）。 | | `/rcon language [语言]` | 更改服务器语言（_示例：/rcon language 英语_）。在服务器浏览器中显示。 | -上述四个限制/计数参数专门用于防范可能通过冻结或崩溃方式攻击 SA-MP 服务器的各类工具。因此，请根据您的服务器实际需求进行配置。系统默认值已预设为安全基准，若发现存在误踢正常玩家的情况，请立即适当调高相关数值阈值以避免良性玩家遭受影响。 +上述四个限制/计数参数专门用于防范可能通过冻结或崩溃方式攻击 SA-MP 服务器的各类工具。因此，请根据你的服务器实际需求进行配置。系统默认值已预设为安全基准，若发现存在误踢正常玩家的情况，请立即适当调高相关数值阈值以避免良性玩家遭受影响。 ### 相关回调和函数 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/server/Installation.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/server/Installation.md index 6b25da1d6e5..faf6b41b9dd 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/server/Installation.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/server/Installation.md @@ -1,14 +1,14 @@ --- -title: 从 SA:MP 服务器迁移游戏模式到 open.mp 的完整指南 -sidebar_label: 服务器迁移指南 -description: 本教程面向需要将游戏模式从 SA:MP 服务器迁移至 open.mp 服务器的开发者。 +title: 安装 +sidebar_label: 安装 +description: 将游戏模式从 SA:MP 服务器迁移至 open.mp 服务器的指南。 --- **本教程适用于需要将游戏模式从 SA:MP 服务器迁移至 open.mp 服务器的开发者** -:::note +:::tip -如果您正在使用 FCNPC 插件，请暂时停止使用，因为该插件目前不兼容 open.mp。 +**FCNPC 用户的好消息！** 传统的 FCNPC 插件已被官方的 **open.mp NPC 组件** 取代，它提供了相同的功能，并且性能更好，集成更原生。只需将你的代码转换为内置的 NPC 组件即可。 ::: @@ -280,9 +280,9 @@ GivePlayerWeapon(playerid, WEAPON_KNIFE, 1);
-- **warning 234: 函数已弃用 (符号 "GetPlayerPoolSize") 此函数存在根本性缺陷** -- **warning 234: 函数已弃用 (符号 "GetVehiclePoolSize") 此函数存在根本性缺陷** -- **warning 234: 函数已弃用 (符号 "GetActorPoolSize") 此函数存在根本性缺陷** +- **warning 234: 函数已弃用 (符号 "GetPlayerPoolSize") 此函数已损坏。** +- **warning 234: 函数已弃用 (符号 "GetVehiclePoolSize") 此函数已损坏。** +- **warning 234: 函数已弃用 (符号 "GetActorPoolSize") 此函数已损坏。** 替换方案： diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/server/LinuxServerInstallation.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/server/LinuxServerInstallation.md index de74e9f2dfc..41d6844a76a 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/server/LinuxServerInstallation.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/server/LinuxServerInstallation.md @@ -1,53 +1,52 @@ --- -title: Linux系统安装服务器 -sidebar_label: Linux系统安装服务器 -description: 本指南提供在 Linux 系统上安装 open.mp 服务器的完整教程。 +title: Linux 服务器安装指南 +sidebar_label: Linux 服务器安装 +description: 在 Ubuntu 或其他基于 Debian 的 Linux 系统上安装 open.mp 服务器的完整指南。 --- -**本指南提供在 Ubuntu 或其他基于 Debian 的 Linux 系统上安装 open.mp 服务器的完整教程。 -无论您是新手还是需要温故知新，本指南都可能为您提供有价值的信息！** +**本指南包含了在 Ubuntu 或其他基于 Debian 的 Linux 系统上安装 open.mp 服务器的完整教程。 +无论你是初学者还是想要复习知识，本指南都可能对你有所帮助！** :::warning -若您仍在使用 SA:MP 服务器且尚未迁移至 open.mp，**[请立即停止并优先阅读此迁移指南](https://www.open.mp/docs/server/Installation)**。 +如果你正在使用 SA:MP 服务器且尚未转换到 open.mp，**[请先停止并阅读此指南](https://www.open.mp/docs/server/Installation)**。 ::: -:::note +:::tip -若您正在使用 FCNPC 插件，请暂停操作，因该插件目前暂不支持 open.mp。 +**FCNPC 用户的好消息！** 传统的 FCNPC 插件已被官方的 **open.mp NPC 组件** 取代，它提供了相同的功能，并且性能更好，集成更原生。只需将你的代码转换为内置的 NPC 组件即可。 ::: -## 先决条件 +## 前提条件 -开始前请确保具备： +开始之前，你需要具备： -- 运行 Ubuntu（推荐 20.04 或更新版本）或其他 Debian 系 Linux 的机器 -- 用于文件传输的 WinSCP 或 Filezilla -- PuTTY 或您的主机商 SSH 解决方案 +- 运行 Ubuntu（推荐 20.04 或更高版本）或其他基于 Debian 的 Linux 系统的机器； +- 用于文件传输的 WinSCP 或 Filezilla； +- PuTTY 或你的主机 SSH 解决方案； :::note -安装 WinSCP 时，安装程序会提示安装 PuTTY！ -您可选择立即安装或后续单独下载，此选项不影响后续操作。 +如果安装 WinSCP，安装程序会提示你安装 PuTTY！ +你可以选择是否安装，但之后也可以随时下载！ ::: -## 第一阶段：环境准备 +## 第一阶段：准备环境 1. 通过 SSH 连接： - - 使用 PuTTY 或主机商提供的 SSH 方案连接您的服务器实例 + - 使用 PuTTY 或你的主机 SSH 解决方案连接到你的实例。 :::note -若不确定如何连接 Linux 实例，请参考在线教程或主机商文档。 +如果你不确定如何连接到 Linux 实例，请查阅在线指南或你的主机提供商的文档。 ::: -2. 更新系统组件： - - - 执行以下命令确保系统处于最新状态： +2. 更新你的 Linux 实例： + - 在继续之前，确保你的系统是最新的，运行： ``` sudo apt update @@ -57,44 +56,61 @@ description: 本指南提供在 Linux 系统上安装 open.mp 服务器的完整 sudo apt upgrade ``` -3. 创建安全服务账户： - - - 为安全起见，创建无主目录的专用服务账户： +3. 创建安全的服务账户： + - 出于安全原因，我们应该创建一个没有主目录的专用服务账户： ``` sudo useradd -M svc-omp-server ``` 4. 锁定服务账户： - - - 禁止该服务账户用于登录： + - 防止服务账户被用于登录： ``` sudo usermod -L svc-omp-server ``` -5. 创建服务器文件目录： +5. 将你的用户添加到服务组： + - 将当前用户添加到 svc-omp-server 组，以便管理文件： + + ``` + sudo usermod -aG svc-omp-server $USER + ``` + + :::warning - - 使用标准第三方应用目录 /opt： + 你需要注销并重新登录才能使组更改生效！ + + ::: + +6. 创建服务器文件目录： + - 我们将使用 /opt 目录，这是第三方应用程序的标准位置： ``` sudo mkdir /opt/omp-server ``` -6. 设置目录权限： - - - 变更目录所属组以匹配服务账户： +7. 设置目录权限： + - 将目录的组更改为与服务账户匹配： ``` sudo chgrp svc-omp-server /opt/omp-server ``` - - 设置 g+s 标志使新文件继承正确组权限，并移除其他用户访问： + - 赋予组读取、写入和执行权限： + + ``` + sudo chmod g+rwx /opt/omp-server + ``` + + - 设置 g+s 标志，使新文件继承正确的组： ``` sudo chmod g+s /opt/omp-server ``` + - 移除其他人的访问权限： + ``` sudo chmod o-rwx /opt/omp-server ``` @@ -103,17 +119,15 @@ description: 本指南提供在 Linux 系统上安装 open.mp 服务器的完整 ## 第二阶段：安装 open.mp 服务器文件 -7. 进入服务器目录： - - - 切换至服务器文件存储位置： +8. 导航到服务器目录： + - 我们需要移动到 /opt/omp-server 目录，服务器将存储在此处： ``` cd /opt/omp-server ``` -8. 下载服务器文件： - - - 获取 open.mp 服务器最新版本： +9. 下载 open.mp 服务器文件： + - 下载最新版本的 open.mp 服务器： ``` sudo -u svc-omp-server wget https://github.com/openmultiplayer/open.mp/releases/download/vX.X.X.XXXX/open.mp-linux-x86.tar.gz @@ -121,26 +135,24 @@ description: 本指南提供在 Linux 系统上安装 open.mp 服务器的完整 :::warning -**请务必通过 open.mp GitHub 发布页面确认最新版本！** +**你应该始终在 open.mp GitHub 发布页面检查最新版本！** [https://github.com/openmultiplayer/open.mp/releases](https://github.com/openmultiplayer/open.mp/releases) ::: -9. 解压服务器文件： +10. 解压服务器文件： + - 下载完成后，解压文件： - - 下载完成后执行解压： - - ``` - sudo -u svc-omp-server tar -xzf open.mp-linux-x86.tar.gz - ``` + ``` + sudo -u svc-omp-server tar -xzf open.mp-linux-x86.tar.gz + ```
-## 第三阶段：配置与启动服务器 - -10. 安装 x86 依赖库： +## 第三阶段：配置和启动服务器 - - 因服务器为 32 位应用，需启用架构支持： +11. 安装所需软件包： + - 由于服务器作为 32 位应用程序运行，你需要启用 32 位架构支持并安装 screen： ``` sudo dpkg --add-architecture i386 @@ -151,12 +163,11 @@ description: 本指南提供在 Linux 系统上安装 open.mp 服务器的完整 ``` ``` - sudo apt install libc6:i386 + sudo apt install libc6:i386 screen ``` -11. 设置可执行权限： - - - 仅需执行一次的权限变更： +12. 使服务器可执行： + - 更改权限使服务器可以执行（仅需一次！）： ``` cd /opt/omp-server/Server/ @@ -166,48 +177,57 @@ description: 本指南提供在 Linux 系统上安装 open.mp 服务器的完整 sudo chmod +x omp-server ``` -12. 启动服务器： - - - 使用以下命令后台启动： +13. 启动服务器： + - 使用 screen 以服务账户身份在可分离的会话中启动服务器： ``` - nohup ./omp-server & + sudo -u svc-omp-server screen -dmS omp-server ./omp-server ``` - - 终端将显示进程 ID (PID)，请记录该数字以备后续使用 + :::tip -
+ 这将创建一个名为 "omp-server" 的分离 screen 会话，以服务账户身份运行。你可以随时附加到此会话来查看控制台！ + + ::: -## 第四阶段：服务器管理 +
-13. 停止服务器： +## 第四阶段：管理服务器 - - 使用步骤 12 记录的 PID 终止进程： +14. 查看服务器控制台： + - 附加到正在运行的服务器以查看控制台输出： ``` - sudo kill + sudo -u svc-omp-server screen -r omp-server ``` -14. 查询进程 ID（若遗忘）： + - 要从 screen 会话分离（保持运行），请按：`Ctrl+A` 然后 `D` - - 通过系统监控工具定位： +15. 停止服务器： + - 附加到 screen 会话（步骤 14），然后在控制台中输入 `/exit` 或按 `Ctrl+C` 优雅地停止服务器。 + - 或者，你可以终止 screen 会话： ``` - top + sudo -u svc-omp-server screen -X -S omp-server quit ``` - - 查找 omp-server 进程并记录 PID，按 Q 退出后执行步骤 13 操作 +16. 检查服务器是否正在运行： + - 查看所有 screen 会话： + + ``` + sudo -u svc-omp-server screen -ls + ```
-## 第五阶段：上传游戏模式与文件 +## 第五阶段：上传你的游戏模式和文件 -15. 上传自定义内容： - - 使用 WinSCP 或 Filezilla 将游戏模式与脚本传输至 /opt/omp-server 目录 - 重要提示：Linux 插件请使用 .so 文件，.dll 文件仅限 Windows 系统 +17. 上传你的自定义游戏模式和脚本： + - 使用 WinSCP 或 Filezilla 将你的游戏模式和脚本传输到 /opt/omp-server 目录。 + 重要提示：确保对 Linux 插件使用 .so 文件，因为 .dll 文件仅在 Windows 上受支持。 ## 获取帮助 -若仍遇到服务器配置问题，请加入 open.mp 官方 Discord 服务器：[https://discord.gg/samp](https://discord.gg/samp) +如果你在设置服务器时仍然遇到问题，请加入官方 open.mp Discord 服务器：[https://discord.gg/samp](https://discord.gg/samp) -在 [#openmp-support](https://discord.com/channels/231799104731217931/966398440051445790) 频道提问时请提及本指南，以便我们持续改进。 +在 [#openmp-support](https://discord.com/channels/231799104731217931/966398440051445790) 频道发布你的问题，并提及本指南，以便我们改进它。 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/server/RemoteConsole.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/server/RemoteConsole.md index 203a3bd498c..a8d4751c798 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/server/RemoteConsole.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/server/RemoteConsole.md @@ -21,4 +21,4 @@ description: 远程服务器管理。 - 示例：重启服务器直接输入 `gmx` 并回车即可 - 指令若包含 `/rcon` 前缀将无法执行 -祝您使用愉快！ +祝你使用愉快！ diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/server/config.json.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/server/config.json.md index c197c5b7910..df92fed9728 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/server/config.json.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/server/config.json.md @@ -1,13 +1,13 @@ --- title: config.json sidebar_label: config.json -description: open.mp服务器配置文件 +description: open.mp 服务器配置文件。 --- ## 描述 - `config.json`是用于配置 open.mp 服务器各项参数的配置文件 -- 仍支持使用[server.cfg](server.cfg)文件，但推荐使用 config.json 以获得更全面的配置选项 +- 你仍然可以在 open.mp 服务器中使用 [server.cfg](server.cfg) 文件，但建议使用 config.json，因为它有更多设置！
@@ -17,9 +17,9 @@ description: open.mp服务器配置文件 :::tip -可通过以下命令将 server.cfg 转换为 config.json： +你可以简单地将你的 server.cfg 转换为 config.json。 -在服务器目录打开命令行并执行： +在服务器目录中打开命令提示符，输入以下命令，然后按回车： ```bash # Windows @@ -29,7 +29,7 @@ omp-server --dump-config ./omp-server --dump-config ``` -**注意：** 若目录已存在 config.json 文件，需先删除再执行命令 +**注意：** 如果目录中有 config.json 文件，你可能需要在执行上述命令前删除它。 ::: @@ -37,7 +37,7 @@ omp-server --dump-config :::tip -生成默认配置文件命令： +要生成默认的 config.json，请输入以下命令： ```bash # Windows @@ -51,199 +51,249 @@ omp-server --default-config
-## 服务器公告 +## 服务器身份 -| 键名 | 类型 | 默认值 | 只读 | 规则 | 功能说明 | -| -------- | ------ | ------ | ---- | ---- | ---------------------------------------------------------------- | -| announce | 布尔值 | true | ❌ | ❌ | 控制是否向 open.mp 主列表公告服务器。设为`true`启用，`false`禁用 | +### 主机名 -## 自定义模型（资源） +| 键 | 类型 | 默认值 | 只读 | 规则 | 效果 | +| ---- | ------ | -------------- | ---- | ---- | ---------------------------------------------------- | +| name | string | open.mp server | ❌ | ❌ | 将在服务器浏览器中以及玩家连接到服务器时显示的名称。 | -| 键名 | 类型 | 默认值 | 只读 | 规则 | 功能说明 | -| ----------------------- | ------ | ------ | ---- | ---- | ------------------------------------- | -| artwork.cdn | 字符串 | | ✅ | ❌ | 远程模型服务器的 HTTP 地址 | -| artwork.enable | 布尔值 | true | ✅ | ✅ | 启用/禁用从/models 目录加载自定义模型 | -| artwork.models_path | 字符串 | models | ✅ | ❌ | 自定义模型存储路径 | -| artwork.port | 整型 | 7777 | ✅ | ❌ | 资源服务端口 | -| artwork.web_server_bind | 字符串 | | ✅ | ❌ | 资源服务绑定地址 | +### 语言 -## 聊天过滤器 +| 键 | 类型 | 默认值 | 只读 | 规则 | 效果 | +| -------- | ------ | ------ | ---- | ---- | -------------------------------------------------------------------- | +| language | string | | ❌ | ❌ | 服务器浏览器中显示的语言。玩家可以在服务器浏览器中按语言筛选服务器。 | -| 键名 | 类型 | 默认值 | 只读 | 规则 | 功能说明 | -| ----------------- | ------ | ------ | ---- | ---- | ---------------------------------------------------------------------------------------------------------------------------------------- | -| chat_input_filter | 布尔值 | true | ❌ | ❌ | 控制聊天输入过滤。禁用后可输入%等特殊字符，也可使用[ToggleChatTextReplacement](../scripting/functions/ToggleChatTextReplacement)函数控制 | +### 公告 -## 服务器信息查询 +| 键 | 类型 | 默认值 | 只读 | 规则 | 效果 | +| -------- | ---- | ------ | ---- | ---- | ----------------------------------------------------------------------------- | +| announce | bool | true | ❌ | ❌ | 切换是否向 open.mp 主列表公告服务器。设为 '**true**' 启用，'**false**' 禁用。 | -| 键名 | 类型 | 默认值 | 只读 | 规则 | 功能说明 | -| ------------ | ------ | ------ | ---- | ---- | ---------------------------------------------------------------------------- | -| enable_query | 布尔值 | true | ❌ | ❌ | 控制是否在服务器浏览器显示信息。禁用后玩家仍可加入，但浏览器不显示服务器详情 | +### 网站 URL -## 游戏设置 - -| 键名 | 类型 | 默认值 | 只读 | 规则 | 功能说明 | -| ---------------------------------- | ------ | ------ | ---- | ---- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| game.allow_interior_weapons | 布尔值 | true | ❌ | ❌ | 允许在室内使用武器 | -| game.chat_radius | 浮点数 | 200.0 | ❌ | ❌ | 聊天有效半径（单位：米），同时影响玩家在地图上的可见距离 | -| game.death_drop_amount | 整型 | 0 | ❌ | ❌ | 玩家死亡时掉落的现金金额 | -| game.gravity | 浮点数 | 0.008 | ❌ | ✅ | 全局重力参数（SA-MP 默认值为 0.008） | -| game.group_player_objects | 布尔值 | false | ❌ | ❌ | 优化玩家物体 ID 分配机制。SA-MP 中全局物体与玩家物体共享 ID 池，启用后服务器会尝试复用其他玩家已占用的玩家物体槽位，避免全局物体占满后无法创建玩家物体的问题 | -| game.lag_compensation_mode | 整型 | 1 | ✅ | ✅ | **0**：完全禁用延迟补偿，**1**：完全启用延迟补偿，**2**：仅启用位置补偿（不补偿玩家旋转） | -| game.map | 字符串 | | ❌ | ✅ | 服务器浏览器显示的自定义地图名称（例如："我的特技地图"） | -| game.mode | 字符串 | | ❌ | ❌ | 服务器浏览器显示的游戏模式名称，可通过[SetGameModeText](../scripting/functions/SetGameModeText)覆盖 | -| game.nametag_draw_radius | 浮点数 | 70.0 | ❌ | ❌ | 玩家名牌最大显示距离（单位：米） | -| game.player_marker_draw_radius | 浮点数 | 250.0 | ❌ | ❌ | 玩家标记显示半径（单位：米） | -| game.player_marker_mode | 整型 | 1 | ❌ | ❌ | **0**：禁用玩家标记，**1**：全局标记模式，**2**：流式标记模式。[标记模式文档](../scripting/resources/markermodes) | -| game.time | 整型 | 12 | ❌ | ✅ | 全局游戏时间（小时制，范围 0-23） | -| game.use_all_animations | 布尔值 | false | ✅ | ❌ | 启用所有版本动画（包含某些版本缺失的动画） | -| game.use_chat_radius | 布尔值 | false | ❌ | ❌ | 启用聊天距离限制 | -| game.use_entry_exit_markers | 布尔值 | true | ✅ | ❌ | 启用室内出入口标记（黄色箭头标识） | -| game.use_instagib | 布尔值 | false | ❌ | ❌ | 启用一击必杀模式（该功能在 SA-MP 客户端已移除，名称源自《雷神之锤》的 instagib 模式） | -| game.use_manual_engine_and_lights | 布尔值 | false | ❌ | ❌ | 手动控制车辆引擎和灯光。设为`false`时，游戏会自动开关引擎，并在黑暗时自动开启车灯 | -| game.use_nametag_los | 布尔值 | true | ❌ | ❌ | 启用名牌视线检测（Line-Of-Sight），防止透过墙壁看到玩家名牌 | -| game.use_nametags | 布尔值 | true | ❌ | ❌ | 显示玩家名牌、血条和护甲条 | -| game.use_player_marker_draw_radius | 布尔值 | false | ❌ | ❌ | 启用玩家标记（小地图上的雷达标记）显示 | -| game.use_player_ped_anims | 布尔值 | false | ❌ | ❌ | 使用标准 CJ 皮肤行走动画，而非各皮肤专属动画（如滑板皮肤的滑行动作） | -| game.use_stunt_bonuses | 布尔值 | true | ❌ | ❌ | 启用车辆特技奖励（如车辆翘轮行驶时给予金钱奖励） | -| game.use_vehicle_friendly_fire | 布尔值 | false | ❌ | ❌ | 启用车辆友军伤害（允许攻击同队伍车辆） | -| game.use_zone_names | 布尔值 | false | ❌ | ❌ | 显示区域名称（如进入"Vinewood"区域时右下角显示文字提示） | -| game.validate_animations | 布尔值 | true | ❌ | ❌ | 验证玩家动画有效性 | -| game.vehicle_respawn_time | 整型 | 10000 | ❌ | ❌ | 车辆重生时间（单位：毫秒，默认 10 秒） | -| game.weather | 整型 | 10 | ❌ | ✅ | 全局天气 ID（SA-MP 默认天气为 10） | - -## 语言设置 - -| 键名 | 类型 | 默认值 | 只读 | 规则 | 功能说明 | -| -------- | ------ | ------ | ---- | ---- | ------------------------------------------- | -| language | 字符串 | | ❌ | ❌ | 服务器浏览器显示的语言标识（例如："zh-CN"） | - -## 日志配置 - -| 键名 | 类型 | 默认值 | 只读 | 规则 | 功能说明 | -| ------------------------------- | ------ | --------------------- | ---- | ---- | ------------------------------------------------------------------------------------------------------------------------ | -| logging.enable | 布尔值 | true | ❌ | ❌ | 启用日志系统 | -| logging.file | 字符串 | log.txt | ✅ | ❌ | 日志文件存储路径 | -| logging.log_chat | 布尔值 | true | ❌ | ❌ | 记录玩家聊天内容 | -| logging.log_connection_messages | 布尔值 | true | ❌ | ❌ | 记录玩家连接/断开事件 | -| logging.log_cookies | 布尔值 | false | ❌ | ❌ | 记录连接 cookie 信息（用于追踪异常连接） | -| logging.log_deaths | 布尔值 | true | ❌ | ❌ | 记录玩家死亡事件 | -| logging.log_queries | 布尔值 | false | ❌ | ❌ | 记录所有玩家查询请求（用于防御 DDoS 攻击） | -| logging.log_sqlite | 布尔值 | false | ❌ | ❌ | 记录 SQLite 数据库错误 | -| logging.log_sqlite_queries | 布尔值 | false | ❌ | ❌ | 记录所有 SQL 查询语句（调试用） | -| logging.timestamp_format | 字符串 | [%Y-%m-%dT%H:%M:%S%z] | ✅ | ❌ | 时间戳格式（基于 C/C++的 strftime 函数）。示例：**[%H:%M:%S]** 显示时分秒，**[%d/%m/%Y %H:%M:%S]** 显示日/月/年 时:分:秒 | -| logging.use_prefix | 布尔值 | true | ❌ | ❌ | 在日志条目前添加类型前缀（如[Info]） | -| logging.use_timestamp | 布尔值 | true | ❌ | ❌ | 在日志条目前添加时间戳 | +| 键 | 类型 | 默认值 | 只读 | 规则 | 效果 | +| ------- | ------ | ------- | ---- | ---- | -------------------------------------------- | +| website | string | open.mp | ✅ | ✅ | 玩家可以访问以获取有关服务器更多信息的网站。 | -## 玩家与 NPC +### Discord -| 键名 | 类型 | 默认值 | 只读 | 规则 | 功能说明 | -| ----------- | ---- | ------ | ---- | ---- | ---------------------------- | -| max_bots | 整型 | 0 | ❌ | ❌ | NPC 最大数量（占用玩家槽位） | -| max_players | 整型 | 50 | ✅ | ❌ | 玩家最大数量（范围 1-1000） | - -## 服务器名称 - -| 键名 | 类型 | 默认值 | 只读 | 规则 | 功能说明 | -| ---- | ------ | -------------- | ---- | ---- | -------------------------------------------------- | -| name | 字符串 | open.mp server | ❌ | ❌ | 服务器显示名称（显示在服务器浏览器和玩家连接界面） | - -## 网络配置 - -| 键名 | 类型 | 默认值 | 只读 | 规则 | 功能说明 | -| ------------------------------- | ------ | ------ | ---- | ---- | -------------------------------------------------------------------------------------------------------------- | -| network.acks_limit | 整型 | 3000 | ❌ | ❌ | ACK 确认包数量限制（防 DDoS 设置） | -| network.aiming_sync_rate\* | 整型 | 30 | ✅ | ❌ | 瞄准状态同步间隔（单位：毫秒，值越低同步越精确但增加带宽消耗） | -| network.allow_037_clients | 布尔值 | true | ❌ | ❌ | 允许 0.3.7 旧版客户端连接 | -| network.bind | 字符串 | | ✅ | ❌ | 服务器绑定 IP 地址（用于多 IP 服务器） | -| network.cookie_reseed_time | 整型 | 300000 | ❌ | ❌ | 连接 cookie 种子刷新间隔（单位：毫秒，默认 5 分钟） | -| network.grace_period | 整型 | 5000 | ❌ | ❌ | 同 IP 连接宽限期（单位：毫秒，服务器启动后 5 秒内允许同一 IP 无限连接，主要用于 NPC 批量连接） | -| network.http_threads | 整型 | 50 | ❌ | ❌ | HTTP 服务线程数 | -| network.in_vehicle_sync_rate\* | 整型 | 30 | ✅ | ❌ | 车辆内状态同步间隔（单位：毫秒） | -| network.limits_ban_time | 整型 | 60000 | ❌ | ❌ | 违规连接封禁时间（单位：毫秒，当触发 acks/messages 限制时生效） | -| network.message_hole_limit | 整型 | 3000 | ❌ | ❌ | 消息空洞数量限制（防 DDoS 设置） | -| network.messages_limit | 整型 | 500 | ❌ | ❌ | 客户端每秒最大消息数限制 | -| network.minimum_connection_time | 整型 | 0 | ❌ | ❌ | 最小连接间隔（单位：毫秒，用于防御连接洪水攻击） | -| network.mtu | 整型 | 576 | ✅ | ❌ | 最大传输单元（保持默认值，修改不当会导致连接问题。详见[维基百科](https://zh.wikipedia.org/wiki/最大传输单元)） | -| network.multiplier | 整型 | 10 | ❌ | ❌ | 网络流量乘数（调整带宽使用） | -| network.on_foot_sync_rate\* | 整型 | 30 | ✅ | ❌ | 步行状态同步间隔（单位：毫秒） | -| network.player_marker_sync_rate | 整型 | 2500 | ✅ | ❌ | 玩家标记同步间隔（单位：毫秒） | -| network.player_timeout | 整型 | 10000 | ❌ | ❌ | 玩家连接超时时间（单位：毫秒，10 秒无响应后断开） | -| network.port | 整型 | 7777 | ✅ | ❌ | 服务器端口（需进行[端口转发](https://portforward.com)） | -| network.public_addr | 字符串 | | ✅ | ❌ | 公网地址（用于资源下载服务） | -| network.stream_radius | 浮点数 | 200.0 | ❌ | ❌ | 实体流加载半径（单位：米，范围 50.0-400.0） | -| network.stream_rate | 整型 | 1000 | ❌ | ❌ | 流加载检测间隔（单位：毫秒，范围 500-5000） | -| network.time_sync_rate | 整型 | 30000 | ❌ | ❌ | 时间同步间隔（单位：毫秒） | -| network.use_lan_mode | 布尔值 | false | ❌ | ❌ | 已弃用参数（原用于局域网模式） | - -> [*] `aiming_sync_rate`、`in_vehicle_sync_rate`和`on_foot_sync_rate`数值越低同步越精确，但会增加带宽消耗 - -## 服务器密码 - -| 键名 | 类型 | 默认值 | 只读 | 规则 | 功能说明 | -| -------- | ------ | ------ | ---- | ---- | ---------------------------------- | -| password | 字符串 | | ❌ | ❌ | 服务器访问密码（留空表示无需密码） | - -## Pawn 脚本 - -| 键名 | 类型 | 默认值 | 只读 | 规则 | 功能说明 | -| ------------------- | ------------ | ---------- | ---- | ---- | ----------------------------------------------------- | -| pawn.legacy_plugins | 列表, 字符串 | [] | ✅ | ❌ | 加载传统插件列表（示例：`["mysql", "streamer"]`） | -| pawn.main_scripts | 列表, 字符串 | ["test 1"] | ✅ | ❌ | 主游戏模式脚本（.amx 文件路径） | -| pawn.side_scripts | 列表, 字符串 | [] | ✅ | ❌ | 滤镜脚本列表（示例：`["filterscripts/Race_System"]`） | - -## 远程控制台 - -| 键名 | 类型 | 默认值 | 只读 | 规则 | 功能说明 | -| ------------------- | ------ | -------- | ---- | ---- | ----------------------------------------------- | -| rcon.allow_teleport | 布尔值 | false | ✅ | ❌ | 允许 RCON 管理员通过地图标记传送 | -| rcon.enable | 布尔值 | false | ✅ | ❌ | 启用远程控制台功能 | -| rcon.password | 字符串 | changeme | ❌ | ❌ | RCON 密码（必须修改默认值，否则服务器无法启动） | - -## 性能优化 - -| 键名 | 类型 | 默认值 | 只读 | 规则 | 功能说明 | -| ------------- | ------ | ------ | ---- | ---- | ---------------------------------------------------------------------------------------------------- | -| sleep | 浮点数 | 5.0 | ❌ | ❌ | 主线程休眠时间（单位：毫秒，值越高 CPU 占用越低但同步质量下降） | -| use_dyn_ticks | 布尔值 | true | ✅ | ❌ | 动态调整 tick 率（例如 sleep=5 时恒定 200 ticks/秒）。通过动态补偿代码执行时间差异来维持稳定 tick 率 | - -## 主机名 - -| 键名 | 类型 | 默认值 | 只读 | 规则 | 功能说明 | -| ------- | ------ | ------- | ---- | ---- | ------------------ | -| website | 字符串 | open.mp | ❌ | ✅ | 服务器官方网站地址 | - -## Discord 设置 - -| 键名 | 类型 | 默认值 | 只读 | 规则 | 功能说明 | -| -------------- | ------ | ----------------------- | ---- | ---- | ------------------------------------------------- | -| discord.invite | 字符串 | https://discord.gg/samp | ❌ | ❌ | Discord 服务器邀请链接（显示在 open.mp 启动器中） | +| 键 | 类型 | 默认值 | 只读 | 规则 | 效果 | +| -------------- | ------ | ----------------------- | ---- | ---- | ------------------------------------------ | +| discord.invite | string | https://discord.gg/samp | ❌ | ❌ | 在 omp 启动器中显示的服务器 Discord 地址。 | ![](https://i.ibb.co/cTRq5pr/294345382-54d77460-da32-458e-bcfa-10ebec90fbfa.png) -## 横幅设置 +### 横幅 -| 键名 | 类型 | 默认值 | 只读 | 规则 | 功能说明 | -| ------------- | ------ | ------ | ---- | ---- | ----------------------------------------- | -| banners.light | 字符串 | | ❌ | ❌ | 浅色主题横幅 URL（分辨率建议：1200x240） | -| banners.dark | 字符串 | | ❌ | ❌ | 深色主题横幅 URL（支持透明背景 PNG 格式） | +| 键 | 类型 | 默认值 | 只读 | 规则 | 效果 | +| ------------- | ------ | ------ | ---- | ---- | ---------------------------------------------- | +| banners.light | string | | ❌ | ❌ | 在 omp 启动器中显示的服务器浅色横幅 URL 地址。 | +| banners.dark | string | | ❌ | ❌ | 在 omp 启动器中显示的服务器深色横幅 URL 地址。 | ![](https://i.ibb.co/86T8wYG/image.png) -## 服务器 LOGO +### 服务器徽标 -| 键名 | 类型 | 默认值 | 只读 | 规则 | 功能说明 | -| ---- | ------ | ------ | ---- | ---- | ----------------------------------------------------------------- | -| logo | 字符串 | | ❌ | ❌ | 服务器 LOGO URL（显示在启动器和 Discord 状态，建议尺寸：512x512） | +| 键 | 类型 | 默认值 | 只读 | 规则 | 效果 | +| ---- | ------ | ------ | ---- | ---- | --------------------------------------------------------- | +| logo | string | | ❌ | ❌ | 在 omp 启动器和 Discord 状态中显示的服务器徽标 URL 地址。 | ![](https://i.ibb.co/VQZch1Y/image-1.png) +## 连接与网络 + +### 网络 + +| 键 | 类型 | 默认值 | 只读 | 规则 | 效果 | +| ------------------------------- | ------ | ------ | ---- | ---- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| network.acks_limit | int | 3000 | ❌ | ❌ | | +| network.aiming_sync_rate\* | int | 30 | ✅ | ❌ | 客户端在射击武器时应向服务器更新新数据的毫秒数。 | +| network.allow_037_clients | bool | true | ❌ | ❌ | 切换是否允许使用 0.3.7 客户端的玩家加入服务器。 | +| network.use_omp_encryption | bool | false | ❌ | ❌ | 切换 open.mp 数据包加密以提供额外保护（默认协议仍可同时工作）。 | +| network.bind | string | | ✅ | ❌ | 服务器应使用的 IP 地址。服务器将强制使用此 IP 地址，而不是自动选择空闲的 IP 地址。此 IP 地址必须与服务器上网卡分配的地址之一匹配。这对于在同一台机器上的同一端口运行多个服务器非常有用。 | +| network.cookie_reseed_time | int | 300000 | ❌ | ❌ | 连接 Cookie 种子值更新的毫秒数。 | +| network.grace_period | int | 5000 | ❌ | ❌ | 这是服务器启动后允许来自同一 IP 的无限连接的宽限期，主要用于 NPC。
默认：5 秒 | +| network.http_threads | int | 50 | ❌ | ❌ | | +| network.in_vehicle_sync_rate\* | int | 30 | ✅ | ❌ | 客户端在车辆内时应向服务器更新新数据的毫秒数。 | +| network.limits_ban_time | int | 60000 | ❌ | ❌ | 设置达到错误连接数据包限制（当达到 acks/消息限制时）的 raknet 封禁时间（毫秒）。 | +| network.message_hole_limit | int | 3000 | ❌ | ❌ | 用于处理 DoS 攻击的网络级别设置。 | +| network.messages_limit | int | 500 | ❌ | ❌ | 用户每秒可以发送的最大消息数。 | +| network.minimum_connection_time | int | 0 | ❌ | ❌ | 服务器在接受另一个传入连接之前将等待的毫秒数。除非你的服务器受到连接洪水攻击，否则不建议使用此变量。 | +| network.mtu | int | 576 | ✅ | ❌ | 保持默认值，如果你不知道这是什么，你真的不需要也不应该更改它，因为如果你不知道，那么你的服务器上没有任何东西需要更高的 MTU，但如果你仍然感兴趣：https://zh.wikipedia.org/wiki/%E6%9C%80%E5%A4%A7%E4%BC%A0%E8%BE%93%E5%8D%95%E5%85%83 | +| network.multiplier | int | 10 | ❌ | ❌ | | +| network.on_foot_sync_rate\* | int | 30 | ✅ | ❌ | 客户端在步行时应向服务器更新新数据的毫秒数。 | +| network.player_marker_sync_rate | int | 2500 | ✅ | ❌ | 客户端在移动时应向服务器更新新数据的毫秒数。 | +| network.player_timeout | int | 10000 | ❌ | ❌ | 玩家在未向服务器发送任何数据后超时的毫秒数。 | +| network.port | int | 7777 | ✅ | ❌ | 服务器应使用的端口。你需要[端口转发](https://portforward.com)才能让玩家从你的局域网外部加入你的服务器。 | +| network.public_addr | string | | ✅ | ❌ | 运行服务器的某些机器可能具有不同的 IP，此设置用于在 `bind` 配置中设置的地址不同时设置一个新地址。此配置变量仅用于 DL 服务器，因为在 open.mp 中，它将托管一个用于下载模型的 Web 服务器。 | +| network.stream_radius | float | 200.0 | ❌ | ❌ | 玩家将在 X,Y 平面上流式加载服务器实体的距离。最大值为 **400.0**，最小值为 **50.0**。较高的值使玩家可以在更远的距离看到服务器实体，但需要更多的客户端处理能力和潜在的更多带宽。 | +| network.stream_rate | int | 1000 | ❌ | ❌ | 为每个玩家重新测试服务器实体流式加载前的毫秒数。最大值为 **5000**，最小值为 **500**。较低的值会增加服务器处理量，因为它必须更频繁地为每个玩家重新检查流式条件。 | +| network.time_sync_rate | int | 30000 | ❌ | ❌ | 玩家游戏时间更新的速率（毫秒）。 | +| network.use_lan_mode | bool | false | ❌ | ❌ | 已弃用的变量，无效。 | + +> [*] 降低 `aiming_sync_rate`、`in_vehicle_sync_rate` 和 `on_foot_sync_rate` 的值会提高同步性能，但会使用更多带宽。 + +### 服务器锁定 + +| 键 | 类型 | 默认值 | 只读 | 规则 | 效果 | +| -------- | ------ | ------ | ---- | ---- | ------------------------------------------------------------------------ | +| password | string | | ❌ | ❌ | 用于锁定服务器的密码。使用此密码后，只有知道此密码的玩家才能加入服务器。 | + +### 查询服务器信息 + +| 键 | 类型 | 默认值 | 只读 | 规则 | 效果 | +| ------------ | ---- | ------ | ---- | ---- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | +| enable_query | bool | true | ❌ | ❌ | 切换是否应在服务器浏览器中显示服务器信息。设为 '**true**' 启用或 '**false**' 禁用。玩家仍然可以加入已禁用查询的服务器，但服务器浏览器将不显示任何信息。 | + +## 玩家与 NPC + +### 玩家和 NPC 限制 + +| 键 | 类型 | 默认值 | 只读 | 规则 | 效果 | +| ----------- | ---- | ------ | ---- | ---- | ------------------------------------------------------------------------------------------------------------- | +| max_bots | int | 0 | ❌ | ❌ | 你的服务器可以容纳的 NPC 最大数量。通过更改此数字，你可以改变有多少玩家插槽可由 NPC 使用。 | +| max_players | int | 50 | ✅ | ❌ | 你的服务器可以容纳的玩家最大数量。通过更改此数字，你可以改变可以进入服务器的玩家数量。最大为 1000，最小为 1。 | + +### NPC 更新速率 + +| 键 | 类型 | 默认值 | 只读 | 规则 | 效果 | +| ------------------------ | ---- | ---------------------------- | ---- | ---- | ------------------------------------------------------------------------------- | +| npc.aiming_sync_rate | int | network.aiming_sync_rate | ❌ | ❌ | NPC 瞄准同步速率（毫秒）。如果未设置，则默认为 network.aiming_sync_rate。 | +| npc.in_vehicle_sync_rate | int | network.in_vehicle_sync_rate | ❌ | ❌ | NPC 车辆内同步速率（毫秒）。如果未设置，则默认为 network.in_vehicle_sync_rate。 | +| npc.on_foot_sync_rate | int | network.on_foot_sync_rate | ❌ | ❌ | NPC 步行同步速率（毫秒）。如果未设置，则默认为 network.on_foot_sync_rate。 | +| npc.process_update_rate | int | 50 | ❌ | ❌ | 通用 NPC 处理更新速率（毫秒）。 | + +### NPC 同步跳过更新限制 + +| 键 | 类型 | 默认值 | 只读 | 规则 | 效果 | +| ------------------------------------- | ---- | ------ | ---- | ---- | ----------------------------------------------------------- | +| npc.aim_sync_skip_update_limit | int | 15 | ❌ | ❌ | 空闲 NPC 在瞄准时跳过的同步更新次数，超过此限制后强制同步。 | +| npc.in_vehicle_sync_skip_update_limit | int | 15 | ❌ | ❌ | 空闲 NPC 在车辆内跳过的同步更新次数，超过此限制后强制同步。 | +| npc.on_foot_sync_skip_update_limit | int | 15 | ❌ | ❌ | 空闲 NPC 在步行时跳过的同步更新次数，超过此限制后强制同步。 | + +## 游戏设置 + +| 键 | 类型 | 默认值 | 只读 | 规则 | 效果 | +| ---------------------------------- | ------ | ------ | ---- | ---- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| game.allow_interior_weapons | bool | true | ❌ | ❌ | 切换是否允许在室内使用武器。'**true**' 允许在室内使用武器，'**false**' 禁用。 | +| game.chat_radius | float | 200.0 | ❌ | ❌ | 设置聊天的半径限制。只有距离玩家一定距离内的玩家才能在聊天中看到他们的消息。同时改变玩家在地图上看到其他玩家的距离。 | +| game.death_drop_amount | int | 0 | ❌ | ❌ | | +| game.gravity | float | 0.008 | ❌ | ✅ | 服务器使用的全局重力。 | +| game.group_player_objects | bool | false | ❌ | ❌ | 在 SA:MP 中，每个玩家对象和全局对象共享一个 ID 池。如果一个 ID 被"分配"给玩家，每个玩家都可以拥有一个具有该 ID 的唯一对象，但如果你创建了最大数量的全局对象，那么你就无法再创建任何每个玩家对象。
如果启用了玩家对象分组，服务器将尝试查找另一个玩家已使用的玩家对象插槽。 | +| game.lag_compensation_mode | int | 1 | ✅ | ✅ | **0**：完全禁用延迟补偿。

**1**：完全启用延迟补偿。

**2**：仅启用位置延迟补偿。这意味着玩家旋转将不会进行延迟补偿。 | +| game.map | string | | ❌ | ✅ | 服务器浏览器中显示的地图名称。可以是任何内容，例如 My Stunt Map。 | +| game.mode | string | | ❌ | ❌ | 服务器浏览器中显示的模式。使用 [SetGameModeText](../scripting/functions/SetGameModeText) 具有相同的效果，并覆盖 config.json 中使用的值。如果你有多个需要不同游戏模式文本的游戏模式，请使用此函数。 | +| game.nametag_draw_radius | float | 70.0 | ❌ | ❌ | 设置显示玩家名称的最大距离。 | +| game.player_marker_draw_radius | float | 250.0 | ❌ | ❌ | 为所有玩家设置标记半径。 | +| game.player_marker_mode | int | 1 | ❌ | ❌ | **0**：标记模式关闭

**1**：标记模式全局

**2**：标记模式流式

[标记模式](../scripting/resources/markermodes) | +| game.time | int | 12 | ❌ | ✅ | 服务器使用的全局世界时间，并将在服务器浏览器中显示。 | +| game.use_all_animations | bool | false | ✅ | ❌ | 允许使用某些版本中缺失的动画。'**true**' 启用所有动画，'**false**' 禁用。 | +| game.use_chat_radius | bool | false | ❌ | ❌ | 启用/禁用聊天半径。 | +| game.use_entry_exit_markers | bool | true | ✅ | ❌ | 启用/禁用游戏中所有的室内入口和出口（门处的黄色箭头）。 | +| game.use_instagib | bool | false | ❌ | ❌ | instagib 是一个旧的配置变量，在 sa-mp 客户端中已不可用，名称可能来自 Quake 游戏，instagib 基本上是瞬间击杀或一击必杀，在游戏中启用一击必杀功能（目前不可用，因为 sa-mp 在客户端移除了此功能） | +| game.use_manual_engine_and_lights | bool | false | ❌ | ❌ | 控制车辆引擎和灯光。**false**：防止游戏在玩家进入/退出车辆时自动打开/关闭引擎，以及在天黑时自动打开前灯。 | +| game.use_nametag_los | bool | true | ❌ | ❌ | 切换玩家上方名称标签、生命条和护甲条的视线（Line-Of-Sight）。 | +| game.use_nametags | bool | true | ❌ | ❌ | 切换玩家上方名称标签、生命条和护甲条的绘制。 | +| game.use_player_marker_draw_radius | bool | false | ❌ | ❌ | 切换玩家标记（雷达上的光点）。 | +| game.use_player_ped_anims | bool | false | ❌ | ❌ | 使用标准玩家行走动画（CJ 皮肤的动画）而不是每个皮肤的自定义动画（例如滑板皮肤的滑行动画）。 | +| game.use_stunt_bonuses | bool | true | ❌ | ❌ | 为所有玩家启用或禁用特技奖励。如果启用，玩家在车辆中表演特技（例如翘轮）时将获得金钱奖励。 | +| game.use_vehicle_friendly_fire | bool | false | ❌ | ❌ | 为团队车辆启用友军伤害。玩家将无法损坏队友的车辆。 | +| game.use_zone_names | bool | false | ❌ | ❌ | 允许开启区域名称，例如玩家进入区域时屏幕右下角显示的 "Vinewood" 或 "Doherty" 文本。 | +| game.validate_animations | bool | true | ❌ | ❌ | 验证玩家的动画。 | +| game.vehicle_respawn_time | int | 10000 | ❌ | ❌ | 设置车辆重生时间（毫秒）。（默认 10 秒） | +| game.weather | int | 10 | ❌ | ✅ | 服务器使用的全局天气，并将在服务器浏览器中显示。 | + +## 聊天 + +| 键 | 类型 | 默认值 | 只读 | 规则 | 效果 | +| ----------------- | ---- | ------ | ---- | ---- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | +| chat_input_filter | bool | true | ❌ | ❌ | 切换聊天输入过滤器。禁用它以在聊天中使用像 % 这样的字符。你也可以使用 [ToggleChatTextReplacement](../scripting/functions/ToggleChatTextReplacement) 函数。 | + +## 自定义模型（艺术作品） + +| 键 | 类型 | 默认值 | 只读 | 规则 | 效果 | +| ----------------------- | ------ | ------ | ---- | ---- | ------------------------------------------------------------------------------------------ | +| artwork.cdn | string | | ✅ | ❌ | 远程模型服务器的 http 地址。 | +| artwork.enable | bool | true | ✅ | ✅ | 切换服务器是否使用 /models 文件夹中的自定义模型。设为 '**true**' 启用或 '**false**' 禁用。 | +| artwork.models_path | string | models | ✅ | ❌ | 自定义模型所在的路径。 | +| artwork.port | int | 7777 | ✅ | ❌ | | +| artwork.web_server_bind | string | | ✅ | ❌ | | + +## Pawn + +| 键 | 类型 | 默认值 | 只读 | 规则 | 效果 | +| ------------------- | ------------ | ---------- | ---- | ---- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| pawn.legacy_plugins | list, string | [] | ✅ | ❌ | /plugins 文件夹中的 .dll 或 .so 文件，服务器应将其作为插件运行。插件是旨在增强游戏模式和过滤器脚本的脚本。
示例：`["mysql", "streamer"]` | +| pawn.main_scripts | list, string | ["test 1"] | ✅ | ❌ | /gamemodes 文件夹中的 .amx 文件，服务器应将其作为游戏模式运行。 | +| pawn.side_scripts | list, string | [] | ✅ | ❌ | /filterscripts 文件夹中的 .amx 文件，服务器应将其作为过滤器脚本运行。过滤器脚本是在游戏模式后台运行的脚本。它们用于向服务器添加额外功能而无需编辑游戏模式。如果你想将特定属性应用于多个游戏模式，这将非常有用。
示例：`["filterscripts/Race_System"]` | + +## RCON + +| 键 | 类型 | 默认值 | 只读 | 规则 | 效果 | +| ------------------- | ------ | -------- | ---- | ---- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | +| rcon.allow_teleport | bool | false | ✅ | ❌ | 确定 RCON 管理员在设置路径点时是否会被传送至该处。设为 '**true**' 启用或 '**false**' 禁用。 | +| rcon.enable | bool | false | ✅ | ❌ | 切换是否应使用[远程控制台](RemoteConsole)功能。设为 '**true**' 启用或 '**false**' 禁用。 | +| rcon.password | string | changeme | ❌ | ❌ | 用于管理服务器和使用远程控制台（rcon）的密码。你必须确保将其更改为难以破解的密码，以免他人控制你的服务器。如果 RCON 密码是 changeme，你的服务器将无法启动！ | + +## 日志记录 + +| 键 | 类型 | 默认值 | 只读 | 规则 | 效果 | +| ------------------------------- | ------ | --------------------- | ---- | ---- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| logging.enable | bool | true | ❌ | ❌ | 启用/禁用日志记录。 | +| logging.file | string | log.txt | ✅ | ❌ | 保存服务器日志的路径和文件名。 | +| logging.log_chat | bool | true | ❌ | ❌ | 切换是否应在服务器控制台中显示玩家聊天。有助于防止日志变得臃肿，或者如果你有另一个脚本化的聊天记录解决方案。设为 '**true**' 启用或 '**false**' 禁用。 | +| logging.log_connection_messages | bool | true | ❌ | ❌ | 启用/禁用玩家和 NPC 加入消息。 | +| logging.log_cookies | bool | false | ❌ | ❌ | 切换记录新连接玩家请求的连接 Cookie。设为 '**true**' 启用或 '**false**' 禁用。 | +| logging.log_deaths | bool | true | ❌ | ❌ | 切换是否应在服务器控制台中显示玩家死亡。设为 '**true**' 启用或 '**false**' 禁用。 | +| logging.log_queries | bool | false | ❌ | ❌ | 切换是否应记录玩家发送到服务器的所有查询。设为 '**true**' 启用或 '**false**' 禁用。这在 DDoS 攻击期间非常有用。 | +| logging.log_sqlite | bool | false | ❌ | ❌ | 在服务器控制台中记录 sqlite DB\_\* 函数错误。 | +| logging.log_sqlite_queries | bool | false | ❌ | ❌ | 记录所有 sqlite DB_Query 调用，包括查询字符串。 | +| logging.timestamp_format | string | [%Y-%m-%dT%H:%M:%S%z] | ✅ | ❌ | 应使用的时间戳格式。该格式基于 C/C++ 中的 [strftime](http://cplusplus.com/reference/ctime/strftime/) 格式。以下是一些示例：

**[%H:%M:%S]** 仅显示时间。

**[%d/%m/%Y %H:%M:%S]** 这将以 dd/mm/yyyy 格式显示日期，后跟 hour:minute:second 格式的时间。 | +| logging.use_prefix | bool | true | ❌ | ❌ | 切换是否应在每条控制台消息中打印前缀，例如 `[Info]`。设为 '**true**' 启用或 '**false**' 禁用。 | +| logging.use_timestamp | bool | true | ❌ | ❌ | 切换是否应在每条控制台消息中打印时间戳。设为 '**true**' 启用或 '**false**' 禁用。 | + +## 性能 + +### 休眠与时钟周期 + +| 键 | 类型 | 默认值 | 只读 | 规则 | 效果 | +| ------------- | ----- | ------ | ---- | ---- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| sleep | float | 5.0 | ❌ | ❌ | 主 open.mp 和 raknet 网络线程在每个同步周期内将"休眠"空闲的毫秒数。较高的值会降低服务器处理量，但会降低同步质量。较低的值会增加服务器处理量，但会提高同步质量。除非你的玩家数量非常高并且服务器 FPS 稳定性有问题，否则不建议更改此值。 | +| use_dyn_ticks | bool | true | ✅ | ❌ | dynticks 配置基本上是为了通过使用更多 CPU 来弥补任何下降，从而将服务器的时钟周期保持在恒定计数。
它是使用提供的 sleep 值计算的，因此如果 sleep 为 5，则恒定时钟周期计数为 1000 / 5 = 200 ticks/秒。
open.mp 根据每个时钟周期的代码执行时间动态修改内部 sleep 值，只是为了将其稳定在 200 ticks，较低的 sleep 意味着更多的 CPU 使用（如果服务器代码编写良好，则差异不大） | + +
+ +## 环境变量扩展 + +`config.json` 字符串可以使用 `${VAR}` 从环境变量中提取值。服务器在启动期间解析它们，open.mp 内部没有 .env 解析器，因此请确保环境已预先填充（shell `export`、Docker `env_file`、systemd `Environment=` 等）。 + +**示例：** + +```json +{ + "password": "${SERVER_PASSWORD}", + "logging": { + "enable": "${LOG_TOGGLE}:-true" // 这默认为 true + }, + "banners": { + "dark": "${BANNER_DARK}:-", // 这默认为横幅上无图像 + "light": "${BANNER_LIGHT}" + } +} +``` + +- `${VAR}` 默认变量语法 +- `${VAR:-default}` 在变量缺失时提供回退值 +- `$${VAR}` 转义以在配置中将 `${VAR}` 保留为文本 +
:::note -- 标记"只读"的参数需重启服务器生效，其他参数可通过[SendRconCommand](../scripting/functions/SendRconCommand)实时修改 -- 标记"规则"的参数会显示在服务器浏览器的规则栏 -- 带(\*)的参数需平衡性能与带宽消耗 -- 网络参数修改前建议备份配置文件 +- 标记为"只读"的值在运行时无法更改。所有其他值可以通过将它们传递给 [SendRconCommand](../scripting/functions/SendRconCommand) 或通过服务器控制台（临时）更改。 + +- 标记为"规则"的值显示在服务器浏览器的"规则"部分中。 ::: diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/server/omp-functions.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/server/omp-functions.md index bc92d1e3829..8ba1d560932 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/server/omp-functions.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/server/omp-functions.md @@ -8,7 +8,7 @@ description: open.mp 新增函数与回调说明。 ## 玩家相关 -| 名称 | +| 参数 | | ----------------------------------------------------------------------------------- | | [TogglePlayerWidescreen](../scripting/functions/TogglePlayerWidescreen) | | [IsPlayerWidescreenToggled](../scripting/functions/IsPlayerWidescreenToggled) | @@ -57,7 +57,7 @@ description: open.mp 新增函数与回调说明。 ## 物体相关 -| 名称 | +| 参数 | | --------------------------------------------------------------------------------------------- | | [SetObjectNoCameraCollision](../scripting/functions/SetObjectNoCameraCollision) | | [SetPlayerObjectNoCameraCollision](../scripting/functions/SetPlayerObjectNoCameraCollision) | @@ -100,7 +100,7 @@ description: open.mp 新增函数与回调说明。 ## 拾取物相关 -| 名称 | +| 参数 | | --------------------------------------------------------------------------------- | | [CreatePlayerPickup](../scripting/functions/CreatePlayerPickup) | | [DestroyPlayerPickup](../scripting/functions/DestroyPlayerPickup) | @@ -136,7 +136,7 @@ description: open.mp 新增函数与回调说明。 ## 车辆相关 -| 名称 | +| 参数 | | ----------------------------------------------------------------------------------- | | [ChangeVehicleColours](../scripting/functions/ChangeVehicleColours) | | [GetPlayerLastSyncedVehicleID](../scripting/functions/GetPlayerLastSyncedVehicleID) | @@ -182,7 +182,7 @@ description: open.mp 新增函数与回调说明。 ## 文本绘图 -| 名称 | +| 参数 | | ------------------------------------------------------------------------------------------------------- | | [TextDrawColour](../scripting/functions/TextDrawColour) | | [TextDrawBoxColour](../scripting/functions/TextDrawBoxColour) | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/server/server.cfg.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/server/server.cfg.md index bb588391ca2..339129133c1 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/server/server.cfg.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/server/server.cfg.md @@ -13,8 +13,8 @@ description: 服务器配置文件 | 设置项 | 类型 | 默认值 | 只读属性 | 规则 | 作用说明 | | ------------- | ------ | -------------------------- | -------- | ---- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | -| echo | string | Executing Server Config... | 是 | 否 | 当执行 server.cfg 时 samp-server.exe 在服务器控制台输出的内容。完全无需修改此值，因为只有您自己能看到控制台 | -| rcon_password | string | changeme | 否 | 否 | 用于管理服务器和使用远程控制台（RCON）的密码。必须确保将其更改为难以破解的密码，以防止他人控制您的服务器。如果 RCON 密码保持为 changeme，服务器将无法启动！ | +| echo | string | Executing Server Config... | 是 | 否 | 当执行 server.cfg 时 samp-server.exe 在服务器控制台输出的内容。完全无需修改此值，因为只有你自己能看到控制台 | +| rcon_password | string | changeme | 否 | 否 | 用于管理服务器和使用远程控制台（RCON）的密码。必须确保将其更改为难以破解的密码，以防止他人控制你的服务器。如果 RCON 密码保持为 changeme，服务器将无法启动！ | | rcon | bool | 1 | 否 | 否 | 切换是否使用[远程控制台](RemoteConsole)功能。设置为 1 启用或 0 禁用 | ## 脚本配置 @@ -34,9 +34,9 @@ description: 服务器配置文件 | hostname | string | SA-MP Server | 否 | 否 | 在服务器浏览器和玩家连接服务器时显示的服务器名称 | | language | string | | 否 | 否 | 在服务器浏览器中显示的语言标识。玩家可通过此选项在服务器浏览器中按语言筛选服务器。

**注意：** 此服务器变量在 0.3.7 版本添加，旧版本无效 | | mapname | string | San Andreas | 否 | 是 | 在服务器浏览器中显示的地图名称，可自定义（例如：My Stunt Map） | -| gamemodetext | string | Unknown | 否 | 否 | 在服务器浏览器中显示的游戏模式名称。使用 [SetGameModeText](../scripting/functions/SetGameModeText) 具有相同效果并会覆盖此处的设置。若需多个游戏模式显示不同名称，请使用该函数 | +| gamemodetext | string | Unknown | 否 | 否 | 在服务器浏览器中显示的游戏模式名称。使用 [SetGameModeText](../scripting/functions/SetGameModeText) 具有相同效果并会覆盖此处的设置。若需多个游戏模式显示不同名称，请使用此函数 | | weather | string\* | 10 | 否 | 是 | 服务器使用的全局天气设置，同时显示在服务器浏览器中。在 server.cfg 中使用此设置将导致服务器启动时崩溃，请改用 [SetWeather](../scripting/functions/SetWeather) | -| worldtime | string\* | 12:00 | 否 | 是 | 服务器使用的全局时间设置，同时显示在服务器浏览器中。在 server.cfg 中设置此值无效，请改用 [SetWorldTime](../scripting/functions/SetWorldTime) | +| worldtime | string\* | 12:00 | 否 | 是 | 服务器使用的全局世界时间设置，同时显示在服务器浏览器中。在 server.cfg 中设置此值无效，请改用 [SetWorldTime](../scripting/functions/SetWorldTime) | | gravity | string\* | 0.008 | 否 | 否 | 服务器使用的全局重力设置。在 server.cfg 中使用此设置将导致服务器启动时崩溃，请改用 [SetGravity](../scripting/functions/SetGravity) | | weburl | string | www.open.mp | 否 | 是 | 玩家可访问的服务器信息网站 | | version | string | | 是 | 是 | 服务器使用的 SA-MP 版本，显示在服务器浏览器中。在 server.cfg 中设置此值无效 | @@ -52,7 +52,7 @@ description: 服务器配置文件 | sleep | int | 5 | 否 | 否 | 主 SA-MP 和 RakNet 网络线程在每个同步周期内的空闲休眠时间（毫秒）。较高值降低服务器处理负载但降低同步质量，较低值增加服务器负载但提升同步质量。除非玩家数量极高且遇到服务器 FPS 稳定性问题，否则不建议修改 | | lanmode | bool | 0 | 否 | 否 | 已弃用参数，无实际效果 | | bind | string | | 是 | 否 | 服务器强制使用的 IP 地址。必须与服务器网卡分配的 IP 地址匹配，适用于在同一端口运行多个服务器 | -| port | int | 8192 | 是 | 否 | 服务器使用的端口号。需进行[端口转发](https://portforward.com)才能让外部玩家加入 | +| port | int | 8192 | 是 | 否 | 服务器使用的端口号。需进行[端口转发](https://portforward.com)才能让外部玩家加入 | | conncookies | int\* | 1 | 否 | 否 | 切换 0.3.7 连接验证系统。设置为 1 启用或 0 禁用

**注意：** 此服务器变量在 0.3.7 R2 版本添加，旧版本无效 | | cookielogging | int\* | 0 | 否 | 否 | 切换是否记录新连接玩家请求的连接验证信息。设置为 1 启用或 0 禁用

**注意：** 此服务器变量在 0.3.7 R2 版本添加，旧版本无效 | | connseedtime | int | 300000 | 否 | 否 | 连接验证种子值的更新间隔（毫秒）

**注意：** 此服务器变量在 0.3.7 版本添加，旧版本无效 | @@ -61,33 +61,33 @@ description: 服务器配置文件 | messageholelimit | int | 3000 | 否 | 否 | 防御拒绝服务攻击（DoS）的网络层设置 | | ackslimit | int | 3000 | 否 | 否 | （功能说明待补充） | | playertimeout | int | 10000 | 否 | 否 | 玩家无数据发送时的超时时间（毫秒） | -| mtu | int | 576 | 是 | 否 | [最大传输单元](https://en.wikipedia.org/wiki/Maximum_transmission_unit)设置

**注意：** 此服务器变量在 0.3.DL 版本添加，旧版本无效 | +| mtu | int | 576 | 是 | 否 | [最大传输单元](https://en.wikipedia.org/wiki/Maximum_transmission_unit)设置

**注意：** 此服务器变量在 0.3.DL 版本添加，旧版本无效 | > [*] 部分设置项的实际类型可能与标注类型不符 ## 日志配置 -| 设置项 | 类型 | 默认值 | 只读属性 | 规则 | 作用说明 | -| -------------- | ------ | ---------- | -------- | ---- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| output | bool | 0 | 否 | 否 | 切换是否在服务器控制台复制日志消息（包括脚本的 print/printf 输出和插件的 logprintf 输出）。此选项仅在 Linux 服务器生效 | -| timestamp | bool | 1 | 否 | 否 | 切换是否在每条控制台消息前添加时间戳 | +| 设置项 | 类型 | 默认值 | 只读属性 | 规则 | 作用说明 | +| -------------- | ------ | ---------- | -------- | ---- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| output | bool | 0 | 否 | 否 | 切换是否在服务器控制台复制日志消息（包括脚本的 print/printf 输出和插件的 logprintf 输出）。此选项仅在 Linux 服务器生效 | +| timestamp | bool | 1 | 否 | 否 | 切换是否在每条控制台消息前添加时间戳 | | logtimeformat | string | [%H:%M:%S] | 是 | 否 | 时间戳格式字符串，基于 C/C++ 的 [strftime](https://cplusplus.com/reference/ctime/strftime/) 格式：

**[%H:%M:%S]** 仅显示时间（默认格式）
**[%d/%m/%Y %H:%M:%S]** 显示日期（日/月/年）和时间 | -| logqueries | bool | 0 | 否 | 否 | 切换是否记录玩家发送给服务器的所有查询请求。在防御 DDoS 攻击时非常有用 | -| chatlogging | int\* | 1 | 否 | 否 | 切换是否在服务器控制台显示玩家聊天内容。若已有其他聊天记录方案，可禁用此功能以减少日志膨胀 | -| db_logging | int\* | 0 | 否 | 否 | 记录 sqlite db\_\* 函数错误到服务器控制台

**注意：** 此服务器变量在 0.3.7 R2 版本添加，旧版本无效 | -| db_log_queries | int\* | 0 | 否 | 否 | 记录所有 sqlite db_query 调用（包含查询语句）

**注意：** 此服务器变量在 0.3.7 R2 版本添加，旧版本无效 | +| logqueries | bool | 0 | 否 | 否 | 切换是否记录玩家发送给服务器的所有查询请求。在防御 DDoS 攻击时非常有用 | +| chatlogging | int\* | 1 | 否 | 否 | 切换是否在服务器控制台显示玩家聊天内容。若已有其他聊天记录方案，可禁用此功能以减少日志膨胀 | +| db_logging | int\* | 0 | 否 | 否 | 记录 sqlite db\_\* 函数错误到服务器控制台

**注意：** 此服务器变量在 0.3.7 R2 版本添加，旧版本无效 | +| db_log_queries | int\* | 0 | 否 | 否 | 记录所有 sqlite db_query 调用（包含查询语句）

**注意：** 此服务器变量在 0.3.7 R2 版本添加，旧版本无效 | > [*] 部分设置项的实际类型可能与标注类型不符 ## 客户端配置 -| 设置项 | 类型 | 默认值 | 只读属性 | 规则 | 作用说明 | -| ----------------- | ----- | ------ | -------- | ---- | -------------------------------------------------------------------------------------------------------------------------------- | -| onfoot_rate\* | int | 30 | 是 | 否 | 玩家步行状态时向服务器发送新数据的更新间隔（毫秒） | -| incar_rate | int | 30 | 是 | 否 | 玩家在车辆内时向服务器发送新数据的更新间隔（毫秒） | -| weapon_rate | int | 30 | 是 | 否 | 玩家使用武器时向服务器发送新数据的更新间隔（毫秒） | -| stream_distance\* | float | 200.0 | 否 | 否 | 玩家在 X,Y 平面上流式加载服务器实体的距离（范围 50.0-400.0）。较高值使玩家能在更远距离看到实体，但会增加客户端处理负担和带宽消耗 | -| stream_rate\* | int | 1000 | 否 | 否 | 重新检测实体流式加载条件的时间间隔（500-5000 毫秒）。较低值会增加服务器处理负载，因为需要更频繁地为每个玩家重新检查流式加载条件 | +| 设置项 | 类型 | 默认值 | 只读属性 | 规则 | 作用说明 | +| ----------------- | ----- | ------ | -------- | ---- | ------------------------------------------------------------------------------------------------------------------------------ | +| onfoot_rate\* | int | 30 | 是 | 否 | 玩家步行状态时向服务器发送新数据的更新间隔（毫秒） | +| incar_rate | int | 30 | 是 | 否 | 玩家在车辆内时向服务器发送新数据的更新间隔（毫秒） | +| weapon_rate | int | 30 | 是 | 否 | 玩家使用武器时向服务器发送新数据的更新间隔（毫秒） | +| stream_distance\* | float | 200.0 | 否 | 否 | 玩家在 X,Y 平面上流加载服务器实体的距离（范围 50.0-400.0）。较高值使玩家能在更远距离看到实体，但会增加客户端处理负担和带宽消耗 | +| stream_rate\* | int | 1000 | 否 | 否 | 重新检测实体流加载条件的时间间隔（500-5000 毫秒）。较低值会增加服务器处理负载，因为需要更频繁地为每个玩家重新检查流加载条件 | > [*] 降低 onfoot_rate、incar_rate 和 weapon_rate 的值可提升同步性能，但会增加带宽消耗 @@ -106,10 +106,10 @@ description: 服务器配置文件 ## 自定义模型 -| 设置项 | 类型 | 默认值 | 只读属性 | 规则 | 作用说明 | -| ---------- | ------ | ------ | -------- | ---- | -------------------------------------------------------------------------------------------------------- | +| 设置项 | 类型 | 默认值 | 只读属性 | 规则 | 作用说明 | +| ---------- | ------ | ------ | -------- | ---- | --------------------------------------------------------------------------------------------------------- | | useartwork | bool | 0 | 是 | 否 | 切换是否使用 models 文件夹中的自定义模型

**注意：** 此服务器变量在 0.3.DL 版本添加，旧版本无效 | -| artwork | string | No | 是 | 是 | 根据 useartwork 设置自动显示为 **No** 或 **Yes** | +| artwork | string | No | 是 | 是 | 根据 useartwork 设置自动显示为 **No** 或 **Yes** | | artpath | string | models | 是 | 否 | 自定义模型存储路径

**注意：** 此服务器变量在 0.3.DL 版本添加，旧版本无效 | ## 其他配置 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/tutorials/MenuGuide.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/tutorials/MenuGuide.md index 0cc59d9bd67..306af085f1e 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/tutorials/MenuGuide.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/tutorials/MenuGuide.md @@ -134,7 +134,7 @@ if(CurrentMenu == teleportmenu) ## 最终步骤 -现在需要创建显示菜单的命令。这是最简单的步骤：在`OnPlayerCommandText`中使用`strcmp`进行命令比对并调用`ShowMenuForPlayer`。如果您已有命令处理器，可直接通过处理器调用： +现在需要创建显示菜单的命令。这是最简单的步骤：在`OnPlayerCommandText`中使用`strcmp`进行命令比对并调用`ShowMenuForPlayer`。如果你已有命令处理器，可直接通过处理器调用： ```pawn if(strcmp(cmdtext, "/teleport", true) == 0) @@ -146,7 +146,7 @@ if(strcmp(cmdtext, "/teleport", true) == 0) ## 补充建议与结语 -理解本教程后，请尝试创建自己的菜单。如您所见，菜单系统并不复杂，但能为服务器玩家带来深刻印象。您可以用它实现酷炫的效果，例如： +理解本教程后，请尝试创建自己的菜单。如你所见，菜单系统并不复杂，但能为服务器玩家带来深刻印象。你可以用它实现酷炫的效果，例如： - 创建便利店/超市的购物系统 - 在第二列显示商品价格 @@ -156,4 +156,4 @@ if(strcmp(cmdtext, "/teleport", true) == 0) 进阶技巧：在调用`ShowMenuForPlayer`后使用[TogglePlayerControllable](../scripting/functions/TogglePlayerControllable)传递`false`来禁用移动，确保玩家浏览菜单时无法移动，并在`OnPlayerSelectedMenuRow`回调结束时使用[TogglePlayerControllable](../scripting/functions/TogglePlayerControllable)传递`true`来恢复操作。 -希望本教程对您有所帮助。如有疑问，请访问论坛/Discord 咨询。 +希望本教程对你有所帮助。如有疑问，请访问论坛/Discord 咨询。 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/tutorials/PickupGuide.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/tutorials/PickupGuide.md index e229ed0b9de..1b2272c53d3 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/tutorials/PickupGuide.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/tutorials/PickupGuide.md @@ -30,7 +30,7 @@ new gMyPickup; 以在格罗夫街创建金钱拾取物为例： -首先需要选择显示模型，您可通过[此外部站点](https://dev.prineside.com/en/gtasa_samp_model_id)查看完整模型列表。本教程选用编号 1274 的美元符号模型。 +首先需要选择显示模型，你可通过[此外部站点](https://dev.prineside.com/en/gtasa_samp_model_id)查看完整模型列表。本教程选用编号 1274 的美元符号模型。 接下来确定[拾取类型](../scripting/resources/pickuptypes)，该参数决定拾取物行为特性。为实现"拾取后暂时消失，数分钟后重生"的效果，我们选择类型 2。 @@ -81,7 +81,7 @@ public OnPlayerPickUpPickup(playerid, pickupid) } ``` -恭喜！您已掌握创建和处理拾取物的核心方法！ +恭喜！你已掌握创建和处理拾取物的核心方法！ ## 进阶应用 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/tutorials/PluginDevelopmentGuide.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/tutorials/PluginDevelopmentGuide.md index 126486dafca..cf02c904167 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/tutorials/PluginDevelopmentGuide.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/tutorials/PluginDevelopmentGuide.md @@ -178,7 +178,7 @@ Exports 是一个声明, 它允许我们……好吧, 导出一些东西到我 目前需要导出的函数有 6 个. 我们在项目中使用了其中 5 个. 不要担心你在函数声明中看到的 `PLUGIN_EXPORT` 和 `PLUGIN_CALL` 定义. 我们将在文章后面介绍这些以及其他一些重要的定义(标记为绿色文本). -| 函数 | 描述 | +| 函数 | 说明 | | -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Supports()** | 这个函数告诉服务器我们的插件将具备哪些功能, 基于它返回的内容. 通常我们在插件中只使用 3 个支持标志：**SUPPORTS_VERSION**、**SUPPORTS_AMX_NATIVES** 和 **SUPPORTS_PROCESS_TICK**. | | **Load(void\*\*)** | Load 函数是相当简单的. 它在插件被加载时调用, 并传递一个地址数组, 插件将用来执行功能. 我们通常使用的两个索引是 **PLUGIN_DATA_AMX_EXPORTS** 和 **PLUGIN_DATA_LOGPRINTF**. | @@ -191,7 +191,7 @@ Exports 是一个声明, 它允许我们……好吧, 导出一些东西到我 现在来看看代码的有趣部分！你可能会发现我们在前面的小例子中使用了大量的定义和结构. 如果你之前从未开发过 SA-MP 插件, 这些可能会显得非常混乱甚至令人生畏. 我们将在本节中阐明这些定义和结构. -| 定义/结构 | 描述 | +| 定义/结构 | 说明 | | --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **cell** | "cell" 是一个 typedef, 旨在提供可移植性. PAWN 支持 16 位、32 位和 64 位整数. typedef "cell" 始终是正确的大小, 而 "int" 可能不是. 通常在 SA-MP 插件中, 这个 typedef 始终是 32 位整数. **注意：** 还有一个 "ucell" typedef 用于无符号整数, 但几乎不使用. | | **AMX_NATIVE_CALL** | 这个定义了我们的原生函数将使用的调用约定. 目前它被定义为空, 因此将使用默认值. | @@ -260,7 +260,7 @@ amx 函数在 PAWN 实施者指南中有非常详细的文档, 可以在这里 int amx_Allot(AMX *amx, int cells, cell *amx_addr, cell **phys_addr); ``` -| 参数 | 描述 | +| 参数 | 说明 | | ------------- | ------------------------------------------------------- | | **amx** | 抽象机器. | | **cells** | 要保留的单元格数量. | @@ -269,7 +269,7 @@ int amx_Allot(AMX *amx, int cells, cell *amx_addr, cell **phys_addr); **说明：** 在早期版本的 PAWN 中, 数组和字符串必须在将其传递给脚本之前明确地为其分配内存. 在当前版本中, 这一功能已被 amx_PushArray 和 amx_PushString 函数在很大程度上取代. PAWN 函数只能访问其抽象机器内部的内存. 如果要"按引用"传递参数到 PAWN 函数, 必须将该参数的地址传递给 amx_Exec. 此外, 该地址本身也必须在抽象机器的地址范围内. 一个额外的复杂性是, 抽象机器使用相对于抽象机器数据段的地址, 而主机程序使用相对于操作系统提供的环境的地址. -amx_Allot 在抽象机器内部分配内存单元, 并返回两个地址. amx_addr 参数是相对于抽象机器的"数据段"的变量地址；这是您应该传递给 amx_Exec 的值(通过 amx_Push). 参数 phys_addr 持有相对于主机程序地址空间的地址. 因此, C/C++程序可以使用此地址并写入分配的内存. amx_Exec 返回后, 您可以检查内存块(amx_Exec 调用的 PAWN 函数可能已经写入其中), 然后通过调用 amx_Release 最终释放它. +amx_Allot 在抽象机器内部分配内存单元, 并返回两个地址. amx_addr 参数是相对于抽象机器的"数据段"的变量地址；这是你应该传递给 amx_Exec 的值(通过 amx_Push). 参数 phys_addr 持有相对于主机程序地址空间的地址. 因此, C/C++程序可以使用此地址并写入分配的内存. amx_Exec 返回后, 你可以检查内存块(amx_Exec 调用的 PAWN 函数可能已经写入其中), 然后通过调用 amx_Release 最终释放它. **另请参见：** [amx_Exec](#amx_exec), [amx_PushArray](#amx_pusharray), [amx_PushString](#amx_pushstring), [amx_Release](#amx_release) @@ -283,7 +283,7 @@ amx_Allot 在抽象机器内部分配内存单元, 并返回两个地址. amx_ad [float] amx_ctof([cell] c); ``` -| 参数 | 描述 | +| 参数 | 说明 | | ----- | -------------------------------- | | **c** | 要从"cell"类型转换为"float"的值. | @@ -303,7 +303,7 @@ amx_Allot 在抽象机器内部分配内存单元, 并返回两个地址. amx_ad int amx_Exec(AMX *amx, long *retval, int index); ``` -| 参数 | 描述 | +| 参数 | 说明 | | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **amx** | 从中调用函数的抽象机器. | | **retval** | 调用函数后的返回值将保存在此处. 如果不关心返回值, 此参数可以为 NULL. | @@ -323,7 +323,7 @@ amx_Allot 在抽象机器内部分配内存单元, 并返回两个地址. amx_ad int amx_FindPublic(AMX *amx, char *funcname, int *index); ``` -| 参数 | 描述 | +| 参数 | 说明 | | ------------ | ----------------------------------------- | | **amx** | 抽象机器. | | **funcname** | 要查找的公共函数的名称. | @@ -341,7 +341,7 @@ int amx_FindPublic(AMX *amx, char *funcname, int *index); [cell] amx_ftoc([float] f); ``` -| 参数 | 描述 | +| 参数 | 说明 | | ----- | -------------------------------- | | **f** | 要从"float"类型转换为"cell"的值. | @@ -361,13 +361,13 @@ int amx_FindPublic(AMX *amx, char *funcname, int *index); int amx_GetAddr(AMX *amx, cell amx_addr, cell **phys_addr); ``` -| 参数 | 描述 | +| 参数 | 说明 | | ------------- | ------------------------------------------------------------------------------------------------------------------------------ | | **amx** | 抽象机器. | | **amx_addr** | 相对于抽象机器的地址. | | **phys_addr** | 一个指向变量的指针, 该变量将保存指定单元格的内存地址. 如果 amx_addr 参数不是抽象机器内部的有效地址, phys_addr 将被设置为 NULL. | -**说明：** 此函数返回抽象机器中地址的内存地址. 通常在扩展模块中使用此函数, 因为它允许您访问抽象机器内部的变量. +**说明：** 此函数返回抽象机器中地址的内存地址. 通常在扩展模块中使用此函数, 因为它允许你访问抽象机器内部的变量. ## amx_GetString @@ -379,7 +379,7 @@ int amx_GetAddr(AMX *amx, cell amx_addr, cell **phys_addr); int amx_GetString(char *dest, cell *source, int use_wchar, size_t size); ``` -| 参数 | 描述 | +| 参数 | 说明 | | ------------- | ------------------------------------------------------------------------------------------------------------ | | **dest** | 指向字符数组的指针, 该数组的大小足以容纳转换后的源字符串. | | **source** | 指向源字符串的指针. 使用 amx_GetAddr 将 amx 中的字符串地址转换为物理地址. | @@ -400,7 +400,7 @@ int amx_GetString(char *dest, cell *source, int use_wchar, size_t size); int amx_Push(AMX *amx, cell value); ``` -| 参数 | 描述 | +| 参数 | 说明 | | --------- | --------------------- | | **amx** | 抽象机器. | | **value** | 要传递给公共函数的值. | @@ -419,7 +419,7 @@ int amx_Push(AMX *amx, cell value); int amx_PushArray(AMX *amx, cell *amx_addr, cell **phys_addr, const cell array[], int numcells); ``` -| 参数 | 描述 | +| 参数 | 说明 | | ------------- | ------------------------------------------------------------------------------------------------- | | **amx** | 抽象机器. | | **amx_addr** | 分配的单元格的地址, pawn 程序(在抽象机器中运行)可以访问该地址, 需要释放内存块. 此参数可以为 NULL. | @@ -441,7 +441,7 @@ int amx_PushArray(AMX *amx, cell *amx_addr, cell **phys_addr, const cell array[] int amx_PushString(AMX *amx, cell *amx_addr, cell **phys_addr, const char *string, int pack, int use_wchar); ``` -| 参数 | 描述 | +| 参数 | 说明 | | ------------- | ------------------------------------------------------------------------------------------------------------ | | **amx** | 抽象机器. | | **amx_addr** | 分配的单元格的地址, pawn 程序(在抽象机器中运行)可以访问该地址, 释放内存块需要此参数. 此参数可以为 NULL. | @@ -464,7 +464,7 @@ int amx_PushString(AMX *amx, cell *amx_addr, cell **phys_addr, const char *strin int amx_Register(AMX *amx, AMX NATIVE INFO *list, int number); ``` -| 参数 | 描述 | +| 参数 | 说明 | | ---------- | --------------------------------------------------------------------------------------------------------- | | **amx** | 抽象机器. | | **list** | 结构数组, 每个结构包含一个指向本地函数名称的指针和一个函数指针. 列表可以用两个 NULL 指针的结构可选地终止. | @@ -486,7 +486,7 @@ int amx_Register(AMX *amx, AMX NATIVE INFO *list, int number); int amx_Release(AMX *amx, cell amx_addr); ``` -| 参数 | 描述 | +| 参数 | 说明 | | ------------ | ------------------------------------------------------------------------------------------------------------------ | | **amx** | 抽象机器. | | **amx_addr** | 分配的单元格的地址, pawn 程序(在抽象机器中运行)看到的地址. 此值由 amx_Allot、amx_PushArray 和 amx_PushString 返回. | @@ -505,7 +505,7 @@ int amx_Release(AMX *amx, cell amx_addr); int amx_SetString(cell *dest, char *source, int pack, int use_wchar, size_t size); ``` -| 参数 | 描述 | +| 参数 | 说明 | | ------------- | --------------------------------------------------------------------------------------------------------------- | | **dest** | 指向 amx 中字符数组的指针, 其中存储转换后的字符串. 使用 amx_GetAddr 将 amx 中的字符串地址转换为物理地址. | | **source** | 指向源字符串的指针. | @@ -528,7 +528,7 @@ int amx_SetString(cell *dest, char *source, int pack, int use_wchar, size_t size int amx_StrLen(const cell *cstring, int *length); ``` -| 参数 | 描述 | +| 参数 | 说明 | | ----------- | --------------------------------- | | **cstring** | 抽象机中的字符串. | | **length** | 该参数将在返回时保存字符串的长度. | @@ -547,7 +547,7 @@ int amx_StrLen(const cell *cstring, int *length); amx_StrParam([AMX*] amx, [int] param, [char*] result); ``` -| 参数 | 描述 | +| 参数 | 说明 | | ---------- | --------------------------- | | **amx** | 抽象机器. | | **param** | 参数编号. | @@ -765,7 +765,7 @@ cell AMX_NATIVE_CALL EmitPawnCallback(AMX* amx, cell* params) amx_addr, *phys_addr; - //由于某种原因, amx_PushArray似乎会使服务器崩溃, 而我完全不知道为什么. 根据实现者的指南和代码, 我的使用应该是完全有效的. 由于该函数不起作用, 我们必须 + //由于某种原因, amx_PushArray似乎会使服务器崩溃, 而我完全不知道为什么. 根据实现者的指南和代码, 我的使用应该是完全有效的. 由于此函数不起作用, 我们必须 //使用旧方法, 自己分配内存, 设置它, 并将其推送到我们自己手动管理的空间中. 这非常简单. 我们使用amx_Allot在堆上分配内存(这会返回两个地址- 一个在抽象机器中的位置 //(amx_addr), 另一个是相对于实际服务器的地址空间(phsy_addr - 我们可以在C++中使用)). 一旦分配了内存, 我们使用memcpy将内存从我们的数组复制到phys_addr地址位置. amx_Allot(amx, sizeof(arr) / sizeof(cell), &amx_addr, &phys_addr); @@ -780,7 +780,7 @@ cell AMX_NATIVE_CALL EmitPawnCallback(AMX* amx, cell* params) amx_Exec(amx, &ret, idx); //释放我们分配的内存. 函数amx_Alloc在抽象机器的堆上分配内存. - //函数amx_PushString和amx_PushArray都在内部使用该函数, 因此每次使用这些函数时, 你都必须释放内存. 注意：我们使用了amx_PushString和amx_PushArray, 却只有一个释放调用. + //函数amx_PushString和amx_PushArray都在内部使用此函数, 因此每次使用这些函数时, 你都必须释放内存. 注意：我们使用了amx_PushString和amx_PushArray, 却只有一个释放调用. //这是因为堆上的内存是按升序分配的！amx_Release会释放从某一点以上的所有内存 //(第二个参数, amx_addr - 即我们的addr变量). 由于它是这样做的, 我们只存储了来自amx_PushString调用的地址, 因为它会删除从该点开始的所有内容. amx_Release(amx, addr); @@ -835,7 +835,7 @@ p = string var(字符串变量)(例如GetPlayerName等) #### 调用原生函数 -Invoke 使用一个适当命名为"callNative"的可变参数成员函数来调用原生函数. 此函数的参数为指向包含原生函数信息的 Native 结构的指针(参见上一节), 以及该原生函数的所有参数的省略号. 该函数返回被调用的原生函数的返回值. 以下是一个调用多个原生函数的示例函数, 其中使用了不同的参数类型(int、引用和字符串变量). +Invoke 使用一个适当命名为"callNative"的可变参数成员函数来调用原生函数. 此函数的参数为指向包含原生函数信息的 Native 结构的指针(参见上一节), 以及该原生函数的所有参数的省略号. 此函数返回被调用的原生函数的返回值. 以下是一个调用多个原生函数的示例函数, 其中使用了不同的参数类型(int、引用和字符串变量). ```cpp //此函数演示：如何使用Invoke调用SA-MP原生函数. @@ -869,7 +869,7 @@ cell AMX_NATIVE_CALL WhereIsPlayer(AMX* amx, cell* params) 使用 Invoke 方法时, 对于回调函数来说, 没有 100%透明的挂钩方法. 想要挂钩使用 Invoke 的回调函数的插件需要通过 PAWN 来实现. 你可以创建一个原生函数, 然后在你想挂钩的 PAWN 回调函数内调用该原生函数, 并将该原生函数用作伪回调. 你可以使用 ALS 挂钩方法来实现这一点, 这样可以让最终用户不需要做任何工作. -第一步显然是创建原生函数(记得将其添加到我们要注册的原生函数列表中, 并在你的 include 文件中添加它). 我决定挂钩的回调函数是 OnPlayerConnect, 因此我将编写一个具有与该回调函数相同参数的原生函数, 然后添加需要该回调的代码(在这种情况下是一个小玩笑). +第一步显然是创建原生函数(记得将其添加到我们要注册的原生函数列表中, 并在你的 include 文件中添加它). 我决定挂钩的回调函数是 OnPlayerConnect, 因此我将编写一个具有与此回调函数相同参数的原生函数, 然后添加需要此回调的代码(在这种情况下是一个小玩笑). ```cpp //此函数演示：如何编写一个原生函数来充当回调函数. @@ -1233,7 +1233,7 @@ extern void *pAMXFunctions; using namespace std; -//该函数演示了：如何从PAWN获取字符串(及其长度). +//此函数演示了：如何从PAWN获取字符串(及其长度). //PAWN 原生函数: native PrintPawnString(const str[]); cell AMX_NATIVE_CALL PrintPawnString(AMX* amx, cell* params) { @@ -1268,7 +1268,7 @@ cell AMX_NATIVE_CALL PrintPawnString(AMX* amx, cell* params) return 1; } -//该函数演示了：如何调用PAWN脚本中的回调函数. +//此函数演示了：如何调用PAWN脚本中的回调函数. //PAWN 原生函数: native EmitPawnCallback(); cell AMX_NATIVE_CALL EmitPawnCallback(AMX* amx, cell* params) { @@ -1297,9 +1297,9 @@ cell AMX_NATIVE_CALL EmitPawnCallback(AMX* amx, cell* params) *phys_addr; //由于某种原因, amx_PushArray似乎会导致服务器崩溃, 我对此一无所知. - //从实现者指南和代码来看, 我的用法应该是完全有效的. 由于该函数无法正常工作, 我们只能 + //从实现者指南和代码来看, 我的用法应该是完全有效的. 由于此函数无法正常工作, 我们只能 //使用旧方法：分配内存, 设置它, 并手动推送所有内容. 这非常简单. 我们 - //使用amx_Allot在堆上分配内存(该函数返回2个地址—一个是虚拟机中的位置 + //使用amx_Allot在堆上分配内存(此函数返回2个地址—一个是虚拟机中的位置 //(amx_addr), 另一个是相对于实际服务器地址空间的地址(phys_addr—可用于C++)). //分配内存后, 我们使用memcpy将数组的内存复制到phys_addr地址位置. amx_Allot(amx, sizeof(arr) / sizeof(cell), &amx_addr, &phys_addr); @@ -1310,7 +1310,7 @@ cell AMX_NATIVE_CALL EmitPawnCallback(AMX* amx, cell* params) amx_Push(amx, var); //使用之前获取的idx变量执行函数. - //注意：该函数的第二个参数是回调函数的返回值(如果不关心返回值, 可以为NULL). + //注意：此函数的第二个参数是回调函数的返回值(如果不关心返回值, 可以为NULL). amx_Exec(amx, &ret, idx); //释放分配的内存. 函数amx_Alloc在虚拟机的堆上分配内存. diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/tutorials/PortForwarding.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/tutorials/PortForwarding.md index 4c4b7cf9436..666b57b4772 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/tutorials/PortForwarding.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/tutorials/PortForwarding.md @@ -6,15 +6,15 @@ description: 服务器端口转发配置教程。 **欢迎来到端口转发教程！** -您正在阅读的是由 Leopard 制作的端口转发教程。 +你正在阅读的是由 Leopard 制作的端口转发教程。 -您需要准备一个 samp-server 或 omp-server 以及路由器。若您没有路由器，则无需进行端口转发！ +你需要准备一个 samp-server 或 omp-server 以及路由器。若你没有路由器，则无需进行端口转发！ ## 准备工作 -首先需要找到您的**网关地址**。假设您使用 Vista 系统：点击开始菜单，在搜索栏输入**cmd**，打开黑色命令提示符窗口。输入**ipconfig**命令，等待信息加载完成后，在输出内容中查找标有**_gateway_**的条目（请保持窗口开启）。 +首先需要找到你的**网关地址**。假设你使用 Vista 系统：点击开始菜单，在搜索栏输入**cmd**，打开黑色命令提示符窗口。输入**ipconfig**命令，等待信息加载完成后，在输出内容中查找标有***gateway***的条目（请保持窗口开启）。 -找到网关地址后，打开浏览器。在地址栏输入查找到的**_gateway_**数值（例如：192.168.0.1/192.168.1.1），按回车键进入。 +找到网关地址后，打开浏览器。在地址栏输入查找到的***gateway***数值（例如：192.168.0.1/192.168.1.1），按回车键进入。 ## 路由器配置 @@ -33,7 +33,7 @@ description: 服务器端口转发配置教程。 按以下参数进行配置： ``` -Port: 您的端口号（默认：7777） +Port: 你的端口号（默认：7777） Port Type: UDP Enabled: 启用 **IP: 请继续第三步操作** @@ -46,7 +46,7 @@ Enabled: 启用 返回命令提示符窗口，在输出信息中查找*IPv4*地址（格式如：**192.168.0.100**）。复制该地址并返回路由器设置界面。例如我的 IP 是 192.168.0.100 ``` -Port: 您的端口号（默认：7777） +Port: 你的端口号（默认：7777） Port Type: UDP Enabled: 启用 IP: 192.168.0.100 @@ -58,7 +58,7 @@ IP: 192.168.0.100 ``` 名称: SA-MP服务器（可自定义） -端口号: 您的端口号（默认：7777） +端口号: 你的端口号（默认：7777） 协议: UDP ``` @@ -70,4 +70,4 @@ IP: 192.168.0.100 在网站上获取公网 IP 地址，将其添加到 SA-MP 客户端的收藏列表并附加端口号（默认 7777）。若连接成功， -**恭喜您！** _您已完成端口转发配置_！ +**恭喜你！** _你已完成端口转发配置_！ diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/tutorials/QueryMechanism.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/tutorials/QueryMechanism.md index 83d1f81d9c7..22d82442774 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/tutorials/QueryMechanism.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/tutorials/QueryMechanism.md @@ -13,7 +13,7 @@ SA:MP 查询机制是通过 UDP 数据包传输服务器统计信息的标准协 查询是通过 UDP 协议向服务器地址发送的序列化数据包。 -您可能会疑惑："服务器如何区分查询数据包与常规 RakNet 协议数据？" 其原理在于底层 RakNet 套接字层会识别数据包头部的"SAMP"标识（十六进制值：53 41 4D 50），并采用特殊处理流程。[查看源码](https://github.com/openmultiplayer/RakNet/blob/master/Source/SocketLayer.cpp#L371) +你可能会疑惑："服务器如何区分查询数据包与常规 RakNet 协议数据？" 其原理在于底层 RakNet 套接字层会识别数据包头部的"SAMP"标识（十六进制值：53 41 4D 50），并采用特殊处理流程。[查看源码](https://github.com/openmultiplayer/RakNet/blob/master/Source/SocketLayer.cpp#L371) ## 序列化数据包 @@ -63,7 +63,7 @@ SA:MP 查询机制是通过 UDP 数据包传输服务器统计信息的标准协 #### 类型 `i` 响应 -| 字节 | 键值 | 字节宽度 | 描述 | +| 字节 | 键值 | 字节宽度 | 说明 | | ----------- | ---------- | -------- | ---------------------------------- | | 11 | Password | 1 | 0 表示未设置密码，1 表示已设置密码 | | 12-13 | Players | 2 | 当前在线玩家数量 | @@ -77,7 +77,7 @@ SA:MP 查询机制是通过 UDP 数据包传输服务器统计信息的标准协 #### 类型 `r` 响应 -| 字节 | 键值 | 字节宽度 | 描述 | +| 字节 | 键值 | 字节宽度 | 说明 | | ----------- | --------- | -------- | -------------------- | | 11-12 | RuleCount | 2 | 服务器提供的规则数量 | | 13 | (strlen) | 1 | 规则名称字符串长度 | @@ -89,7 +89,7 @@ _(从第 13 字节开始循环，共循环 RuleCount 次)_ #### 类型 `c` 响应 -| 字节 | 键值 | 字节宽度 | 描述 | +| 字节 | 键值 | 字节宽度 | 说明 | | ----------- | ----------- | -------- | -------------------- | | 11-12 | PlayerCount | 2 | 服务器提供的玩家数量 | | 13 | (strlen) | 1 | 玩家昵称字符串长度 | @@ -100,7 +100,7 @@ _(从第 13 字节开始循环，共循环 PlayerCount 次)_ #### 类型 `d` 响应 -| 字节 | 键值 | 字节宽度 | 描述 | +| 字节 | 键值 | 字节宽度 | 说明 | | ----------- | ----------- | -------- | ------------------------- | | 11-12 | PlayerCount | 2 | 服务器提供的玩家数量 | | 13 | PlayerID | 1 | 玩家 ID（取值范围 0-255） | @@ -113,7 +113,7 @@ _(从第 13 字节开始循环，共循环 PlayerCount 次)_ #### 类型 `p` 响应 -| 字节 | 键值 | 字节宽度 | 描述 | +| 字节 | 键值 | 字节宽度 | 说明 | | ---- | -------- | -------- | -------------------------------- | | 11 | number 1 | 1 | 客户端发送的伪随机序列第一个数字 | | 12 | number 2 | 1 | 伪随机序列第二个数字 | diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/tutorials/_.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/tutorials/_.md index 26788eb2c88..b3583e1b5d4 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/tutorials/_.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/tutorials/_.md @@ -1,7 +1,7 @@ --- title: 教程 sidebar_label: 教程 -description: 收录各类教程，助您编写游戏模式并管理服务器。 +description: 收录各类教程，助你编写游戏模式并管理服务器。 --- -本节内容汇集了多篇教程指南，助您掌握游戏模式开发与服务器管理技巧。教程排列不分先后顺序，请根据需求查阅。 +本节内容汇集了多篇教程指南，助你掌握游戏模式开发与服务器管理技巧。教程排列不分先后顺序，请根据需求查阅。 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/tutorials/cooldowns.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/tutorials/cooldowns.md index 89bfa643f06..feda62ffab7 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/tutorials/cooldowns.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/tutorials/cooldowns.md @@ -241,4 +241,4 @@ OnPlayerFinishRace(playerid) [此工具包](https://github.com/ScavengeSurvive/timeutil)提供毫秒格式化功能，可将数值转换为易读字符串。 -希望本文对您有所启发！撰写初衷是发现许多开发者尚未掌握`GetTickCount()`和`gettime()`作为定时器替代方案的妙用。 +希望本文对你有所启发！撰写初衷是发现许多开发者尚未掌握`GetTickCount()`和`gettime()`作为定时器替代方案的妙用。 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/tutorials/stringmanipulation.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/tutorials/stringmanipulation.md index 75bbac7be13..8b90eab2931 100644 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/tutorials/stringmanipulation.md +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/tutorials/stringmanipulation.md @@ -36,7 +36,7 @@ new str_1[5]; new str_2[100]; ``` -您还可以预先定义一个常量值，以便多次使用它们作为字符串大小. +你还可以预先定义一个常量值，以便多次使用它们作为字符串大小. ```cpp // 声明一个常量 @@ -103,7 +103,7 @@ new message_2[] = "这是另一条消息"; ``` -请确保字符串的大小大于您为其分配的字符数，如果字符串的大小小于或等于该字符数，将导致编译错误, 两个方括号[]之间的留空 (就像 `message_2` 那样), 会自动赋予该数组大小等于您指定的文本大小+1, 在上面的例子中, `7 + 1 = 8`, 为什么加 1? 因为它为空字符预留了一个位置 (_又名 空终止符_), 单词 “_Hello_” 有 5 个字符, 因此要将其存储在字符串中, 应该有 6 个单元格, 其中 5 个单元格用于存储单词的字符, 1 个单元格用于存储**空字符**. +请确保字符串的大小大于你为其分配的字符数，如果字符串的大小小于或等于该字符数，将导致编译错误, 两个方括号[]之间的留空 (就像 `message_2` 那样), 会自动赋予该数组大小等于你指定的文本大小+1, 在上面的例子中, `7 + 1 = 8`, 为什么加 1? 因为它为空字符预留了一个位置 (_又名 空终止符_), 单词 “_Hello_” 有 5 个字符, 因此要将其存储在字符串中, 应该有 6 个单元格, 其中 5 个单元格用于存储单词的字符, 1 个单元格用于存储**空字符**. 首先，我们定义一个新数组，你可以决定它的大小，也可以留空让编译器填充，两种方法都可以，我们将在数组中填充字符，创建字符串“_Hello_”. @@ -121,7 +121,7 @@ message_3[5] = '\0'; 在这里，我们为 `message_3` 数组的每个槽分配了一个字符，如果你声明了一个没有明确大小的字符串，这样的做法是行不通的，请注意，要表示一个字符，它应该写在两个单引号（`'`）之间，另外，请注意我们是如何从槽 `0` 开始的，这是很自然的、 考虑到我曾强调字符串是一个字符数组，这意味着第一个槽总是 `0`，最后一个槽是其大小减去 1（_空字符不计算在内_），在本例中最后一个槽是 `4`，从 0 到 4，共 5 个字符，第 6 个是空终止符，稍后再详述. -您也可以为字符串分配数字，这些数字将被视为 **ASCII** 代码（_一种用数字表示字符的系统，它涵盖了从 0 到 127 的 128 个字符，更多信息[在此](https://en.wikipedia.org/wiki/ASCII)_）, 同样的信息“_Hello_”可以使用 _ASCII_ 代码分配，如下所示; +你也可以为字符串分配数字，这些数字将被视为 **ASCII** 代码（_一种用数字表示字符的系统，它涵盖了从 0 到 127 的 128 个字符，更多信息[在此](https://en.wikipedia.org/wiki/ASCII)_）, 同样的信息“_Hello_”可以使用 _ASCII_ 代码分配，如下所示; ```cpp new message_4[6]; @@ -134,7 +134,7 @@ message_4[4] = 111; // ASCII 代表 “o” message_4[5] = 0; // ASCII 代表空终止符 ``` -是的，您可以用这些代码进行数字运算，就像用普通数字运算一样，毕竟机器只是将字符视为数字而已. +是的，你可以用这些代码进行数字运算，就像用普通数字运算一样，毕竟机器只是将字符视为数字而已. ```cpp new message_5[1]; @@ -262,7 +262,7 @@ new text_1[8] = "Hello"; | ASCII 码 | 72 | 101 | 108 | 108 | 111 | 0 | 0 | 0 | | 字符 | 'H' | 'e' | 'l' | 'l' | 'o' | '\0' | '\0' | '\0' | -例如，如果您想删除该字符串的内容，只需使用以下三个示例中的一个就可以了; +例如，如果你想删除该字符串的内容，只需使用以下三个示例中的一个就可以了; ```cpp text_1[0] = 0; @@ -282,7 +282,7 @@ text_1[0] = '\0'; ## 字符串操作功能 -在处理多文本块时，_pawn_ 可以满足您的需求，它提供了一些非常基本的功能，可以高效地完成工作. +在处理多文本块时，_pawn_ 可以满足你的需求，它提供了一些非常基本的功能，可以高效地完成工作. 以下是一些本地支持的函数 (_摘自 string.inc_); @@ -582,7 +582,7 @@ printf("Hey "RANDOM_STRING", Micheal here! #"#RANDOM_NUMBER); Hey Vsauce, Micheal here! #2018 ``` -正如我之前所说，当使用 **格式说明符** 时，`printf` 函数真正展现了它的优势。这是它的独特之处和区别所在。您可以附加任意数量的变量，并轻松输出简单和复杂的字符串。我们将在稍后介绍这些说明符时深入探讨这一点。 +正如我之前所说，当使用 **格式说明符** 时，`printf` 函数真正展现了它的优势。这是它的独特之处和区别所在。你可以附加任意数量的变量，并轻松输出简单和复杂的字符串。我们将在稍后介绍这些说明符时深入探讨这一点。 #### 客户端消息 @@ -596,7 +596,7 @@ Hey Vsauce, Micheal here! #2018 SendClientMessage(playerid, color, const message[]) ``` -比方说，您想向 ID 1 的玩家发送一条文本，告诉他们 “Hello there!”; +比方说，你想向 ID 1 的玩家发送一条文本，告诉他们 “Hello there!”; ```cpp SendClientMessage(1, -1, "Hello there!"); @@ -614,7 +614,7 @@ SendClientMessage(0, -1, mornMsg); SendClientMessage(0, -1, "How are you ",STRING_MSG#?); ``` -正如您在上面的示例中看到的，这将向 ID _0_ 的玩家发送两条白色的信息，第一条信息将显示“_Hello!_”，第二条信息将显示“_How are you today?_”，这与其他函数的工作方式非常相似。请记住，预定义的常量整数必须以 `#` 号作为前缀. +正如你在上面的示例中看到的，这将向 ID _0_ 的玩家发送两条白色的信息，第一条信息将显示“_Hello!_”，第二条信息将显示“_How are you today?_”，这与其他函数的工作方式非常相似。请记住，预定义的常量整数必须以 `#` 号作为前缀. ```cpp #define NMB_MSG 3 @@ -623,7 +623,7 @@ SendClientMessage(3, -1, "It's "#NMB_MSG" PM"); 非常直观，文本将发送给 ID _3_ 的玩家，颜色为白色，内容为“_It’s 3 PM_”。 -现在您知道如何向某人发送消息了，您可以使用相同的方法向所有人发送相同的消息，真的很简单，您可以将函数放在一个遍历所有连接玩家的循环中，并冒险将您的代码公布就结束了，但嘿，实际上已经有一个原生函数可以完成完全相同的事情，唯一的不同在于它们的语法略有变化。 +现在你知道如何向某人发送消息了，你可以使用相同的方法向所有人发送相同的消息，真的很简单，你可以将函数放在一个遍历所有连接玩家的循环中，并冒险将你的代码公布就结束了，但嘿，实际上已经有一个原生函数可以完成完全相同的事情，唯一的不同在于它们的语法略有变化。 ```cpp SendClientMessageToAll(color, const message[]); @@ -639,11 +639,11 @@ SendClientMessageToAll(-1, "Hello everyone!"); #### Textdraws -这是 SA-MP 最强大的功能之一，只需释放您的想象力，textdraws 基本上是可以显示在客户端屏幕上的图形形状/文本/精灵/预览模型等等，它们使 UI 特别生动和互动（当然有一定的限制）。但是，这里也有一些限制，例如，您不能显示超过 1024 个字符的字符串，老实说，这已经足够了。即使它们功能广泛，但可以显示的字符串在格式化方面也很贫乏，您不能像使用其他输出函数那样做很多事情，在这方面感觉有点狭隘，但它确实通过其他令人兴奋的内容弥补了格式化的缺失，更多关于 textdraws 的内容请参考 [这里](../scripting/resources/textdraws)。 +这是 SA-MP 最强大的功能之一，只需释放你的想象力，textdraws 基本上是可以显示在客户端屏幕上的图形形状/文本/精灵/预览模型等等，它们使 UI 特别生动和互动（当然有一定的限制）。但是，这里也有一些限制，例如，你不能显示超过 1024 个字符的字符串，老实说，这已经足够了。即使它们功能广泛，但可以显示的字符串在格式化方面也很贫乏，你不能像使用其他输出函数那样做很多事情，在这方面感觉有点狭隘，但它确实通过其他令人兴奋的内容弥补了格式化的缺失，更多关于 textdraws 的内容请参考 [这里](../scripting/resources/textdraws)。 #### Dialogs -Dialogs 可以被视为“消息框”，当然，它们有不同的类型，接受几种不同的输入，最重要的是，它们接受所有普通字符串的格式化方式，这使得它们比 textdraw 更容易使用。它们也有一些限制，比如字符串大小以及只能在客户端屏幕上同步显示，SA-MP 只提供了一个原生函数来处理 dialogs，老实说，这将是您的最后关注点，因为这个唯一的函数完成了它的工作，并且效率很高，更多关于 dialogs 的内容请参考 [这里](../scripting/functions/ShowPlayerDialog)。 +Dialogs 可以被视为“消息框”，当然，它们有不同的类型，接受几种不同的输入，最重要的是，它们接受所有普通字符串的格式化方式，这使得它们比 textdraw 更容易使用。它们也有一些限制，比如字符串大小以及只能在客户端屏幕上同步显示，SA-MP 只提供了一个原生函数来处理 dialogs，老实说，这将是你的最后关注点，因为这个唯一的函数完成了它的工作，并且效率很高，更多关于 dialogs 的内容请参考 [这里](../scripting/functions/ShowPlayerDialog)。 ### 颜色解释 @@ -681,7 +681,7 @@ SendClientMessageToAll(0xFFFFFFFF, "Hello everyone!"); ##### RGB -这与 **RGBA** 颜色空间非常相似，但没有 alpha 通道，只是红、绿、蓝的混合，以 6 位的十六进制数字表示，在 pawn 中，这种表示法通常用于将颜色嵌入到文本中，只需将您的 6 位十六进制数字用一对大括号括起来，就可以开始使用了，例如： (**\{FF0000\} = 红色**)、 (**\{00FF00\} = 绿色**)、 (**\{0000FF\} = 蓝色**)、 (**\{000000\} = 黑色**)、 (**\{FFFFFF\} = 白色**)，这里是这种表示法的更清晰的可视化：`{FFFFFF}`。让我们看一个简单的示例： +这与 **RGBA** 颜色空间非常相似，但没有 alpha 通道，只是红、绿、蓝的混合，以 6 位的十六进制数字表示，在 pawn 中，这种表示法通常用于将颜色嵌入到文本中，只需将你的 6 位十六进制数字用一对大括号括起来，就可以开始使用了，例如： (**\{FF0000\} = 红色**)、 (**\{00FF00\} = 绿色**)、 (**\{0000FF\} = 蓝色**)、 (**\{000000\} = 黑色**)、 (**\{FFFFFF\} = 白色**)，这里是这种表示法的更清晰的可视化：`{FFFFFF}`。让我们看一个简单的示例： ```cpp SendClientMessageToAll(0x00FF00FF, "I'm green{000000}, and {FF0000}I'm red"); @@ -693,9 +693,9 @@ SendClientMessageToAll(0x00FF00FF, "I'm green{000000}, and {FF0000}I'm red"); 请记住，十六进制表示法不区分大小写，因此输入 `0xFFC0E1FF` 与输入 `0xfFC0e1Ff` 是一样的，嵌入的颜色也是如此，`{401C15}` 与 `{401c15}` 是一样的。 -有时候，处理颜色可能会很麻烦，记住所有这些长十六进制数字并不容易。您应该始终有一个参考可以回去查看，网上有很多颜色选择工具，您可以简单地搜索“_color picker_”，并在成千上万的工具中选择一个。如果您不介意的话，我为您提供一个推荐工具，[这是一个简单的工具](https://www.webfx.com/web-design/color-picker/)，我建议在处理颜色时使用它。 +有时候，处理颜色可能会很麻烦，记住所有这些长十六进制数字并不容易。你应该始终有一个参考可以回去查看，网上有很多颜色选择工具，你可以简单地搜索“_color picker_”，并在成千上万的工具中选择一个。如果你不介意的话，我为你提供一个推荐工具，[这是一个简单的工具](https://www.webfx.com/web-design/color-picker/)，我建议在处理颜色时使用它。 -人们发现的一个问题是管理工作流程，如果做得对，可以使工作节奏更顺畅，减少处理项目时的痛苦。虽然颜色选择工具非常有帮助，但每次需要选择颜色时来回切换仍然会浪费大量时间，这种挫败感就像披萨上放了菠萝一样令人烦恼。幸运的是，您可以利用预定义的常量，为稍后使用定义您最常用的颜色，这里有一个简单的示例; +人们发现的一个问题是管理工作流程，如果做得对，可以使工作节奏更顺畅，减少处理项目时的痛苦。虽然颜色选择工具非常有帮助，但每次需要选择颜色时来回切换仍然会浪费大量时间，这种挫败感就像披萨上放了菠萝一样令人烦恼。幸运的是，你可以利用预定义的常量，为稍后使用定义你最常用的颜色，这里有一个简单的示例; ```cpp #define COLOR_RED 0xFF0000FF @@ -725,7 +725,7 @@ ShowPlayerDialog(playerid, 0, DIALOG_STYLE_MSGBOX, "注意", "{"COL_GREEN"}你 #### 文本绘图（Textdraws）和游戏文本（Gametexts） -如上所述，**RGB** 表示法不被支持，但幸运的是，我们有其他方法来解决这个问题，对于文本绘图，您可以使用本地函数 [TextDrawColor](../scripting/functions/TextDrawColor) 来更改文本绘图的颜色，但这与文本绘图的 **RGBA** 颜色空间对于客户端消息和对话框是一样的，颜色不能被嵌入。为此，我们使用特殊的字符组合来引用颜色和其他一些符号，您可以在 [这里](../scripting/resources/gametextstyles) 查看它们。 +如上所述，**RGB** 表示法不被支持，但幸运的是，我们有其他方法来解决这个问题，对于文本绘图，你可以使用本地函数 [TextDrawColor](../scripting/functions/TextDrawColor) 来更改文本绘图的颜色，但这与文本绘图的 **RGBA** 颜色空间对于客户端消息和对话框是一样的，颜色不能被嵌入。为此，我们使用特殊的字符组合来引用颜色和其他一些符号，你可以在 [这里](../scripting/resources/gametextstyles) 查看它们。 | | | | -------------- | ---- | @@ -739,7 +739,7 @@ ShowPlayerDialog(playerid, 0, DIALOG_STYLE_MSGBOX, "注意", "{"COL_GREEN"}你 因此，嵌入颜色可以这样做: **\~w\~Hello this is \~b\~blue \~w\~and this is \~r\~red** -您还可以使用另一种字符组合来玩混色游戏, **\~h\~**, 它会使某种颜色变浅，以下是几个例子: +你还可以使用另一种字符组合来玩混色游戏, **\~h\~**, 它会使某种颜色变浅，以下是几个例子: | | | | ------------------------------ | ------ | @@ -750,7 +750,7 @@ ShowPlayerDialog(playerid, 0, DIALOG_STYLE_MSGBOX, "注意", "{"COL_GREEN"}你 | \~r\~\~h\~\~h\~\~h\~\~h\~\~h\~ | 粉色 | | \~g\~\~h\~ | 亮绿色 | -您可以在[这里](../scripting/resources/colorslist)找到更多相关信息. +你可以在[这里](../scripting/resources/colorslist)找到更多相关信息. ### 转义字符 @@ -790,7 +790,7 @@ ShowPlayerDialog(playerid, 0, DIALOG_STYLE_MSGBOX, "注意", "{"COL_GREEN"}你 print("\a"); ``` -执行 samp-server.exe 后，您将听到蜂鸣声通知，您也可以使用十进制代码; +执行 samp-server.exe 后，你将听到蜂鸣声通知，你也可以使用十进制代码; ```cpp print("This is a beep \7"); @@ -826,7 +826,7 @@ Hello 2018 ^ ``` -正如您所看到的，光标正好位于字符串最后一个可见字符的位置，即 _8_，这与在键盘上切换插入模式是一样的 +正如你所看到的，光标正好位于字符串最后一个可见字符的位置，即 _8_，这与在键盘上切换插入模式是一样的 ```cpp print("Hello 2018\b9"); @@ -1044,7 +1044,7 @@ new chr = ''\'; - **“双引号” 转义序列 - `\"`** -与单引号不同，双引号在嵌套时会产生问题，Pawn 将双引号之间的任何内容都视为一个字符串，因此，如果您想在字符串中输入双引号，程序会感到困惑，因为它不知道每个引号的作用: +与单引号不同，双引号在嵌套时会产生问题，Pawn 将双引号之间的任何内容都视为一个字符串，因此，如果你想在字符串中输入双引号，程序会感到困惑，因为它不知道每个引号的作用: ```cpp print("Hello "world"); @@ -1571,7 +1571,7 @@ Lua developer! Lua ``` -#### 使用示例 +#### 示例 将我们迄今为止所看到的付诸实践，我们可以以几乎任何方式格式化字符串，到目前为止，我们主要在控制台工作，使用 `print` 和 `printf` 函数输出数据，实际上主要是 `printf`，因为它本身支持动态格式化字符串，因此函数名中有个 f。 diff --git a/frontend/i18n/zh-CN/docusaurus-theme-classic/footer.json b/frontend/i18n/zh-CN/docusaurus-theme-classic/footer.json new file mode 100644 index 00000000000..2d46796d4b8 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-theme-classic/footer.json @@ -0,0 +1,70 @@ +{ + "link.title.Documentations": { + "message": "文档", + "description": "页脚中标题为Documentations的链接列标题" + }, + "link.title.Community": { + "message": "社区", + "description": "页脚中标题为Community的链接列标题" + }, + "link.title.More": { + "message": "更多", + "description": "页脚中标题为More的链接列标题" + }, + "link.item.label.Introduction": { + "message": "入门指南", + "description": "标签为Introduction的页脚链接，指向文档" + }, + "link.item.label.open.mp Migration": { + "message": "迁移至open.mp", + "description": "标签为open.mp Migration的页脚链接，指向文档" + }, + "link.item.label.config.json": { + "message": "config.json", + "description": "标签为config.json的页脚链接，指向docs/server/config.json" + }, + "link.item.label.Discord": { + "message": "Discord", + "description": "标签为Discord的页脚链接，指向https://discord.gg/samp" + }, + "link.item.label.GitHub": { + "message": "GitHub", + "description": "标签为GitHub的页脚链接，指向https://github.com/openmultiplayer/open.mp" + }, + "link.item.label.Donate": { + "message": "捐赠", + "description": "标签为Donate的页脚链接，指向https://opencollective.com/openmultiplayer" + }, + "link.item.label.YouTube": { + "message": "YouTube", + "description": "标签为YouTube的页脚链接，指向https://youtube.com/openmultiplayer" + }, + "link.item.label.X": { + "message": "X", + "description": "标签为X的页脚链接，指向https://x.com/openmultiplayer" + }, + "link.item.label.Servers": { + "message": "服务器", + "description": "标签为Servers的页脚链接，指向/servers" + }, + "link.item.label.Blog": { + "message": "博客", + "description": "标签为Blog的页脚链接，指向/blog" + }, + "link.item.label.Animations": { + "message": "动画", + "description": "标签为Animations的页脚链接，指向/animations" + }, + "link.item.label.UID Generator": { + "message": "UID生成器", + "description": "标签为UID Generator的页脚链接，指向/uid" + }, + "link.item.label.SA-MP": { + "message": "SA-MP", + "description": "标签为SA-MP的页脚链接，指向https://sa-mp.mp/" + }, + "copyright": { + "message": "版权所有 © 2025 open.mp。基于Docusaurus构建", + "description": "页脚版权信息" + } +} diff --git a/frontend/i18n/zh-CN/docusaurus-theme-classic/navbar.json b/frontend/i18n/zh-CN/docusaurus-theme-classic/navbar.json new file mode 100644 index 00000000000..63d701fbbc7 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-theme-classic/navbar.json @@ -0,0 +1,30 @@ +{ + "title": { + "message": "Open Multiplayer", + "description": "导航栏中的标题" + }, + "item.label.Docs": { + "message": "文档", + "description": "标签为Docs的导航栏项目" + }, + "item.label.Blog": { + "message": "博客", + "description": "标签为Blog的导航栏项目" + }, + "item.label.Forums": { + "message": "论坛", + "description": "标签为Forums的导航栏项目" + }, + "item.label.Servers": { + "message": "服务器", + "description": "标签为Servers的导航栏项目" + }, + "item.label.Partners": { + "message": "合作伙伴", + "description": "标签为Partners的导航栏项目" + }, + "item.label.Donate": { + "message": "捐赠", + "description": "标签为Donate的导航栏项目" + } +} diff --git a/frontend/src/components/templates/translations/zh-CN/lowercase-note.tsx b/frontend/src/components/templates/translations/zh-CN/lowercase-note.tsx index 6220203d6a5..a296d5355fb 100644 --- a/frontend/src/components/templates/translations/zh-CN/lowercase-note.tsx +++ b/frontend/src/components/templates/translations/zh-CN/lowercase-note.tsx @@ -3,7 +3,7 @@ import Admonition from "../../../Admonition"; export default function NoteLowercase({ name = "函数" }) { return ( -

这个${name}以小写字母开头。

+

这个{name}以小写字母开头。

 ); }