Hytale Bud Plugin

Used template by Up, slightly modified by Kaupenjoe.
Inspired by MyFriends by LukeysMods.

Bud Work Feature inspired by Ancient Constructs by DanBagh.

🌟 Overview

This is a proof of concept (PoC) plugin for Hytale that integrates Large Language Models (LLM) to create truly interactive RPG-style companions. These "Buds" don't just follow you—they talk, react to the world, and remember your battles. The mod works fully without an LLM configured too — the AI layer is what makes it come alive, not what it depends on.

Only tested in single player mode!

Upgrading from an older version? Remove the /prompts folder, or update it with /bud prompt reset.

New in 2.0.0.:

• Bud Roster Spawning: New card item to spawn/despawn all roster Buds at once, without needing to use commands. The card can be crafted on the arcane workbench.
• Bud Cards: Optical rework and texture now matches the card.
• Bud Work Stations: Now you can send your bud to work an harvest/lumber/mine items
• Bud 2 Bud Reactions: Buds now react to each other's mood changes, spawns, state changes (e.g. sitting down), and legendary memories, and can chain into a couple of named back-and-forth replies before going quiet again
• Bud 2 Bud Memories: Your buds will now have persisted memories about other buds, including a shared "legendary" memory between a pair of buds
• Bud Player State Reactions: Your buds will now react if you have status effects like poisoned, health regeneration e.g.
• Central Version Management: Global version file and prompt/bud-config reloading

Meet the Buddies

	🦊 Veri — Feran, agile and curious, fights with daggers. Worker role: Mining.
	👹 Gronkh — Trork, grumpy but loyal, fights with a mace. Worker role: Lumbering.
	🍃 Keyleth — Kweebec, shy and intelligent, supports with a bow. Worker role: Farming.

Every Bud is fully data-driven — new companions are added via a YAML definition, no plugin rebuild required. → Meet the Buddies in full

🚀 Features

• LLM Reactions — your Buds react in character to combat, block placement, crafting, item pickups, weather, new zones, your chat, even your status effects — generated live by an LLM, or a hand-written fallback line when none is configured.
• Bud Cards + Crafting — summon and dismiss companions with a craftable card instead of chat commands. → How to craft & use them
• Bud Work Stations — assign a Bud to a Workstation and it farms, logs, or mines a field on its own. → How Work Stations work

→ See every feature

🆕 New Features

Highlights of the latest release:

• Bud-to-Bud Reactions & Memories — Buds react to each other and build shared memories.
• Bud Work Stations — send a Bud to farm, log, or mine autonomously.
• Data-driven Bud Registry — new companions via YAML, no rebuild.
• Central content versioning — prompts and Bud definitions auto-update safely.

→ Full changelog

🎮 Commands

Everything runs through /bud <subcommand> — creation, deletion, state, memory, prompts, reload, debug.

→ Full command reference

⚙️ Configuration

Six JSON files, one per concern (LLM, Reaction, Orchestrator, Work, Debug, Conversation), plus the Bud Registry and prompt YAMLs.

→ Full configuration reference

🛠️ Development

1. Initial Setup: .\gradlew decompileServer
2. Build: .\gradlew build
3. Run Server: .\gradlew runServer
4. Auth Login: /auth login device
5. Persist Login: /auth persistence Encrypted

Known Issues

• After player teleport, buds are often broken and are "invisible". Workaround: Use "/bud" or "/bud reset" command to respawn them.

📜 History

For a detailed list of all changes and version history, please see the CHANGELOG.md.