🕊 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)
📃 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:
🤝 Donation:
- means alot 2 me if I get something for my modding works ^_^, do ping and lemme know if ur droppin one
![[Outdated] More NPC Spawns project image](https://media.forgecdn.net/avatars/thumbnails/1617/92/256/256/639041539567935758.png)