y3-lua-pipeline

Enforce Y3 Lua API safety and correct script directory routing.

Updated Apr 4, 2026
One-click install
npx skills add https://github.com/WindXRan/y3td --skill y3-lua-pipeline-windxran
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: y3-lua-pipeline
Source: https://github.com/WindXRan/y3td/tree/main/maps/EntryMap/.y3maker/skills/y3-lua-pipeline
Command: npx skills add https://github.com/WindXRan/y3td --skill y3-lua-pipeline-windxran

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It eliminates the high failure rate of writing Y3 Lua by enforcing API safety, correct script directory detection, and verified event/API usage before you run or hot-reload code.

Core Features & Use Cases

  • API safety first: automatically prompts you to read API safety rules and the project’s Lua “known issues” before writing new Lua code.
  • Deterministic script routing: enforces a mandatory directory detection checklist to ensure Lua scripts are placed/required from the correct engine-loading paths.
  • Y3 framework compliance: constrains implementations to the official y3-lualib APIs and prevents “invented API” calls by requiring verification in source or references.
  • Unified scope (game logic + UI Lua): covers both gameplay systems (logic/events/skills/buffs/damage/unit creation/timers/save-load) and UI interaction code.

Quick Start

Activate y3-lua-pipeline and, before writing any Lua, read api-safety.mdc and the existing memory/lua-issues, then follow the script directory detection checklist to choose the correct code.lua + require/module routing.

Frequently Asked Questions about y3-lua-pipeline

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I safely write Y3 Lua game logic without triggering engine load failures?

Safe Y3 Lua development requires reading API safety rules and known Lua issues before coding, then enforcing mandatory script directory detection to ensure correct engine-loading paths. This eliminates high failure rates caused by misplaced scripts or unverified API calls during hot-reloads.

Why does my Y3 Lua UI interaction code fail when hot-reloading?

Y3 Lua UI interaction code fails during hot-reload when scripts are not placed in correct engine-loading paths or when APIs are used without verification. Enforcing strict script directory detection and checking y3-lualib references prevents these failures.

What is the correct way to route Y3 Lua scripts for event handling and buff logic?

Correct Y3 Lua script routing requires executing a mandatory directory detection checklist to choose the proper code.lua path and module routing. This ensures event handling, unit effects, and buff logic load deterministically through the official y3-lualib framework.

Does Y3 Lua development support custom API calls for damage and death logic?

Y3 Lua development constrains implementations to official y3-lualib APIs and prevents invented API calls for damage and death logic. You must verify API existence in y3 source or references before writing gameplay systems to ensure reliable execution.

Can I use y3-lualib for both gameplay AI behaviors and UI Lua interactions?

Yes, y3-lualib provides a unified scope covering both gameplay systems including AI behaviors, timers, and save/load logic, alongside UI Lua interaction code. Both require the same API safety checks and script directory verification before implementation.

What are the known limitations when writing Y3 Lua skill effects and timers?

Known limitations when writing Y3 Lua skill effects and timers include encountering undocumented API behaviors and engine-loading path issues. Reading the project's known Lua issues and verifying API existence in references before coding mitigates these constraints.