Knowledge Base
Build mods from the source up.
Tutorials, prompts, and deep technical references, including guides written straight from the decompiled game source, for every platform we support.
Hytale Asset Store: Data-Driven Content and Asset Resolution
How Hytale stores, references, and resolves data-driven content. A source-grounded tour of the AssetStore, AssetMap, codecs, contained assets, and the JSON-to-runtime pipeline for blocks, items, and entities.
Hytale Codec System: Type-Safe Data Schemas and Validation
A source-grounded guide to Hytale's codec system: how Codec, BuilderCodec, KeyedCodec, and validators (de)serialize and validate every JSON asset a modder writes.
Hytale's Entity Component System: Archetypes, Chunks, and Queries
A source-grounded tour of Hytale's archetype-based ECS — Component, ComponentType, Archetype, ArchetypeChunk, ReadWriteQuery, CommandBuffer, and the system pipeline modders write against.
Hytale Event Bus: Priorities, Cancellation, and Async Dispatch
A source-grounded reference for Hytale's server event bus: listener registration, EventPriority ordering, ICancellable events, keyed dispatch, and the split between synchronous and CompletableFuture-based async buses.
Hytale Networking: Protocol Packets and Wire Serialization
A source-grounded tour of Hytale's packet protocol: the framed wire format, VarInt and fixed/variable block serialization, the PacketRegistry, and the client-server message taxonomy.
Hytale Raycasting and Hit Detection: The Geometry of Interaction
A source-grounded tour of Hytale's raycasting and hit-detection math: ray-vs-AABB intersection, DDA voxel traversal for block targeting, slab-based entity ray tests, and the frustum-projection executor that powers melee selectors.
Hytale Registry System: Registering and Resolving Game Content
A source-grounded tour of Hytale's server registry system — how plugins register entities, codecs, and assets under string keys, and how those registrations are tracked, resolved, and torn down.
Hytale World Storage: Persistence, Chunks, and Serialization
How the Hytale server persists world and entity state — the IndexedStorageFile blob format, BSON chunk serialization, pluggable IChunkStorageProvider backends, and the async save/load pipeline.
Hytale Entity Effects: Buffs, Debuffs, and Damage-Over-Time
A deep dive into Hytale's entity effect system covering data-driven effect definitions, overlap and removal behaviors, periodic damage with cooldowns, stat modifiers, model changes, invulnerability, and the ECS EffectController pipeline.
Hytale Flock System: Group AI Coordination and Pack Behavior
A deep dive into Hytale's flock system covering group formation, leader election, flocking steering behaviors, shared damage tracking, and data-driven flock configuration.
Hytale Inventory System: Containers, Slot Filters, and Transactions
A deep dive into Hytale's inventory architecture covering ItemContainers, slot filters, transactional item operations, the six inventory sections, and the ECS-driven change event pipeline.
Hytale Mob Spawning System: Beacons, Markers, and Spawn Suppression
A deep dive into Hytale's data-driven mob spawning architecture covering world spawns, spawn beacons, spawn markers, spawn suppression, and the SpawningContext validation pipeline.