快速开始

Plugin API 1.0 使用 Lua 5.4.8。开发插件只需要 UTF-8 文本编辑器、能够生成可移植 ZIP 路径的打包工具，以及用于测试的 SA-MP Android。

创建文件

hello-plugin/
├─ manifest.json
└─ main.lua

manifest.json：

{
  "schemaVersion": 1,
  "id": "com.example.hello",
  "name": "Hello Plugin",
  "version": "1.0.0",
  "apiVersion": "^1.0",
  "entry": "main.lua",
  "description": "A minimal SA-MP Android plugin.",
  "activationMode": "immediate",
  "permissions": [],
  "contexts": ["multiplayer"],
  "author": {
    "name": "Your Name"
  }
}

main.lua：

samp.log.info("loaded " .. samp.plugin.id)

samp.events.on("player.spawned", function(event)
    samp.log.info(
        "spawned in session " ..
        samp.format.number(event.sessionId, 0)
    )
end)

打包与测试

压缩 hello-plugin 目录中的内容，不要压缩目录本身。把 ZIP 后缀改为 hello-plugin.splug。打开压缩包时，应当能在根目录直接看到 manifest.json。

TIP

你也可以使用官方 Plugin Tools CLI。运行 samp-plugin pack hello-plugin 即可自动验证并打包插件。该仓库还包含示例插件可供参考。

1. 打开“资源 → 插件 → 导入”。
2. 选择 .splug 文件。
3. 查看插件信息并启用。
4. 进入多人游戏会话。
5. 在插件状态或日志中检查 loaded 消息。

已经安装的插件只要内容发生变化，就必须增加 version；相同 ID 和版本不能对应不同内容。