How to install an inZOI mod (CurseForge, in game)
- Start inZOI and from the main screen open Creative Mode, then select Mod (below Architecture Studio and Character Studio).
- Open the Add Mod tab. It is a CurseForge browser built into the game: search, filter by category and click Download.
- Go back to My Mod Management. New mods show a Validation Required badge.
- Tick the mod, click Validate, wait until the badge changes to Normal, then flip the activation toggle on.
- Load your save. Mods can be activated, deactivated, validated and deleted in bulk from the same panel, which also shows total size.
Since v0.11.0 you can rename installed mods and switch overlay UI mods on and off from the Mods menu in the main lobby. Krafton also changed how activation and load order work to lower the risk of corrupted files.
Manual install (Nexus Mods and other sites)
Mods from outside CurseForge go in a folder by hand. Krafton's documented path on Windows is:
C:\Users\[your name]\Documents\inZOI\Mods (shortcut: %USERPROFILE%\Documents\inZOI\Mods)
- Extract the download first. Each mod folder should contain three files:
.pak,.ucasand.utoc. - Restart the game, then validate and enable the mod in My Mod Management like a CurseForge mod.
- Some older Nexus Mods files need the community Mod Enabler and go in
BlueClient\Content\Paks\~modsinside the game folder instead. Follow the mod page's own instructions, and prefer CurseForge versions when both exist: they update through the game.
Most downloaded inZOI mods
CurseForge's all-time chart is led by Create a Zoi and Build Mode content. Download counts as of November 2026:
| Mod | Creator | Type | Downloads |
|---|---|---|---|
| Fullmoon Hairstyle Collection | Jang_Fullmoon | Hair | 289K |
| Amanda Hairstyle | CazySims | Hair | 240K |
| Wall shelf with warm LED lights | Mladi | Build: home office | 222K |
| Margot Hairstyle | CazySims | Hair | 212K |
| Amanda Hairstyle - Physics | CazySims | Hair with physics | 186K |
| Bodytattoo Asian V1 | F&M | dreamdoll | Tattoos | 177K |
| PL | Luxe Stiletto Court Shoes | platinumluxesims | Objects | 173K |
| SEOULSOUL_HAIR_002 | SEOULSOUL | Hair | 156K |
| Anime-Themed Desktop Setup | Mladi | Build: home office | 151K |
| Fullmoon Shoes Collection | Jang_Fullmoon | Outfits | 150K |
| Female hair 01 | TheKunstwollen | Hair | 136K |
| Elegant Body Chain Necklace | apaloosa10 | Accessories | 134K |
| Nimbus Sofa [VZ] | VallyZoi | Build: living room | 124K |
| Charlie Books Set | _NOORA_ | Objects | 119K |
| NCTN Padded Block Bed | Nichotinee | Build: bedroom | 119K |
Creators worth following for steady releases: CazySims (hair, several with physics), Jang_Fullmoon (hair and shoes), Mladi and _NOORA_ (furniture and clutter), Tyche_Zoi (plants, including an IKEA mini plants set).
Types of inZOI mods
| Type | What it changes | Made with |
|---|---|---|
| Create a Zoi | Hair, outfits, shoes, tattoos, makeup, accessories | ModKit wizards (CAZ, Headwear) |
| Build Mode | Furniture, decor, plants, lot objects | ModKit, Build Wizard |
| Vehicles | New or changed cars, built from game assets | Vehicle Wizard |
| Graphics | Filters and visual presets | Custom graphics filters (v0.11.0) |
| Data mods | Values and lists, such as shop stock | ModKit data editing |
| Script mods | Gameplay rules, careers, events, new menus | Lua editor, HTML for UI |
Cosmetic mods are by far the largest group on CurseForge. Script mods are newer and fewer, but they are what most players mean when they ask for a mod that adds a career, school or story system. Krafton's own demo of the script system showed a stock market, a height slider, an NPC possession menu, a Dungeons & Dragons-style dice roll system and luxury bags in the Pocket Market shop.
Best inZOI script mods (gameplay)
Script mods change how the game plays, not just how it looks. They became possible with v0.11.0 and CurseForge listed 119 of them by early November 2026. The most popular:
| Script mod | Creator | Downloads |
|---|---|---|
| ZoiWorks - Love Stories | ZoiWorks | 33.3K |
| HighSchool Life | AshCodes | 28.1K |
| ZoiWorks - OnlyZois | ZoiWorks | 27.5K |
| ZoiWorks - Organized Crime | ZoiWorks | 26.7K |
| ZoiWorks - Protect & Serve | ZoiWorks | 25.5K |
| inZOI: Age of Magic - Spell Tome (Witch) | QuinnsIdeas | 23.2K |
| Life Controller | JadeS97 | 22.3K |
| Love and Consequences | beckyzoi | 17.3K |
| EnhancedPregnancy | Art024 | 16.4K |
| ZOI COMMAND CENTER (ZCC) | divinityart | 15.0K |
| Zoi Wellness Tracker | JudgeMinai | 15.0K |
| ZoiWorks - Quick Needs | ZoiWorks | 11.4K |
| Family Life | AshCodes | 10.8K |
| Alimony | Art024 | 9.7K |
| ZoiWorks - Zoi Radio | ZoiWorks | 9.1K |
ZoiWorks is the biggest name in script mods, with a series that covers romance, crime, policing, needs, radio and dynamic weather. AshCodes focuses on teen and family life, and Art024 on family-life details such as pregnancy, alimony and meal calls.
Many script mods are tagged Beta. They are tied to the game build they were made for, so expect breakage after big patches until the creator updates.
How to make an inZOI mod
- Get the ModKit: the inZOI ModKit is free on the Epic Games Store and launches from the Epic Games Launcher. The game itself is played through Steam.
- Wizards: guided tools cover hair, headwear (Headwear Wizard, v0.11.0), buildings (Build Wizard), vehicles (Vehicle Wizard) and custom graphics filters. Character meshes get automatic LODs.
- Script mods: written in Lua with the Lua script editor in the ModKit. Mod UI can be built with plain HTML.
- AI help: the game exposes an MCP server, so you can ask an LLM to write or debug Lua script mods in natural language. The same command line can change limits such as the maximum number of cars and Zois.
- Publish: sign in to CurseForge inside the ModKit, choose Share UGC, then Create Mod, pick your
.modfile and fill in the name, logo (512×512 or 256×256), category and description. Updates go through CurseForge moderation and can release automatically or manually after approval.
Official documentation, including the full CLI reference, lives at mod-docs.playinzoi.com.
inZOI mods not working? Fixes
- Mods off after a patch: every game update sets mods back to Validation Required. Open My Mod Management, select all, Validate, then switch them on.
- Mod installed outside the browser doesn't show as running: fixed in hotfix v0.11.1. Update the game, or restart it after adding files by hand.
- Game crashes on load: deactivate all mods, then turn them back on in halves to find the bad one. Script mods tagged Beta are the usual cause right after an update.
- Manual mod missing: check that
.pak,.ucasand.utocsit together in their own folder insideDocuments\inZOI\Mods, not inside a zip. - Mac or PS5: the 2026 roadmap lists Mac and PS5 mod support as preparation work that may be limited by platform policy. Mod support is built for the Windows Steam version first.
Life sims that don't need mods
Many of the top script mods add the same things: careers, school, romance with consequences, crime and police. They show what players want from a life sim, and how much setup it takes to get it on a gaming PC.
LifeSim is a free online life simulator that runs in the browser on a computer or phone, with no download and no packs. You can be anyone in any real city on Earth and live a life day by day. Characters have needs, jobs and relationships, and the townspeople are driven by AI. There is nothing to install or validate, so it works on any laptop or phone in a few seconds.
inZOI mod support timeline
- March 28, 2025: inZOI enters Early Access on Steam.
- May 2025: official mod support arrives.
- January 2026: Krafton's roadmap targets an integrated in-game mod manager and Lua script modding for December 2026.
- October 15, 2026: v0.11.0 brings Lua script mods early, along with the MCP integration and new wizards.
- November 2026: the team says it is discussing adding some modder-made quality-of-life features to the base game. The next major update is due in December 2026, and like every patch it will switch mods off until you validate them again.