Dopasowanie do Twojego serwera

Własny adapter

Adapter dla własnego frameworka, przerobionej paczki albo zmienionej nazwy resource'u.

Własny adapter jest potrzebny, gdy studio nie zna resource’u, który coś robi na Twoim serwerze: własny framework, ekwipunek przerobiony z innego pod nową nazwą, własne powiadomienia.

Nowy adapter

  1. Resource’y → Co umie projekt, w ramce Tego projekt nie umie pole Zrób adapter dla. Lista podaje resource’y uruchamiane w server.cfg, które nie mają adaptera.
  2. Na wzór: pusty szkielet albo adapter, od którego zacząć. Ekwipunek przerobiony z ox_inventory zaczyna się od adaptera ox_inventory ze zmienioną nazwą.
  3. Zrób adapter. Studio zakłada adapters/<resource>/ w projekcie i otwiera server.lua.

Pusty szkielet ma listę wszystkich zdolności w komentarzach i exporty, które resource udostępnia. Odkomentowujesz te, które resource umie, i wpisujesz w nie wywołanie jego exportu.

Braki w Co umie projekt są pogrupowane w działy (Gracz, Ekwipunek, Interfejs…). Kliknięcie działu pokazuje jego zdolności i to, co bez nich znika ze studia.

Pliki

adapters/moje_powiadomienia/
  adapter.json
  server.lua
  client.lua

adapter.json mówi, czego adapter dotyczy:

{
  "id": "moje_powiadomienia",
  "label": "Moje powiadomienia",
  "resource": "moje_powiadomienia",
  "contract": 2,
  "priority": 50,
  "server": [],
  "client": ["ui.notify"]
}
  • resource: adapter działa tylko wtedy, gdy ten resource jest uruchomiony.
  • server, client: zdolności, które adapter wykonuje po każdej stronie. Studio uzupełnia je samo przy zapisie server.lua i client.lua: zdolność odkomentowana w Lua trafia na listę, zakomentowana z niej znika.
  • priority: gdy dwa adaptery dają to samo, wygrywa mniejsza liczba (chyba że wybierzesz inaczej w Co umie projekt).
  • unless: nazwa resource’u, przy którym ten adapter się wyłącza.
  • contract: wersja listy zdolności. Adapter pisany pod nowszą niż zna studio jest pomijany z ostrzeżeniem.

client.lua wykonuje zdolności po stronie gracza:

StudioAdapter('moje_powiadomienia', {
    ['ui.notify'] = function(text, kind)
        exports.moje_powiadomienia:Pokaz(text, kind)
    end,
})

Zdolności, które dotyczą gracza, dostają po stronie serwera jego numer jako pierwszy argument:

StudioAdapter('moj_ekwipunek', {
    ['inventory.add'] = function(src, item, count)
        return exports.moj_ekwipunek:Daj(src, item, count or 1)
    end,
})

Argumenty i wynik każdej zdolności są w komentarzach pustego szkieletu.

Zapis od razu działa

Zapis pliku adaptera wczytuje go na uruchomionym serwerze i sprawdza jego zdolności. Wynik widać w Co umie projekt, a studio od razu pokazuje to, co nowa zdolność włącza (narzędzia, kroki mechanik).

Zmiana adaptera ze studia

Przy adapterze ze studia jest Dostosuj: kopia trafia do adapters/<id>/ w projekcie i od tej chwili wygrywa nad wersją ze studia. Aktualizacje studia jej nie zmieniają.

Gdy aktualizacja studia przyniesie nową wersję jego adaptera, przy adapterze pojawia się Przywróć z numerem poprzedniej wersji, na wypadek gdyby nowa coś zepsuła.

Claude

Claude robi to samo przez MCP: adapter_new (z from dla adaptera na wzór), adapter_customize, caps_check. Może przeczytać exporty resource’u, napisać adapter i sprawdzić go na serwerze.

Pytanie, na które tu nie ma odpowiedzi? Zadaj je na Discordzie.

Webexe Studio

Kliknij, żeby zobaczyć w 100%.