Справочник Plugin API 1.1
lua
if samp.api.has("entity.list", "1.1") then
-- Использовать возможность
end| Namespace | Назначение |
|---|---|
samp.api, samp.log | Версия, возможности и журнал. |
samp.events | События. |
samp.timer, samp.task | Отложенная работа. |
samp.storage, samp.format | Данные и форматирование. |
samp.game, samp.world, samp.camera, samp.server | Снимки состояния. |
samp.player, samp.entity | Проверяемые Handle. |
samp.ui, samp.draw | Меню и HUD. |
samp.chat, samp.command, samp.clipboard | Сообщения и clipboard. |
samp.audio, samp.network | Аудио и ограниченное наблюдение сети. |
samp.effects, samp.physics | Обратимые эффекты. |
Фаза any доступна в обычном защищённом контексте, managed — только в управляемом callback, hud — только в draw.hud.
Подробные сигнатуры находятся в разделах основной среды, игрока и транспорта, серверных сущностей, меню и HUD, эффектов и физики и параметров событий. Разрешения и лимиты также являются частью контракта API 1.1.
Минорные версии внутри major 1 только добавляют возможности. Текущий клиент принимает точные 1.0, 1.1 и диапазоны ^1.0, ^1.1; для новых возможностей используйте ^1.1, а необязательные возможности проверяйте через samp.api.has().
Контракт возможностей
| Возможность | Разрешение | Фаза |
|---|---|---|
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 |