Bra att veta
246 anteckningar ur handboken, varav 84 varningar, samlade från alla 41 kapitel som har några. Det här är det som är lätt att missa: avgifter som börjar dras, tidsgränser som löper, och val som inte går att ta tillbaka.
246 anteckningar
Kom igång
Yrkesboken öppnar sig själv
Har du inget yrke slås yrkesboken upp automatiskt tre sekunder efter att du loggat in. Stäng den gärna och läs igenom HANDLINGAR & LÖNER för de yrken du är sugen på innan du väljer – första valet är gratis, men bytet kostar.
Varning: Byt inte yrke i onödan
Ett yrkesbyte kostar 500 kronor, kräver tre dagars väntetid sedan förra bytet och nollställer yrkesnivån. Nivåbonusen på inkomsten (1,5 procent per nivå) och det växande dagstaket försvinner alltså med den.
Tre olika nivåer
Blanda inte ihop dem: spelarnivå (1–100, /nivå), yrkesnivå (1–30, /jobb, nollställs vid yrkesbyte) och samhällsnivå (1–50, /samhälle). De delar varken tabell, kurva eller gränssnitt.
Spawn är fredad mark
Zoner skapas med standardflaggor där bygge, öppning av behållare, PvP, skada på djur och bybor, projektiler, mobbspawn, explosioner, eld, hunger, fallskada och all annan skada är avstängda, medan dörrar, knappar och föremålstapp fungerar. Du är alltså trygg på spawn, men du kan inte bygga där. Skydden mot hunger, fallskada och all skada gäller alla, även administratörer.
Kön tappar dig inte vid en omstart
Startar huvudservern om skickas du till väntrummet och står kvar först i kön, i samma ordning som de andra som kastades ut. Kön pausar insläppet tills servern svarar på ping igen. Nekar huvudservern din anslutning tre gånger i rad av något annat skäl – ban eller vitlista – kopplas du bort med serverns eget skäl.
Ekonomi och bank
Avgiften ligger utanför beloppet
Skickar du 1 000 kronor med en procents avgift lämnar 1 010 kronor ditt konto och mottagaren får 1 000. Avgiften avrundas alltid uppåt till hela ören och försvinner ur ekonomin – den är en av serverns money sinks.
Bankavgiften rör bara det översta skiktet
Procentsatsen räknas på skillnaden mellan ditt saldo och gränsen, inte på hela saldot. Med 60 000 kronor på kontot och gränsen 50 000 dras 0,5 procent av 10 000 kronor. Avgiften tas bara ur privata spelarkonton, och frysta konton hoppas över.
Du kan inte betala dig själv
Både /betala och överföringen i banken vägrar när mottagaren är du själv. Har du flera konton – till exempel ett företagskonto – flyttas pengar genom företagets egna vyer, inte hit.
Varning: Mynt tappas när du dör
Med standardinställningen valuta.behall_vid_dod: false behålls mynt inte vid död, utan ligger kvar bland dina droppar precis som allt annat. Bär inte mer kontanter än du har råd att förlora, och sätt in dem på banken innan du ger dig ut på något riskabelt.
Mynt går bara att förvara
De blockeras i trattar och droppare, i tavelramar, i hantverk, städ, smidesbord, slipsten och förtrollningsbord samt i byteshandel med bybor. De får ligga i ditt inventarie, i kistor, tunnor, enderkistor och shulkerlådor – ingen annanstans. Försöker du flytta in dem i ett annat gränssnitt får du meddelandet att mynt inte kan användas där.
Varning: Dupade mynt blir värdelösa
Varje myntserie har en signatur och en kvot: när seriens mynt väl lösts in accepteras inga fler. Kopior avvisas vid insättning, du får besked om det avvisade värdet, och händelsen loggas som en SECURITY-post. Mynt med felaktig signatur beslagtas direkt vid insättningen och loggas också.
Beloppet måste gå jämnt upp
Går ditt uttagsbelopp inte att dela i valörerna får du ett meddelande med valörerna uppräknade. Med standardvalörerna innebär det i praktiken att beloppet måste vara ett jämnt tiotal kronor, utan ören.
Dygnsgränsen gäller per spelare
Du kan ta ut högst 200 000 kronor som mynt per dygn (valuta.max_uttag_per_dygn). Gränsen finns för att bromsa storskaliga dupe-försök och räknas per spelare, inte per uttag.
Servern, kön och inspektionen
Reload räcker inte till allt
config.yml, sv.yml och modulernas egna filer läses om direkt, men inställningarna under databas: träder i kraft först vid omstart. Webb-API:t startas om automatiskt med de nya inställningarna.
Varning: Kontrollera olevererade myntserier
/nordguild hälsa visar antalet olevererade myntserier. Är det inte noll har ett uttag avbrutits mitt i – de levereras eller återbetalas automatiskt vid nästa start, men siffran är värd att hålla ögonen på.
Inspektera först, agera sedan
Vid en supportfråga om pengar är /inspektera rätt startpunkt: du ser saldo, senaste transaktioner, revisionsposter och myntserier i samma bok, och kan gå vidare därifrån utan att gissa.
Varning: Köns kommandon ligger inte på Paper
/kö och /köadmin registreras av NordGuildKo på Velocity-proxyn och läser plugins/nordguild-ko/config.yml där, inte NordGuilds egen config.yml. /nordguild reload rör dem alltså inte – använd /köadmin ladda.
Hjälptips i chatten
Ett tips du redan följt kommer aldrig tillbaka
Har du registrerat en byggnad får du aldrig tipset om /byggnad igen – inte heller om du hann göra det innan tipset visades. Det gäller för alltid och överlever omstarter, eftersom det sparas i databasen (player_tips.done_at).
Högst ett per dygn och tre per inloggning
Samma tips visas högst en gång per dygn (tips.cooldown_timmar), och du får aldrig se fler än tips.max_per_session (standard 3) per inloggning. Det går dessutom minst tips.min_sekunder_mellan (90 sekunder) mellan två tips, och de första tips.tystnad_efter_inloggning_sekunder (20 sekunder) efter att du kommit in är helt tysta.
Servern kan stänga av dem
tips.aktiv: false i config.yml tystar hela systemet, och tips.avstangda listar enskilda tips som ska vara avstängda. Id:na är desamma som visas i /tips lista.
Yrken
Varning: Självplacerade block räknas inte
Du kan inte lägga ut samma järnblock om och om igen. Bryter du ett block du själv har placerat ger det noll kronor och noll XP. Spärren gäller även genom kolvar – knuffar du undan ett placerat block följer märkningen med. Ett träd som växer ur en planterad planta räknas däremot som naturligt.
Varning: Byggare: 24 timmar per position
Som byggare får du bara betalt en gång per plats. Bryter du ett byggblock spärras positionen i 24 timmar, så att bygga och riva samma vägg om och om igen ger ingenting.
Varning: Kreativt läge ger aldrig lön
Handlingar i kreativt läge eller åskådarläge belönas aldrig, oavsett yrke.
Grödor måste vara fullvuxna
Som bonde får du bara betalt när du skördar en gröda som nått sin maximala ålder. Att bryta halvvuxna grödor ger inget. Mjölkning kräver ett vuxet djur.
Varning: Tama och namngivna djur ger inget
Jägaren får aldrig betalt för att döda ett tamt djur eller en varelse med eget namn. Detsamma gäller allt som spawnat ur en spawner, ett spawner-ägg eller en trial spawner.
Dagstaket är ett hårt tak
Nivåbonusen läggs på före dagstaket, så taket förblir ett verkligt tak. När du slår i det får du en notis, och resten av dygnets handlingar ger XP men inga pengar. Taket nollställs vid dygnsskiftet.
Byggnader kan höja din yrkesinkomst
Vissa samhällsbyggnader ger en procentuell bonus på yrkesinkomsten, antingen för alla yrken eller för ett enda. Bonusen gäller medan du arbetar i staden, läggs på före dagstaket, och den sammanlagda multiplikatorn hålls alltid mellan 0,1 och 3,0.
Varning: Yrkesbyte nollställer nivån
Bytet kostar 500 kr, nollställer nivå och XP till 1 respektive 0, och spärrar nästa byte i tre dagar. Har du grävt upp dig till nivå 25 som gruvarbetare försvinner den nivån när du blir bonde – tänk efter först.
Köpmannens butiksprovision är avsiktligt låg
Provisionen på butiksförsäljning (1,35 kr per 100 kr) ligger med flit under butikens transaktionsavgift på 2 %. Även på maxnivå, med +45 % nivåbonus, blir provisionen 1,96 % – så att sälja fram och tillbaka mellan två egna konton går alltid back. Ett automattest vaktar den invarianten.
Ändra jobb.yml utan omstart
Löner, XP och handlingar ligger i plugins/NordGuild/jobb.yml. Redigera filen och kör /jobbadmin ladda, så läses den om direkt. Svaret visar hur många yrken som lästes in och hur många varningar som uppstod, och omläsningen hamnar i revisionsloggen.
Spelarnivå
Varning: Spelarnivå är inte samhällsnivå
Det här är den vanligaste förväxlingen. Din spelarnivå (1–100) är din egen och följer med dig överallt. Samhällsnivån (1–50) tillhör staden och delas av alla invånare – den stiger när samhället uppgraderas, inte när du spelar. Ett samhälle på nivå 12 gör dig inte till spelarnivå 12. Systemen delar varken tabell, kurva eller UI.
Varning: Yrkesnivån är en tredje sak
Din yrkesnivå (1–30) syns i /jobb, inte i /nivå, och nollställs varje gång du byter yrke. Din spelarnivå påverkas inte alls av ett yrkesbyte.
Företagskravet mäts mot spelarnivån
foretag.krav.min_spelarniva (standard 10) räknas mot din spelarnivå. Det finns även ett valfritt extrakrav foretag.krav.min_yrkesniva som mäts mot yrkesnivån, men det står som standard på 0, alltså avstängt.
Varje källa har ett eget tak
Du kan inte spela dig till nivå 100 på ett enda sätt. Taken är per källa och per dygn, så en dag där du bara bryter malm slår i yrkeshandlingstaket på 2 000 XP och stannar där – trots att du fortsätter tjäna pengar.
Varning: Vildmark ger ingen bygg-XP
Block ger bara XP om de sätts i din egen claim eller i claim som tillhör det samhälle du är medlem i. Att stapla en pelare ute i skogen ger ingenting.
Varning: Samma plats räknas en gång per dygn
En byggd position ger inte XP igen inom 24 timmar. Att bygga och riva samma block om och om igen är alltså meningslöst. Kreativt läge och åskådarläge ger heller aldrig bygg-XP.
Byggnader kan höja din XP
Ett bibliotek i staden ger en procentuell bonus på all spelar-XP medan du befinner dig där. Den sammanlagda multiplikatorn hålls alltid mellan 0,1 och 5,0.
Belöningar betalas ut en gång – och tas inte tillbaka
Nivåbelöningarna är idempotenta per spelare och nivå: passerar du nivå 50 två gånger får du bara 500 kr en gång. Ett /nivåadmin nollställ tar inte tillbaka redan utbetalda belöningar, så spelaren kan inte tjäna pengar på att nollställas och klättra igen.
Admin-XP kringgår taken
/nivåadmin xp bryr sig inte om dygnstaken – det är avsiktligt, så du som admin kan kompensera en spelare direkt. Justeringen loggas som källan admin. Alla adminändringar hamnar i revisionsloggen (kategori ADMIN), nivåbelöningar loggas som ECONOMY och nekade adminförsök som SECURITY.
Behörigheten kontrolleras två gånger
nordguild.admin.niva prövas både i kommandot och en gång till inne i tjänsten, så nivåer inte kan ändras via en genväg förbi kommandolagret. Nekas kontrollen får du ett tydligt felmeddelande och försöket loggas.
Grunda ett samhälle
Alla underkommandon tål svenska tecken
Underkommandon normaliseras innan de tolkas: å och ä blir a, ö blir o. /samhalle lamna, /stad lämna och /by leave gör alltså exakt samma sak.
Stå mot det hörn du vill växa åt
De 2x2 chunks du får väljs efter var i chunken du står: den egna chunken plus de tre grannarna åt det håll du befinner dig. Står du mitt i en chunk blir formen inte den du väntar dig – gå ut mot det hörn du vill växa åt innan du bekräftar.
Namn, beskrivning, färg och motto går att ändra efteråt
Det finns inget chattkommando för det. Gå in via [INSTÄLLNINGAR] och [UPPGIFTER] i samhällsboken – det kräver MANAGE_SETTINGS, och det nya namnet måste vara ledigt precis som vid grundandet.
Varning: Upplösning går inte att ångra
/samhälle upplös raderar claims, tomter, roller och medlemskap. Ägda tomter ersätts bara med mark.aterkopsandel (standard 50 %) av vad de kostade, och bara så långt kassan räcker. Överlåt hellre till någon annan än att upplösa en stad med invånare i.
Medlemmar och roller
Besökar-rollen är stadens ytterdörr
Rollen Besökare kan inte ges till någon – den beskriver vad ALLA som inte är invånare får göra inne i staden. Vill du att förbipasserande ska kunna öppna kistor på ditt torg redigerar du Besökar-rollen som vilken roll som helst, och slår dessutom på regeln besokare_behallare. Försöker du använda [GE ROLLEN TILL …] på den nekas det.
Du kan inte ge bort mer än du själv har
Är du inte borgmästare stoppas du om du försöker sätta en behörighet du saknar på en roll, eller ge en roll en prioritet som är lika hög som eller högre än din egen. Borgmästaren har inga sådana begränsningar utöver att prioriteten måste ligga mellan 0 och 99.
Varning: En inbjudan kan tystna av sig själv
Inbjudningskontraktet ligger kvar i 48 timmar. Blir du sparkad eller tappar INVITE innan mottagaren hinner signera verkställs inbjudan inte alls – spelaren blir aldrig medlem, och händelsen loggas som SECURITY.
Några nycklar täcker in varandra
MANAGE_CITY_BANK ger automatiskt både WITHDRAW och DEPOSIT, och MANAGE_SETTINGS respektive UPGRADE ger automatiskt MANAGE_BUILDINGS. Dessutom godtas MANAGE_PLOTS där CREATE_PLOTS krävs, och MANAGE_SETTINGS där MANAGE_TAXES krävs – de finkorniga nycklarna bröts ur de grova och de gamla ska fortsätta fungera. Övriga uppdelningar är avsiktligt fristående: BUILD ger inte BREAK.
Permissioner och regler
Strängaste regeln vinner alltid
Ligger en skyddad zon över delar av din stad gäller den strängaste av zonens och stadens regler. Samma sak gäller mellan stadsregel och rollbehörighet: rollen måste tillåta OCH regeln måste vara på.
Varning: Reglerna binder även borgmästaren
eld: av stoppar tändstål även för borgmästaren, och djurskada: av hindrar en hyresgäst från att klippa sina egna får på sin egen tomt. Tänk igenom det innan du stänger av något i en stad med aktiva bönder eller djuruppfödare.
Varning: Låsta regler ändras bara i config.yml
Regler under samhalle.lasta_regler får samma värde i alla samhällen på servern. Låsningen läggs på när reglerna läses, så inte ens en rad som ligger kvar i databasen från innan låsningen kan kringgå den – och /samhälleadmin regel nekas lika hårt som borgmästarens knapp.
Två regler för besökare hänger ihop med rollen
besokare_behallare räcker inte ensam: Besökar-rollen måste också ha CONTAINERS. Och på en OFFENTLIG tomt är dörrar, knappar och redstone alltid fria för besökare med INTERACT – offentliga tomter är till för att användas.
redstone-regeln gäller bara utifrån
Regeln redstone stoppar bara icke-invånare. Dina egna invånare styrs i stället av USE_REDSTONE på sin roll, oavsett hur regeln står.
Utanför dörrar och knappar kommer besökaren inte in
Även med besokare_dorrar på räcker Besökar-rollens INTERACT bara till dörrar, grindar, luckor, knappar, spakar och tryckplattor. Allt annat man kan högerklicka på i staden – utom på en offentlig tomt – kräver att du ger Besökar-rollen fler behörigheter.
Tomter
Varning: Restriktionerna stoppar dig innan du bygger fel
Försöker du placera en spawnare, ett industriblock, en bikupa eller en säng, eller hänga upp en tavla, en föremålsram eller ett rustningsställ där tomttypen inte tillåter det, avbryts placeringen med ett meddelande som säger exakt vad typen inte tillåter. Butiks- och företagsbyggnadsflaggorna kontrolleras i stället av butiks- respektive byggnadsmodulen när skylten eller byggnaden skapas. Den som har nordguild.admin.samhalle går förbi allt. Hela systemet kan slås av med mark.restriktioner_aktiva, och vilka block som räknas till varje flagga styrs av mark.restriktioner.block.
En ÄGD tomt är skyddad
Staden kan varken säga upp eller ta bort en ägd tomt: både uppsägningen och TA BORT nekas i tjänsten, inte bara i boken. Ägaren måste själv sälja tillbaka den, eller en administratör lösa in den. Upplöses samhället löses ägda tomter in ur kassan till sina ägare innan resten av kontot töms till borgmästaren, så du ska aldrig kunna bli av med både tomt och pengar.
Statusen syns i actionbaren
Går du in på en tomt visas den i actionbaren: ledig med veckohyra, till salu med pris, hyrd eller ägd med innehavarens namn, hyrd eller ägd av ett företag, reserverad, eller allmän plats. Ett snabbt sätt att se om marken du står på är tagen.
Hyresgästens rätt slår rollbehörigheterna
Du som hyr eller äger tomten, eller är medlem i det företag som hyr eller äger den, får alltid bygga, bryta, öppna behållare och interagera där. Andra invånare kommer bara in med MANAGE_PLOTS. Stadens regler ligger dock ovanpå och kan bara göra det strängare: är eld avstängd brinner det inte på din tomt heller.
Åtkomstordningen
Behörigheter avgörs i tur och ordning: zon-override (spawnzon, admin-bypass), sedan tomtägare eller hyresgäst, sedan stadens regler som veto, sedan rollbehörigheten och sist besökarrollen. Det är därför en stadsregel alltid vinner över din tomträtt, medan en rollbehörighet aldrig gör det.
Så får du en tomt
Varning: Godkänt är inte samma sak som klart
Det vanligaste misstaget är att tro att en godkänd ansökan ger tomten. Den gör bara att tomten reserveras åt dig i 48 timmar och att ett avtal skickas. Signerar du inte under /kontrakt inom den tiden släpps reservationen, du får meddelandet om att reservationen gått ut, och tomten går tillbaka till att vara ledig. Logga in och signera samma dag du får notisen.
Varning: Ändrad hyra eller ändrat pris avbryter ett osignerat avtal
Höjer eller sänker staden veckohyran innan du hunnit signera hyresavtalet, avbryts avtalet med ett meddelande om att hyran ändrats, och du får det nya beloppet. Samma spärr finns på köpeskillingen. Be då om ett nytt avtal. Poängen är att du aldrig ska debiteras ett annat belopp än det du signerade.
Varning: Tre öppna ansökningar åt gången
Du kan ha högst tre öppna ansökningar samtidigt, och taket räknas över alla samhällen, inte per stad. Vill du söka en fjärde tomt måste du först dra tillbaka en av dina öppna, eller vänta tills en avgörs eller går ut efter sju dagar.
Köp och hyra fungerar olika
Att köpa en tomt som redan är till salu sker direkt med en bekräftelse och en enda transaktion, utan kontrakt. Att hyra går alltid via ett hyresavtal som ska signeras. Går det via en godkänd ansökan väljer markansvarig upplåtelseform, och då kommer även köpet som ett köpeavtal (MARKKOP) att signera.
Borgmästaren hyr inte
Är du borgmästare i staden nekas hyra med motiveringen att stadens mark redan är din. Du behöver inte hyra av dig själv. Köp är däremot inte spärrat på samma sätt.
Företag hyr genom företagssidan
Ett företag hyr mark via /företag mark, inte via /samhälle mark. Bara tomter av typen FORETAG, HANDEL eller INDUSTRI i huvudkontorets samhälle går att hyra, pengarna tas ur företagskassan och det behövs inget kontrakt. Alla medlemmar i det hyrande företaget får bygga på tomten.
Varning: En stad i kris hyr inte ut
Är staden i det ekonomiska läget KRITISK är tomtuthyrningen pausad. Befintliga avtal löper vidare, men nya hyresavtal går inte att verkställa förrän staden betat av sin skuld.
Så delar borgmästaren ut mark
Varning: Ägd mark går inte att ta tillbaka
När en tomt väl blivit ÄGD nekas både uppsägning och TA BORT i tjänsten, inte bara i boken. Enda vägarna tillbaka är att ägaren säljer tillbaka den frivilligt, att markskatten förblir obetald i mark.obetald_skatt_dagar, eller att en administratör kör frigör och tvångsinlöser den. Tänk efter innan du säljer eller tilldelar med äganderätt.
Skapa och hantera är två olika rättigheter
CREATE_PLOTS räcker för markeringsverktyget och för att skapa nya tomter, men inte för att sätta pris, ge bort, redigera, avgöra ansökningar eller säga upp. Det kräver MANAGE_PLOTS. Vill du ha en markansvarig som ritar ut tomter men inte styr över befintliga hyresgäster ger du bara CREATE_PLOTS.
Varning: Dålig stadsekonomi blockerar markarbetet
Är staden i läget FÖRFALLEN går det inte att skapa nya tomter eller nya claims, och ingen uppgradering är möjlig. I KRITISK är claims frysta och tomtuthyrningen pausad. Betala av skulden med /samhälle ekonomi betala skulder så tar läget ett steg tillbaka mot NORMAL.
Varning: Chunkar med tomt går inte att avclaima
Har du lagt en tomt i en chunk sitter den chunken fast i staden tills tomten är borta. Samma sak gäller chunken där stadens hem ligger. Planera tomtplaceringen innan du fyller upp claimtaket.
Taken skyddar hyresgästen
Veckohyran kan aldrig sättas högre än mark.max_hyra_per_vecka (50 000 kr) och köpeskillingen aldrig högre än mark.max_koppris (10 000 000 kr). Det finns för att MANAGE_PLOTS annars skulle kunna tömma en hyresgästs, särskilt ett företags, kassa via en enda uthyrning.
Allt loggas
Tomter, hyror, köp, återköp, tvångsinlösen, tilldelningar, ansökningsbeslut och vräkningar revisionsloggas under kategorierna SETTLEMENT, CLAIM, ECONOMY och ADMIN. Blir det bråk om vem som fick vilken tomt går det att slå upp i efterhand.
Markskatt, hyra och obetalda avgifter
Första veckan efter köpet är skattefri
Köper du en tomt börjar markskatten löpa först veckan därpå. Du hinner alltså komma igång innan den första dragningen kommer.
Varning: Sälj hellre tillbaka än att bli av med tomten
Att låta markskatten förbli obetald i fjorton dygn kostar dig hela tomten utan en krona tillbaka. Säljer du tillbaka den frivilligt får du mark.aterkopsandel, som standard 50 procent, av det du betalade. Mellanskillnaden är avsiktlig, den gör markspekulation dyr och är en inkomst för samhällskassan.
Markskatt per tomt har samma tak
Borgmästaren kan sätta markskatten på en enskild tomt via markboken, men värdet måste ligga inom exakt samma serverspann samhalle.skatt.markskatt som stadens allmänna skattesats. Annars hade taket varit meningslöst för en ägare som redan sitter på sin tomt och skulle kunna tvingas ut med en skräddarsydd skattesats.
Ändrad standardskatt drar inte med individuella tomter
När du ändrar stadens standardmarkskatt följer bara de tomter med som fortfarande hade det gamla standardvärdet. En tomt vars skatt du satt individuellt behåller sitt värde, och svaret i chatten säger hur många tomter som följde med.
Varning: Företagsmark belastar företagskassan
Hyr företaget tomten dras veckohyran ur företagskassan, inte ur din privata plånbok. Går företaget i konkurs släpps dess tomter, och butiker som stod på dem stängs. Just därför krävs uttagsrätt (WITHDRAW_MONEY) utöver MANAGE_PLOTS för tomter dyrare än foretag.tomthyra_kraver_uttagsratt_over (5 000 kr per vecka).
Så håller du koll på jobben
Hyran körs av jobbet markhyra, markskatten av markskatt och utgångna reservationer och ansökningar av markstadning. Alla tre syns med senaste och nästa körning i /nordguild hälsa, och en administratör kan tvinga fram dem med /samhälleadmin hyra kör respektive /samhälleadmin underhåll kör.
Hyra och markskatt är stadens inkomster
Båda går rakt in i samhällskassan och bokförs i huvudboken, markskatten som skatt uppdelad per slag. Första veckohyran och köpeskillingen räknas däremot inte som ekonomisk aktivitet, så du kan inte farma stadens progression genom att hyra och säga upp i cirkel. Har staden skulder är höjd markskatt ett sätt att få in pengar, men den sänker samtidigt stadens attraktivitet och kan driva bort ägare som inte har råd.
Byggnader
Så räknas bonusen ut
Bonus per byggnad = basbonus för uppnådd nivå x kvalitetsfaktor x dublettfaktor. Summan per typ kapas sedan mot taket, och taket går aldrig att överskrida hur många byggnader staden än har. Kvalitetsfaktorn är 0,5 + 0,5 x kvalitet/100, så en slarvigt byggd byggnad ger halva bonusen och en påkostad hela.
Dubletter ger mindre
Flera byggnader av samma typ trappas ned enligt kurvan 100, 50, 25, 10, 0 procent. Andra byggnaden ger halva bonusen, femte och framåt ingenting. Ordningen är alltid högst kvalitet först, därefter äldst registrerad. Byggnaderna räknas fortfarande fullt för kapacitet, produktion och progression - det är bara bonusen som trappas ned.
Varning: Bara godkända byggnader ger bonus
En skadad, avstängd eller övergiven byggnad ger ingen bonus alls, oavsett hur bra den är byggd.
Bonusen kan gälla staden, chunken eller huset
Varje bonus har en omfattning: stad (hela samhället, det vanliga), chunk (byggnadens egna chunkar) eller byggnad (bara inne i markeringen). Stallets spawnchans är till exempel en chunkbonus och gäller alltså bara kring stallet, medan avelshastigheten gäller hela staden.
Stadens byggnadstak
Hur många byggnader ett samhälle får ha styrs av samhällsnivån: nivå 1-5 ger 5 platser, 6-12 ger 10, 13-20 ger 20, 21-30 ger 40, 31-40 ger 80 och 41-50 ger 120. Kvoten visas i boken som använda av max. Övergivna byggnader räknas inte mot taket.
Varning: Byggnaderna kostar mer än de drar in
Byggkostnaden går från 1 500 kr för ett värdshus till 25 000 kr för en centralstation, och varje byggnad har dessutom ett veckounderhåll som växer med nivån. Den enda pengakällan i modulen är bankens ränta, som är liten och takad till 500 kr per vecka och samhälle. Räkna med att byggnaderna kostar staden pengar - de betalar sig i bonusar och produktion, inte i kronor.
Varning: Underhåll betalas även för trasiga hus
Veckounderhållet räknas på alla byggnader utom de övergivna. En skadad eller avstängd byggnad kostar alltså fortfarande pengar utan att ge bonus.
Så registrerar du en byggnad
Markeringen har gränser
Varje sida måste vara minst 3 block. Markeringen får vara högst 40 000 block i volym och ingen sida längre än 128 block. För stora markeringar avvisas direkt, innan systemet ens börjar läsa världen.
Varning: En byggnad är ett hus
Två registrerade byggnader får aldrig överlappa varandra. Går markeringen in i en redan registrerad byggnad får du veta vilken det är, och registreringen avbryts. Du kan alltså inte registrera samma hus två gånger för dubbel bonus. Undantaget är administratörens supportrader från /byggnadadmin ge: de ligger på en enda blockposition och varken spärrar eller spärras.
Namnet
Lämnar du namnet tomt får byggnaden typens namn. Namnet ska vara 3 till 32 tecken. Är namnet redan upptaget i samhället lägger systemet till en siffra åt dig, så du får Bank 2, Bank 3 och så vidare.
Detta stoppar dig innan mätningen
Innan ett enda block läses kontrolleras: att typen finns, att du har rollen, att markeringen håller sig inom min- och maxmåtten, att hela markeringen ligger inom stadens claims, att namnet är giltigt, att byggnadstaket inte är fullt, att en unik typ inte redan finns, att du inte har max antal av typen, att en byggnad som typen kräver finns godkänd, att invånarna räcker, att produktionen räcker, att stadskassan är över typens miniminivå, att marktypen under markeringens mitt stämmer, och att markeringen inte överlappar en annan byggnad. Alla dessa kontroller körs sedan en gång till auktoritativt mot databasen inuti registreringen, bakom samhällets lås.
Samhällsnivån syns i kravlistan, inte som ett stopp
Kravet kravs_samhallsniva prövas inte före mätningen utan står som en egen rad i kravlistan. Är staden för liten mäts huset alltså ändå, och du ser raden med kryss och stadens nuvarande nivå bredvid den nivå som krävs.
Pengarna kontrolleras sist
Att kassan räcker till byggkostnaden prövas av ekonomin inuti registreringstransaktionen, efter mätningen. Räcker den inte rullas hela registreringen tillbaka: ingen byggnad, inga pengar dragna. Avgiften har idempotensnyckeln byggnad:<id>, så en omkörning aldrig kan betala två gånger.
Går området inte att läsa
Ligger byggnaden i en värld eller chunk som inte är laddad kan området inte läsas, och du får ett meddelande om att försöka igen om en stund. Ingenting registreras och ingen status ändras.
Krav och kvalitet
Kvaliteten avgör halva bonusen
Effektiv bonus = basbonus x (0,5 + 0,5 x kvalitet/100). Ett hus med kvalitet 0 ger halva bonusen, ett med kvalitet 100 ger hela. Det lönar sig alltså rejält att bygga större än minimum, blanda material, inreda och lysa upp. Poängen visas i boken, i /byggnad info och i /byggnadadmin debug.
Använd grupper i stället för enskilda material
RED_BED: 2 betyder två röda sängblock och underkänner en blå säng utan att någon förstår varför. Gruppen Sängar gör samma jobb utan att bestämma inredningen. Mönstret * matchar hela slutet av materialnamnet, så *_FENCE fångar inte *_FENCE_GATE - staket och grindar går att kräva var för sig.
Varning: Bara block räknas
Mätningen läser bara block ur världen, aldrig entiteter eller föremål. Ett rustningsställ, en godsvagn eller sakerna i en kista syns inte alls. Blocket måste dessutom gå att få tag på i överlevnadsläge - kreativläges-block som spawner, bedrock, barriär, kommandoblock och valv kan aldrig vara ett giltigt krav. Båda reglerna vaktas av ett test.
Varning: Dörrar och sängar är två block var
En dörr består av två block (över och under) och en säng av två (huvud och fot). Ett krav på 4 sängblock betyder alltså två sängar, och 2 järndörrsblock betyder en järndörr.
Nivåernas krav är kumulativa
En typ kan ha nivåerna I, II, III med egna krav, egna bonusar och eget underhåll. Nivå II:s krav är nivå I:s plus nivå II:s egna. Vid varje mätning avgörs den högsta uppfyllda nivån automatiskt, och boken visar också vad som fattas till nästa nivå.
Varning: Nivåns bonusblock ersätter nivån under
Bonusarna på en nivå adderas inte till nivån under, de ersätter den. Ett Stall II ger 25 procent avel i stället för nivå I:s 15 procent. En nivå utan eget bonusblock ärver nivån under oförändrat.
Omvalideringen är händelsestyrd
Bryts eller placeras ett block innanför en registrerad byggnads volym markeras byggnaden som smutsig och kontrolleras inom en minut. Det periodiska svepet ligger kvar som skyddsnät var 120:e minut och tar högst tre byggnader per körning. Ingen byggnad valideras oftare än var 30:e sekund; /byggnad kontrollera <namn> och /byggnadadmin validera går förbi den spärren och har i stället sin egen cooldown.
Oladdade chunkar sänker aldrig ett hus
Går området inte att läsa, till exempel för att världen inte är laddad, rörs statusen inte alls - kontrollen skjuts bara fram.
Gamla nycklar fungerar kvar
De äldre nycklarna min_golvyta, max_golvyta, min_innerhojd, min_vaggar_procent, min_tak_procent, min_golv_procent, krav_block och forbjudna_block finns kvar och blir samma kravtyper. En befintlig byggnader.yml fungerar alltså oförändrad.
Status
Varning: En skadad byggnad går inte att stänga av
Bara en godkänd byggnad kan stängas av. Ett trasigt hus repareras eller avregistreras. Annars hade stäng av plus slå på nollställt fristen och gett tillbaka full bonus för ett hus som redan bevisats inte hålla kraven, om och om igen. Databasen har en kontroll som ser till att status och skadedatum aldrig kan hamna i otakt.
Varning: Taket räknar platser, inte godkännanden
Max antal per samhälle räknar alla byggnader av typen utom de övergivna - alltså även de skadade och avstängda. Ett skadat stall upptar sin plats precis som ett helt.
Varning: Övergivna blockerar inte antalet - men unika typer blockerar de fortfarande
En övergiven byggnad räknas varken mot stadens byggnadstak eller mot max antal per samhälle för vanliga typer. Unika typer är undantaget: där räknas alla rader oavsett status, så en övergiven kyrka upptar fortfarande stadens enda kyrkoplats tills den avregistreras.
Notiser till hela samhället
Registrering, avregistrering, skada, reparation, förfall, ingen plats kvar, avstängning, påslagning och bankräntan skickar en notis till alla medlemmar i samhället. Du behöver alltså inte sitta och bevaka boken.
Upplöses staden städas byggnaderna bort
Byggnader vars samhälle inte längre finns tas bort av förfallsjobbet - de kan ändå aldrig repareras. Städningen körs bara när samhällsmodulen bevisligen är laddad, så en kall cache aldrig kan radera något av misstag.
Byggnadstyper
Varning: Fyra byggnadskedjor
Fyra typer kräver att en annan byggnad redan står godkänd i staden: Ridcenter kräver Stall, Vapenverkstad kräver Smedja, Handelsgille kräver Marknadshall, och Centralstation kräver både Hamn och Lager. Är den byggnaden skadad, avstängd eller övergiven räknas den inte som godkänd.
Unik betyder unik oavsett status
Rådhus, bank, marknadshall, hamn, centralstation, kyrka, bibliotek, skola, sjukhus och kasern är markerade som unika: högst en per samhälle, oavsett om den befintliga är hel, skadad, avstängd eller övergiven. Vapenverkstad, ridcenter och handelsgille har max 1 per stad men är inte unika - där släpper en övergiven byggnad sin plats.
Billigast först
Ska du bygga upp en ny stad är värdshuset (1 500 kr) och lagret (3 000 kr) billigast och har inga nivåkrav alls. Stall och bageri på 2 500 kr, kvarnen på 3 500 kr, verkstaden på 3 000 kr och smedjan på 4 000 kr kräver heller ingen viss samhällsnivå. Rådhuset, kyrkan, biblioteket och marknadshallen öppnar först vid By, alltså samhällsnivå 6.
Produktionspoäng och utvecklingspoäng
Utöver bonusarna bidrar varje godkänd byggnad med sina produktionspoäng till samhällets löpande produktion, viktade med kvaliteten och nedtrappade per dublett enligt kurvan 100, 65, 40, 20, 10 procent. Utvecklingspoängen ges en enda gång när byggnaden godkänns och trappas per dublett enligt 100, 60, 20, 10, 5 procent. Utvecklingspoängen nollställs aldrig - rivs byggnaden ligger poängen kvar.
Ändra typerna själv
Vill Felix justera krav, kostnader, underhåll eller bonusar redigeras byggnader.yml och sedan körs /byggnadadmin ladda. Nya kravtyper listas med /byggnadadmin kravtyper, och en helt egen bonustyp får automatiskt standardtaket 25 procent tills ett eget tak sätts i config.yml under byggnader.tak.
Produktionspoäng
Produktionspoäng är inte kronor
Det här är den vanligaste missuppfattningen. Produktionen är ett mått på stadens uppbyggnad; kronorna kommer ur den verkliga handeln (skatter, butiker, marknad). Först vid veckoutbetalningen omvandlas poängen till pengar, och då med den låga faktorn 0,50 kr per poäng. En stad med 3 000 poäng får alltså 1 500 kr, inte 3 000 kr. Två städer med samma produktion kan ha helt olika skatteintäkter.
Varning: Ingen enskild källa kan fylla taket
En källa får aldrig utgöra mer än 55 procent av nivåns produktionstak (kallor.kalltak_andel). Fyrtio lager och inget annat tar dig alltså inte till 100 procent – du behöver invånare, företag och handel också.
Varning: Nivåtaket kapar summan
Procenten i boken och i tab-listan är produktion delat med nivåns produktionstak. När taket slår till skalas grenarna ned proportionellt med kumulativ avrundning, och detaljvyn skriver ut "Nivåns produktionstak (X) slog till – uppgradera staden för mer." Både inriktningens bonus och byggnadsbonusen produktionsbonus räknas in FÖRE taket, så ingen av dem kan lyfta staden över taket.
Vad du säljer avgör vilken gren som växer
Butiksförsäljning inne i staden räknas alltid till Handel (produktion.butiksgren). Din försäljning på Centrala marknaden matchas däremot mot grenarnas materialmönster: malm och sten till Gruvdrift, grödor, kött och fisk till Jordbruk, stockar, plankor och verktyg till Industri, tillagad mat, böcker och drycker till Tjänster. Första grenen som matchar vinner, och Handel har mönstret "*" som fångar allt övrigt.
Siffran är upp till fem minuter gammal
Alla samhällens produktion räknas om var 5:e minut (produktion.cache_minuter). Vill du se effekten av en nyss registrerad byggnad direkt kör du /produktion beräkna (cooldown 5 minuter, kräver MANAGE_SETTINGS).
Produktion är inte samma sak som omsättning
Ett företags produktion mäter vad det gör, inte vad det tjänar. Ett bageri som säljer 2 000 bullar för en krona styck har hög produktion och låg vinst; en juvelerare med en enda försäljning har tvärtom.
Varning: Ingen veckoinkomst i en tom stad
Utbetalningen kräver minst 2 invånare (produktion.min_invanare) som varit inloggade den senaste veckan. Annars kommer meddelandet att staden inte fick någon produktionsinkomst, hur höga poängen än är. Produktionsboken visar läget som raden Aktiva X/2.
Utvecklingspoäng
Varning: Riv och bygg upp igen ger noll nya poäng
Kurvsteget mäts mot det STÖRSTA antal byggnader av typen som staden haft samtidigt, inte mot antalet den någonsin byggt. Rivs en byggnad ligger poängen kvar, men steget frigörs inte. Riv-och-bygg-om, nedläggning-och-nyregistrering av företag och in-och-utsparkning av spelare ger alla noll nya poäng.
Ett hus TILL ger nästa steg i kurvan
Vill du ha nya utvecklingspoäng ur en byggnadstyp måste staden ha fler samtidiga byggnader av den typen än den någonsin haft. Har du två kvarnar och river den ena får du ingenting av att bygga upp den igen – men bygger du en tredje får du det tredje kurvsteget.
Byggnadstypens max_per_samhalle är taket
Byggnadskällan kapas mot typens max_per_samhalle i byggnader.yml. En övergiven byggnad räknas inte mot taket, men kan repareras tillbaka till godkänd – därför läser progressionen taket själv i stället för att lita på byggnadsmodulen. Unika byggnader som rådhus och bank har max_per_samhalle 1 och ger alltså bara sitt första kurvsteg.
Varning: Nollställning återställer högvattenmärket
/produktionadmin nollställ raderar utvecklingsraderna och därmed även märket. Efter en nollställning kan samma kurvsteg bokföras en gång till. Använd det bara medvetet.
Nivåerna är det enda som är stabilt av sig själv
Nivå 3 är alltid nivå 3, men byggnader, företag och spelare har alla en referens som går att byta ut mot en ny. Utan högvattenmärket gick utvecklingspoäng – som är ett nivåkrav – att farma obegränsat för byggkostnaden, bolagsavgiften respektive antalet spelare på servern.
Så uppgraderar du din stad
Varning: Rådhus, inte radhus
Kravnyckeln stavas radhus i config.yml, men byggnaden heter Rådhus och är stadens administrationsbyggnad – klocka, talarstol, bokhyllor och stadens fana. Det finns inget radhus i betydelsen kedjehus i NordGuild. Rådhuset är unikt: max ett per samhälle.
Pengar ensamt tar dig ingenstans
Kraven är avsiktligt multidimensionella. Du kan inte köpa dig till nivå 30 – invånare, byggnader, byggda block, ålder, handel, produktion och utveckling måste alla vara på plats.
Varning: Kravvyn är cachad, beslutet är färskt
Produktion och utveckling visas ur cachen med en grå rad om när de räknades fram. En byggnad som just registrerats eller ett företag som just grundats räknas ändå direkt vid uppgraderingen, utan /produktion beräkna. Omvänt fäller ett underlag som försvunnit (konkurs, riven byggnad, nollställning) uppgraderingen även om kravvyn visar grönt.
Chunktaket är 5 plus 4 gånger nivån
Nivå 1 ger 9 chunkar (3x3) och nivå 50 ger 205; varje nivå däremellan ger fyra till. Nivå 1 gav förut 4, vilket rymmer ungefär två hus – och eftersom nivå 2 kräver en bostad (kravet bostader, räknat av byggnadsskanningen) blev starten trång: marken tog slut ungefär där man byggt det som krävdes för att få mer mark. Behöver du fler chunkar innan nästa nivå går det att köpa extra chunkplatser med /samhälle köpchunk för 5 000 kr styck, upp till 3 × nivån (claims.extra_chunk_max_per_niva). Både stadsboken och markboken visar priset på raden Claims, och avslaget när taket är nått gör det också.
Gamla samhällen hamnar rätt automatiskt
Varje spanns första nivå har kvar det gamla id:t (BOSATTNING, BY, KOPING, STAD, STORSTAD, METROPOL), så ett samhälle sparat med ett gammalt id hamnar på nivå 1, 6, 13, 21, 31 respektive 41. Ingen datamigrering behövs.
Varning: Underhållet växer snabbare än produktionen
Vid nivå 50 kostar det kommunala underhållet 14 000 kr i veckan, medan produktionen ger runt 5 000 kr. En storstad måste leva på skatter, markhyror och företagsskatt – inte på produktionsinkomsten.
Stadens ekonomi
Underhållet dras som två poster
Claim-underhållet (samhalle.underhall_per_vecka, efter byggnadsbonusen underhållsrabatt – rådhuset ger 10 % på nivå 1 och 15 % på nivå 2, taket för hela staden är 20 %) och byggnadsunderhållet dras i samma veckokörning men bokförs var för sig. Notisen till dem med VIEW_FINANCES visar uppdelningen: claim X kr, byggnader Y kr, totalt Z kr.
Varning: Två obetalda underhållsveckor spärrar staden
Efter 2 veckor med obetalt underhåll (underhall_blockerar_efter_veckor) går det varken att uppgradera eller claima ny mark – oavsett vilket ekonomiskt läge staden råkar stå i.
Varning: Obetald markskatt kostar tomten
Kan markskatten inte betalas växer tomtens skatteskuld, och efter 14 dygn (mark.obetald_skatt_dagar) återgår tomten till staden utan ersättning.
Dröjsmålsränta är avstängd som standard
samhalle.ekonomi.skuldranta_procent står på 0, så skulden växer inte av sig själv. Slås den på läggs räntan bara till skuldsiffran – inga nya pengar skapas.
Staden dör aldrig av sig själv
KRITISK är sista steget uppåt. Ingen stad raderas automatiskt, och en stad i kris kan alltid räddas genom att skulden betalas av.
Attraktivitet gör ännu ingenting
Attraktivitet 0–100 räknas ur skattenivåer, lediga bostadstomter, byggnader per invånare, produktion, lediga jobb, butiker och ekonomisk hälsa. Den visas i statistiken och via API:t men har ännu ingen mekanisk effekt – den är avsedd för ett framtida inflyttningssystem.
Banken är medvetet en liten inkomst
Ränta betalas ut måndagar klockan 04 som 0,25 procent av kassan per vecka, takat till 500 kr. En bank kostar 15 000 kr att bygga, kräver 20 000 kr i stadskassan och 400 kr i underhåll per vecka, och ger högst 26 000 kr om året vid fullt tak.
Specialisering
Välj efter vad staden redan gör
Öppna /produktion detaljer först. Bonusen är procentuell, så den är värd mest på den gren som redan har flest poäng – och nackdelen svider minst på en gren du ändå knappt använder. I produktionsboken står plus- och minusprocenten i marginalen bredvid grenen.
Varning: Bytet har lång cooldown
Efter ett byte går det 30 dygn innan nästa. Boken skriver ut "Inriktningen byttes nyligen. Försök igen om X dagar" och avgiften dras inte om bytet nekas – valet är en villkorad uppdatering, så två klick kan aldrig ge två byten eller två avgifter.
Varning: Räcker inte kassan händer ingenting
Täcker stadskassan inte bytesavgiften på 5 000 kr rullas hela bytet tillbaka med meddelandet att stadskassan inte täcker bytesavgiften, och den gamla inriktningen ligger kvar.
Varning: Inriktningen lyfter dig inte över taket
Både inriktningens procent och byggnadsbonusens produktionsbonus (tak 40 procent för hela staden) räknas in före nivåtaket. Ligger du redan i taket ger inriktningen noll extra poäng – då är det uppgradering som gäller.
Samma inriktning två gånger går inte
Väljer du den inriktning staden redan har svarar boken att staden redan har den, utan avgift. Och hinner någon annan välja i exakt samma ögonblick får du meddelandet att inriktningen just valdes av någon annan – försök igen.
Produktionsadmin
Varning: Nollställning är inte bara en siffernollning
/produktionadmin nollställ raderar utvecklingsraderna och därmed högvattenmärket. Efter en nollställning kan samma kurvsteg bokföras en gång till, alltså kan staden farma tillbaka poäng den redan haft.
Utbetalningen kan inte köras dubbelt
Raden i settlement_production_log skrivs i samma transaktion som pengaflytten och är unik per samhälle och ISO-vecka. /produktionadmin kör är därför ofarligt att köra igen – ingen stad får betalt två gånger för samma vecka.
Ikappkörningar mäter i sitt eget fönster
Har servern legat nere över en måndag tas de missade veckorna igen en i taget vid start. Varje ikappkörning mäter aktiviteten i fönstret [tillfället − 7 dygn, tillfället], aldrig fram till nu, så samma arbete kan inte betalas ut en gång per missad vecka.
Omräkningen är billig
En omräkning kostar sex aggregerade SQL-frågor totalt, oavsett hur många samhällen servern har, och körs var 5:e minut. Du behöver inte vara rädd för att köra /produktionadmin beräkna.
Varning: Balansera underhåll mot produktion
kr_per_poang vägs mot samhalle.underhall_per_vecka. Vid nivå 50 är underhållet 14 000 kr i veckan mot cirka 5 000 kr i produktionsinkomst – höjer du kr_per_poang gör du storstäder självförsörjande, vilket ekonomin inte är byggd för.
Byggnadstyperna valideras vid start
Typerna i produktion.grenar.*.byggnader, samhalle.nivaer.*.krav.byggnader och krav.byggnadsnivaer måste finnas i byggnader.yml, aldrig överstiga typens max_per_samhalle, aldrig kräva en byggnadsnivå typen inte har, och aldrig krävas på en lägre eller samma nivå som typens egen kravs_samhallsniva. ByggnadstyperTest kontrollerar allt detta, kategorikraven inräknade.
En typ får bara ligga under en gren
Står samma byggnadstyp under flera grenar i produktion.grenar vinner den första. Samma sak gäller marknadsmaterialen: första grenen vars mönster matchar tar försäljningen, och Handel har mönstret "*" som fångar resten.
Företag
Butiksförsäljningen går genom företaget
När en kund handlar i företagets butik går pengarna kund till företagskassa, transaktionsavgiften på 2 procent förstörs, och stadens företagsskatt (som mest 10 procent) går företag till stadskassa. Avgiften kan vara lägre: stadens handelsbyggnader och ett handelsdistrikt drar av procentenheter från den. Bara köp på minst 10 kr räknas i omsättning, transaktionsräknare och stadens ekonomiska aktivitet.
Namnregler
Företagsnamnet måste vara 3 till 32 tecken, får inte vara upptaget och får varken se ut som ett visnings-id (SE-000012) eller bestå av enbart siffror. Beskrivningen får vara högst 200 tecken.
Varning: Två företag är taket
Du kan äga högst 2 företag samtidigt. Tar du emot ett företag genom överlåtelse räknas det in i taket, så överlåtelsen nekas om mottagaren redan är full. Adminkommandot /företagadmin ägare går förbi taket.
Du kan inte styra uppåt
Roller har prioritet. Du kan bara sparka, ta bort eller ge roll åt någon vars roll ligger under din egen, och ägarrollen kan aldrig delas ut – den byter du bara genom överlåtelse.
Så startar du ett företag
Varning: Bolagsavgiften börjar ticka direkt
Företagets första bolagsavgift förfaller 7 dagar efter registreringen och dras sedan varje vecka. Ha alltid pengar kvar i kassan.
Förhandstillstånd först, företag sedan
Ska du in i Gruvdrift, Alkemi eller Transport: sök tillståndet med /företag tillstånd ansök <bransch> innan du registrerar. Avgiften för ett förhandstillstånd betalas ur ditt eget konto när staden godkänner. Varje stad får ändra sin egen lista över tillståndspliktiga branscher, så kolla /företag tillstånd först.
Ändra dig i tid
Ett upptaget namn eller en avbruten prompt kastar dig bara tillbaka i flödet. Inget dras förrän du trycker [REGISTRERA].
Anställning och löner
Ägaren kan inte vara anställd
Ägaren kan inte anställas i sitt eget företag; lönen skulle gå förbi utdelningsavgiften. Överlåter du företaget till en anställd avslutas den anställningen automatiskt och innestående lön betalas om kassan räcker.
Skulden följer den anställde
Obetald lön ligger kvar på anställningen med ränta och betalas ut vid nästa lönekörning, vid uppsägning, vid avsked eller vid konkurs. Säger du upp dig försvinner alltså inte skulden.
Varning: Du kan inte sparka uppåt
Du kan bara sparka någon vars roll är lägre än din egen. Ägaren kan sparka alla.
Anställda kostar plats
Taket för antal anställda sitter i företagsnivån: 3 på Nystartat och upp till 40 på Koncern. Är taket nått går det inte att skicka fler erbjudanden.
Företagsnivåer och utdelning
Varning: Bolagsavgiften växer med nivån
En Koncern betalar 10 000 kr i veckan bara för att finnas. Uppgradera inte för uppgraderandets skull om omsättningen inte bär avgiften. Ett rådhus i samhället sänker avgiften med 8 procent (12 procent på Rådhus II), men rabatten kan aldrig göra avgiften noll.
Nivåsteget kan hoppa flera steg
Nivåkontrollen fortsätter uppåt så länge nästa nivås krav är uppfyllda, så ett företag kan gå upp flera nivåer i samma kontroll. Ett Förfallet företag uppgraderas inte alls. En uppgradering ropas ut på servern och ägaren får en titel på skärmen.
Lönereserven skyddar personalen
Du kan aldrig dela ut så mycket att nästa veckas löner inte får plats i kassan. Det är avsiktligt.
Småköp räknas inte
Bara köp på minst 10 kr räknas mot omsättning och transaktionsräknare, så nivåkraven går inte att farma med enöresaffärer.
Konkurs
Varning: Riskzonen släpper inte av sig själv
Sviten av misslyckade perioder bryts först när både periodens löner och all gammal löneskuld är betald. Ett företag ska aldrig kunna visa Aktivt med innestående löner kvar.
Varning: Räntan gör skulden dyr
Obetalda löner växer med 5 procent per vecka, och räntan går till den anställde. Fyra missade perioder är alltså inte fyra veckolöner utan mer.
Lägg hellre ned i tid
Säg upp personalen och avregistrera företaget medan det finns pengar kvar, så får du resten av kassan tillbaka. Låter du det gå till konkurs får du ingenting.
Allt loggas
Registrering, anställning, avsked, roller, utdelning, insättning, skuldbetalning, tomter, överlåtelse, avregistrering, löner, avgifter, konkurs och nivåändringar revisionsloggas under kategorierna COMPANY, ECONOMY och ADMIN. Företagsnamn i adminkommandon kan anges som namn eller SE-000012.
Stadens verktyg mot företagen
Skattelättnaden är en andel, inte en procentsats
Procenten är hur stor del av stadens skattesats som faller bort. 50 procents lättnad på 8 procents företagsskatt ger 4 procent. Det får finnas högst en aktiv lättnad per företag, och en ny ersätter den gamla.
Varning: Handelsdistriktet kostar också
Butiker i ett handelsdistrikt får lägre transaktionsavgift, men staden tar en extra veckoavgift per butik i zonen ur företagskassan. Räkna på om rabatten bär avgiften. Distrikten syns i lila på stadens karta.
Gamla företag rördes inte
Företag som redan fanns när tillståndsplikten infördes fick ett hävdvunnet tillstånd av migrationen, så ingenting bröts när regeln kom.
Varning: En förfallen stad blir dyrare
Har staden Förfallen ekonomi eller sämre betalar företagen i den 25 procents påslag på bolagsavgiften, och påslaget går till samhällskassan. Går påslaget inte att betala tas det inte ut och blir ingen skuld.
Spelarbutiker med kista och skylt
Varning: KÖP betyder att DU säljer
Det vanligaste felet. Tänk från kundens sida: KÖP är knappen kunden trycker på för att köpa av dig, SÄLJ är knappen kunden trycker på för att sälja till dig.
Varning: Säljpriset måste vara lägre än köppriset
Har skylten både KÖP och SÄLJ vägrar systemet om säljpriset är lika högt eller högre – annars kunde vem som helst köpa och sälja tillbaka i evighet och tömma ditt konto. Kontrollen görs både på partipriset och på priset per styck efter avrundningen.
Priset gäller partiet, inte styckena
Skriver du 16 Vete på rad 2 och 16 kr på rad 3 kostar hela bunten 16 kr, alltså 1 kr per vete. Priset per styck avrundas uppåt när kunden köper (minst 1 öre) och nedåt när butiken köper in.
Skylten går inte att skriva om – ändra priset i boken
En registrerad butiksskylt är vaxad och skyddad mot omskrivning. Vill du ändra pris eller mängd kör du /butik, går till MINA BUTIKER, väljer butiken och sedan SORTIMENT: där finns [ÄNDRA PRIS] (kundpris och köppris per styck, 0 stänger av riktningen) och [ÄNDRA SKYLTANTAL]. Skylten ritas om automatiskt.
Varning: Bryter du skylten eller kistan försvinner butiken
Både skylten, kistan och blocket som håller upp skylten är skyddade – också mot eld, vatten, lava, explosioner, kolvar och trattar. Bryter du själv någon av dem avregistreras butiken och du får en notis. Andra spelare kommer inte åt kistan alls.
En skyltbutik säljer bara en vara
Vill du sälja flera varor sätter du upp flera skyltar med varsin kista – eller använder ett företag och en sortimentsbutik med upp till 27 varor.
Kontrollera ägaren innan du skriver skylten
Har du valt ett företag med /butik skyltägare tillhör alla nya skyltar företaget tills du loggar ut. Kör /butik skyltägare jag för att gå tillbaka till dig själv.
Varning: På företagets tomt räcker det inte att vara anställd
Sätter du en egen skyltbutik på en tomt som ditt företag hyr binds den inte till tomten – företaget kan ju sparka dig. I stället krävs behörigheten PLACE_SHOPS i samhället. Saknar du den nekas skylten.
Du kan inte handla i din egen butik
Äger du butiken själv stängs du av från dina egna knappar. Är butiken ett företags är det företagets ägare som stängs av – vanliga anställda får handla där.
Butiker i systemet
Insälj kostar butiken avgiften
När en kund säljer till butiken betalar butiken exakt skyltens pris till kunden och avgiften ovanpå. Kunden ser alltså alltid rätt summa. Räcker inte kassan eller lagerplatsen får kunden tillbaka sina föremål.
Recensioner finns bara för företagsbutiker
En recension per köp, 1–5 stjärnor och text på högst 120 tecken, köpet måste vara värt minst 10 kr, 24 timmars cooldown per kund och butik, och företagets ägare eller medlemmar får inte recensera. Snittet syns i butiken och räknas in i företagets betyg.
Varning: Kvarlämnade butiker
Upphör hyran av tomten eller marknadsplatsen blir butiken kvarlämnad: inga köp går att göra och den kan inte öppnas igen. Markens nya innehavare får riva skylten och öppna behållarna, och då tas butiken bort och företaget notifieras.
Kolla spelarbutikerna före servern
Spelarhandeln är huvudmarknaden. Säljer du en vara på Centrala marknaden och en butik inom 500 block betalar mer per styck får du en diskret upplysning i chatten med butik, pris och koordinater. /butik hitta <vara> och knappen [SPELARBUTIKER] i /marknad visar var det lönar sig bäst.
Dubbelklick gör inte dubbla köp
Varje köp och insälj har en idempotensnyckel och det finns ett dubbelklicksskydd per butik och kund. Trycker du två gånger snabbt får du meddelandet att ett köp redan pågår.
Marknadsplatser
Varning: Konkurs släpper platsen
Går företaget i konkurs eller avregistreras stängs dess butiker och marknadsplatserna släpps automatiskt.
Behållaren måste stå på samma plats som skylten
En butiks lagerbehållare måste stå på samma tomt eller marknadsplats som butiksskylten. Är butiker.krav_mark avslaget gäller i stället att behållaren ska stå inom butiker.behallare_avstand (10 block) från skylten.
Ohyrd plats är låst för alla utom admin
Ingen kan bygga, öppna behållare, använda hinkar eller tända eld på en plats som ingen hyr. Det gäller även om marken under är oclaimad spawnmark.
Centrala marknaden
Dygnsgränsen är din, prissänkningen är allas
Gränsen på till exempel 512 per dygn räknas per spelare. Den dynamiska prissänkningen räknas däremot på allt som sålts på hela servern samma dygn – säljer många vete samtidigt sjunker priset för alla. Båda nollställs vid dygnsskiftet.
Stora partier driver ner sitt eget pris
Priset räknas stegvis under själva försäljningen: säljer du 500 vete på en gång sjunker priset efter varje 64 stycken redan medan köpet pågår. Du tjänar alltså inget på att spara ihop och sälja allt vid ett tillfälle.
Varning: Sälj inte mynt
Mynt går inte att sälja på marknaden. Sätt in dem på banken i stället.
Varning: Marknadsvärde är inte uppköpspris
Raden Marknadsvärde: X kr i lore är ett riktvärde som bland annat används som prisförslag i butiker. Vad servern faktiskt betalar ser du med /marknad pris <vara>.
Ange varor på svenska eller Minecraft-namn
Både Järntacka och IRON_INGOT fungerar i /marknad pris och i adminkommandona.
Allt loggas
Alla adminåtgärder revisionsloggas i kategorin MARKET, och försäljningar över marknad.revision_over (10000 kr) loggas också.
Kontrakt
Läs villkoren, inte bara titeln
Villkorssidorna är avtalets innehåll: lön, hyra, tomtnummer, samhälle. Titeln på förstasidan är förkortad – håll muspekaren över den för att se hela.
Varning: Signeringen är i två steg
[SIGNERA] är inte klart. Först efter [ACCEPTERA AVTALET] är avtalet påskrivet. Ångrar du dig innan dess finns [ÅNGRA].
Varning: Avtal går ut
Ett erbjudande är giltigt i 48 timmar. Utgångna avtal städas bort automatiskt var femte minut och parterna får en notis. Samma jobb plockar också upp avtal som fastnat mitt i verkställandet efter en omstart.
Varning: Ett avtal som inte går att verkställa avbryts
Har förutsättningarna ändrats sedan avtalet skrevs – tomten är uthyrd till någon annan, företaget har inte plats kvar – markeras avtalet som återkallat och båda parterna meddelas.
Signaturer ger XP
Ett signerat kontrakt ger 400 XP mot spelarnivån, med ett dagstak på 2000 XP från den källan.
Historiken finns kvar
[Historik] i /kontrakt visar dina senaste 40 avtal med status, även avböjda och utgångna. Alla kontrakt revisionsloggas i kategorin CONTRACT.
Varning: Numret i boken är inte hela id:t
Raden Nr på avtalets förstasida är ett förkortat id. /kontrakt <id> kräver det fullständiga UUID:t – i praktiken öppnar du avtalet genom att klicka på det i listan eller i historiken.
Skyddade zoner och spawn
Servern har redan en zon som heter spawn
Den täcker 512 x 512 block över byn i världen nordguild (x 2560–3071, z 1024–1535) och går över hela höjden. Den har standardflaggorna, det vill säga ingen byggnation, inga behållare, ingen PvP, inga skador på djur eller bybor, ingen mobbspawn, inga projektiler, inga explosioner, ingen eld, ingen svält, ingen fallskada och ingen skada alls. Vill du ändra storleken gör du en ny markering och kör /zon storlek spawn. Enskilda regler ändrar du med /zon flagga spawn <flagga> <på|av>.
Markeringen är platt – höjden sätts separat
Både yxan och /zon hörn1 och /zon hörn2 sparar bara X och Z. Nya zoner får hela världens höjd (-64 till 320) och blir alltså en kolumn. Vill du ha ett tunnare skikt kör du /zon höjd efteråt. Samma sak vid /zon storlek: höjden behålls som den var.
Bypass gäller begränsningarna, inte skydden
En spelare med nordguild.admin.zon eller aktiv /claimbypass går förbi zonens begränsningar: bygg, behållare, interagera, pvp, skador, mobbspawn, projektiler och föremålstapp. De tre skydden svalt, fallskada och all_skada gäller alla, även administratörer. Ett skydd är ingen begränsning, och en admin i en skadefri spawnzon ska inte heller kunna dö där.
Bygg-flaggan skyddar även över zongränsen
Utan detta hade det räckt att stå utanför spawnzonen för att förstöra den. Kolvar får inte flytta block in i en byggskyddad zon utifrån, vätska får inte rinna in utifrån (inne i zonen flödar vatten och lava som vanligt) och dispensers får inte spruta hinkar, eld eller TNT över zongränsen. Att flytta något ut ur en zon är ofarligt och tillåts, och rörelser helt inom samma zon påverkas inte.
Inuti en claim vinner den strängaste regeln
Claim-bypass går alltid först. Därefter konsulteras zonen före ägarens policy, men zonens regel kan bara förbjuda, aldrig ge tillstånd: förbjuder zonen handlingen svarar den definitivt nej, annars lämnar den ingen åsikt och samhällets policy får avgöra. Inne i ett samhälles claim gäller alltså den strängaste av zonens och ägarens regel. Utanför alla claims frågar claim-systemet aldrig – där verkställer zonlyssnaren själv, och den ligger före claim-lyssnaren i händelsekedjan.
Överlappande zoner avgörs på prioritet
Högst prioritet vinner. Delar flera zoner den högsta prioriteten i samma punkt vinner den strängaste regeln – ett enda av räcker för att förbjuda. Så bygger du en PvP-arena mitt inne i spawnzonen: ge arenan högre prioritet och sätt pvp: på där.
Namngivna och tama djur städas aldrig
När mobbspawn är av stoppas naturlig spawn och spawnare, och en lätt uppgift går dessutom igenom världar som har minst en sådan zon och tar bort fientliga varelser som redan hunnit spawna eller vandrat in. Städningen rör bara fientliga varelser, och aldrig något som har namn eller ägare. Varje körning har en fast budget (zoner.stada_mobbar_max_entiteter) så den aldrig kan bli en världsskanning.
Alla zonändringar hamnar i revisionsloggen
Både zonändringar och /zon spawn sätt loggas under kategorin ADMIN och går att läsa med /revision kategori ADMIN. Zonmodulen rör aldrig ekonomin – den har varken källa eller sink.
Chatt, tab-lista och namnskyltar
Varning: Tab-huvudet är serverglobalt
Huvudet ritas en gång för alla spelare, så bara <server>, <online>, <max>, <tps>, <tps5>, <tps15> och <tpsfarg> har riktiga värden där. Skriver du en spelarberoende platshållare i huvudmallen visas det neutrala värdet – aldrig en annan spelares siffror. Alla andra mallar (chattraden, tab-raden, foten och namnskylten) är personliga och där fungerar samtliga platshållare.
Varning: tab.aktiv: false stänger även av namnskyltarna
Namnskyltarna använder samma scoreboard-team som tab-listans sortering. Sätter du chatt.tab.aktiv: false och kör /chatt ladda återställs spelarna till vanilla direkt: listnamn, huvud och fot nollställs och sorteringsteamen tas bort – och därmed försvinner namnskyltarna också. chatt.namnskylt.aktiv styr bara namnskylten när tab-listan är på, och satt till false töms prefix och suffix medan sorteringen behålls.
Så sorteras tab-listan
Spelarna grupperas efter samhälle – samhällena i bokstavsordning, spelare utan samhälle sist – och sorteras alfabetiskt inom gruppen. Grupperingen görs med en numrerad serie scoreboard-team på huvudscoreboarden som återanvänds, så det skapas aldrig nya team per uppdatering. Själva tab-raden sätts separat som listnamn, eftersom Minecraft använder listnamnet rakt av och inte lägger teamets prefix och suffix ovanpå.
Spelarnamn och meddelanden tolkas aldrig som MiniMessage
Skriver någon <red>hej eller en klickbar knapp i chatten visas det ordagrant. Det kan aldrig bli färg, hover eller ett kommando som körs. Länkar förblir vanlig text.
Tab-listan rör aldrig databasen
Uppdateringen körs på huvudtråden och läser enbart cachade värden. Saknas något, till exempel saldot direkt efter inloggning, visas chatt.neutralt_varde och värdet hämtas asynkront till nästa varv. Allt cachas per spelare och ritas om först när de underliggande värdena ändrats, så femtio spelare kostar i normalfallet noll MiniMessage-tolkningar per uppdatering.
Okända taggar lämnas som text
Skriver du fel på en platshållare i en mall syns den ordagrant i spelet. Kör /chatt test efter varje ändring så ser du direkt hur din egen rad blev.
Chatthändelsen avbryts aldrig
Formatet sätts som en ChatRenderer på AsyncChatEvent. Papers egna chattkanaler och mottagarlistor fungerar därför precis som förut. Kastar en krok ett undantag används det neutrala värdet, så chatten kan inte gå sönder av en trasig modul.
Administration
Säkerhetsvakterna straffar aldrig – de larmar
Vakterna skriver larm i konsolen och till alla online med nordguild.admin när ett konto får mer än inkomst_grans kronor via JOBB eller MARKNAD inom inkomst_fonster_minuter, eller när en ny SECURITY-post skrivs i revisionsloggen. Ingen automatisk bestraffning sker. Larmen skrivs själva som SECURITY-poster med prefixet [VAKT] och kan läsas med /ekonomiadmin larm eller /revision säkerhet. Vid start hoppas befintliga SECURITY-poster över, så gamla händelser larmar inte om.
Varning: ge och ta är till för support, inte för spel
ge och sätt uppåt är en admin-källa, ta och sätt nedåt samt makulering är en admin-sink. De syns tydligt i /ekonomiadmin penningmängd under typen ADMIN. Skriv alltid en anledning – den hamnar i revisionsloggen tillsammans med aktör, mål och belopp.
Belopp skrivs i kronor
Både 250 och 1 250,50 fungerar. Tab-komplettering föreslår alla giltiga mål.
Var åtgärderna hamnar i revisionsloggen
Alla ekonomiska adminåtgärder loggas i samma transaktion som själva flytten, under kategorin ADMIN med aktör, mål, belopp och anledning. Makulering av myntserier och vaktlarm loggas som SECURITY. Reload, export och backup loggas som ADMIN.
Modulernas egna adminkommandon ligger i sina egna kapitel
/claimbypass hör till claims, /jobbadmin till yrkena, /samhälleadmin till samhällen och mark, /marknadadmin till marknaden, /företagadmin till företagen och /butikadmin till butikerna. Adminboken länkar dit med knappar.
Ge någon administratörsrättigheter
Enklast är op <spelare>, som ger allt. Med LuckPerms blir det finkornigt: /lp user <spelare> permission set nordguild.admin true, /lp user <spelare> permission set nordguild.admin.ekonomi true, eller på en grupp med /lp group admin permission set nordguild.admin true. Kösystemets behörigheter (nordguild.ko.*) sätts på proxyn, inte på huvudservern.
Prestanda och drift
Varning: Underkommandot heter logg och det följer loggen
sudo mc logg paper öppnar en löpande vy som inte tar slut av sig själv – avsluta med Ctrl+C. Vill du bara kasta ett snabbt öga läser du logs/latest.log i serverns volym direkt i stället.
Varning: Stoppa alltid ordentligt
Använd stop, inte kill, så att världen och databasen hinner skrivas klart. kill finns för när servern har hängt sig och stop inte biter.
Bara ett par saker blockeras – med flit
Skyddet stoppar bara sådant en spelare kan upprepa i det oändliga: avel, kastade ägg, dispenserägg, spawnägg, handbyggda järnvarelser, snögubbar och koppargolem, botade bybor, ocelotungar och duplicering. Naturliga spawns, spawners, chunkgenerering, portaler och förvandlingar rörs aldrig. Avel avbryts så att ingen unge skapas, och kastade ägg kläcks helt enkelt inte.
Varning: Järnfarmar omfattas inte som standard
Järnvarelser som byn själv bygger har spawn-anledningen VILLAGE_DEFENSE, inte BUILD_IRONGOLEM. Gränsen IRON_GOLEM: 8 gäller därför i praktiken bara golem som en spelare staplar ihop för hand. Lägg till VILLAGE_DEFENSE i prestanda.anledningar om järnfarmar ska omfattas – det är ett spelbalansbeslut, inte en teknisk detalj.
Hinkutsläpp är utelämnat med flit
BUCKET (axolotl, fisk, grodyngel som hälls ut) står inte i listan. Hinken är redan tömd när händelsen når pluginet, så en blockering skulle förstöra spelarens fångade djur. Gränsen AXOLOTL: 15 gäller alltså inte hinkutsläpp.
Spelaren får alltid veta varför
När en spelares egen handling stoppas kommer en kort text i actionbaren, till exempel Här finns redan 20 hönor i den här chunken, strypt till högst en per spelare var meddelande_cooldown_sekunder. Vid avel och kastat ägg går meddelandet till spelaren i händelsen, vid spawnägg och golembyggen till närmaste spelare inom sex block. Fodret respektive ägget är redan förbrukat när händelsen når pluginet – därför tas föräldrarna samtidigt ur parningsläge, annars hade servern försökt para dem igen varje tick i upp till 30 sekunder. Spawns utan någon som väntar på svar, som dispenserägg och botade bybor, blockeras tyst.
Undantagen gäller bara räkningen
prestanda.rakna_tama: false och prestanda.rakna_namngivna: false gör att tama respektive namngivna djur inte räknas mot gränsen. Befintliga djur rörs aldrig och kan alltid flyttas dit ägaren vill, oavsett hur många som redan står i chunken.
Så larmar övervakningen
prestanda.overvakning mäter TPS, MSPT, minne, laddade chunkar och entiteter per värld var intervall_sekunder (standard 60) och larmar i konsolen, till online-adminer med nordguild.admin.prestanda och som revisionspost under kategorin ADMIN när 1-minuters-TPS understiger tps_larm (17) eller en värld har fler entiteter än entiteter_larm (8000). Samma larmtyp upprepas tidigast efter larm_cooldown_minuter. Modulen har inga ekonomiska flöden alls.
/prestanda är helt läsande
Kommandot ändrar aldrig världen, tar aldrig bort entiteter och rör varken ekonomin eller databasen. Skanningen körs med budget – prestanda.skanning_chunks_per_tick chunkar per tick – och resultatet återanvänds i prestanda.skanning_cache_sekunder sekunder, så flera samtidiga adminer ger bara en skanning.
Varning: Uppdatera pluginet
Ta backup först. Byt sedan jaren och starta om. Migrationerna körs automatiskt vid start, före modulerna – loggraden Databas ansluten (N migrationer kördes) visar hur många som var nya. Bara EN NordGuild-jar får ligga i plugins/, annars laddas den gamla eller båda. Ändringar i config.yml och sv.yml kräver ingen omstart, bara /nordguild reload, och nya nycklar fylls automatiskt på från jaren; databasinställningar och nya migrationer kräver full omstart. Kö-pluginen uppdateras på samma sätt, NordGuildKo på proxyn och NordGuildVantrum på väntrummet, och kön kan laddas om med /köadmin ladda. Rulla bara tillbaka till en äldre jar om inga nya migrationer kördes – har schemat ändrats måste databasen återställas från dumpen som togs före uppdateringen.
Startordning efter en omstart av hela maskinen
PostgreSQL först, sedan huvudservern och väntrummet, sist proxyn. Proxyn klarar att huvudservern är nere – kön går då i sondläge – men pluginet stänger av sig om databasen saknas.
Varning: Backup varje natt 03:15
Rutinen tar världarna och en pg_dump och sparar fjorton dagars historik. Snabba ögonblicksbilder inifrån spelet får du med /nordguild backup db och /nordguild export allt. Testa återställningen minst en gång – en backup du aldrig läst tillbaka är en förhoppning, inte en backup. Återställ alltid världarna och databasen från samma tidpunkt, annars kommer föremål i kistor och pengar i databasen i otakt.
Pluginets egna loggrader
De börjar med [NordGuild]. Ett modulfel vid start ser ut så här: Modul <namn> kunde inte aktiveras – stänger av pluginet. Det FÖRSTA felet i loggen är orsaken.
Kön
Sondläge när huvudservern är nere
Är huvudservern nere på grund av omstart eller krasch går kön i sondläge: ingen skickas dit, proxyn pingar servern var paus_efter_fel_sekunder sekund och släpper in igen så fort den svarar. Kickade spelare hamnar först i kön, i samma inbördes ordning som de hade.
Kön kan laddas om utan omstart
/köadmin ladda läser om config.yml på proxyn och behåller kön. /köadmin max <n> skriver dessutom tillbaka det nya värdet till filen, så det överlever en omstart.
Varning: Kösystemets behörigheter sätts på proxyn
nordguild.ko.prioritet, nordguild.ko.bypass och nordguild.ko.admin måste sättas i LuckPerms på Velocity, inte på huvudservern. Sätter du dem på Paper händer ingenting. Konsolen på proxyn får alltid köra /köadmin.
Ljudet kräver att väntrumspluginet finns
Ljudet vid insläpp skickas som ett pluginmeddelande på kanalen nordguild:ko till väntrumsservern, som spelar det. NordGuildVantrum måste alltså vara installerat där.
Bara /kö fungerar i väntrummet
Alla kommandon utom de i tillatna_kommandon blockeras, och den som försöker får ett besked. Undantaget är spelare med nordguild.vantrum.admin, som får bygga och köra kommandon som vanligt.
Webb-API
API:t är avstängt tills hemsidan byggs
webb.aktiv står på false i plugins/NordGuild/config.yml. Ingen port öppnas och ingen data lämnar servern förrän du sätter det till true, kör /nordguild reload och eventuellt /webb starta.
Varning: Lyssnaren ska inte nås utifrån
Håll bind på 127.0.0.1 och låt nginx stå framför. Ska något annat än nginx på samma maskin nå API:t sätter du webb.token och kräver Bearer-token på varje anrop.
Så ser svaren ut
Allt är application/json med utf-8. Pengar levereras både som heltal öre i <nyckel>_ore och som färdig svensk sträng i <nyckel> – räkna alltid på _ore. Tider kommer som ISO-8601 i UTC plus ett svenskt datum i <nyckel>_datum. Nycklarna är svenska utan diakritiska tecken, till exempel samhalle, niva och foretag. Svaren sätter Cache-Control enligt cache_sekunder (felsvar no-store), tillåter CORS från alla ursprung för GET och OPTIONS, och skickar X-Content-Type-Options: nosniff.
/api svarar som /api/status
Avslutande snedstreck spelar ingen roll.
Start och stopp revisionsloggas
Både /webb starta och /webb stoppa hamnar i revisionsloggen under kategorin ADMIN. /nordguild reload startar också om API:t med de nya inställningarna.