Jak žádat o pomoc

V případě, kdy máte problém se serverem, nebo pluginem (případně módem), svůj problém vždy rovnou, konkrétně, co nejpodrobněji popište, vždy přiložte log serveru a co nejvíce relevantních informací (například pokud se hráč nemůže připojit, tak zprávu, co to hráči napíše, když se zkusí připojit. Pokud určité nastavení pluginu, přiložte konfigurační soubor/y pluginu a tak dále).

Pokud se server zhroutí (crashne) a vytvoří se i crash log, zašlete i jej. Crash logy se nachází ve složce /crash-reports/. Crash log posílejte společně s klasickým logem, neposílejte pouze samotný crash log.

Zpráva typu “nejde mi server” nebo “nejde mi plugin” je sama o sobě naprosto nedostačující.

Svůj problém co nejpodrobněji popište, poskytněte k němu co nejvíce informací, uveďte, co jste již vyzkoušeli, případně jaké návody jste použili apod.

Vždy přikládejte log a konfigurační soubory relevantní k problému, tedy neposílejte log starý dva dny, když řešíte problém dějící se teď. Obvykle chcete zaslat poslední log, ten se krom platformy BungeeCord nachází v /logs/latest.log, na BungeeCordu v proxy.log.0.

V případě, kdy po radě problém stále přetrvává, případně narazíte na problém nový, opět zašlete (nový) log, případně konfigurační soubory a poskytněte co nejvíce informací souvisejících s problémem. Příčina problému může být jiná, nebo jste nemuseli postupovat správně, a bez nového logu případně konfiguračních souborů to zjistit nelze. Proto pokud po radě problém přetrvává, napsat “nejde” je naprosto nedostačující.

Pokud se server ani nepokusí zapnout, tím pádem se log nevytvoří, zašlete výstup z konzole (terminalu). Pokud se konzole ihned uzavře, tím pádem nemáte čas výstup zkopírovat, na nový poslední řádek startovací skriptu (něco.bat/něco.sh) na operačním systému Windows přidejte pause, na Linuxu/macOS read -p "Stiskněte libovolnou klávesu pro ukončení".

Co při žádání o pomoc nedělat

• neodebírat z logu “nepodstatné informace”
• neposílat úryvky logu/konfiguračních souborů

Ať se jedná o logy, chyby, nebo konfigurační soubory, vždy jej sdílejte celé (s výjimkou zneužitelných informací jako tokenů/hesel v konfiguračních souborech). Neodstraňujte “nepodstatné informace”.

Z logu dokáže zkušený člověk vyčíst o mnoho více, než si můžete myslet, a tak odstranění některých informací může zjištění příčiny problému značně ztěžit, nebo znemožnit. Pokud chcete odstranit “citlivé” údaje, jako např. IP adresy, můžete využít služby https://mclo.gs která je automaticky zacenzuruje.

• neposílat text/soubor/snímek obrazovky

Když chcete sdílet nějaký text (např. konfigurační soubor, nebo log), nikdy jej neposílejte jako text, soubor, nebo snímek obrazovky. Místo toho využijte pastebin službu viz zde.

• neposílat výstup z konzole

Vždy sdílejte log místo výstupu konzole. Výstup konzole nemusí obsahovat všechny informace a v závislosti na hostingu může být osekaný. Zároveň lidé žádající o pomoc často nezkopírují celý relevantní výstup, nebo zkopírují i výstup z předešlého startu serveru, kde mohou být zastaralé informace, nebo minimálně jsou díky tomu informace méně přehledné.

• nežádat o pomoc “zpětně”

Neřešte problém “zpětně”. V závislosti na konkrétním problému a zbylých informací (např. z logů) může být určení příčiny o dost ztěženo nepůjde jej určit jednoznačně, případně vůbec. Pokud problém nebudete řešit v době, kdy jej máte, neočekávejte, že se jím někdo bude chtít zabývat.

Například v následujícím případě příčina problému zpětně dohledat nelze, jelikož už ani neexistují informace, ze kterých by se příčina mohla dát vyčíst: “Potřeboval bych pomoct s modovaným serverem. Sestavil jsem si balíček módů a nahrál do složky. Server se spustil, ale po chvíli, co někdo hraje, ho to odpojí a už se mu nejde připojit. Log už poslat nemůžu, protože jsem server přeinstaloval na Vanillu, abychom si mohli alespoň něco zahrát.”

Nevhodné dotazy a chování při žádání o pomoc

Níže můžete vidět nejčastější příklady nevhodných typů otázek a chování s vysvětlením proč, a jak by dotaz mohl vypadat “správně”.

• “jak funguje <plugin>?”
• “jak nastavit <plugin>?”

Dotaz typu “Jak nastavit/Jak funguje <plugin>” je špatný, jelikož je příliš obecný. Plugin má řadu funkcí a možností nastavení, o kterých se více dočtete v dokumentaci daného pluginu, případně z konfiguračních souborů. Pokud Vám dokumentace k objasnění nestačí, je potřeba vždy upřesnit, co konkrétně chcete v pluginu nastavit, případně popsat, u jakého konkrétního aspektu pluginu potřebujete vysvětlit jeho funkčnost. Vysvětlovat každý aspekt fungování a konfigurace pluginu (tzn. “papouškovat” dokumentaci pluginu) nikdo ochotný nebude.

Správně položený dotaz může vypadat například následovně: “Jak v pluginu Residence změnit maximální velikost resek pro hráče?”

• “ahoj, je tu někdo?”
• “můžu se zeptat?”
• “potřebuju pomoct s XY”
• “máte někdo zkušenost s pluginem XY?”
• “má někdo čas? mám menší otázku (týkající se <xy>)”

Svůj problém vždy rovnou konkrétně popište a poskytněte co nejvíce informací. Otázkami podobné otázkám výše si jen snižujete šanci, že Vám někdo pomůže.

Otázku typu “Mám problém s <xy>” si totiž většina lidí přebere jako: Mám problém s <xy>, který ale ani nejsem ochotný popsat a poskytnout více informací, tudíž hledám konkrétního člověka, který má natolik sebedůvěry, že mi bude schopný pomoci, a bude ochotný věnovat svůj čas zjišťování příčiny problému, i když já ani tolik ochoty řešit problém, abych jej dostatečně popsal, natož poskytl základní informace potřebné k zjištění příčiny/řešení problému, nemám. (https://dontasktoask.com)

Správný dotaz může vypadat například následovně: “Dobrý den, mám problém s <x>. Když udělám <y>, stane se <z>, i když mám v konfiguraci pluginu nastavené <něco>. <odkaz na konfiguraci pluginu>. Proč se to děje?”

• “nefunguje mi plugin”
• “nejde mi server”

Zpráva typu “nejde mi server”, “nejde mi plugin”, atp. je naprosto nedostačující. Vždy je potřeba popsat, co konkrétně nefunguje a jakým způsobem. Co přesně znamená, že server “nejde”? Automaticky se vypne? Nebo se nevypne, ale nejde se připojit? A co znamená, že “nejde” plugin? Nezapne se? Nebo se zapne, ale nejde provádět nějaká akce? Nebo příkaz vrátí chybu? Buďte konkrétní.

Je tedy důležité vždy problém popsat co nejkonkrétněji, tedy u jakého konkrétního pluginu máte jaký konkrétní problém (obecně je dobré uvést, dle čeho usuzujete, že server/plugin “nejde”) a přiložit co nejvíce informací, tedy minimálně log serveru, případně konfigurační soubory, a v případě, kdy se hráč nemůže připojit, tak i zprávu, co to hráči při pokusu o připojení napíše.

• “nevite proc se deje tohle? <screenshot>” bez dalších informací
• “nevíte co s tím? <screenshot>” bez dalších informací

Screenshot určitě může pomoci, avšak ze samotného screenshotu často ani nemusí být zřejmé, jaký problém máte. Proto je důležité nejen poslat screenshot, ale i poskytnout co nejvíce dalších informací včetně detailního popisu problému včetně toho, kdy, případně v jakém případě problém nastane.

• “proč nejde nastavit <plugin>”

Nevíme. Co konkrétně znamená “nastavit <plugin>”? A co konkrétně znamená, že “nejde nastavit”? Dle čeho soudíte, že plugin nejde nastavit? Jak konkrétně jste plugin nastavovali? Je potřeba být konkrétní a poskytnout co nejvíce informací.

Správný dotaz může vypadat například následovně: “Dobrý den, v pluginu <plugin> mi nejde nastavit <x>. V konfiguračním souboru jsem nastavil <y> na true, ale i po načtení změn mi to po kliknutí napíše <z> <odkaz na konfigurační soubor>”

• “potřebuju pomoct s XY, napište mi do DM”
• nepřidávejte si nikoho do přátel a nepište mu soukromou zprávu

Pokud člověk nedal předem svolení, nepingujte jej a vždy pište do kanálu určenému k řešení Vašeho problému. To znamená, že si jej nemáte přidávat do přátel a psát mu soukromou zprávu. Je to neohleduplné nejen vůči samotnému člověku, od kterého pomoc žádáte, ale i ostatním uživatelům, které mohou problém později ve veřejném chatu dohledávat. Navíc si škodíte sami sobě, jelikož si snižujete šanci získání ideální pomoci, “víc hlav víc ví”.

• dodržujte internetové základy slušného chování

To znamená nespamovat, bez předešlé konverzace uživatele ne-@pingovat (pokud Vám k tomu nedá svolení), případně se bez předešlé konverzace neobracet na nikoho konkrétního (v obecné komunitní podpoře. Pokud chcete autorovi pluginu nahlásit chybu, tak je to samozřejmě v pořádku).

Ve výsledku takovým chováním uškodíte jen sami sobě, spamováním a podobně si nepomůžete, požádání o pomoc správným způsobem ano.

Kde žádát o pomoc

Pokud řešítě obecný problém týkající se Minecraft serveru a potřebujete poradit, existuje mnoho komunitních míst pro to určených. Mezi taková místa patří například:

• Discord server/fóra samotné platformy (např. PaperMC/PurpurMC/Fabric Discord)
• Admincraft Discord/Reddit (r/admincraft)
• HelpChat Discord (https://helpch.at/)
• Discord server Vašeho hostingu (pokud využíváte managed hosting, který takový Discord server má)

Pokud řešíte problém specifický pro plugin (případně mód), na stránce pluginu často naleznete pozvánku na Discord server.

Nejpohodlnějším místem, kde žádat o pomoc, bývá obvykle Discord.

Pastebin

Nikdy logy a konfigurační soubory neposílejte jako soubor, nebo snímek obrazovky. Vždy využijte pastebin službu, kde vložíte obsah souboru a nasdílíte vygenerovaný odkaz, pomocí kterého si jiní uživatelé mohou jednoduše vložený obsah souboru zobrazit. Mezi takové služby patří např. https://mclo.gs nebo https://pastebin.com.

Posílat obrázky je nevhodné, jelikož u nich nelze vyhledávat v textu, v závislosti na velikosti a rozlišení monitoru můžou někteří uživatelé vidět text špatně, nebo jej nepřečtou vůbec. Dále text na obrázku nemohou přečíst uživatelé s poškozením zraku, a zároveň soubor může obsahovat bílé znaky (whitespaces), které z obrázku nejdou na první pohled vidět. Zároveň je text ze snímku obrazovky cizího monitoru hůře čitelný pro všechny.

Posílat soubory je nevhodné, jelikož si uživatel musí stáhnout sdílený soubor k sobě do počítače (čehož se někteří bojí z hlediska bezpečnosti), a taktéž v případě některých přípon nelze obsah souboru jednoduše zobrazit (zejména na mobilních zařízeních).

Posílat čistý text (na Discord) je nevhodné, jelikož v něm nejde jednoduše vyhledávat.