Portal 2 AI mod: mówiąca AI komory i komendy głosowe
Zbuduj mod AI do Portal 2: sarkastyczną AI komory testowej, która reaguje na twoje próby, komory sterowane głosem i quiz naukowy, połączone z VScript.
Neocortex TeamThe team behind Neocortex
· 6 min czytania

Skrypty map Portal 2 nie mogą łączyć się z internetem. To jeden problem, który musi rozwiązać każdy mod AI do Portal 2, a odpowiedzią jest mała aplikacja pomocnicza działająca obok gry. Gdy już jest na miejscu, twoja komora testowa może mieć własną mówiącą AI, co pasuje do gry o byciu osądzanym przez głos w ścianach: komora, która zauważa, że gracz pięć razy nie trafia w ten sam skok, i ma na to coś do powiedzenia; komora, którą kontrolujesz głosem; oraz quiz, który otwiera wyjście tylko za poprawne odpowiedzi. Neocortex dostarcza postać AI, Conversation Flows, quizy i głosowe komendy działające na urządzeniu.
Zrzut ekranu: Portal 2 © Valve
Dlaczego mod AI do Portal 2 potrzebuje aplikacji pomocniczej?
Mapy Portal 2 buduje się w Hammerze za pomocą Portal 2 Authoring Tools i udostępnia w Steam Workshop. Logika mapy to wejścia i wyjścia encji plus VScript, który w Portal 2 działa w Squirrelu. VScript potrafi odczytywać i przesuwać encje, śledzić gracza i wypisywać do konsoli, ale nie ma dostępu do sieci ani HTTP.
Mapa robi więc to, co potrafi: raportuje i reaguje, a lokalna aplikacja pomocnicza rozmawia z Neocortex. Pomocnik może być napisany w dowolnym języku z klientem HTTP.
Jak zdarzenia wychodzą z gry i wracają?
| Kierunek | Jak |
|---|---|
| Z gry | Twój VScript wypisuje oznaczone linie (zdarzenie, stan komory) do konsoli. Uruchomienie Portal 2 z -condebug zapisuje wyjście konsoli do pliku console.log, który pomocnik może obserwować. Zobacz opcje wiersza poleceń Valve. |
| Z powrotem do gry | Opcja uruchomienia -netconport otwiera port konsoli, przez który pomocnik może wysyłać polecenia konsoli, na przykład wywołanie script do VScriptu mapy. Trzymaj ten port na własnym komputerze. |
| Napisy | Twoja mapa pokazuje tekst odpowiedzi encją game_text. |
| Głos | Pomocnik odtwarza głos postaci przez wyjście audio komputera. |
Po stronie Neocortex pomocnik odczytuje stan gry z dziennika konsoli i wysyła go razem z wiadomością gracza do postaci przez /v3/chat. Mapa pokazuje odpowiedź jako napisy, pomocnik odtwarza głos z /v3/audio/generate albo /v3/audio/stream, a działania zwrócone przez postać wracają do mapy jako polecenia konsoli. Conversation Flows zwracają słowa kluczowe punktów kontrolnych (flowState), na które reaguje mapa, na przykład otwierając kolejny test, a silnik quizów prowadzi gry pytań i odpowiedzi przez /v3/quiz.
Co może zrobić AI komory testowej?
Stwórz oryginalnego nadzorcę zamiast pożyczać tego z gry: PROCTOR-7, inteligencję obiektu, zdegradowaną do prowadzenia jednej komory i niezadowoloną z tego. Nadaj jej osobowość (Personality), ustawienie emocji (Emotion) i bazę wiedzy (Knowledge) o rozwiązaniu komory, jej historii i drobnych urazach.
Mapa raportuje, co się dzieje: „gracz wpadł w breję”, „trzeci nieudany rzut przy panelu B”, „kostka położona na złym przycisku”, „gracz stoi bez ruchu przez 40 sekund”. Pomocnik wysyła te zdarzenia z każdą wiadomością, a PROCTOR-7 komentuje głosem, z tagiem emocji przy każdej kwestii: CURIOUS, gdy spróbujesz czegoś nowego, ANGRY, gdy złamiesz zamierzone rozwiązanie.
Może też zwracać działania, na przykład niechętne { "name": "SPAWN_CUBE", "targetId": "dropper_01" } po wystarczającej liczbie porażek, które mapa wykonuje jako podpowiedź.
Conversation Flow może zamienić całą komorę w historię: wstęp, pierwszy test, „awarię”, przez którą gracz musi przeprowadzić PROCTOR-7, i końcowy test. Każde słowo kluczowe punktu kontrolnego zwrócone przez API otwiera kolejną część mapy.
Zrzut ekranu: Portal 2 © Valve
Czy gracz może rozwiązać komorę, rozmawiając?
Tak. Zbuduj komorę, którą gracz rozwiązuje, rozmawiając z nią. W panelu Neocortex projektujesz zestaw komend jako aktorów, działania i obiekty: aktor „chamber”, działania „raise”, „lower”, „drop” i „extend”, obiekty „platform”, „cube” i „bridge”.
Gracze mówią naturalnie, a pomocnik natychmiast otrzymuje dopasowane komendy, także kilka działań i ilości w jednym zdaniu: „zrzuć dwie kostki i podnieś platformę”. Działa to z przyciskiem mowy albo stałym nasłuchem, w wielu językach, a Neocortex Voice Commands działa na komputerze gracza bez wysyłania do chmury, co ma znaczenie, gdy od czasu reakcji zależy wyrzut.
Voice Commands to licencjonowany SDK: skontaktuj się z nami w sprawie licencji Voice Commands.
Ta sama komora może sprawdzać wiedzę zamiast refleksu. Postać prezenterka zadaje pytania z fizyki zbudowane w panelu Neocortex: pęd, grawitację, dlaczego portal zachowuje twoją prędkość. Silnik quizów (plan Team) prowadzi pytania i punktację; każda dobra odpowiedź włącza kolejny segment mostu świetlnego, a zła zrzuca kostkę do brei.
Czy to działa w Portal 2: Community Edition?
Portal 2: Community Edition to wersja Portal 2 utrzymywana przez społeczność, działająca na Strata Source, oficjalnie licencjonowanym forku gałęzi silnika CS:GO. Weszła w otwartą betę na Steamie 17 kwietnia 2026 roku, jest darmowa dla właścicieli Portal 2 i dodaje natywny port 64-bitowy, skrypty AngelScript, interfejs Panorama, system dodatków i własny Workshop.
To wciąż beta, więc sprawdź dokumentację, co jej skrypty potrafią. Wzorzec aplikacji pomocniczej działa tam tak samo.
Czy można publikować to w Workshopie?
Warunki Valve dla Workshopu dotyczą mapy, a aplikacja pomocnicza to osobne pobranie, które gracze uruchamiają, jeśli chcą. Ogranicz funkcje AI i głosu do komór dla jednego gracza, nigdy nie używaj ich, by zyskać przewagę w kooperacji z graczami, którzy się na to nie zgodzili, i niech każdy gracz używa własnego klucza API Neocortex.
Zbuduj pierwszą mówiącą komorę
- Zbuduj komorę testową w Hammerze z plikiem VScript, który wypisuje oznaczone zdarzenia do konsoli.
- Zaprojektuj swoją postać w panelu Neocortex: Personality i Knowledge PROCTOR-7, Conversation Flow dla komory, quiz i zestaw komend.
- Napisz aplikację pomocniczą: obserwuj
console.log, wywołuj/v3/chat, odtwarzaj głos i wysyłaj komendy z powrotem przez port konsoli. - Trzymaj klucz API w pliku konfiguracyjnym pomocnika, który wypełnia gracz, nigdy zakodowany na stałe w buildzie, który udostępniasz.
- Testuj w trybie jednoosobowym z ustawionymi opcjami uruchomienia, a potem opublikuj mapę w Workshopie, a pomocnika osobno.
Po stronie głosu przeczytaj głosowe komendy działające na urządzeniu w modach do gier. Dla modów silnika Source zobacz nasz przewodnik po modzie AI NPC do Half-Life 2, a dla gry na Source, której skrypty mogą wywoływać API bezpośrednio, nasz przewodnik po modzie AI do Titanfall 2. A jeśli później chcesz mieć PROCTOR-7 w samodzielnej grze, ta sama postać Neocortex działa przez naszą integrację z Unity.
Wersje narzędzi i linki sprawdzono w październiku 2026. Narzędzia do modowania często się zmieniają, więc sprawdź stronę każdego projektu, by znaleźć najnowsze wydanie.
Częste pytania
Czy można dodać postać AI do Portal 2?
Tak, za pomocą małej aplikacji pomocniczej. Skrypty map Portal 2 nie mogą łączyć się z internetem, więc mapa wypisuje zdarzenia do konsoli, a lokalna aplikacja pomocnicza przekazuje je postaci AI. Neocortex dostarcza postać, jej głos i odpowiedzi, a pomocnik odsyła je z powrotem do gry.
Czy VScript Portal 2 może wysyłać zapytania HTTP?
Nie. VScript w Portal 2 to Squirrel działający wewnątrz mapy, bez dostępu do sieci. Typowy wzorzec to zapisywanie zdarzeń do konsoli, odczytywanie ich z aplikacji pomocniczej i pozwolenie, by ta aplikacja wywoływała API internetowe, takie jak Neocortex.
Czy mogę sterować komorą testową w Portal 2 głosem?
Tak. Aplikacja pomocnicza może nasłuchiwać mikrofonu i wysyłać dopasowane komendy do gry, na przykład podniesienie platformy albo zrzucenie kostki. Neocortex Voice Commands wykonuje dopasowanie na komputerze gracza, więc działa offline i reaguje natychmiast.
Czym jest Portal 2: Community Edition?
Portal 2: Community Edition to wersja Portal 2 utrzymywana przez społeczność, działająca na silniku Strata Source, w otwartej becie na Steamie od kwietnia 2026 roku i darmowa dla właścicieli Portal 2. Dodaje AngelScript, interfejs Panorama i system dodatków, a wzorzec aplikacji pomocniczej dla Neocortex działa tam także.
Czy mogę opublikować mapę AI z testami w Steam Workshop?
Możesz opublikować mapę w Workshopie jak zwykle, ale aplikację pomocniczą trzeba udostępnić osobno, na przykład na GitHubie. Każdy gracz uruchamia ją z własnym kluczem API Neocortex, który zdobędziesz w edytorze w przeglądarce.






