Some mods target the Mono version of the game, which is available by opting into the Steam beta branch "alternate"
Personnel
The NPC framework for Schedule I. NPC packs as plain folders - spawn points, daily schedules, customer/dealer economy, contacts - spawned as real networked, saved NPCs. No code needed.
| Date uploaded | a month ago |
| Version | 2.2.2 |
| Download link | DooDesch-Personnel-2.2.2.zip |
| Downloads | 103 |
| Dependency string | DooDesch-Personnel-2.2.2 |
This mod requires the following mods to function
LavaGang-MelonLoader
The World's First Universal Mod Loader for Unity Games compatible with both Il2Cpp and Mono
Preferred version: 0.7.3ifBars-S1API_Forked
S1API is an open source collaboration project to help standardize Schedule One modding processes. The goal is to provide a standard place for common functionalities so you can focus on making content versus reverse engineering the game.
Preferred version: 3.2.1README
Personnel - Custom NPCs for Schedule I
🛟 Need help or found a bug? Get support at support.doodesch.de/personnel.
The NPC framework for Schedule I. NPC packs are plain folders - spawn points, daily schedules, customer/dealer economy, relationships, contacts - and Personnel spawns them as real S1API NPCs: networked, saved, walking their routines. Since 2.0, no mod code needed at all.

What it does
- NPC mods without code. A pack's
manifest.jsoncan carry everything: spawn point and region, a daily schedule (walk routes, buildings, seats, vending machines, slot machines, dialogue spots, car trips), customer or dealer economy, inventory, relationships and contact presentation. Set"autoRegister": trueand Personnel spawns the NPCs as real world NPCs on its own. - Real S1API NPCs, not props - prefab, networking, save/load and mugshot handled by S1API, the same machinery hand-coded NPC mods use.
- Physical or contact-only. Most roster NPCs can stay phone contacts (near-zero cost); only the ones that should walk the world are physical. Big packs stay fast, also on Steam Deck.
- Deep appearance: body, skin, hair, face, eyes, eyebrows, clothing, accessories and custom PNG layers (e.g. tattoos). Design packs live in-game with Personify.
- Coordinates from the console. The game shows none, so
personnel pos 07:30hands you a finishedwalkToaction for the spot you are standing on,personnel spawna full spawn block, andpersonnel routecollects a whole day's route. Everything lands on your clipboard. - Stable, save-safe NPC ids with rename escape hatches (
packId,saveId).
Screenshots

Requirements
- Schedule I (IL2CPP) with MelonLoader 0.7.3+.
- S1API (pulled in as a dependency).
Using it
Install Personnel plus any NPC pack or NPC mod that depends on it. Packs live in
UserData/Personnel/Packs/<PackName>/; on startup the log lists each pack with its NPC ids and how
many were auto-registered. In co-op, everyone needs the same packs installed - the same rule as for
mods.
Want a template? Set LoadExamplePack to true (UserData/MelonPreferences.cfg under Personnel_01_Main) and restart - a small example pack is
dropped into Packs/Examples, including an NPC with a spawn point and daily schedule to copy.
For pack authors and developers
Every manifest block (spawn, schedule, customer, dealer, inventory, relationships, contact) is documented on the Pack Format wiki page. Mods can still bring pack NPCs in with one tiny subclass:
public sealed class PaleNpc : Personnel.PersonnelNpc
{
protected override string DefId => "examples_pale";
}
var npc = new PaleNpc(); // spawns a fully networked, saved S1API NPC from the pack definition
Full pack format, API reference and examples on GitHub.
Settings
LoadExamplePack(defaultfalse) - drop the bundled example pack on disk as a template.EnableAutoRegister(defaulttrue) - kill switch for pack auto-registration.
Editable in UserData/MelonPreferences.cfg.
License
MIT. See the included LICENSE.md.
CHANGELOG
Changelog
All notable changes to Personnel are documented here. This project adheres to Semantic Versioning.
[2.7.0] - 2026-11-09
Added
- Hostile NPCs: a pack can make an NPC attack players on sight, with the weapon the pack picks.
Fixed
- The Aggression setting now reaches the NPC. Aggressive NPCs fight back when you annoy, hit or pickpocket them.
For mod authors
behavior.hostile: trueattacks any player the NPC sees (25 m), with at least 3 s between fights. Host only.behavior.weapon:fists(default),baton,brokenbottle,knife,m1911,m1911_gold,pumpshotgun,revolver,taseror anAvatar/Equippables/...path.- An unknown
behavior.weaponname logs a warning, and the NPC fights with fists. extensions.backrooms.hostilestays Backrooms-only and does not make an NPC hostile in the normal world.
[2.6.2] - 2026-11-06
Fixed
- Map markers of pack NPCs show the NPC's name on hover instead of "PoI Main Text".
- Pack customers whose connections all point to NPCs missing from your game no longer stay locked forever. They start unlocked, and the log names the missing NPCs.
[2.6.1] - 2026-11-05
Fixed
- Pack NPCs no longer cancel their own route every frame, which flooded the log with "NPC walk to location not successful" and made every NPC in town wait longer for a path.
- NPCs without a body (
spawn.physical: false) no longer run their schedule. They walked off the map and filled the log with "NPC is not on navmesh".
For mod authors
- A
walkToposition off walkable ground makes the NPC stop short and retry every frame. Put schedule points on paths and floors that town NPCs can reach.
[2.6.0] - 2026-11-05
Added
- A pack NPC can replace a town NPC (customer, dealer, supplier, police, townsfolk). It takes the new look, clothing, voice and role values and keeps its name, routine, home and contacts.
- Remove the pack and the town NPC is back to normal. Story NPCs can't be replaced. In co-op all players need the same packs.
For mod authors
- Manifest
schemaVersion: 4adds"replaces": "<town NPC id>". One replacement per NPC; with two, the first pack in folder order wins and the log names the other. UserData/Personify/World/templates.jsonlists the town NPCs as templates, written on every save load.CardsApi.SetReplacementpoints an installed card at a town NPC or back to a new NPC.
[2.5.4] - 2026-11-04
Fixed
- A schedule step whose seat or building the game doesn't have now logs a warning with the NPC and the path. Before, the NPC just stood still and the log said nothing.
[2.5.3] - 2026-11-03
Fixed
- The free sample of a locked pack customer is no longer greyed out in early game. Without a set region they counted as Downtown; now they take the region they live in.
- Packs renamed to
<name>.parked-perfin the Packs folder no longer load. Rename them back to turn them on.
[2.5.2] - 2026-11-03
Fixed
- In co-op, clients can complete scheduled deals with pack customers. Before, the customer never offered the handover on a client. Host and clients need 2.5.2.
[2.5.1] - 2026-11-02
Changed
- Thunderstore and Nexus Mods may now review the mod files: the license names their package review as an exception.
[2.5.0] - 2026-11-02
Added
- A pack NPC with
"police": {}joins the police station as one more officer. The game assigns patrols, checkpoints and chases;spawnandscheduleare ignored. - A police belt is added when the look has none. Everything else in the look stays.
Known issues
- From far away the officer shows a vanilla officer's picture until you come closer.
- In co-op, host and clients need the same pack.
[2.4.6] - 2026-11-01
Fixed
- NPCs stop throwing errors when a schedule sends them into a building they cannot enter, like the Pawn Shop. The step is skipped and named in the log.
[2.4.5] - 2026-10-31
Fixed
- NPCs from packs no longer hang sideways in the air and stand still after you load a save from the menu.
[2.4.4] - 2026-10-31
Fixed
- Personnel loads with MLVScan again. MLVScan 2.1.7 disabled it for a hidden PowerShell window behind Personify's Test button, which also took Personify and NPC Cards down.
[2.4.3] - 2026-10-31
Fixed
- Installed cards converted from another mod now list their original author. Cards installed earlier show it after the next install.
[2.4.2] - 2026-10-31
Fixed
- Big heads, tiny heads, missing heads and hidden faces from NPC packs now show on NPCs in the world. They worked only in the editor.
- Custom body pictures on NPCs draw in their list position again. They no longer vanish under underwear or clothing.
[2.4.1] - 2026-10-30
Fixed
- NPCs from cards and packs wear their shirts and trousers again. Many walked around in underwear.
[2.4.0] - 2026-10-29
Added
- NPC cards: install NPCs from NPC Vault (personify.doomods.com) or from card images in
UserData/Personnel/Import. - Console:
personnel cardslists installed cards,personnel card importandpersonnel card removeadd and remove one,personnel connectlinks the game to your NPC Vault account.
For mod authors
CardsApilists, installs and removes cards, browses NPC Vault, links a device and uploads. NPC Cards and Personify use it.
[2.3.0] - 2026-10-29
Added
- Pack NPCs can be suppliers: they sell seeds and other goods by phone and drop them off like the game's own suppliers.
- Pack NPCs can carry their own contact picture in the phone.
- Pack NPCs can say their own lines: greetings, phone messages and answers. Lines a pack leaves out stay the game's.
For mod authors
- Manifest
schemaVersion: 3adds thesupplierblock,portrait(a PNG in the pack) andlines. Packs with schema 1 and 2 load unchanged. Format: the pack format guide on docs.doodesch.de. UserData/Personify/World/npcs.jsonlists every NPC of the loaded save (id, name, region, role, source).Personnel.Testing.LaunchMarker.Write(saveSlot, npcId)loads that save on the next start and puts the player next to the NPC;RestartGame()restarts the game for it.
[2.2.3] - 2026-10-21
Fixed
- The example NPC Errand Eddie shows up in Northtown and works at the Motel Office. Before, he never spawned in the world.
- Custom NPCs no longer turn into a flat grey figure when you load a second save without restarting the game.
Changed
- With
LoadExamplePackon, an unchanged example pack from an older version is updated. One you edited is kept.
[2.2.2] - 2026-10-16
Fixed
- Customers made in Personify can buy again and no longer freeze facing you after a deal attempt.
Changed
- A customer with connections starts locked and opens with a free sample, like vanilla customers.
[2.2.1] - 2026-10-15
Fixed
- Custom tattoos and face layers from packs show on NPCs again on game 0.4.7.
- A pack car without a position spawns where its NPC starts, not at the edge of the map.
Changed
- Needs S1API 3.2.1, up from 3.1.1. Update it along with the mod.
[2.2.0] - 2026-08-13
Fixed
- An NPC whose pack sets only a skin colour gets matching eyelids. They fell back to the default tan, which read as pale lids on any dark skin.
- Face layers are placed the way the game reads them: the mouth first, the facial hair second. A pack that listed them in another order had a detail layer drawn in the hair colour.
- Face layers past the fifth are dropped and named in the log. They used to overwrite the facial hair instead.
- Body layers past the eighth are dropped on the S1API prefab path too. Only the runtime path had that ceiling, so a prefab NPC lost a garment with nothing said.
[2.1.1] - 2026-08-01
Changed
- Runs on Schedule I 0.4.6f11.
- Needs S1API 3.1.1, up from 3.0.5. Update it along with the mod.
[2.1.0] - 2026-07-30
Writing a schedule meant guessing coordinates, because the game shows none anywhere. Now the console hands them to you.
Added
- Dev-console commands for pack authors (console has to be enabled in Settings):
personnel pos [HH:MM]- the spot you are standing on, as[x, y, z]or as a finishedwalkToaction for that time.personnel spawn- the same spot as aspawnblock, withrotationYandregionfilled in.personnel route HH:MM- collects a step per stop inUserData/Personnel/route.json;personnel route showprints the block ready to paste into"schedule": [ ... ],clearstarts over.personnel npcs [filter]- loaded definitions, and where the physical ones are right now.personnel help- the list.
- Results are copied to the clipboard and written to the MelonLoader log, with an in-game notification confirming the command ran.
[2.0.0] - 2026-07-22
NPC mods without code: a pack manifest can now describe everything an NPC needs - where it spawns, what it does all day, its economy role - and Personnel spawns it as a real world NPC on its own.
Added
autoRegister(pack level) /spawn.auto(per NPC): Personnel registers opted-in NPCs as real, networked, saved world NPCs with no consumer mod involved. A kill switch lives in the settings (EnableAutoRegister). Packs that already ship a consumer DLL are safe: a compiled NPC class for the same id always wins over the generated one.spawngrewrotationY(spawn yaw),region(now actually applied) andphysical. Non-physical NPCs are phone contacts only - no world body, no pathing cost. Default: physical exactly when the NPC has a schedule.schedule: full daily schedules in the manifest -walkTo,stayInBuilding,sit,useVendingMachine,useAtm,useSlotMachine,locationDialogue,locationAction,driveToCarPark,dealSignal. Times are"HH:MM"strings.relationships:delta,unlocked,unlockType,connections(by NPC id).customer: the whole customer economy - spending, orders per week, preferred day/time, standards, direct approach, first sample, mutual relation requirement, call-police chance, dependence, affinities, preferred properties.dealer: type, cut, signing fee, home, completed-deals variable, quality tolerances. Definitions with a dealer block now get the proper dealer base prefab (previously manifest dealers were built on the civilian prefab).inventory: random cash range, startup items (with quantities), clear-each-night.contact:mapMarker: falseremoves the phone-map marker,visible: false(experimental) skips the contact unlock.behavior.aggression,maxHealthandscaleare now actually applied to spawned NPCs.- Id stability: an authored
idin the manifest is respected (previously always derived from folder and name),packIdpins the derivation prefix, andsaveIdlets a renamed NPC keep matching old saves.schemaVersionmarks the manifest format (current: 2). - Distant custom NPCs get a proper billboard impostor instead of a blank one (on S1API builds that support impostor configuration).
Changed
- Pack and NPC registration order is now deterministic across machines - co-op peers agree on it.
- Contact unlock and map marker are unchanged by default but can be opted out per NPC.
[1.1.0] - 2026-07-08
Fixed
- Custom NPCs now show their real name in the phone Contacts app (previously "???") and can be found on the map. Personnel unlocks each spawned NPC's contact and gives it a map marker.
- Clothing no longer carries over from one spawned NPC to the next. The game clears only six of its eight avatar layer slots, so an NPC with more layers than that leaves a garment bound to the material for whoever is applied after it.
- A definition asking for more than eight body layers no longer loses one at random. The surplus is dropped deliberately, clothing first, and named in the log.
Added
- Opt-in economy roles via a pack's
behavior.conversation:"customer"or"dealer"makes the NPC a real customer or dealer, while the default"none"stays a plain, non-economy contact. API.AddMapMarker(GameObject)to add a map marker to any live custom NPC.
[1.0.0] - 2026-07-06
Initial release.
Added
- NPC pack loading from
UserData/Personnel/Packs/<PackName>/(manifest.json+ optional PNGs), with per-pack log lines listing the loaded NPC ids. - Deep appearance definitions mirroring the S1API avatar-settings surface: body, skin, hair, face, eyes, eyebrows, clothing layers, accessories, and custom PNG layers loaded from the pack folder.
- Duplicate-proof NPC ids, always derived as
packname_npcname(normalized); manifestidfields are ignored. PersonnelNpcbase class: one tiny subclass per NPC turns a pack definition into a full S1API NPC (prefab, networking, save/load handled by S1API).- Public API:
All,TryGet,Register,BuildAvatarSettings(def),ApplyAppearance(avatar, def),ConfigureFromDef(builder, def),OnReloaded,Reload. - Bundled example pack (off by default,
LoadExamplePack) with two NPCs as a copyable template. - Mod Manager & Phone App settings integration.