> For the complete documentation index, see [llms.txt](https://docs.hytech-mods.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hytech-mods.com/readme.md).

# Introduction

Welcome to the Hytale modding API documentation by **Hytech**.

## Quick Start

1. [**Plugin System**](/core-apis/core/plugin-system.md) - Create your first mod
2. [**Event System**](/core-apis/core/event-system.md) - Handle game events
3. [**Messaging**](/core-apis/core/messaging.md) - Send messages to players

## API Status Legend

All API documentation uses validation status markers:

| Status                     | Meaning                                       |
| -------------------------- | --------------------------------------------- |
| 🟢 **Verified**            | Tested in-game, confirmed working             |
| 🔴 **Requires Validation** | Discovered from decompilation, not yet tested |

## Documentation Sections

### Core APIs

Essential APIs for mod development:

* [Plugin System](/core-apis/core/plugin-system.md) - JavaPlugin base class
* [Event System](/core-apis/core/event-system.md) - EventBus and handlers
* [Messaging](/core-apis/core/messaging.md) - Player messaging
* [Logging](/core-apis/core/logging.md) - HytaleLogger

### Game Systems

* [Commands](/game-systems/commands.md) - Command system
* [Entities](/game-systems/entities.md) - Entities and players
* [Items & Inventory](/game-systems/items.md) - ItemContainer API

### World & NPCs

* [World Generation](/world-and-npcs/worldgen.md) - Biomes, caves, chunks
* [NPC AI](/world-and-npcs/npc.md) - NPC behavior
* [Spawning](/world-and-npcs/spawning.md) - Entity spawning

### Utilities

* [Math](/utilities/math.md) - Vectors, shapes, raycasting
* [Common](/utilities/common.md) - Shared utilities

## Reference

* [**Complete Class List**](/reference/complete-class-list.md) - All 5,218 server classes
* [**File Structure**](/getting-started/file-structure.md) - Hytale installation layout
* [**Server Packages**](/getting-started/server-packages.md) - Package overview

## Important Notes

> **⚠️ Color Codes**: Minecraft-style color codes (`§`) do NOT work in Hytale.

> **⚠️ Deprecated APIs**: Some APIs like `getPlayer()` are deprecated but still functional.

***

*Documentation by* [*Hytech-Mods*](https://github.com/Hytech-Mods)