# Nidarel

Serwer Minecraft All the Mods 10: podziemne kuźnie i tunele pod starym światem, który się zapadł. Poradniki i przygoda „Dzwonienie spod ziemi”.

# Jak dołączyć do Nidarelu

> Źródło: repo afterlife/docs/nidarel/poradnik-rp.md — edytuj w repo, nie tutaj.

# Nidarel — jak dołączyć do serwera Minecraft

![Orin w tunelach Nidarelu](https://wiki.ariku.pl/uploads/images/gallery/2026-10/nidarel-b-4.png)

*Dzyń, dzyń!* O, nowy wędrowiec! Jestem Orin, a to mój wózek. Rozgość się, zaraz zjedziemy na dół, nyah~

Nidarel to nasz serwer Minecraft na paczce **All the Mods 10**: podziemne kuźnie i tunele pod starym światem, który się zapadł. Coś tam wciąż dzwoni. Serwer jest dla członków społeczności Anvil of Suns na Discordzie.

## W skrócie

Spieszysz się do kopalni? *strzyże uszami* Proszę, sześć kroków:

1. Weź rangę **Minecraft**: ariku.pl → tryb GAMING → Role, albo panel ról na Discordzie.
2. Napisz do mnie, ładnie: *„Orin, dodasz mnie proszę do Minecrafta? nick TwójNick”*.
3. W aplikacji **CurseForge** zainstaluj **All the Mods 10, wersja 8.2**.
4. Do tej samej paczki dodaj mod **authlogic** (opis niżej).
5. Dołącz do serwera **game.ariku.pl**.
6. Na czacie wpisz `!link KOD`. Kod dostajesz ode mnie.

## Krok po kroku

### 1. Ranga Minecraft

Zanim wpuszczę cię pod ziemię, musisz dać znać, że w ogóle chcesz kopać, nyah~

Ranga otwiera kanał **#nidarel** i pozwala mi dopisać cię do listy graczy. Weźmiesz ją na ariku.pl (GAMING → Role) albo w panelu ról na Discordzie.

### 2. Prośba do mnie

Teraz pora poprosić mnie o wpis. Tylko grzecznie, bo potrafię fuknąć! *macha ogonem*

Napisz do mnie na kanale albo w prywatnej wiadomości, na przykład:

> Orin, dodasz mnie proszę do Minecrafta? nick TwójNick

- Nick musi mieć 3–16 znaków: litery, cyfry albo `_`. Musi być dokładnie taki, jakim grasz.
- Lubię grzeczność. Na rozkaz się obrażę, ale wystarczy poprosić drugi raz, ładniej.
- Na jedno konto Discord przypada jeden nick. Podanie nowego zastępuje stary.
- Odpiszę ci z kodem `!link`, który jest ważny 24 godziny.

### 3. Paczka All the Mods 10

Do tuneli nie schodzi się z gołymi rękami, więc przygotuj ekwipunek.

1. Zainstaluj aplikację **CurseForge** i wybierz grę Minecraft.
2. Znajdź **All the Mods 10** i zainstaluj **dokładnie wersję 8.2**. Inna wersja nie wejdzie na serwer.
3. W ustawieniach CurseForge (Minecraft → **Java Settings**) ustaw pamięć na **co najmniej 8 GB**. ATM10 to duża paczka.

### 4. Mod authlogic, czyli logowanie

W mroku tuneli muszę wiedzieć, kto jest kim, żeby żaden przebieraniec nie grzebał w cudzych skrzyniach. *przekrzywia głowę*

Serwer wpuszcza konta premium i konta bez premium. Mod **authlogic** pilnuje, żeby nikt nie wszedł na cudze konto. **Bez niego serwer od razu cię rozłączy.**

1. Pobierz authlogic w wersji **0.0.5** dla **NeoForge 1.21.1** ze strony https://modrinth.com/mod/authlogic.
2. W CurseForge otwórz profil ATM10 → menu **⋯** → **Open Folder** i wrzuć plik `.jar` do folderu `mods`.

**Konto premium** loguje się samo.

**Konto bez premium:** przy pierwszym wejściu authlogic poprosi o hasło. Hasło zostaje na twoim komputerze i nigdy nie trafia na serwer. Zapamiętaj je. Pierwsza osoba, która wejdzie z danym nickiem, ustala dla niego hasło, więc wejdź jako pierwszy, zaraz po dopisaniu.

### 5. Dołączanie

Brama do podziemi stoi otworem, wskakuj na wózek!

**Multiplayer → Add Server** → adres **game.ariku.pl**.

### 6. Połączenie konta z Kroniką

Kiedy już staniesz na kamiennej posadzce, szepnij mi swój kod. *mruczy pod nosem*

W grze wpisz na czacie `!link KOD`, z kodem ode mnie. Potwierdzę to szeptem. Od tej pory **Kronika** wie, że to ty. Dzięki temu twoje osiągnięcia i przygody trafiają do opowieści pod twoim imieniem.

## Przygoda „Dzwonienie spod ziemi”

![Orin pędzi wózkiem przez Nether](https://wiki.ariku.pl/uploads/images/gallery/2026-10/nidarel-b-3.png)

Słyszysz to echo w głębi szybów? *dzwoneczek cicho brzęczy*

Przy pierwszym wejściu dostaniesz książkę. Przygodę włączasz przyciskiem w książce albo komendą `/trigger orin_zgoda`, a wyłączasz komendą `/trigger orin_cisza`, w każdej chwili. Bywam psotna i potrafię „pożyczyć” drobiazg, ale zawsze go oddaję. Niczego ci nie zniszczę.

## Mapa na żywo

https://mapa.ariku.pl pokazuje teren i budowle. **Nigdy nie pokazuje pozycji graczy.** Mapę otworzysz też z mapy świata na ariku.pl, klikając Nidarel.

## Reset hasła

Węglowy pył wywiał ci hasło z głowy, nyah~? Albo zmieniłeś komputer? Na ariku.pl wejdź w tryb GAMING → panel **Nidarel** → **resetuj hasło**. Potem wejdź do gry jak najszybciej i ustaw nowe, bo do tego czasu nick może zająć ktoś inny. Dziennie są 3 resety.

## Prywatność

Czat i zdarzenia z serwera (wejścia, osiągnięcia, śmierci) trafiają do Kroniki, czyli opowieści o tym, co dzieje się w świecie Anvil of Suns. Mapa nigdy nie pokazuje pozycji graczy.

## Coś nie działa?

Koło w wózku skrzypi, a brama nie chce drgnąć? *drapie się za uchem* Zerknij tutaj:

| Komunikat | Co zrobić |
|---|---|
| *You are not white-listed* | Poproś mnie o dopisanie (krok 2), z dokładnym nickiem. Bez mojej wiedzy się nie prześlizgniesz! |
| *Authentication required. Please install the AuthLogic mod* | Brakuje moda authlogic (krok 4). Dorzuć go do paczki i wracaj. |
| *Password mismatch* | Złe hasło. Zrób reset hasła na ariku.pl. |
| *This username is registered for online mode only* | Ten nick należy do konta premium. Zaloguj się kontem premium. |
| *Mismatched mod list* / zła wersja | Zainstaluj dokładnie ATM10 8.2. Inaczej trybiki do siebie nie pasują, nyah~ |
| Serwer „śpi” | Panel Nidarel na ariku.pl pokazuje stan. Daj znać na #nidarel. |

# Nidarel Adventurer — towarzysz AI (mod ai_companion)

> Źródło: repo ai-companion/docs/wiki/towarzysz-ai.md. Edytuj w repo, nie tutaj.

> **Stan: działa na Nidarelu od 25.10.2026.** Mod pobierzesz z [ariku.pl/download](https://ariku.pl/download) (sekcja mody, obok authlogic). Bez niego w paczce serwer cię nie wpuści.

**Nidarel Adventurer** to towarzysz AI: postać w świecie Minecrafta, która chodzi za tobą, rozmawia na czacie i wykonuje polecenia. Kopie rudy, walczy z potworami, rzuca zaklęcia i pamięta, co ustaliliście.

Za myślenie odpowiada model językowy, Gemini 3.8 Flash. Za działanie odpowiada kod serwera. Model wybiera, co zrobić i jak to powiedzieć. Serwer sprawdza każdą akcję i dopiero wtedy ją wykonuje. Towarzysz nie wpisuje komend i nie dostaje uprawnień gracza.

## Co trzeba mieć

- Plik `ai_companion-0.1.0.jar` z [ariku.pl/download](https://ariku.pl/download) w folderze `mods` **na swoim kliencie**, czyli w tej samej paczce ATM10 co serwer. Bez niego serwer z modem cię nie wpuści, bo towarzysz to nowy rodzaj stworzenia, który musi znać też klient.
- Nic więcej. Model działa po stronie serwera, a ty nie potrzebujesz żadnego klucza.

## Pierwsze kroki

1. Wpisz `/companion summon`. Obok ciebie pojawi się twój towarzysz, domyślnie **Mędrzec**.
2. Daj mu kilof albo miecz. Kliknij go prawym przyciskiem z przedmiotem w ręce. Zbroję założy sam.
3. Napisz do niego na czacie:
   - `@Mędrzec znajdź diamenty, wykop 8 i wróć do mnie`
   - `Mędrzec, zostań tutaj`
   - `@ai co widzisz w okolicy?`

Towarzysz odpowie na czacie, powie, co zamierza zrobić, i zda raport, kiedy skończy. Jeśli nie wie, o co ci chodzi, dopyta, zamiast zgadywać.

Każdy gracz ma jednego towarzysza. Inni gracze nie mogą mu wydawać poleceń, chyba że im na to pozwolisz: `/companion share <nick>`.

## Najważniejsze komendy

| Komenda | Co robi |
|---|---|
| `/companion summon` / `dismiss` | przywołuje albo odsyła; pamięć i przedmioty zostają |
| `/companion follow` / `stay` / `defend` / `stop` | idź za mną / zostań / broń mnie / przerwij |
| `/companion status` | zdrowie, mana, zadanie, ekwipunek |
| `/companion mine <ruda> [ile]` | kopanie bez modelu, np. `/companion mine iron 16` |
| `/companion give` | oddaje ci wszystko, co uzbierał (albo kucnij i kliknij go pustą ręką) |
| `/companion skill <umiejętność>` | `lightning_strike`, `arcane_bolt`, `shield`, `healing`, `emergency_escape`, `summon_creature` |
| `/companion personality list` / `set <id>` | zmiana charakteru, tylko twojego towarzysza |
| `/companion skin <wygląd>` | `default`, `wise_one`, `orin`, `steve`, `alex` |
| `/companion memory mark <nazwa>` | zapamiętuje to miejsce, np. `baza`; potem „idź do bazy” |
| `/companion memory clear` | czyści jego pamięć |

## Kopanie

- Kopie tylko rudy z listy serwera: węgiel, żelazo, miedź, złoto, redstone, lapis, diamenty, szmaragdy, kwarc oraz rudy z modów (cyna, osm, ołów, uran, cynk, srebro, nikiel). Drewno też.
- Szuka w promieniu do 48 bloków i tylko w załadowanych chunkach. Nie generuje nowego świata.
- Gdy do rudy nie ma przejścia, przekopuje się tunelem przez kamień, ziemię i żwir. Nigdy nie kopie prosto w dół.
- **Nie kopie obok lawy.** Przy ostrożnym trybie omija też wodę i luźny żwir nad głową.
- Szanuje claimy (FTB Chunks). Sprawdza każdy blok tak, jakbyś to ty go kopał, więc musisz być wtedy w grze.
- Odkłada narzędzie, zanim się zepsuje. Nie zniszczy ci kilofa.

## Walka i umiejętności

- Broni się, broni ciebie, a w trybie `defend` sam atakuje potwory w pobliżu.
- **Nigdy nie atakuje graczy**, oswojonych zwierząt, osadników ani golemów.
- Przy niskim zdrowiu się wycofuje.
- Ma własną manę i własne umiejętności. Błyskawica domyślnie nie wywołuje pożaru i rani tylko cel.
- Gdy na serwerze jest Iron's Spells 'n Spellbooks, magiczny pocisk rzuca jako prawdziwe zaklęcie z tego moda. Nie strzela, kiedy stoisz na linii ognia.

## Osobowości

| id | Kto to |
|---|---|
| `sage` | Mędrzec: spokojny, rozważny, czasem zagadkowy |
| `guardian` | Strażnik: krótkie ostrzeżenia, najpierw twoje bezpieczeństwo |
| `trickster` | Figlarz: żarty i nietypowe pomysły, ale w granicach zasad |
| `scholar` | Badacz: komentuje odkrycia, oddziela fakty od przypuszczeń |
| `silent` | Milczek: odzywa się tylko w ważnych sprawach |
| `chaotic` | Szaleniec: głośny, odważny, dramatyczny |

Osobowość zmienia sposób mówienia, gadatliwość i taktykę. Nie zmienia tego, co towarzyszowi wolno. Administrator może dodać własne osobowości jako pliki JSON.

## Gdy model nie działa

Towarzysz działa dalej. Rozumie wtedy proste polecenia, na przykład „chodź”, „zostań”, „stop”, „wykop 10 żelaza” czy „pilnuj”, i odpowiada krótkimi gotowymi zdaniami. Serwer się nie zacina, bo rozmowa z modelem odbywa się w tle.

## Dla administratora

- Konfiguracja jest w `config/ai_companion-common.toml`: backend modelu, limity, listy dozwolonych bloków, walka i umiejętności. Klucz API nigdy nie jest zapisywany w pliku, tylko w zmiennej środowiskowej.
- Dokumentacja techniczna leży w repo `ai-companion`: README, `docs/ARCHITECTURE.md`, `docs/SECURITY.md`, `docs/COMPATIBILITY.md`, `docs/TESTING.md`.
- Testy z 24.10.2026:
  - 83 testy jednostkowe;
  - 10 testów w świecie na czystym NeoForge;
  - 9/9 scenariuszy na pełnej paczce ATM10 8.3, w tym prawdziwe polecenie przez Gemini i zaklęcie Iron's.
- Panel konfiguracji: ariku.pl → GAMING → **Nidarel Adventurer**. Zmiany (osobowość, wygląd, tryb, charakter, pamięć) serwer stosuje przy najbliższej synchronizacji, gdy twój towarzysz jest w świecie.