Zum Hauptinhalt springen

Shop-System

EliteMobs bringt ein integriertes Shop-System mit, mit dem Spieler Elite-Münzen (die EliteMobs-Währung) für EliteMobs-Ausrüstung und Pfeile ausgeben und verdienen können. Auf die Shops wird normalerweise über Schmied- und Händler-NPCs in der Abenteurergilde zugegriffen, sie können aber auch mit Befehlen geöffnet werden.

Wirtschaftseinstellungen

Lass enableEconomy: true in EconomySettings.yml für die normale Shop-Nutzung aktiviert. Die Einstiegsmenüs des dynamischen und des Custom-Shops prüfen diese Einstellung; direkte Adminbefehle und die Verkaufs- und Pfeil-NPCs prüfen sie jedoch nicht auf dieselbe Weise. Sie ist keine allgemeine Zugriffssperre. Mit funktionierender Vault-Integration verwenden Guthaben den Vault-Anbieter statt der EliteMobs-Währungsdatenbank.

Währung​

Die Standardwährung heißt Elite-Münzen (currencyName in EconomySettings.yml). Spieler verdienen sie hauptsächlich durch das Töten von Elites (Währungsregen) und durch den Verkauf von EliteMobs-Beute. Guthaben können mit den Standard-Geldbefehlen geprüft und bezahlt werden:

  • /em money check – prüfe dein Guthaben (es gibt keinen Befehl /em wallet; einige Konfigurationskommentare verwenden noch diesen alten Namen)
  • /em pay <player> <amount> – bezahle einen anderen Spieler (unterliegt playerToPlayerPaymentTaxes)

Admins können Guthaben mit /em money add|remove|set und Verwandten verwalten.

Die Shops​

Dynamischer Shop (prozedural generierte Ausrüstung)​

Verwende /em shop dynamic oder sprich mit dem Schmied-NPC (elitemobs.shop.dynamic.npc). Der Spielerbefehl leitet zur Gilde weiter, wenn agTeleport aktiviert und die Gilde installiert ist und der Spieler elitemobs.adventurersguild.teleport besitzt. Andernfalls öffnet er das Kauf-oder-Verkauf-Menü. Der NPC öffnet dieses Menü direkt.

Der dynamische Shop verwendet die konfigurierten Angebotsplätze eines Menüs mit 54 Plätzen für prozedurale EliteMobs-Waffen und -Rüstungen. Die Stufen richten sich nach deiner Skill-Stufe für diesen Gegenstandstyp: Jeder Gegenstand wird zwischen (skillLevel - 5) und skillLevel im Bereich 1–100 ausgewürfelt. Ab Skill-Stufe 105 haben alle Angebote dieses Skills Stufe 100. Materialien ohne passenden Skill verwenden die Stufe aus deinen durchschnittlichen Erfahrungspunkten über alle Skill-Typen.

  • Klicke einen Gegenstand an, um ihn zum berechneten Wert zu kaufen. Du brauchst genügend Guthaben, einen leeren Lagerplatz und musst die geltende Skill-Anforderung zum Anlegen des Gegenstands erfüllen. Die Prüfung berücksichtigt die Einstellung für Ausrüstungsbeschränkungen und deren Ausnahmen, darunter Gegenstände bis einschließlich Stufe 20.
  • Verwende die Neu würfeln-Schaltfläche, um das angebotene Sortiment zu aktualisieren (kurze 2-Sekunden-Abklingzeit).
  • Auch ein Kauf erneuert das Sortiment.

Custom-Shop (besondere Gegenstände)​

Verwende /em shop custom oder sprich mit dem Spezial-Schmied-NPC (elitemobs.shop.custom.npc). Der Spielerbefehl folgt derselben Gildenweiterleitung wie der dynamische Shop; der NPC öffnet das Kauf-oder-Verkauf-Menü direkt.

Der Custom-Shop wählt zufällige Einträge aus den zulässigen Custom Items. itemType: CUSTOM ist zulässig; UNIQUE, DROPPABLE und CLASS_LOOT sind ausgeschlossen. Angebotene Kopien werden an den Käufer seelengebunden, wenn Seelenbindung aktiviert ist. Behalte mindestens einen zulässigen Gegenstand: Die aktuelle Auswahl kann kein leeres Sortiment befüllen.

Käufe benötigen genügend Guthaben und einen leeren Lagerplatz. Dieses Menü verwendet die Skill-Prüfung des dynamischen Shops nicht; ein erfolgreicher Kauf bedeutet daher nicht, dass der Spieler den Gegenstand anlegen kann. Neu würfeln hat 2 Sekunden Abklingzeit; Käufe erneuern das Sortiment ebenfalls.

Gegenstände verkaufen​

Das Verkaufen wird über die Verkaufen-Option des Kauf-oder-Verkauf-Menüs erreicht (nach dem Öffnen des dynamischen oder Custom-Shops) oder direkt von einem Admin mit /em shop sell <player> (elitemobs.shop.sell.other). Der Verkaufs-Schmied-NPC verwendet die Berechtigung elitemobs.shop.sell.npc.

Im Verkaufsmenü:

  • Klicke EliteMobs-Gegenstände in deinem Inventar an, um ihre Stapel in die Verkaufsplätze zu verschieben. Ungebundene und an dich gebundene Gegenstände werden akzeptiert. Vanilla-Gegenstände und an andere Spieler gebundene Gegenstände werden abgelehnt; für die Bindung gelten eine deaktivierte Prüfung oder eine Umgehungsberechtigung als Ausnahme.
  • Die Bestätigungs-Schaltfläche zeigt die laufende Summe an. Klicke sie an, um alles zu verkaufen und Elite-Münzen zu erhalten.
  • Der Wiederverkaufswert ist ein Anteil des gespeicherten Gegenstandswerts oder, wenn dieser fehlt, des berechneten Werts. itemResaleValue in EconomySettings.yml legt ihn fest (Standard 5 %). Die Stapelgröße multipliziert die Auszahlung.
  • Verkaufserlöse begleichen zuerst offene Spielschulden; nur der Rest erhöht das verfügbare Guthaben.
  • Jeder Stapel wird einzeln gutgeschrieben. Lehnt der Wirtschaftsanbieter eine Gutschrift ab, erhältst du diesen Stapel zurück, der Verkauf stoppt und shopTransactionFailedMessage wird angezeigt. Bereits zuvor gutgeschriebene Stapel bleiben verkauft.

Pfeil-Shop​

Geöffnet durch Sprechen mit dem Pfeil-Shop-NPC (elitemobs.shop.arrow.npc).

Der Pfeil-Shop verkauft Munition für Elite-Münzen. Das Standardsortiment umfasst:

  • Normale Pfeile (ein kleiner Stapel und ein großer Stapel)
  • Spektralpfeile
  • Getränkte Pfeile mit Gift, Langsamkeit, Schwäche, Schaden und Heilung

Menge und Preis jedes Eintrags stehen in menus/arrow_shop_menu.yml. Klicke einen Pfeil zum Kaufen an; du brauchst genügend Guthaben und einen leeren Inventarplatz, selbst wenn die Pfeile anderswo stapelbar wären. Die Angebotsplätze sind in der Implementierung festgelegt. Starte nach Änderungen an Preisen, Mengen oder Artikelnamen neu: Der Katalog wird beim ersten Laden der Menüklasse zwischengespeichert.

Befehle und Berechtigungen​

BefehlBerechtigungStandardBeschreibung
/em shop dynamicelitemobs.shop.dynamictrueÖffnet das Einstiegsmenü des dynamischen Shops oder fordert eine Gildenteleportation an
/em shop procedural <player>elitemobs.*opÖffnet den dynamischen (prozeduralen) Shop für einen anderen Spieler
/em shop customelitemobs.shop.commandnur im CodeÖffnet das Einstiegsmenü des Custom-Shops oder fordert eine Gildenteleportation an; vergib bei Bedarf diese tatsächlich geprüfte Berechtigung statt des deklarierten, ungenutzten elitemobs.shop.custom
/em shop custom <player>elitemobs.shop.custom.otheropÖffnet den Custom-Shop für einen anderen Spieler
/em shop sell <player>elitemobs.shop.sell.otheropÖffnet das Verkaufsmenü für einen anderen Spieler

NPC-Interaktionsberechtigungen (Spielern standardmäßig über das elitemobs.user-Bündel gewährt):

BerechtigungNPC
elitemobs.shop.dynamic.npcSchmied (dynamischer Shop)
elitemobs.shop.custom.npcSpezial-Schmied (Custom-Shop)
elitemobs.shop.sell.npcGegenstände verkaufen
elitemobs.shop.arrow.npcPfeil-Shop

Konfiguration​

Die Shop-Wirtschaft wird in EconomySettings.yml konfiguriert. Bemerkenswerte Schlüssel:

SchlüsselStandardWirkung
enableEconomytrueAktiviert normale Wirtschaftseinstiege; sperrt nicht jeden direkten Shop-Zugriff
currencyNameElite CoinsAnzeigename der Währung
useVaultfalseLeitet Guthaben über Vault anstelle der EliteMobs-Datenbank
itemResaleValue5Prozentsatz des vollen Gegenstandswerts, der beim Verkauf gezahlt wird
playerToPlayerPaymentTaxes0.2Steuersatz (0.0–1.0), der auf /em pay-Überweisungen angewendet wird (0.2 = 20 %)
enableCurrencyShowertrueOb Elite-Mobs beim Tod Münzen fallen lassen
currencyShowerTierMultiplier1.0Multiplikator für fallengelassene Währung (2.0 = doppelte Menge)
materialWorth.defaultMaterialWorth1Wert für jedes Material ohne eigenen Eintrag materialWorth.<MATERIAL>

Die Einträge materialWorth.<MATERIAL> verwenden feste Standardwerte aus den Materialstufen des Plugins: Netherit 18, Diamant und Dreizack 17, Eisen 16, Stein und Kettenrüstung 15 sowie Gold, Holz und Leder 13. Diese Stufen sind Konstanten und keine Konfigurationseinstellungen. Ändere die einzelnen materialWorth-Einträge in EconomySettings.yml, um die Shoppreise festzulegen.

Die Menülayouts (Slots, Gegenstandssymbole, Namen und Nachrichten) für jeden Shop befinden sich in den Menü-Konfigurationsdateien von EliteMobs (zum Beispiel die Menükonfigurationen für Kauf-oder-Verkauf, Custom-Shop, prozeduralen Shop, Verkauf und Pfeil-Shop).

Der berechnete Kaufwert setzt sich aus Material, Verzauberungen und Trankeffekten mit einem Grundwert von 1 zusammen. Bereits gespeicherte Wiederverkaufswerte können deshalb nach Preisänderungen von neu berechneten Kaufpreisen abweichen.

Bei jedem Kauf wird zuerst der Preis abgebucht; den Gegenstand gibt es erst, nachdem der Wirtschaftsanbieter die Zahlung akzeptiert hat. Lehnt der Anbieter die Zahlung ab, erhält der Spieler die Meldung über unzureichendes Guthaben, und nichts wird ausgegeben. Scheitert die Transaktion mittendrin, sieht der Spieler shopTransactionFailedMessage, und das Serverlog hält Preis, Annahme der Abbuchung und Gegenstand fest, damit ein Administrator den Fall klären kann.