# 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)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.hytech-mods.com/readme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.