🕊 NPC Spawn Controller 🕊

⚙ Features:

- add modifications with filters to modify .json files and generate your mod which dynamically loads into your running world

- set your game directory, include/exclude mods and retrieve the game&+mod .json files

- search menus (for NPCs, Environments, Files, NPC Categories, Directories, Spawn Block Sets, Spawn Fluid Tags), use the search menu to select multiple items or a quick double click for single item selection

- option to clear NPCs(excluding tamed ones) when you generate the mod

- set World Max NPC Count (vanilla default: 500)

- presets which you can save/load/clone/append, two presets are included by default

- mod items which you can add/edit/clone/remove

- mod item holds modifications and global filters, you can add none global filters to a specific modification or global ones which applies to all modifications within the mod item

📂 Installation:

- Note: mod includes a tool and a mod file, do not the place tool in your mods directory

- Download and install ☕Java SE Development Kit, which is required to run the tool

- Extract ‘NPCSpawnControl.jar’ into ‘Game\UserData\Mods’ folder

- Extract ‘Tool’ folder and your done…

📝 Notes:

- (important): if the game has an update or when you include/exclude mods, you have to retrieve the game .json files again for the updated files, note this process doesn't take more than 2 seconds (depends on your hardware)

- (important): your modification must have a target filter (e.g.: Target All World Spawn Files) or else it won't go through any files and won't work

- (important): if your modding and want to see the changes while your world is running you first need to enable auto update by typing '/nsc-autoupdate-toggle', make sure to turn off auto update when your done modding

- certain modifications only work on certain files, these mods start with a rounded bracket containing the file type it can work with (NPC & Beacon) means its for beacon files and NPCs in it only, (World) for world spawn files

- when you retrieve the game files they are located in your tool directory in a folder called 'DefaultContent'

- info about game files:

- ‘Server\Environments’ are environment files that has a SpawnDensity controlling the amount of NPCs in the environment

- ‘Server\NPC\Spawn’ contains NPC spawn files:

- World, NPCs that spawn in surface(ground/air), underwater, cave(NOTE: there is only one file for cave in ‘Zone3’, caves mostly use beacons)

- Markers, are spawnpoints for NPCs, it’s placed in dungeons, structures and places like Forgotten Temple

- Beacons, are for NPCs that spawn in caves, though it might have other uses and not only in caves (not sure)

- Suppression, no idea what this is >_<

- ‘Server\NPC\Roles’ contains NPCs and components

- ‘Server\Item\Block\Sets’ contains groups of blocks which the NPCs will spawn on

- ‘Server\Item\Block\Fluids’ contains fluids for NPCs to spawn in (e.g.: water for aquatic NPCs to spawn in)

- having troubles?, reach out 2 me at my 🍺tavern/discord https://discord.gg/ZFZ37Y2m

📃 List of Modifications:

- (Environment) NPC Spawn Density

- (NPC) Add

- (NPC) Flock Size

- (NPC) Remove

- (NPC) Replace Id

- (NPC) Spawn Block Set | Fluid Tag

- (NPC) Weight

- (World) Despawn Day Time Range

- (World, Beacon) Light Ranges

- (World, Marker) Spawn Day Time Range

- (Beacon) Max Spawned NPCs

- (Beacon) Minimum Distance From Player

- (Beacon) NPC Beacon Radius

- (Beacon) NPC Idle Despawn Time

- (Beacon) NPC Spawn Radius

- (Beacon) NPC Spawn Range

- (Beacon) Spawn After Time Game Range

- (Json) Remove Element

- (Marker) NPC Deactivation Distance

- (Marker) NPC Exclusion Radius

- (Marker) NPC Max Drop Height

- (NPC & Marker) NPC Real-time Respawn Time

- (NPC & Marker) Spawn After Game Time

📃 List of Filters:

- Filename (Contains | Equals) / Not (Contains | Equals)

- NPC Category (Contains | Equals) / Not (Contains | Equals)

- NPC Id (Contains | Equals) / Not (Contains | Equals)

- Spawn File Environment (Contains | Equals) / Not (Contains | Equals)

- Target All Beacon Spawn Files

- Target All Environment files

- Target All Files

- Target All Marker Spawn Files

- Target All World Spawn Files

- Target Folder

⚠ Known Issues:

- had a small issue when I used'(NPC) Add' mod type the weight of the item doesn't seem to change, I wasn't able to reproduce this issue after reopening the application, released an update (not sure if the issue is fixed)

🕊 About This Project/Author:

📁 Project:

- started in January 2026 with my mod 'More NPC Spawns' broke after an update, I initially edited every .json file manually and I gotta say it was a pain :P, so I decided to make this tool and I was expecting this to finish within a month or so but it ended up taking around 3 months >_<

- project duration: around (3 months)

- tool is written in ☕ Java

- 💳 license: GNU General Public License

🕴 Me:

- in my twenties currently unemployed though used to be employed, quited job (currently studying for univ)

- I'm your average coder a game developer working and addicted to projects xD and gaming, I love modding games that I enjoy, some of my works below:

https://www.nexusmods.com/profile/Shaanig03/mods

https://github.com/Shaanig03?tab=repositories

https://steamcommunity.com/profiles/76561198090625400/myworkshopfiles/

- my tavern: https://discord.gg/ZFZ37Y2m

🤝 Donation:

- means alot 2 me if I get something for my modding works ^_^, do ping and lemme know if ur droppin one