Plugin API 1.1 参考

Plugin API 1.1 是 .splug 当前可以使用的公开契约。可以在运行时查询能力：

if samp.api.has("entity.list", "1.1") then
    -- 使用该能力
end

命名空间	用途
samp.api	版本和能力查询。
samp.log	带插件归属的日志。
samp.events	事件订阅。
samp.timer、samp.task	有界延迟任务。
samp.storage	私有持久化。
samp.format	有界数字格式化。
samp.game、samp.server	只读状态快照。
samp.player	带世代校验的本地玩家 Handle。
samp.entity	已流入服务器实体。
samp.ui、samp.draw	设置菜单与 HUD。
samp.effects、samp.physics	可恢复的受控效果。

any 能力通常可在初始化和受保护回调使用；managed 只能在托管回调使用；hud 只能在 draw.hud 使用。

详细签名分别见核心运行环境、本地玩家与车辆、 服务器实体、菜单与 HUD 绘制、 效果与物理以及完整事件回调参数。 权限与运行限制同样属于 API 1.1 正式契约。

同一 major 版本内的 minor 版本只追加能力。当前客户端同时兼容精确的 1.0、^1.0、1.1 和 ^1.1；需要 1.1 新能力的插件应声明 ^1.1， 可选能力则应使用 samp.api.has() 查询。

Capability 契约

能力	权限	调用阶段
api.has	无需权限	any
log	无需权限	any
events.on	无需权限	any
event.plugin.loaded	无需权限	any
event.plugin.unloading	无需权限	any
event.game.ready	无需权限	any
event.game.frame	无需权限	any
event.session.started	无需权限	any
event.session.ended	无需权限	any
event.server.connected	无需权限	any
event.server.disconnected	无需权限	any
event.player.spawned	无需权限	any
event.player.died	无需权限	any
event.player.damage_before	game.player.write	any
event.player.health_changed	game.player.read	any
event.player.vehicle_entered	game.vehicle.read	any
event.player.vehicle_left	game.vehicle.read	any
event.player.interior_changed	game.state.read	any
event.player.weapon_changed	game.player.read	any
event.player.aiming_changed	game.player.read	any
event.player.motion_changed	game.player.read	any
event.player.vehicle_collision	game.vehicle.read	any
event.player.skin_changed	game.player.read	any
event.player.animation_changed	game.player.read	any
event.player.task_changed	game.player.read	any
event.world.time_changed	game.state.read	any
event.world.weather_changed	game.state.read	any
event.vehicle.health_changed	game.vehicle.read	any
event.vehicle.state_changed	game.vehicle.read	any
event.chat.message_received	chat.read	any
event.chat.server_message_received	chat.read	any
event.chat.bubble_received	chat.read	any
event.checkpoint.entered	game.state.read	any
event.checkpoint.left	game.state.read	any
event.ui.menu_opened	ui.menu	any
event.ui.menu_closed	ui.menu	any
event.ui.control_changed	ui.menu	any
event.input.touch	ui.input	any
event.camera.mode_changed	game.state.read	any
event.draw.hud	ui.draw	hud
event.network.packet_received	network.inspect	any
event.network.rpc_received	network.inspect	any
event.network.packet_sending	network.inspect	any
event.network.rpc_sending	network.inspect	any
event.network.packet_before_send	network.intercept	any
event.network.rpc_before_send	network.intercept	any
event.entity.streamed_in	game.entity.read	any
event.entity.streamed_out	game.entity.read	any
event.pickup.collected	game.entity.read	any
event.chat.message_sending	chat.intercept	any
event.command.executing	command.intercept	any
event.dialog.shown	dialog.read	any
event.dialog.responding	dialog.intercept	any
event.textdraw.shown	textdraw.read	any
event.textdraw.hidden	textdraw.read	any
event.textdraw.text_changed	textdraw.read	any
event.textdraw.clicking	textdraw.intercept	any
timer.after	无需权限	any
task.spawn	无需权限	any
task.sleep	无需权限	any
storage.get	plugin.storage	any
storage.set	plugin.storage	any
storage.remove	plugin.storage	any
format.number	无需权限	any
game.state	game.state.read	any
world.time	game.state.read	any
world.weather	game.state.read	any
checkpoint.state	game.state.read	any
camera.state	game.state.read	any
network.stats	network.stats.read	any
audio.play	audio.playback	any
audio.stop	audio.playback	any
audio.state	audio.playback	any
server.current	server.state.read	any
chat.notify	ui.chat	any
chat.send	chat.send	any
command.send	chat.send	any
clipboard.get	ui.clipboard.read	any
clipboard.set	ui.clipboard.write	any
ui.menu.register	ui.menu	any
draw.text	ui.draw	hud
draw.line	ui.draw	hud
draw.rect	ui.draw	hud
draw.image	ui.draw	hud
draw.circle	ui.draw	hud
draw.progress_bar	ui.draw	hud
draw.world_to_screen	ui.draw	hud
player.local_player	game.player.read	any
player.is_valid	game.player.read	any
player.position	game.player.read	any
player.health	game.player.read	any
player.armor	game.player.read	any
player.velocity	game.player.read	any
player.weapon	game.player.read	any
player.aim	game.player.read	any
player.motion	game.player.read	any
player.skin	game.player.read	any
player.animation	game.player.read	any
player.task	game.player.read	any
player.vehicle	game.vehicle.read	any
vehicle.is_valid	game.vehicle.read	any
vehicle.position	game.vehicle.read	any
vehicle.health	game.vehicle.read	any
vehicle.velocity	game.vehicle.read	any
vehicle.state	game.vehicle.read	any
vehicle.seat	game.vehicle.read	any
vehicle.occupants	game.vehicle.read	any
entity.get	game.entity.read	any
entity.list	game.entity.read	any
entity.is_valid	game.entity.read	any
entity.position	game.entity.read	any
entity.player.name	game.entity.read	any
entity.player.npc	game.entity.read	any
entity.player.state	game.entity.read	any
entity.player.health	game.entity.read	any
entity.player.armor	game.entity.read	any
entity.player.vehicle_id	game.entity.read	any
entity.player.stats	game.entity.read	any
entity.vehicle.model	game.entity.read	any
entity.vehicle.health	game.entity.read	any
entity.vehicle.velocity	game.entity.read	any
entity.vehicle.heading	game.entity.read	any
entity.object.model	game.entity.read	any
entity.object.rotation	game.entity.read	any
entity.object.moving	game.entity.read	any
entity.object.attachment	game.entity.read	any
entity.actor.model	game.entity.read	any
entity.actor.health	game.entity.read	any
entity.actor.invulnerable	game.entity.read	any
entity.actor.heading	game.entity.read	any
entity.pickup.model	game.entity.read	any
entity.pickup.pickup_type	game.entity.read	any
entity.text_label.text	game.entity.read	any
entity.text_label.color	game.entity.read	any
entity.text_label.draw_distance	game.entity.read	any
entity.text_label.test_los	game.entity.read	any
entity.text_label.attachment	game.entity.read	any
player.set_health	game.player.write	managed
player.set_armor	game.player.write	managed
player.set_position	game.player.write	managed
player.set_velocity	game.player.write	managed
player.set_skin	game.player.write	managed
player.set_weapon	game.player.write	managed
player.set_ammo	game.player.write	managed
vehicle.set_health	game.vehicle.write	managed
vehicle.set_position	game.vehicle.write	managed
vehicle.set_velocity	game.vehicle.write	managed
effects.acquire	无需权限	managed
effects.group	无需权限	any
effects.release	无需权限	managed
effects.player.physics_flags	game.physics.override	managed
effects.player.collision_filter	game.physics.override	managed
effects.camera.follow	game.camera.control	managed
physics.create_surface	game.physics.override	managed
surface.is_valid	game.physics.override	any
surface.set_position	game.physics.override	managed
surface.release	game.physics.override	managed
require	无需权限	any