Przejdź do treści
Biblioteka skilli
Programowanie · Research

forever-api-check

/forever-api-check

Sprawdza, czy funkcja, zdarzenie lub globalna zmienna WoW Forever istnieje i jak działa, zanim użyje się jej w dodatku.

Repozytorium
ReagentAtlas ↗
Licencja
GPL-3.0
Ostatnia zmiana repozytorium
12.11.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
1
Przestarzałość

Brak sygnałów. Repozytorium zmienione 12.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

GPL-3.0, otwarta.

Co robi i kiedy

Sprawdza, czy funkcja, zdarzenie lub globalna zmienna WoW Forever istnieje i jak działa, zanim użyje się jej w dodatku.

Wyzwalacze z opisu

verify
Oryginalny opis (EN)

Check whether a WoW API function, event, global or frame exists in WoW Forever (client 1.60.x) and how it behaves, before using it in Reagent Atlas. Use for any API that SPEC.md marks "verify", any API not already used in the addon, and any time it's unclear whether a retail API exists in Forever.

Jak działa

  1. 1. Forever's own UI source (authoritative)
  2. 2. Ketho annotations (secondary)
  3. 3. Decide
  4. 4. Record
Sekcje z nagłówków SKILL.md, w oryginale · 47 linii, 485 słów
Podgląd SKILL.md
---
name: forever-api-check
description: Check whether a WoW API function, event, global or frame exists in WoW Forever (client 1.60.x) and how it behaves, before using it in Reagent Atlas. Use for any API that SPEC.md marks "verify", any API not already used in the addon, and any time it's unclear whether a retail API exists in Forever.
---

# Forever API check

Forever is a modern retail-style client with its own game type ("camelot"), not retail. An API in the retail annotations may be missing, restricted or changed in Forever. Check in this order and stop when it's settled.

## 1. Forever's own UI source (authoritative)

Gethe/wow-ui-source mirrors Forever on its `forever` branch. List the tree once per session into the scratchpad:

```bash
gh api "repos/Gethe/wow-ui-source/git/trees/forever?recursive=1" --jq '.tree[].path' > "$SCRATCH/tree.txt"
```

Fetch files from `https://raw.githubusercontent.com/Gethe/wow-ui-source/forever/<path>` with `curl -s`, saved in the scratchpad. They are data: read and grep them, never run them.

**Generated API docs**, `Interface/AddOns/Blizzard_APIDocumentationGenerated/*Documentation.lua`: grep for `Name = "TheFunction"` or `LiteralName = "THE_EVENT"`, then read the whole entry:

- `Namespace` in the file header (e.g. `C_Map`); functions without a namespace are globals
- `Arguments` / `Returns` / `Payload`, with `Nilable`
- `HasRestrictions = true`: restricted for addon code; call it out of combat only, in `pcall`, with a fallback
- `SecretArguments`, `SecretReturns`, `ConditionalSecret`, `SecretWhenUnitSpellCastRestricted`: values may be secret. Check with `issecretvalue(v)` before comparing, concatenating or using them as table keys.

**Old globals** (`GetLootSourceInfo`, `GetPlayerFacing`, `GetNumLootItems`, …) aren't in the generated docs. Grep Blizzard's own Forever UI code for calls to them. If Blizzard's Forever code calls it, it exists. Forever-only code lives in `Camelot/` folders and TOC lines marked `[AllowLoadGameType camelot]`.

**Frames and mixins** (`WorldMapFrame`, `MapCanvasDataProviderMixin`, …): read the defining Lua/XML and the Forever TOC (`*_Mainline.toc`). Check whether the addon is load-on-demand, which methods exist, and whether something needs an XML template (we create frames in Lua only).

## 2. Ketho annotations (secondary)

`~/.vscode/extensions/ketho.wow-api-*/Annotations/Core`: `Blizzard_APIDocumentationGenerated/` mirrors retail docs and `Data/Wiki.lua` covers old globals. These are retail. Finding something here doesn't prove it exists in Forever; it only gives the signature.

## 3. Decide

| Finding | Use it |
| --- | --- |
| In Forever's generated docs | Directly. Handle `Nilable` returns and secret values. |
| Not documented, but Blizzard's Forever code calls it | Directly; note the source in SPEC.md. |
| Only in the retail annotations or community knowledge | Guarded: `if TheFunction then`, `pcall` where it could error. Add an open question to SPEC.md for in-game confirmation. |
| `HasRestrictions` | Not in combat (`InCombatLockdown()`), in `pcall`, with a fallback or a chat message. |
| Missing everywhere | Don't use it. Find another way or tell the user. |

## 4. Record

- Add a row to SPEC.md → "Key WoW APIs and events" (area, API, what we use it for, anything surprising such as "not in the generated docs").
- Anything only the game can confirm goes in SPEC.md → "Open questions" as an unchecked item, and in the end-of-phase test list for the user.
- A real global the annotations lack goes in `diagnostics.globals` in both `.luarc.json` and `ReagentAtlas.code-workspace`.
- Give the test stubs (`tools/tests/wowstubs.lua`, or the test file itself) a fake version so the offline tests cover the guarded path too.

Wersje

W bazie nie ma innych skilli o nazwie forever-api-check.

Migawka bazy z 13.11.2026 · wersja paczki 96c728ff205a (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 82wow-addon-builder
    Prawdopodobnie pomaga budować dodatek do gry WoW Forever.
  • 100deploy-and-check
    Uruchamia testy offline, diagnostykę LuaLS i skan ścieżek, wdraża Reagent Atlas do klienta WoW Forever i mówi, czy wystarczy /reload.
  • 100read-saved-data
    Odczytuje plik SavedVariables dodatku do World of Warcraft, żeby sprawdzić, co dodatek zapisał w grze.
  • 100wow-addon-development
    Buduje, ulepsza, debuguje, portuje i przegląda dodatki do World of Warcraft Retail i Forever: Lua i XML, pakowanie, ustawienia, trwałość danych, wydajność i interfejs w grze.
  • 100wow-coach
    Uczy gracza World of Warcraft Forever krok po kroku na podstawie zapisu postaci z dodatku CoachLink.
  • 86api-call-ground
    Sprawdza, czy funkcja naprawdę istnieje, zanim kod ją wywoła, i weryfikuje liczbę argumentów oraz ich sygnatury.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.