Administration
Adminskiktet är serverägarens verktygslåda: adminboken /admin som samlar allt på ett ställe, /nordguild för reload, version, hälsa, export och backup, /ekonomiadmin för allt som rör pengar, /revision för revisionsloggen och /inspektera för en fullständig bild av en enskild spelare. Här ligger också säkerhetsvakterna, den dagliga penningmängds-ögonblicksbilden och den veckovisa bankavgiften. Alla ekonomiska adminåtgärder revisionsloggas i samma transaktion som själva flytten, så det finns aldrig en rättelse utan spår.
Rutin vid misstänkt dupe
Gör i den här ordningen. Målet är att stoppa flödet först och utreda sedan.
Frys ekonomin
Inga betalningar går igenom förrän du tinar – bara ADMIN-flyttar fungerar. Inställningen skrivs till config.yml och överlever både reload och omstart, och alla online meddelas.
/ekonomiadmin frys ekonomiTa en backup direkt
Både databas och världar, så bevisen finns kvar. Vill du ha en snabb dump inifrån spelet kör du /nordguild backup db.
sudo mc backupLäs säkerhetsloggen och larmen
Dupe-försök, förfalskade mynt, makuleringar och vaktlarm. Komplettera med /ekonomiadmin larm 20 för vakternas senaste larm och trösklar.
/revision säkerhet 50Se var pengarna kom ifrån
Skapat och förstört per transaktionstyp – vilken källa sticker ut? Kör /ekonomiadmin trend 14 för penningmängden dag för dag.
/ekonomiadmin penningmängd 7Följ pengarna
Stora flyttar de senaste två dygnen. Gräv vidare med /ekonomiadmin transaktioner <mål> 50 och /inspektera <spelare>.
/ekonomiadmin sök --dagar=2 --min=10000Kontrollera mynten
Utfärdade serier, inlösta och i omlopp. Misstänkta serier makuleras med /ekonomiadmin mynt makulera <serie-id> [anledning] – det förstör den utestående täckningen i reserven och loggas som SECURITY. Dupade mynt är redan värdelösa: antalet inlösta kan aldrig överstiga antalet utfärdade.
/ekonomiadmin mynt <spelare>Rätta och tina
Skriv alltid en anledning – den hamnar i revisionsloggen. Frys enskilda konton med /ekonomiadmin frys <mål> om utredningen fortsätter. Är buggen i pluginet: laga, bygg och uppdatera först, och kör /ekonomiadmin tina ekonomi allra sist.
/ekonomiadmin sätt <mål> <belopp> <anledning>Efteråt
Skriv ner vad som hände och sänk vid behov trösklarna i admin.vakter (inkomst_grans, inkomst_fonster_minuter) så larmet kommer tidigare nästa gång.
Kommandon
Hjälptext.
Läser om config.yml och sv.yml och kallar reload() på varje modul, var för sig så att ett fel inte stoppar de andra. Rapporterar vad som lästes om, hur lång tid det tog och eventuella fel. Revisionsloggas.
Pluginversion, serverversion, Minecraft-version, Java och antal moduler.
Databasping, senaste migrering, online, TPS för 1 och 5 minuter, MSPT, minne, upptid, om ekonomin är fryst, olevererade myntserier, vakternas inställning, cache-storlekar (samhällen, företag, yrken, marknadsvärden, uppköpslista, claims) och alla schemalagda jobb i scheduled_runs med senaste och nästa körning.
/nordguild export ekonomi [dagar]Skriver plugins/NordGuild/export/ekonomi-<datum>.json med alla konton (typ, ägare, namn, saldo, fryst), transaktioner de senaste N dagarna (standard admin.export.standard_dagar, 30, tillåtet 1 till 3650), penningmängd och ögonblicksbilder. Körs asynkront och svarar med sökväg, storlek och antal rader per tabell. Revisionsloggas.
/nordguild export allt [dagar]Som ovan plus samhällen, medlemmar, tomter, claims, företag, företagsmedlemmar, anställningar, kontrakt, marknadsvärden, uppköpslista, yrken och spelare. Filen heter allt-<datum>.json och är avsedd för backup eller hemsida.
Listar de exportfiler som redan finns, med katalogen och som mest 15 filnamn.
Kör pg_dump (binären anges i admin.backup.pg_dump, lösenordet skickas via miljövariabeln PGPASSWORD och aldrig på kommandoraden) och skriver plugins/NordGuild/backup/nordguild-<datum>.dump i custom-format. Körs alltid asynkront. Saknas binären ges ett tydligt fel. Revisionsloggas.
/inspektera <spelare>En bok med allt om spelaren: status, saldo och fryststatus, mynt i inventariet om hen är online, yrke, nivå och intjänat idag mot dagstaket, samhälle, roll och medlem sedan, tomter, ägda företag, anställningar med lön och obetalt, väntande kontrakt, kontonummer, första och senaste besök, speltid och myntserier. Knappar för de tio senaste transaktionerna och revisionsposterna, samt en åtgärdssida med förslag på frys, tina, ge, ta, sätt, myntserier, yrkesinfo och revision. Målet måste vara en spelare.
Adminboken. Översikt över online, penningmängd på konton och i reserven, samhällen, företag med anställda, aktiva kontrakt, om ekonomin är fryst, olevererade myntserier och de senaste SECURITY-händelserna. Menyknappar kör eller föreslår adminkommandona: EKONOMI (undermeny med penningmängd, topplista, trend, larm, saldo, ge, ta, sök, mynt och frys eller tina ekonomin, de två sista bakom en bekräftelse), REVISION, SAMHÄLLEN till /samhälleadmin lista, FÖRETAG till /företagadmin lista, MARKNAD till /marknadadmin lista, YRKEN till /jobbadmin statistik, BUTIKER till /butikadmin statistik, CLAIM-BYPASS och INSPEKTERA. Systemsidan har HÄLSA, RELOAD (med bekräftelse), EXPORT EKONOMI, EXPORT ALLT, BACKUP DB, VERSION och UPPDATERA som ritar om boken.
Hjälptext.
/ekonomiadmin saldo <mål>Saldo, kontonummer och fryststatus.
/ekonomiadmin ge <mål> <belopp> [anledning]Skapar pengar till kontot (server till konto, transaktionstyp ADMIN). Spelaren notifieras.
/ekonomiadmin ta <mål> <belopp> [anledning]Förstör pengar från kontot. Nekas vid otillräckligt saldo.
/ekonomiadmin sätt <mål> <belopp> [anledning]Justerar kontot till exakt det saldot med EN administrativ flytt – mellanskillnaden skapas eller förstörs. Svaret visar både före och efter.
/ekonomiadmin överför <från> <till> <belopp> [anledning]Flyttar pengar mellan två konton utan avgift, som typen ADMIN.
/ekonomiadmin frys <mål>Fryser ett konto: inga flyttar vare sig till eller från. Spelaren notifieras.
/ekonomiadmin tina <mål>Tinar ett fryst konto igen.
Fryser hela ekonomin – bara ADMIN-flyttar går igenom. Uppdaterar ekonomi.fryst i config så det överlever reload och omstart. Alla online meddelas.
Tinar hela ekonomin igen.
/ekonomiadmin transaktioner <mål> [antal]Senaste transaktionerna med datum, belopp med tecken, typ och motpart. Hovern visar id, beskrivning och avgift. Standard 15 rader, som mest 100.
/ekonomiadmin sök [--typ=LON] [--från=<mål>] [--till=<mål>] [--min=<kr>] [--dagar=7] [--antal=100]Söker transaktioner med filter, senaste först. Flaggorna får också skrivas på engelska: --kind, --from, --to, --days, --limit. Som mest 100 rader.
/ekonomiadmin penningmängd [dagar]Hur mycket som finns på konton, i myntreserven, totalt skapat och förstört, netto samt per transaktionstyp de senaste N dagarna: källor (skapat), sinks (förstört och avgifter), volym och antal.
/ekonomiadmin topp [antal]Rikaste konton per ägartyp: spelare, företag och samhällen.
/ekonomiadmin trend [dagar]Daglig penningmängd ur economy_snapshots: på konton, i reserv, netto skapat, aktiva spelare senaste dygnet, transaktioner per dygn och förändring.
/ekonomiadmin mynt <spelare>Myntserier som utfärdats till spelaren med serie-id, antal per valör, inlösta och status, plus en summering av utfärdat, inlöst, makulerat och i omlopp. Knappen föreslår makulering.
/ekonomiadmin mynt makulera <serie-id> [anledning]Makulerar en levererad myntserie, förstör den utestående täckningen ur reserven och notifierar spelaren. Loggas som SECURITY. En redan makulerad serie och olevererade serier vägras – de senare levererar eller återbetalar valutamodulen automatiskt.
Tvingar bankavgiftskörningen att köra nu i stället för på sin schemalagda tid.
/ekonomiadmin larm [antal]Senaste vaktlarmen (SECURITY-poster med prefixet [VAKT]) samt vakternas nuvarande trösklar.
Hjälptext.
/revision senaste [antal]Senaste posterna ur alla kategorier, med klickbar paginering i chatten, åtta per sida. Standard 20 poster, som mest 200.
/revision kategori <ECONOMY|COMPANY|SETTLEMENT|CLAIM|CONTRACT|JOB|SHOP|MARKET|ADMIN|SECURITY> [antal]Poster i en enskild kategori. Standard 20 poster, som mest 200.
/revision säkerhet [antal]Samma som kategori SECURITY: dupe-försök, förfalskade mynt, makuleringar och vaktlarm. Visas i mörkrött.
/revision spelare <namn> [antal]Poster där spelaren är aktör.
/revision sök <text> [antal]Fritextsökning i meddelande, mål och aktörsnamn. Avslutar du med en siffra tolkas den som antal.
/revision bok [kategori]Bokvy med kategorimeny och paginerad lista över de 60 senaste posterna.
Växlar bypass av allt claim-skydd på och av för dig själv. Går även förbi zonernas begränsningar, men inte deras skydd. Loggas i revisionsloggen under kategorin CLAIM.
Inställningar under admin: i config.yml
| Nyckel | Vad den styr | Standard |
|---|---|---|
| snapshot_klockslag | Klockslag för den dagliga ögonblicksbilden av penningmängden (tabellen economy_snapshots, jobbet ekonomisnapshot). | 04:00 |
| bankavgift.veckodag | Veckodag för den veckovisa bankavgiften (jobbet bankavgift). MONDAY till SUNDAY. Beloppen står under ekonomi.bankavgift. | MONDAY |
| bankavgift.klockslag | Klockslag för bankavgiften. | 05:00 |
| vakter.aktiv | Om säkerhetsvakterna är igång. | true |
| vakter.intervall_sekunder | Hur ofta vakterna tittar. | 30 |
| vakter.inkomst_grans | Larma när ett konto tagit emot mer än så här många kronor via JOBB eller MARKNAD inom fönstret. | 5000 |
| vakter.inkomst_fonster_minuter | Fönstrets längd. | 10 |
| vakter.larm_cooldown_minuter | Samma konto larmas inte oftare än så här. | 30 |
| vakter.sakerhetslogg | Larma även när en ny SECURITY-post skrivs i revisionsloggen. | true |
| export.standard_dagar | Standardantal dagar transaktioner i /nordguild export ekonomi. | 30 |
| backup.pg_dump | Sökväg till pg_dump. Bara namnet om den ligger i PATH. | pg_dump |
Mål som går att ange i /ekonomiadmin och /revision spelare
| Form | Betyder |
|---|---|
| spelarnamn | En spelare, online eller offline. |
| företag:Namn | Ett företag med namn. |
| SE-000012 | Ett konto med kontonummer. |
| samhälle:Namn | Ett samhälles konto. |
| server | Statskassan. |
| reserv | Myntreserven. |
Bra att veta
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.