Core RPG handbook · Development build / version notes

These are short “correct path” checklists for common authoring jobs. They deliberately point you through shared definitions and authoritative services instead of one-off scene scripts.

Create an item#

1. Open Item Database.
2. Create a definition with a unique stable item ID.
3. Configure stackability/presentation/actions.
4. Add equipment or weapon data if applicable.
5. Validate registries and test save/load.

Create a weapon#

1. Create an equippable item definition.
2. Choose slot/two-handed rules and skill requirements.
3. Configure combat style, min/max range, attack speed, base accuracy/damage and bonuses.
4. Assign a combat style set and visual/animation class.
5. For ranged weapons, assign the correct ammunition category and projectile relationship.

Create a combat NPC#

1. Create/configure the NPC in NPC Database.
2. Assign NpcCombatDefinition stats, style/ranges/speed and optional multi-style attack options.
3. Add/validate the required network NPC prefab composition.
4. Spawn it through NpcSpawnPoint/NpcSpawnDirector.
5. Assign its loot table and test aggro, leash, death and respawn.

Create a quest#

1. Create the quest in Quest Database.
2. Configure prerequisites/objectives/rewards.
3. Connect dialogue/world actions to progression.
4. Test completion and reward claiming.
5. Reconnect and confirm persistent state does not replay rewards.

Add a location#

1. Create the location/travel definitions through Travel Editor.
2. Create stable destination IDs and arrival positions.
3. Connect interaction travel or NetworkTravelTrigger.
4. Register any required save/scene restore information.
5. Test host and remote-client travel plus reconnect restoration.

Add persistent data#

1. Add a versioned DTO field/section.
2. Create/register an IPlayerSaveModule.
3. Capture and restore only server-authoritative state.
4. Define ordering/dependencies.
5. Use stable IDs to resolve content references.
6. Test load, disconnect save and shutdown save.