FrameworkZ

The Ultimate Project Zomboid Roleplay Framework

Revolutionize your Project Zomboid server with the most advanced roleplay framework available. Built from the ground up with modularity, performance, and endless customization in mind.

Get Started Documentation

Powerful Features

Advanced Character System

Comprehensive character creation with persistent data, skills, traits, and progression systems. Create unique roleplay experiences with deep character customization.

Dynamic Factions

Build complex faction systems with hierarchies, permissions, and inter-faction relationships. Perfect for law enforcement, gangs, businesses, and organizations.

Entity Framework

Create custom entities with persistent properties and behaviors. From vehicles to furniture, everything can be customized and enhanced with rich metadata.

Smart Inventory System

Advanced inventory management with custom containers, item restrictions, and automated sorting. Supports complex item interactions and crafting systems.

Plugin Architecture

Modular plugin system allows for easy extension and customization. Load only what you need and create custom modules without touching the core framework.

Data Persistence

Robust data management with automatic saving, loading, and synchronization. Your server state is always preserved across restarts and updates.

FrameworkZ Plugin Example
-- Create a new FrameworkZ plugin local WelcomePlugin = FrameworkZ.Plugins:CreatePlugin("WelcomePlugin") -- Plugin metadata WelcomePlugin.Meta.Author = "YourName" WelcomePlugin.Meta.Description = "Welcomes new players and tracks login count" WelcomePlugin.Meta.Version = "1.0.0" -- Initialize plugin when loaded function WelcomePlugin:Initialize() print("WelcomePlugin initialized!") end -- Hook: Called when a character loads function WelcomePlugin:OnCharacterLoad(character) -- Track login count for this character local loginCount = character.CustomData.loginCount or 0 character.CustomData.loginCount = loginCount + 1 -- Welcome message based on login count if loginCount == 0 then character:GetIsoPlayer():Say("Welcome to the server, " .. character.Name .. "!") else character:GetIsoPlayer():Say("Welcome back! Login #" .. loginCount) end end -- Hook: Called when a character finishes loading function WelcomePlugin:OnCharacterFinishedLoading(player, character) -- Give starter items to new characters if character.CustomData.loginCount == 1 then -- First time - give starter kit local isoPlayer = player:GetIsoPlayer() local inventory = isoPlayer:getInventory() inventory:AddItem("Base.Backpack") inventory:AddItem("Base.Bottle") inventory:AddItem("Base.Apple") isoPlayer:Say("You received a starter kit!") end end -- Register the plugin with FrameworkZ FrameworkZ.Plugins:RegisterPlugin(WelcomePlugin)

Join the Community

FrameworkZ is powered by an active community of developers, server owners, and roleplay enthusiasts. Join us to share ideas, get support, and contribute to the future of Project Zomboid roleplay.

0 Discord Members
0 Active Servers
0 Contributors
0 GitHub Stars
0 Downloads