Alec's Tamework!
PluginA taming framework for Hytale that focuses on fast setup and giving modders reusable systems for companion NPCs. Add ownership, taming, capture/spawn, command tools, and rich NPC interactions without huge custom instruction trees in every role.
<p> <a href="https://www.curseforge.com/hytale/mods/alecs-tamework" target="blank" rel="noopener noreferrer"><img alt="Tamework downloads" src="https://img.shields.io/curseforge/dt/1447962?label=Tamework&style=for-the-badge&logo=curseforge&color=rgb(241%2C100%2C54)" /></a> <a href="https://www.curseforge.com/hytale/mods/alecs-cats" target="blank" rel="noopener noreferrer"><img alt="Cats downloads" src="https://img.shields.io/curseforge/dt/1432112?label=Cats&style=for-the-badge&logo=curseforge&color=rgb(241%2C100%2C54)" /></a> <a href="https://www.curseforge.com/hytale/mods/alecs-nametags" target="blank" rel="noopener noreferrer"><img alt="Nametags downloads" src="https://img.shields.io/curseforge/dt/1464844?label=Nametags&style=for-the-badge&logo=curseforge&color=rgb(241%2C100%2C54)" /></a> <a href="https://www.curseforge.com/hytale/mods/alecs-animal-husbandry" target="blank" rel="noopener noreferrer"><img alt="Animal Husbandry downloads" src="https://img.shields.io/curseforge/dt/1480275?label=Animal%20Husbandry&style=for-the-badge&logo=curseforge&color=rgb(241%2C100%2C54)" /></a> </p> <p> <a href="https://discord.gg/E8n8RgTTdq" target="blank" rel="noopener noreferrer"><img alt="Join Discord" src="https://img.shields.io/discord/1468261809739005996?style=for-the-badge&logo=discord&logoColor=white&label=Join%20Discord&color=rgb(88,101,242)" /></a> <a href="https://ko-fi.com/alechilles" target="blank" rel="noopener noreferrer"><img alt="Support me on Ko-fi" src="https://img.shields.io/badge/ko--fi-Support%20Me-ff5f5f?logo=ko-fi&style=for-the-badge" /></a> <a href="https://hytale.com/" target="blank" rel="noopener noreferrer"><img alt="Creator Code Alec" src="https://img.shields.io/badge/Creator%20Code-Alec-00AEEF?style=for-the-badge" /></a> <a href="https://twitter.com/intent/user?screenname=Alechilles" target="blank" rel="noopener noreferrer"><img alt="Follow Alec on X" src="https://img.shields.io/badge/Follow-%40Alec-White?style=for-the-badge&logo=x&logoColor=rgb(255%2C255%2C255)&logoSize=auto&label=Follow&labelColor=rgb(85%2C85%2C85)&color=rgb(147%2C147%2C147)" /></a> </p> <p> <a href="https://bisecthosting.com/Alec" target="blank"><img alt="25% Off BisectHosting Servers With Code: Alec" src="https://www.bisecthosting.com/partners/custom-banners/249bd432-0996-4ccb-8184-65cd3791a3d2.webp" /></a> </p> <p> <a href="https://www.modstats.io/stats/alecs-tamework" target="_blank" rel="nofollow"><img src="https://www.modstats.io/api/v1/stats/projects/alecs-tamework/embed/card.svg?layout=live&theme=modtale" alt="Alec's Tamework! ModStats"></a> </p>
Now Includes a Universal, Non-Destructive Asset Patcher!
- Add, merge, and insert JSON into any Hytale asset at runtime
- Apply one patch file across multiple target assets
- Gate optional integrations on installed mods
- Supports hot-reloading
- Inspired by Hytalor
- Learn More
Alec's Tamework!
Alec's Tamework is a modular NPC framework and asset patcher for Hytale built to let modders add rich NPC features through assets, templates, and config-driven systems instead of writing custom Java code. It is designed to empower artists, designers, and less technical modders who want advanced companion behavior without first building their own framework.
Tamework also aims to establish a shared standard for tameable NPCs in Hytale so different mods can work on top of similar ownership, naming, command, progression, and companion-management systems instead of forcing players to learn a different workflow for every mod.
This Is a Library
Tamework is a framework dependency for other mods. It does not add a standalone gameplay expansion by itself.
If you are a player looking for gameplay built on Tamework, start with Alec's Animal Husbandry or the wiki for the specific mod you are using.
Why Tamework
- No Java required for most integrations: the main integration path is built around JSON assets, templates, role wiring, and
Tw*Configfiles rather than custom Java systems. - Non-destructive asset patching: Add, merge, and insert JSON into one or many Hytale assets at runtime, with installed-mod conditions and hot-reload support.
- A shared standard for tameable NPCs: mods built on Tamework can present familiar ownership, naming, command, linked-panel, breeding, and progression behavior instead of inventing incompatible one-off systems.
- Optimized interactions: build taming, feeding, mounting, harvesting, breeding, and custom interactions with
TwInteractionConfigandTameworkInteract. - Ownership and tame-state systems: use reusable builders and role-scoped policy for owner checks, protection rules, and companion behavior.
- Spawner, naming, and command items: capture and respawn NPCs with metadata, name companions with custom items, and build command tools with radial and linked-panel support.
- Linked companion runtime: manage loaded, unloaded, dead, and lost companions through a linked panel with recall, home, revive, and related flows.
- Progression systems: add happiness, needs, breeding, life stage, and trait-driven variation through config-driven systems.
- Advanced extension points when needed: bridge into custom logic through hooks and optional integrations without giving up the higher-level framework.
What Integration Looks Like
Integrating Tamework is usually a content-authoring workflow, not a programming workflow. Mods can use it in two ways:
Required Dependency
- Wire your desired Tamework behavior directly into your NPC, item, config, and other server-side assets.
- Add configs for the Tamework systems you want to support.
- Add Alec's Tamework as a required dependency when deploying to CurseForge.
Optional Dependency
- Keep your base assets clean of any references to Tamework functionality.
- Create asset patches under
Server/Tamework/Patchesthat add Tamework actions, interactions, configs, and other JSON-based behavior at runtime only when Tamework is installed. UseTargetsfor shared operations across several assets andWhen.ModInstalledfor optional cross-mod gates. - Add configs for the Tamework systems you want to support.
- Add Alec's Tamework as an optional dependency when deploying to CurseForge.
In both cases, no Java is required: copy and adapt examples, enable the systems you want through comprehensive configs, and polish. The full setup and implementation details can be found in the wiki.
Player-facing Tamework config strings support server.lang keys. Built-in talents, traits, command labels, interaction messages, happiness labels, and major UI labels use language keys so translation packs can override copy without changing behavior assets.
Documentation
Issue Reporting
If you run into a bug, integration issue, or behavior problem, report it in the Discord server:
https://discord.gg/E8n8RgTTdq
<H2>Telemetry</H2> <p><a href="https://www.curseforge.com/hytale/mods/alecs-tamework">Alec's Tamework</a> utilizes <a href="https://www.curseforge.com/hytale/mods/alecs-telemetry">Alec's Telemetry</a> to report crash, error, performance, and usage telemetry data to the developer.</p> <p>This data is anonymous and does <strong>not</strong> contain any personally identifiable information, and is exclusively used to diagnose issues in the mod to provide a better user experience.</p> <p>You may disable this feature at any time in the /telemetry consent menu.</p> <p>Alec's Tamework also reports anonymized active user numbers to <a href="https://hstats.dev/">HStats</a> to track active user count summaries.</p> <br />
0 Comments