FrameworkZ API Documentation - All Functions
📋 All Functions & Methods
Complete reference of all 724 functions and methods.
Functions
14FrameworkZ.Characters.PostLoad(data, characterData)
Parameters
Returns
FrameworkZ.Entities.OnObjectAdded(object)
Parameters
FrameworkZ.Foundation.New()
Returns
FrameworkZ.Foundation.OnGetData(data, namespace, keys, subscriptionID)
Parameters
Returns
FrameworkZ.Foundation.OnRemoveData(data)
Parameters
FrameworkZ.Foundation.OnSaveNamespace(data, namespace)
Parameters
FrameworkZ.Foundation.OnSaveNamespace(data)
Parameters
FrameworkZ.Foundation.OnSetData(data, namespace, keys, value, subscriptionID, broadcast)
Parameters
Returns
FrameworkZ.Foundation.OnSync(data)
Parameters
Returns
FrameworkZ.Foundation.OnSyncBroadcast(data)
Parameters
FrameworkZ.Foundation.OnTeleportToLimbo(data)
Parameters
Returns
FrameworkZ.Logs.OnWeaponHitCharacter(characterGivingDamage, characterTakingDamage, handWeapon, damage)
Parameters
FrameworkZ.UI.GetCenteredX(length, fontSize, text)
Parameters
generateRequestID()
Returns
Methods
247CHARACTER:AddRecognition(character, alias)
Parameters
Returns
CHARACTER:Destroy()
CHARACTER:GetAge()
Returns
CHARACTER:GetBeardColor()
Returns
CHARACTER:GetBeardStyle()
Returns
CHARACTER:GetDescription()
Returns
CHARACTER:GetEyeColor()
Returns
CHARACTER:GetFaction()
Returns
CHARACTER:GetHairColor()
Returns
CHARACTER:GetHairStyle()
Returns
CHARACTER:GetHeight()
Returns
CHARACTER:GetID()
Returns
CHARACTER:GetInventory()
Returns
CHARACTER:GetInventoryID()
Returns
CHARACTER:GetIsoPlayer()
Returns
CHARACTER:GetLogicalInventory()
Returns
CHARACTER:GetName()
Returns
CHARACTER:GetPhysicalInventory()
Returns
CHARACTER:GetPhysique()
Returns
CHARACTER:GetPlayer()
Returns
CHARACTER:GetRecognition(character)
Parameters
Returns
CHARACTER:GetRecognizes()
Returns
CHARACTER:GetSaveableData()
Returns
CHARACTER:GetSkinColor()
Returns
CHARACTER:GetUID()
Returns
CHARACTER:GetUsername()
Returns
CHARACTER:GetWeight()
Returns
CHARACTER:GiveItem(uniqueID)
Parameters
Returns
CHARACTER:GiveItems(uniqueID, amount)
Parameters
CHARACTER:Initialize()
Returns
CHARACTER:InitializeDefaultItems()
CHARACTER:IsCitizen()
Returns
CHARACTER:IsCombine()
Returns
CHARACTER:OnLoad()
CHARACTER:OnPostLoad(firstLoad)
Parameters
CHARACTER:OnPreLoad()
CHARACTER:RecognizesCharacter(character)
Parameters
Returns
CHARACTER:RestoreData(characterData)
Parameters
CHARACTER:Save()
Returns
CHARACTER:SetAge(age)
Parameters
CHARACTER:SetBeardColor(beardColor)
Parameters
CHARACTER:SetBeardStyle(beardStyle)
Parameters
CHARACTER:SetDescription(description)
Parameters
CHARACTER:SetEyeColor(eyeColor)
Parameters
CHARACTER:SetFaction(faction)
Parameters
CHARACTER:SetHairColor(hairColor)
Parameters
CHARACTER:SetHairStyle(hairStyle)
Parameters
CHARACTER:SetHeight(height)
Parameters
CHARACTER:SetID(id)
Parameters
CHARACTER:SetInventory(inventory)
Parameters
CHARACTER:SetInventoryID(inventoryID)
Parameters
CHARACTER:SetIsoPlayer(isoPlayer)
Parameters
CHARACTER:SetLogicalInventory(logicalInventory)
Parameters
CHARACTER:SetName(name)
Parameters
CHARACTER:SetPhysicalInventory(physicalInventory)
Parameters
CHARACTER:SetPhysique(physique)
Parameters
CHARACTER:SetPlayer(player)
Parameters
CHARACTER:SetRecognizes(recognizes)
Parameters
CHARACTER:SetSkinColor(skinColor)
Parameters
CHARACTER:SetUID(uid)
Parameters
CHARACTER:SetUsername(username)
Parameters
CHARACTER:SetWeight(weight)
Parameters
CHARACTER:TakeItem(uniqueID)
Parameters
Returns
CHARACTER:TakeItemByInstanceID(instanceID)
Parameters
Returns
CHARACTER:TakeItems(uniqueID, amount)
Parameters
ENTITY:Initialize()
Returns
ENTITY:ValidateEntityData(worldObject)
Returns
FACTION:Initialize()
Returns
FrameworkZ.CharacterDataManager:AddItemToLogicalInventory(characterData, uniqueID, quantity)
Parameters
FrameworkZ.CharacterDataManager:CreateCharacterData(creationData, player)
Parameters
Returns
FrameworkZ.CharacterDataManager:DeepCopy(original)
Parameters
Returns
FrameworkZ.CharacterDataManager:ExtractItemData(item)
Parameters
Returns
FrameworkZ.CharacterDataManager:GenerateUID()
Returns
FrameworkZ.CharacterDataManager:RestoreCharacterAppearance(isoPlayer, characterData)
Parameters
Returns
FrameworkZ.CharacterDataManager:RestoreCharacterData(character, characterData)
Parameters
Returns
FrameworkZ.CharacterDataManager:RestoreInventoryData(character, characterData)
Parameters
Returns
FrameworkZ.CharacterDataManager:RestoreItemData(item, itemData)
Parameters
Returns
FrameworkZ.CharacterDataManager:RestoreSurvivorAppearance(survivor, characterData)
Parameters
Returns
FrameworkZ.CharacterDataManager:SaveCharacterData(character)
Parameters
Returns
FrameworkZ.CharacterDataManager:SaveInventoryData(character)
Parameters
Returns
FrameworkZ.CharacterDataManager:ValidateCharacterData(characterData)
Parameters
Returns
FrameworkZ.Characters:AddToCache(uid, character)
Parameters
Returns
FrameworkZ.Characters:AddToList(username, character)
Parameters
Returns
FrameworkZ.Characters:GetCharacterByID(username)
Parameters
Returns
FrameworkZ.Characters:GetCharacterByUID(uid)
Parameters
Returns
FrameworkZ.Characters:GetCharacterInventoryByID(username)
Parameters
Returns
FrameworkZ.Characters:Initialize(isoPlayer, id)
Parameters
Returns
FrameworkZ.Characters:New(isoPlayer, id)
Parameters
Returns
FrameworkZ.Characters:OnInitGlobalModData()
FrameworkZ.Characters:OnPostLoad(isoPlayer, characterData)
Parameters
Returns
FrameworkZ.Characters:OnStorageSet(isoPlayer, command, namespace, keys, value)
Parameters
FrameworkZ.Characters:PlayerTick(player)
Parameters
FrameworkZ.Characters:RemoveFromCache(uid)
Parameters
Returns
FrameworkZ.Characters:RemoveFromList(username)
Parameters
Returns
FrameworkZ.Characters:Save(username)
Parameters
Returns
FrameworkZ.Entities:GetEntityByID(entityID)
Parameters
Returns
FrameworkZ.Entities:Initialize(data, name)
Parameters
Returns
FrameworkZ.Entities:IsEntity(object)
Parameters
Returns
FrameworkZ.Entities:New(name)
Parameters
Returns
FrameworkZ.Factions:GetFactionByID(factionID)
Parameters
Returns
FrameworkZ.Factions:GetFactionNameByID(factionID)
Parameters
Returns
FrameworkZ.Factions:Initialize(id, object)
Parameters
Returns
FrameworkZ.Factions:New(name)
Parameters
Returns
FrameworkZ.Foundation.Events:EveryDays()
FrameworkZ.Foundation.Events:OnClientCommand(module, command, isoPlayer, arguments)
Parameters
FrameworkZ.Foundation.Events:OnConnected()
FrameworkZ.Foundation.Events:OnCreatePlayer()
FrameworkZ.Foundation.Events:OnDisconnect()
FrameworkZ.Foundation.Events:OnFillInventoryObjectContextMenu(player, context, items)
Parameters
FrameworkZ.Foundation.Events:OnFillWorldObjectContextMenu(playerNumber, context, worldObjects, test)
Parameters
FrameworkZ.Foundation.Events:OnGameStart()
FrameworkZ.Foundation.Events:OnInitGlobalModData(isNewGame)
Parameters
FrameworkZ.Foundation.Events:OnKeyStartPressed(key)
Parameters
FrameworkZ.Foundation.Events:OnMainMenuEnter()
FrameworkZ.Foundation.Events:OnObjectLeftMouseButtonDown(object, x, y)
Parameters
FrameworkZ.Foundation.Events:OnPlayerDeath(player)
Parameters
FrameworkZ.Foundation.Events:OnPreFillInventoryObjectContextMenu(playerID, context, items)
Parameters
FrameworkZ.Foundation.Events:OnReceiveGlobalModData(key, data)
Parameters
FrameworkZ.Foundation.Events:OnResetLua(reason)
Parameters
FrameworkZ.Foundation.Events:OnServerCommand(module, command, arguments)
Parameters
FrameworkZ.Foundation.Events:OnServerStarted()
FrameworkZ.Foundation:AddAllHookHandlers(hookName)
Parameters
FrameworkZ.Foundation:AddChannel(key)
Parameters
FrameworkZ.Foundation:AddHookHandler(hookName, category)
Parameters
FrameworkZ.Foundation:Broadcast(namespace, key, remove)
Parameters
FrameworkZ.Foundation:CleanupConfirmations(timeout)
Parameters
FrameworkZ.Foundation:ClearBatchSyncQueue(isoPlayer)
Parameters
FrameworkZ.Foundation:EveryDays()
FrameworkZ.Foundation:ExecuteAllHooks(hookName, ...)
Parameters
FrameworkZ.Foundation:ExecuteFrameworkHooks(hookName, ...)
Parameters
FrameworkZ.Foundation:ExecuteGamemodeHooks(hookName, ...)
Parameters
FrameworkZ.Foundation:ExecuteGenericHooks(hookName, ...)
Parameters
FrameworkZ.Foundation:ExecuteHook(hookName, category, ...)
Parameters
📝 Notes
When a function is defined and registered as a hook, sometimes it's as an object. However in the definition it could be as some.func() or some:func() (notice the period and colon between the examples). If the function is defined as some:func() then the object is passed as the first argument. If the function is defined as some.func() then the object is not passed as the first argument, in which case we would also need to define some.func_PassOverHookableObject function which must return \boolean true. This tells the hook system to not supply the object as the first argument if the function is apart of an object in the first place. Generic function hooks do not store an object and so do not have to worry about defining that additional property on its own function.
FrameworkZ.Foundation:ExecuteModuleHooks(hookName, ...)
Parameters
FrameworkZ.Foundation:ExecutePluginHooks(hookName, ...)
Parameters
FrameworkZ.Foundation:Fire(key, data, arguments)
Parameters
Returns
FrameworkZ.Foundation:GetChannel(key)
Parameters
Returns
FrameworkZ.Foundation:GetChannelMeta(key)
Parameters
Returns
FrameworkZ.Foundation:GetData(isoPlayer, namespace, keys, subscriptionID, callback)
Parameters
Returns
📝 Notes
If called on the client, the value may only be accessed in the callback immediately, or later after data has synchronized.
FrameworkZ.Foundation:GetLocalData(namespace, keys)
Parameters
Returns
FrameworkZ.Foundation:GetModule(moduleName)
Parameters
Returns
FrameworkZ.Foundation:GetModuleMetaObject(moduleName)
Parameters
Returns
FrameworkZ.Foundation:GetNamespace(namespace)
Parameters
Returns
FrameworkZ.Foundation:GetNestedValue(root, path)
Parameters
Returns
📝 Notes
Example path argument: {"key", "subkey"} == root["key"]["subkey"]
FrameworkZ.Foundation:GetSubscribers(key)
Parameters
Returns
FrameworkZ.Foundation:GetVersion()
Returns
FrameworkZ.Foundation:HasChannel(key)
Parameters
Returns
FrameworkZ.Foundation:HasSubscription(key, id)
Parameters
Returns
FrameworkZ.Foundation:Initialize()
📝 Notes
The LoadGridSquare event is not added to the hook system for performance reasons, as it is called very frequently.
This function wraps the Project Zomboid Events system to integrate with the FrameworkZ hook system, allowing all foundation events to be processed through the hook mechanism.
FrameworkZ.Foundation:InitializeClient(isoPlayer)
Parameters
FrameworkZ.Foundation:InitializePlayer(isoPlayer, playerData, charactersData)
Parameters
Returns
FrameworkZ.Foundation:LogChannels()
FrameworkZ.Foundation:NewModule(moduleObject, moduleName)
Parameters
Returns
FrameworkZ.Foundation:OnClientCommand(module, command, isoPlayer, arguments)
Parameters
📝 Notes
This function is called on the server when a client sends a command to the server. It processes the command and sends a response back to the client using the networking system.
FrameworkZ.Foundation:OnGameStart()
FrameworkZ.Foundation:OnServerCommand(module, command, arguments)
Parameters
📝 Notes
This function is called on the client when the server sends a command to the client. It processes the command and sends a response back to the server using the networking system.
FrameworkZ.Foundation:OnServerStarted()
FrameworkZ.Foundation:PathToString(path)
Parameters
Returns
FrameworkZ.Foundation:PostInitializeClient(player)
Parameters
FrameworkZ.Foundation:PreInitializeClient(isoPlayer)
Parameters
FrameworkZ.Foundation:ProcessSaveableData(object, ignoreList, encodeList)
Parameters
Returns
FrameworkZ.Foundation:QueueBatchSync(isoPlayer, namespace, key)
Parameters
FrameworkZ.Foundation:RegisterFramework()
FrameworkZ.Foundation:RegisterFrameworkHandler()
FrameworkZ.Foundation:RegisterGamemodeHandler(gamemode)
Parameters
FrameworkZ.Foundation:RegisterGenericHandler()
FrameworkZ.Foundation:RegisterHandler(hookName, handler, object, functionName, category)
Parameters
FrameworkZ.Foundation:RegisterHandlers(objectOrHandlers, category)
Parameters
FrameworkZ.Foundation:RegisterModule(module)
Parameters
FrameworkZ.Foundation:RegisterModuleHandler(module)
Parameters
FrameworkZ.Foundation:RegisterNamespace(name)
Parameters
📝 Notes
This must be used in the shared scope within an OnInitGlobalModData function.
FrameworkZ.Foundation:RegisterPluginHandler(plugin)
Parameters
FrameworkZ.Foundation:RemoveChannel(key)
Parameters
FrameworkZ.Foundation:RemoveData(namespace, key)
Parameters
FrameworkZ.Foundation:RemoveHookHandler(hookName, category)
Parameters
FrameworkZ.Foundation:RestoreData(isoPlayer, command, namespace, keys, callback)
Parameters
Returns
FrameworkZ.Foundation:RestorePlayer(isoPlayer, player, username, playerData, charactersData)
Parameters
Returns
FrameworkZ.Foundation:SaveData(isoPlayer)
Parameters
FrameworkZ.Foundation:SaveNamespace(isoPlayer, namespace)
Parameters
FrameworkZ.Foundation:SendFire(isoPlayer, subscriptionID, callback, ...)
Parameters
Returns
FrameworkZ.Foundation:SendGet(key, callback, callbackID, broadcast, ...)
Parameters
FrameworkZ.Foundation:SendSet(key, value, callback, callbackID, broadcast)
Parameters
FrameworkZ.Foundation:ServerTick()
FrameworkZ.Foundation:SetData(isoPlayer, namespace, keys, value, subscriptionID, broadcast, callback)
Parameters
Returns
📝 Notes
If called on the client, the value may only be accessed in the callback immediately, or later after data has synchronized.
FrameworkZ.Foundation:SetLocalData(namespace, keys, value)
Parameters
Returns
FrameworkZ.Foundation:SetNestedValue(root, path, value)
Parameters
Returns
📝 Notes
Example path argument: {"key", "subkey"} == root["key"]["subkey"] = value
FrameworkZ.Foundation:StartBatchSync(isoPlayer, interval, onComplete)
Parameters
FrameworkZ.Foundation:StartServerTick()
FrameworkZ.Foundation:Subscribe(key, idOrCallback, maybeCallback)
Parameters
Returns
FrameworkZ.Foundation:SyncToPlayer(isoPlayer, namespace, key)
Parameters
FrameworkZ.Foundation:TeleportToLimbo(isoPlayer)
Parameters
Returns
FrameworkZ.Foundation:UnregisterFrameworkHandler()
FrameworkZ.Foundation:UnregisterGamemodeHandler(gamemode)
Parameters
FrameworkZ.Foundation:UnregisterGenericHandler()
FrameworkZ.Foundation:UnregisterHandler(hookName, handler, object, functionName, category)
Parameters
FrameworkZ.Foundation:UnregisterHandlers(objectOrHandlers, category)
Parameters
FrameworkZ.Foundation:UnregisterModuleHandler(module)
Parameters
FrameworkZ.Foundation:UnregisterPluginHandler(plugin)
Parameters
FrameworkZ.Foundation:Unsubscribe(key, id)
Parameters
FrameworkZ.Foundation:Watch(key, id, callback)
Parameters
FrameworkZ.Inventories:Initialize(id, object)
Parameters
Returns
FrameworkZ.Inventories:New(username, type, id)
Parameters
Returns
FrameworkZ.Inventories:Rebuild(isoPlayer, inventory, items)
Parameters
Returns
FrameworkZ.Inventories:Restore(character, inventoryData)
Parameters
Returns
FrameworkZ.Inventories:RestoreEquipment(character, inventoryData)
Parameters
Returns
FrameworkZ.Inventories:RestoreLogicalItems(character, logicalInventoryData)
Parameters
Returns
FrameworkZ.Inventories:Save(character)
Parameters
Returns
FrameworkZ.Items:CreateItem(uniqueID, isoPlayer, callback)
Parameters
Returns
FrameworkZ.Items:RemoveInstance(instanceID, username)
Parameters
Returns
FrameworkZ.Logs:AddLog(logType, message, player)
Parameters
FrameworkZ.Logs:GetLogs(logType, player)
Parameters
Returns
FrameworkZ.Logs:LoadLogsFromFile(player)
Parameters
FrameworkZ.Logs:OpenLogMenu()
FrameworkZ.Logs:SaveLogToFile(logEntry)
Parameters
FrameworkZ.Logs:SearchLogs(keyword)
Parameters
Returns
FrameworkZ.Notifications:AddToQueue(message, notificationType, duration, ui)
Parameters
Returns
FrameworkZ.Players:GetCharacterDataByID(username, characterID, callback)
Parameters
Returns
FrameworkZ.Players:GetPlayerByID(username)
Parameters
Returns
FrameworkZ.Players:Save(username, continueOnFailure)
Parameters
Returns
FrameworkZ.Plugins:AddEventHandler(eventName)
Parameters
FrameworkZ.Plugins:ExecuteCommand(commandName, ...)
Parameters
FrameworkZ.Plugins:ExecutePluginHook(hookName, ...)
Parameters
FrameworkZ.Plugins:LoadPlugin(pluginName)
Parameters
FrameworkZ.Plugins:Log(message)
Parameters
FrameworkZ.Plugins:RegisterCommand(commandName, callback)
Parameters
FrameworkZ.Plugins:RegisterPlugin(plugin, overwrite)
Parameters
FrameworkZ.Plugins:RegisterPluginEventHandlers(plugin)
Parameters
FrameworkZ.Plugins:RemoveEventHandler(eventName)
Parameters
FrameworkZ.Plugins:UnloadPlugin(pluginName)
Parameters
FrameworkZ.Plugins:UnregisterPluginEventHandlers(plugin)
Parameters
FrameworkZ.Plugins:UnregisterPluginHook(pluginName, hookName)
Parameters
FrameworkZ.Timers:Simple(delay, func)
Parameters
FrameworkZ.Utilities:CopyTable(originalTable, tableCopies, shouldCopyMetatable)
Parameters
Returns
FrameworkZ.Utilities:TrimString(str, maxLength, addEllipsis)
Parameters
Returns
FrameworkZ.Utilities:WordWrapText(text, maxLength, eolDelimiter)
Parameters
Returns
INVENTORY:AddItem(item)
Parameters
🔗 See Also
- CHARACTER::GiveItem(uniqueID)
INVENTORY:AddItems(uniqueID, quantity)
Parameters
🔗 See Also
- CHARACTER::GiveItems(uniqueID)