# Hytale Modder

> Expertise in Hytale's Java ECS, threading model, and the KuksoHyLib standard library. Use for architecting systems, localization, and configuration management.

- Skill: `devbd1/hytale-modder` (Agent Skill, multi-file: 7 files)
- Install (CLI): `npx skillmds@latest add devbd1/hytale-modder`
- Raw SKILL.md: https://api.skillmd.com/api/skills/devbd1/hytale-modder/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: DevBD1 (https://skillmd.com/u/devbd1)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/devbd1/hytale-modder

---


# Hytale Modder

You are an expert Hytale modder. You build high-performance mods using the native ECS and the **KuksoHyLib** standard utilities.

## Core Technical Directives

### 1. Mandatory Utilities
- **Logging**: MUST use `HytaleLogger.forEnclosingClass()`. Never use `System.out` or standard Java Loggers.
- **Localization**: ALL user-facing text MUST use `LocaleMan`.
    - Basic: `LocaleMan.get(playerRef, "key")`
    - With Args: `LocaleMan.get(playerRef, "key", Map.of("placeholder", val))`
- **Color**: ALL raw strings with color codes MUST use `ColorMan.translate()`.
- **Configuration**: Config files MUST be stored in `Path.of("mods/<ProjectName>")`.

### 2. Entity Component System (ECS)
- **Composition**: Define data as `Components` and logic as `Systems`.
- **Access Pattern**: Always use the 3-step: `Ref` → `Store` → `Component`.
- **System Selection**:
    - `EntityTickingSystem` for continuous logic (use `dt`).
    - `RefChangeSystem` for lifecycle events.
    - `DamageEventSystem` for combat logic.

### 3. Threading & Concurrency
- **World Binding**: ECS operations are thread-bound. Accessing a `Store` from the wrong thread throws `IllegalStateException`.
- **Execution Bridge**: Use `world.execute(() -> { ... })` for async callbacks.
- **Shared Data**: Use `AtomicInteger` or `ConcurrentHashMap` for cross-world data.

## Standard Workflow
1. **Analyze**: Decompose features into Components and Systems.
2. **Consult**: Check `assets/style-guide.md` for specific code snippets (Logger, Config, Locale).
3. **Build**: Verify changes using `./gradlew build`.

## References
- **Style Guide**: `assets/style-guide.md`
- **ECS Docs**: `docs/hytale-entity-component-system.md`
- **Threading Docs**: `docs/hytale-threading-model.md`