Aller au contenu

Aperçu des exports et événements

Les listes complètes sont générées à partir du code dans la référence de l’API, une page par resource. Cette page est la version courte : les appels que tu utiliseras en écrivant ta propre resource. Côté serveur sauf indication contraire.

local p = exports.bs_core:GetPlayer(src) -- player object, nil if not loaded
exports.bs_core:GetPlayerByCharId(charId)
exports.bs_core:AddMoney(src, account, amount, reason)
exports.bs_core:AddXP(src, amount, reason)
exports.bs_core:GetPlayerMeta(src, key, fallback)
exports.bs_core:AwardAction(src, 'vehicle_repaired') -- counts toward skills and contracts
exports.bs_core:GetLanguage(src)

Les callbacks passent par le bridge, voir Architecture.

exports.bs_inventory:GiveItem(src, 'bandage', 2, metadata)
exports.bs_inventory:RemoveItem(src, 'bandage', 1)
exports.bs_inventory:CountItem(src, 'bandage')
exports.bs_inventory:GetItem('bandage') -- definition
exports.bs_inventory:RegisterContainer(containerId, spec, src)
exports.bs_inventory:OpenContainerFor(src, containerId)
exports.bs_inventory:SetItemMeta(src, slot, item, metadata, silent)

Plus de détails sur Objets et inventaire.

exports.bs_factions:GetFaction(src) -- faction id
exports.bs_factions:FactionRank(src, factionId)
exports.bs_factions:RankAllowed(src, 'build') -- custom rank permissions
exports.bs_factions:GetFactionLevel(factionId)
exports.bs_factions:AddFactionXP(factionId, amount, reason)
exports.bs_factions:AddReputation(src, amount, reason)
exports.bs_factions:GetSquadMembers(src)
exports.bs_factions:SameSquad(a, b)
exports.bs_building:RegisterPlaceable({ id = 'workbench', cat = 'utility', ... })
exports.bs_building:PiecesInRadius(x, y, z, r)
exports.bs_building:NearStation(src, 'workbench', 4.0)
exports.bs_building:RaidOpen()
exports.bs_building:GetRespawnPoint(charId)
-- client
exports.bs_building:StartPlacing(defId)

Événement : bs:building:pieceRemoved (id, defId) à chaque suppression.

exports.bs_crafting:StationDefs()
exports.bs_crafting:Recipes()
exports.bs_crafting:RecipeFor('bandage')
exports.bs_crafting:SkillLevel(src)
exports.bs_jobs:GetJob(src) -- 'mechanic', 'hunter', ... or nil
exports.bs_jobs:HasJob(src, 'medic')
exports.bs_jobs:Does(src, 'hunt') -- capability check: hunt, fish, kidnap, rob, smuggle, gunsmith ...

Vérifie une capacité avec Does plutôt qu’un nom de job quand tu peux. Plusieurs jobs en partagent une, et les propriétaires de serveur renomment les jobs.

exports.bs_medical:IsDowned(src)
exports.bs_medical:Down(src)
exports.bs_medical:Revive(src)
-- client
exports.bs_medical:IsDowned()
exports.bs_medical:IsCarrying()

Voir l’API zombies pour le bruit, les dégâts et les spawns d’événements.

Les événements du framework se nomment bs:<zone>:<chose>. Les hooks de cycle de vie comme bs:hook:player:loaded sont listés sur Architecture. Les panneaux d’UI doivent déclencher bs:ui:opened et bs:ui:closed, voir UI et NUI.