Skip to content

Exports y eventos

API pública de Cuxial Gardener: exports de servidor y el gancho que se ejecuta al pagar un trabajo.

Comprueba si un jugador está trabajando de jardinero, lee su nivel y ejecuta tu propio código cuando se paga un trabajo. Todo lo de esta página es de servidor. Cuxial Gardener no tiene exports de cliente ni eventos públicos.

Exports de servidor ​

IsInCrew ​

Indica si un jugador está en una tripulación de jardineros. La tripulación existe desde que el jugador abre el panel del trabajo, así que no significa que haya un trabajo en curso.

lua
exports.cuxial_gardener:IsInCrew(source)
ParámetroTipoDescripción
sourcenumberId de servidor del jugador.

Devuelve: boolean.

lua
if exports.cuxial_gardener:IsInCrew(source) then
    -- el jugador está en el trabajo de jardinero
end

GetProfile ​

Devuelve el nivel y la XP de jardinero de un personaje. Funciona también con personajes desconectados.

lua
exports.cuxial_gardener:GetProfile(identifier)
ParámetroTipoDescripción
identifierstringIdentificador de personaje de tu framework (el citizenid en QBox y QBCore).

Devuelve: { level: number, xp: number }, o nil si el personaje no tiene perfil de jardinero o la base de datos no está lista.

lua
local profile = exports.cuxial_gardener:GetProfile(citizenid)
if profile and profile.level >= 10 then
    -- desbloquea algo para jardineros con experiencia
end

Gancho: onFinish ​

server/hooks.lua es un archivo abierto. Su función onFinish se ejecuta una vez por cada miembro conectado de la tripulación cuando se paga un trabajo. Escribe tu código dentro: sumar reputación, dar un premio extra, enviar tu propio registro.

server/hooks.lua
lua
function CuxialGardener.hooks.onFinish(src, data)
    -- tu código
end
ParámetroTipoDescripción
srcnumberId de servidor del jugador que ha cobrado.
data.runIdnumberId del trabajo en cuxial_jobs_runs. 0 si no se pudo guardar.
data.regionnumberid de la región en data/regions.lua.
data.scorenumberTareas hechas por este jugador (césped, poda, ramas, flores).
data.bonusnumberTareas extra hechas por este jugador (regar, guardar ramas).
data.moneynumberDinero pagado a este jugador.
data.xpnumberXP dada a este jugador.
data.ownerstringIdentificador de personaje del dueño de la tripulación.
lua
function CuxialGardener.hooks.onFinish(src, data)
    if data.region == 5 and data.score >= 20 then
        exports.ox_inventory:AddItem(src, 'water', 1)
    end
end

Un error dentro del gancho se captura y se muestra en la consola del servidor. El pago no se ve afectado.

Base de datos ​

Las consultas de solo lectura sobre estas tablas son seguras. Las filas de este trabajo tienen job = 'gardener'.

TablaContenido
cuxial_jobs_playersUna fila por personaje: level, xp, progreso diario.
cuxial_jobs_runsTrabajos terminados: region, owner, crew_size, outcome (done, reset, abandoned), inicio y fin.
cuxial_jobs_run_membersLo que hizo y ganó cada miembro en un trabajo: score, bonus, money, xp.
cuxial_jobs_auditFilas de auditoría: trabajo terminado, trabajo reiniciado, acciones de staff.

© Cuxial