ModernUO/Projects/Server/Serialization
Kamron Batman ee2cd1d18d
feat: Adds new decay system and SkipSerialization (#2311)
## Summary

- Replaces scan-based decay checking during world saves with an event-driven timer wheel scheduler
- Removes virtual property checks from serialization hot path, achieving 6-8x faster world saves

## Changes

### DecayScheduler (new):
- Timer wheel with 12 HashSet buckets (5-min intervals) + PriorityQueue for active processing
- O(1) register/unregister vs O(n) scan of all items
- Auto start/stop when items exist/empty
- Configurable tick interval with jitter to prevent system synchronization

### Item.cs:
- Added ScheduledDecayTime computed property
- Added UpdateDecayRegistration() called from SetLastMoved(), property setters, AddItem()/RemoveItem()
- Hooks in Visible, Movable, Spawner setters and Delete()

### World.cs:
- Removed _decayQueue, EnqueueForDecay(), ProcessDecay()
- ItemPersistence.Serialize() now tight loop without virtual calls

## Performance

| Metric        | Before     | After     | Improvement |
|---------------|------------|-----------|-------------|
| Items (230K)  | 245K ticks | 34K ticks | 8x faster   |
| Mobiles (43K) | 56K ticks  | 6K ticks  | 9x faster   |
| Total         | 302K ticks | 40K ticks | 7.5x faster |

## Configuration

decay.maxItemsPerTick = 250       # Items processed per tick
decay.tickInterval = 256ms        # Base processing interval
decay.bucketInterval = 5min       # Timer wheel bucket size
decay.jitterMaxMs = 25            # ±25ms tick jitter
2026-01-08 11:43:51 -08:00
..
Attributes chore: Updates copyright (#1448) 2023-08-09 09:09:26 -07:00
AdhocPersistence.cs chore: Use var everywhere (#2294) 2025-12-27 16:47:28 -08:00
BinaryFileReader.cs fix: Eliminate intermediate string in typecache (#2176) 2025-05-06 21:04:54 -07:00
BufferReader.cs feat: Updates serialization to use MMF (considerable memory savings) (#1841) 2024-06-23 10:51:20 -07:00
BufferWriter.cs feat: Upgrades serialization v4 (Threaded Heap Serialization) (#1947) 2024-09-14 09:57:43 -07:00
GenericEntityPersistence.cs feat: Adds new decay system and SkipSerialization (#2311) 2026-01-08 11:43:51 -08:00
GenericPersistence.cs feat: Upgrades serialization v4 (Threaded Heap Serialization) (#1947) 2024-09-14 09:57:43 -07:00
IGenericReader.cs chore: Use var everywhere (#2294) 2025-12-27 16:47:28 -08:00
IGenericSerializable.cs feat: Upgrades serialization v4 (Threaded Heap Serialization) (#1947) 2024-09-14 09:57:43 -07:00
IGenericWriter.cs chore: Use var everywhere (#2294) 2025-12-27 16:47:28 -08:00
ISerializable.cs feat: Updates serialization to use MMF (considerable memory savings) (#1841) 2024-06-23 10:51:20 -07:00
ISerializableExtensions.cs feat: Updates serialization to use MMF (considerable memory savings) (#1841) 2024-06-23 10:51:20 -07:00
MemoryMapFileWriter.cs feat: Upgrades serialization v4 (Threaded Heap Serialization) (#1947) 2024-09-14 09:57:43 -07:00
Persistence.cs chore: Use var everywhere (#2294) 2025-12-27 16:47:28 -08:00
SerializationExtensions.cs chore: Use var everywhere (#2294) 2025-12-27 16:47:28 -08:00
SerializationThreadWorker.cs feat: Upgrades serialization v4 (Threaded Heap Serialization) (#1947) 2024-09-14 09:57:43 -07:00
UnmanagedDataReader.cs fix: Eliminate intermediate string in typecache (#2176) 2025-05-06 21:04:54 -07:00