tf-scripts/_doc/HELP.md

197 lines
11 KiB
Markdown
Raw Permalink Normal View History

2013-02-16 01:08:43 +01:00
# Informacje ogólne
## Notacja użyta w instrukcji:
| |
| - | - |
| {ścieżka} | - ściezka do pliku na dysku |
| _kursywa_ | - bezpośrednia komenda występująca na mudzie |
| `tekst w ramce` | - dokładna komenda do wpisania |
| <tekst> | - zmienna |
| [tekst] | - zmienna opcjonalna |
2013-02-16 01:26:49 +01:00
## Podstawowe ustawienia
2013-02-16 01:08:43 +01:00
2016-06-14 19:05:29 +02:00
W pliku {~/.tfrc} (skopiowanym z [tfrc](../tfrc)) należy ustawić podstawowe zmienne: schemat kolorów, typ klawiatury oraz ścieżkę do katalogu z logami.
Po pierwszym zalogowaniu się na daną powstać powstaje plik {~/.tf/<nazwa-muda>/<imie-postaci>/<imie-postaci>.tf}, będący kopią [common/std/player.tf](../common/std/player.tf). W pliku tym należy ustawić kilka podstawowych zmiennych dotyczących ekwipunku itp.
2014-12-25 16:12:52 +01:00
Oba pliki zawierają komentarze informujące o tym, co oznacza która zmienna i jakie wartości może przyjmować.
2013-02-16 01:08:43 +01:00
## Własne modyfikacje
__UWAGA:__ Skrypty w katalogu {~/tf} nie powinny być zmieniane przez użytkownika. Ewentualne zmiany zostaną nadpisane podczas aktualizacji skryptów. Wszelkie własne zmiany powinny być wprowadzane __wyłącznie__ w pliku postaci (lub innym miejscu w katalogu {~/.tf}). Przykładowe tworzenie aliasów i komend:
| |
| - | - |
| `/alias pod podskocz` | - tworzy aliasa `pod` wykonującego _podskocz_ |
| `/def pod = podskocz` | - tworzy komendę `/pod` wykonującą _podskocz_ |
2014-11-19 17:58:18 +01:00
| `/def pod2 = podskocz%; sp` | - tworzy komendę `/pod` wykonującą _podskocz_, a potem _sp_ (w TF-ie komendy rozdziela się sekwencją %;) |
2013-02-16 01:08:43 +01:00
# Bindy
## Klawiatura podstawowa
| |
| - | - |
2014-11-19 17:58:18 +01:00
| `F1` - `F8` | - ustawiane przez użytkownika komendami `/f1`, `/f2`, ..., `/f8` |
2013-02-16 01:08:43 +01:00
| `F9` | - _zabij <cel>_ (ustawiany komendą `/cel`) |
| `Esc + F9` | - _przelam obrone <celu>_ (ustawianego komendą `/cel`) |
| `F10` | - _zabij <cel2>_ (ustawiany komendą `/cel2`) |
| `Esc + F10` | - _przelam obrone <celu2>_ (ustawianego komendą `/cel2`) |
| `F11` | - _przestan walczyc_ |
2014-11-19 17:58:18 +01:00
| `F12` | - następna lokacja (szerzej opisane w sekcji "Łazik") |
| `[` | - atak na cel ataku |
2015-01-15 13:11:07 +01:00
| `]` | - przełamanie celu ataku |
2013-02-16 01:08:43 +01:00
## Klawiatura numeryczna
| |
| - | - |
| `/` | - normalne chodzenie |
| `*` | - przemykanie |
| `-` | - przemykanie z drużyną |
2014-11-19 17:58:18 +01:00
| `5` | - następna lokacja (szerzej opisane w sekcji "Łazik") |
2013-02-16 01:08:43 +01:00
| `+` | - _gora_ |
| `.` | - _dol_ |
| `Enter` | - _kondycja wszystkich_ |
| `0` | - _stan_ |
## Bind dynamiczny
Klawisz odwrotnego apostrofu (\`) binduje się dynamicznie zależnie od tekstu otrzymanego od muda na komendy typu _zapal lampe_ albo _zapukaj w brame_. Jego działanie jest jednorazowe, czyli po naciśnięciu bind zostaje usunięty.
# Pasek stanu
2013-02-16 01:16:44 +01:00
![pasek](https://bitbucket.org/ftpd/tf-scripts/raw/master/_doc/pasek.png)
2013-02-16 01:08:43 +01:00
| |
| - | - |
2014-11-19 17:58:18 +01:00
| __róża wiatrów__ | - pokazuje możliwe wyjścia z lokacji (innym kolorem zaznaczony jest kierunek, z którego postać przyszła) |
2013-02-16 01:08:43 +01:00
| __K:__ | - kondycja |
| __Z:__ | - zmęczenie |
2014-11-19 17:58:18 +01:00
| __M:__ | - mana |
2013-02-16 01:08:43 +01:00
| __B:__ | - próba blokowania lub udane zablokowanie (zarówno przez siebie, jak i przeciwko sobie) |
| __W:__ | - warning, na przykład ogłuszenie lub wytrącenie broni |
| __R:__ | - kto aktualnie został wskazany jako rozkaz ataku |
2015-07-27 15:00:29 +02:00
| __B:__ | - aktualna komenda przypięta do binda dynamicznego (opisanego w sekcji "Bindy / Bind dynamiczny") |
2014-12-23 16:59:03 +01:00
| __Hidden:__ | - ukrycie (przyjmuje wartości ON/off) |
| __Sneaky:__ | - przemykanie zamiast chodzenia (przyjmuje wartości ON/GRP/off) |
| __Weapon:__ | - status broni (przyjmuje wartości (ON/ERR/off) |
| __Cover:__ | - gotowość do zasłony lub czas pozostały do następnej próby |
2013-02-16 01:08:43 +01:00
| __Order:__ | - gotowość do wydania rozkazu lub czas pozostały do nastepnej próby |
2014-12-23 14:35:54 +01:00
| __Alert:__ | - ostrzeżenie, np. o walce bez broni |
2014-11-19 18:05:54 +01:00
| __Mail:__ | - status poczty (NEW - jeden list, NEW+ - więcej listów, READ - list do odczytania lokalnie, SEND - list oczekuje na wysłanie, SYNC - w trakcie aktualizacji (przez zwierzątko pocztowe)) |
2015-10-07 11:33:55 +02:00
| __F:__ | - forma (przyjmuje wartości od 0 (_jestes w przecietnej formie_) do 6 (_jestes w nieziemskiej formie_)) |
2015-07-27 16:08:42 +02:00
| __L:__ | - obciążenie (przyjmuje wartości od 0 (_nie wadzi_) do 6 (_przygniata do ziemi_)) |
| __D:__ | - upicie (przyjmuje wartości od -6 (_masz potwornego kaca_) do +10 (_jestes pijany jak bela_)) |
| __P:__ | - strach (przyjmuje wartości od 0 (_czujesz sie bezpiecznie_) do 5 (_czujesz sie bardzo przerazony_)) |
| __T:__ | - pragnienie (przyjmuje wartości od 0 (_nie chce ci sie pic_) do 3 (_chce ci sie bardzo pic_)) |
| __H:__ | - głód (przyjmuje wartości od -2 (_jestes bardzo glodny_) do +2 (_jestes bardzo najedzony_)) |
2014-12-23 14:35:54 +01:00
| __Enemies:__ | - liczba wrogów koncentrujących się na walce z postacią (odświeżane przy sprawdzaniu kondycji) |
2014-12-25 16:14:40 +01:00
| __Kill:__ | - zabici przez siebie / polegli w ogóle od zalogowania |
2013-02-16 01:08:43 +01:00
# Komendy
## Techniczne
| |
| - | - |
| `/c` | - czyści ekran |
| `/fk <tekst>` | - wyswietla <tekst> tak, jakby przyszedł od muda - przydatne do testowania skryptów |
2014-12-25 16:16:36 +01:00
| `/ack` | - czyści bind dynamiczny, informacje w polu "Alert" na pasku itp. |
2013-02-16 01:08:43 +01:00
| `/reload` | - przeładowuje skrypty (jednocześnie kasując wszelkie dopisane 'z palca' zmiany, aliasy itp.) |
| `/typo <foo> <bar>` | - wpisane <foo> wysyła do muda <bar>. Przydatne do skracania sobie trudnych do wpisania nazw |
| `/testuj` | - wysyła do muda mnóstwo komend i wyświetla te, których wpisanie spowodowało coś innego, niż _Slucham?_. Przydatne do zgadywania właściwej komendy itp. |
| `/glow <tekst>` | - włącza kolorowanie <tekst> aż do nastepnego `/reload` lub `/unglow` |
| `/unglow <tekst>` | - wyłącza kolorowanie <tekst>
## Informacyjne
2014-11-19 17:58:18 +01:00
| |
2014-11-19 18:07:25 +01:00
| - | - |
2015-05-06 02:01:10 +02:00
| `/exp` | - licznik cech przy medytowaniu (__UWAGA:__ może nie działać na poziomach niższych niż pewnie stąpa) |
2015-04-03 19:02:15 +02:00
| `/stats` | - pokazuje statystyki defensów, zbroi, tarczy i speca |
2014-11-19 17:58:18 +01:00
| `/zabici` | - pokazuje statystyki zabitych przez siebie i innych |
2014-12-23 14:35:54 +01:00
| `/postepy` | - pokazuje czas osiągnięcia kolejnych postępów oraz liczbę zabitych przez siebie/przez wszystkich w tym momencie |
| `/ktoto <tekst>` | - szuka pasujących wystapień <tekst> w bazie imion |
2014-11-19 17:58:18 +01:00
2013-02-16 01:08:43 +01:00
## Ogólne
| |
| - | - |
2014-11-19 17:58:18 +01:00
| `/f1 <komenda>` - `/f8 <komenda>` | - binduje klawisze `F1` - `F8` pod wskazane komendy |
2013-02-16 01:08:43 +01:00
| `/kowal` | - rozpoczyna naprawę broni i zbroi |
| `/ciuchy` | - rozpoczyna naprawę ubrań |
2013-02-16 01:08:43 +01:00
| `/poczta` | - wyświetla informacje o otrzymanych listach i/lub wiadomościach |
## Bojowe
| |
| - | - |
| `/comp <kim>` | - porównuje cechy bojowe z <kim> |
2016-06-14 19:05:29 +02:00
| `/cel <kogo>` | - ustawia <kogo> jako cel ataku i łamania |
2013-02-16 01:08:43 +01:00
| `/cel2 <kogo>` | - analogicznie do `/cel <kogo>`, drugi cel ataku |
| `/am` | - wyświetla dostępne tryby ataku oraz informuje o aktualnie ustawionym |
| `/am <numer>` | - ustawia tryb ataku o danym numerze |
## Poruszanie się
| |
| - | - |
| `/wns` | - wsiadanie na statek (wyjęcie monet, kupienie biletu itp.) |
| `/wdyl` | - wsiadanie do dyliżansu (wyjęcie monet, kupienie biletu itp.) |
2014-12-25 16:08:30 +01:00
| `/walkcmd` | - ustawia komendę, która zostanie wykonana każdorazowo po zmianie lokacji (`/walkcmd off` aby wyłączyć) |
2013-02-16 01:08:43 +01:00
## Ekwipunek
| |
| - | - |
| `/op` | - zagląda do pojemnika (plecaka, torby, sakwy itp. - rozpoznawane automatycznie przy zakładaniu) |
| `/zp <co>` | - wyjmuje z pojemnika <co> |
2014-11-19 17:58:18 +01:00
| `/dp <co>` | - wkłada do pojemnika <co> |
2013-02-16 01:08:43 +01:00
| `/np` | - _napelnij plecak_ (lub inny pojemnik) |
| `/sz` | - wyjmuje wszystkie zbroje z pojemnika i zakłada je |
2014-11-19 17:58:18 +01:00
| `/sd` | - zdejmuje wszystkie zbroje i wkłada je do pojemnika |
2013-02-16 01:08:43 +01:00
| `/bz` | - wyjmuje broń z pojemnika lub pochwy (zależnie od ustawień w pliku postaci) i dobywajej |
2014-11-19 17:58:18 +01:00
| `/bd` | - opuszcza broń i chowa ją do pojemnika lub pochwy (zależnie od ustawień w pliku postaci) |
2014-11-19 18:34:54 +01:00
| `/szz` | - wyjmuje sztylet i dobywa go (dla zawodów bez broni ciętych noszących dodatkowo sztylet) |
| `/szd` | - opuszcza sztylet i chowa go (dla zawodów bez broni ciętych noszących dodatkowo sztylet) |
2014-11-19 19:00:02 +01:00
| `/bron <on/off>` | - bardziej przyjazna komenda do dobywania broni |
| `/zbroja <on/off>` | - bardziej przyjazna komenda do zakładania zbroi |
| `/sztylet <on/off>` | - bardziej przyjazna komenda do dobywania sztyletu |
2013-02-16 01:08:43 +01:00
| `/dw <co>` | - wkłada <co> do (pierwszego) woreczka |
| `/zw <co>` | - wyjmuje <co> z (pierwszego woreczka)|
| `/d2w` - `/d8w` | - analogicznie do `/dw`, dla drugiego - ósmego woreczka |
| `/z2w` - `/z8w` | - analogicznie do `/zw`, dla drugiego - ósmego woreczka |
| `/ocenkamienie` | - ocenia kamienie i wyświetla ich szacowaną wartość w najwyższych możliwych nominałach |
# Schematy kolorów
2014-12-25 16:12:52 +01:00
Kolory w skryptach definiowane są globalnie w pliku [colorscheme.tf](../common/colorscheme.tf). Własne kolory można uzyskać edytując pojedynczo odpowiednie zmienne (oczywiście __poza__ katalogiem {~/tf}, najlepiej w pliku postaci) lub poprzez redefinicję całego `/def _colorscheme_load`.
2016-08-26 10:23:43 +02:00
__UWAGA__ oprócz zdefiniowanych w skryptach kolorów należy ustawić sobie kolor wyjść już z poziomu samej arkadii (`kolor opisy wyjsc z lokacji <nazwa|numer>`).
2013-02-16 01:08:43 +01:00
# Listy
Mechanizm list służy do kolorowaia imion i/lub opisów innych postaci (oczywiście nic nie stoi na przeszkodzie, żeby kolorować nim cokolwiek innego - to po prostu lista wyrażeń, które będą pokolorowane tak, jak zdefiniowana jest lista ;-)). Możliwe do użycia komendy:
| |
| - | - |
| `/dodaj liste <nazwa listy> <kolor> [kolor tla]` | - dodaje listę o podanej nazwie i zdefiniowanych kolorach |
| `/dodaj <nazwa listy> <wyrazenie>` | - dodaje dane wyrażenie (również reglarne!) do listy |
| `/zmien <nazwa listy> <kolor> [kolor tla]` | - zmienia kolorowanie podanej listy |
| `/wyswietl listy` | - pokazuje aktualnie zdefiniowane listy |
| `/wyswietl <nazwa listy>` | - pokazuje wyrażenia dodane do podanej listy |
| `/usun liste <nazwa listy>` | - usuwa listę |
| `/usun <nazwa listy> <wyrazenie>` | - usuwa dane wyrażenie z podanej listy |
# Łazik
2016-06-14 19:05:29 +02:00
Klawisze `5` na klawiaturze numerycznej oraz `F12` na zwykłej powodują ruch o jedną lokację - na lokacjach z dwoma wyjściami pójdzie w stronę, z której postać nie przyszła (przydatne na traktach - można klikać klawisz zamiast wpisywać kierunki). Inicjowany na lokacji z więcej niż dwoma wyjściami nie robi nic.
2013-03-09 20:56:27 +01:00
Chodzenie w ten sposób uwzględnia tryb chodzenia (zwykłe/przemykanie/przemykanie z drużyną).
2013-02-16 01:08:43 +01:00
# Drużyna
2016-06-14 19:05:29 +02:00
Przy zmianie drużyny (dołączanie, opuszczanie, zmiana przywódcy, przekazanie itp.) należy wcisnąć kombinację klawiszy `Control + d`. Dzięki temu podczas wywołania komendy _kondycja wszystkich_ przy członkach drużyny pojawią się klawisze przypisane do danej osoby (z zakresu `F1` - `F12`). Wciśnięcie kombinacji `Esc + <klawisz>` będzie próbowało daną osobę zasłonić.
2013-02-16 01:08:43 +01:00
2014-11-19 17:58:18 +01:00
__UWAGA:__ skryptowi do odmiany daleko do doskonałości. Czasami w pliku {~/.tf/<nazwa muda>/exceptions.tf} trzeba sobie dopisać wyjątek. Przykładowe znajdują się w [common/std/exceptions.tf](../common/std/exceptions.tf) i są kopiowane do {~/.tf} podczas pierwszego uruchomienia skryptów.