CityShops
- By
CityShops is a Minecraft Forge 1.20.1 chest shop and economy mod for multiplayer servers and SMPs. Create player shops and admin shops, build companies and branches, manage employees and run your business through the interactive Business OS.
Screenshot 2026-09-16 124526.png
Description
🇩🇪 Deutsch
🏙️ Teil der City-Mod-Serie
Du baust eine richtige Stadt in Minecraft?
Dann schau dir auch CityRegion an!
CityRegion erweitert deine Welt um ein umfangreiches Immobilien- und Grundstückssystem mit geschützten Grundstücken, Kaufen & Verkaufen, Vermietung, Auktionen, Wohnungen, Vermietern und vielem mehr.🏠 CityRegion auf CurseForge:
CityRegion - Minecraft Mods - CurseForgeCityShops + CityRegion – Shops, Unternehmen und Immobilien für deine Minecraft-Stadt.
🇬🇧 English
🏙️ Part of the City Mod Series
Building a real city in Minecraft?
Then check out CityRegion!
CityRegion expands your world with a complete real estate and property system, including protected properties, buying & selling, renting, auctions, apartments, landlords and much more.🏠 CityRegion on CurseForge:
CityRegion - Minecraft Mods - CurseForgeCityShops + CityRegion – Shops, businesses and real estate for your Minecraft city.
======================================================================
ENGLISH
======================================================================
SHORT DESCRIPTION
CityShop is a feature-rich sign-based chest shop mod for Minecraft Forge. Players can run sell and buy shops, create companies with shared shops and business bank accounts, and manage their stores through a placeable Shop Computer. Admin shops use unlimited stock and MineBank's state treasury. Statistics, transaction history, ratings, a public market overview, charts, double chests and hopper automation are included.
REQUIRED DEPENDENCIES
- Minecraft 1.20.1
- Minecraft Forge 47.4.10 or newer for Minecraft 1.20.1
- Java 17
- MineBank 1.0.2 or newer
MineBank is mandatory. CityShop uses MineBank for player accounts, business accounts and the state treasury. CityRegion, CityJobs and CityPolice are not required by CityShop.
INSTALLATION
1. Install Minecraft Forge for Minecraft 1.20.1 (Forge 47.4.10 is recommended).
2. Put MineBank and CityShop into the mods folder of the same CurseForge instance.
3. MineBank and CityShop must be installed on the server and on every connecting client.
4. Restart Minecraft or the server.
5. Create or use a MineBank account before trading with player shops.
CREATING A SHOP
1. Place a single chest or double chest.
2. Sneak and attach a sign directly to the chest.
3. Put the desired item into the top-left chest slot. CityShop automatically uses the translated item name instead of an ID such as minecraft:stone.
4. Write one of the sign layouts below.
5. Right-click the sign to register the shop.
6. Stock a sell shop with items, or provide sufficient money and free chest space for a buy shop.
The second line is the amount traded per click. An amount of 16 means that every transaction trades 16 items. It is not a lifetime or stock limit.
PLAYER SELL SHOP
Line 1: [Verkauf]
Line 2: 16
Line 3: empty
Line 4: 5,00
[Shop] is also accepted as a sell shop. Customers pay the displayed total price and receive the configured item amount on every right-click. Revenue is deposited into the owner's account or the associated business account.
PLAYER BUY SHOP
Line 1: [Ankauf]
Line 2: 16
Line 3: empty
Line 4: 3,00
The shop owner buys the configured amount from the interacting player on every click. Items are placed into the chest. Payment comes from the owner's account or the associated business account. Trading stops if items, money or chest space are missing.
ADMIN SELL SHOP
Line 1: [AdminVerkauf]
Line 2: 16
Line 3: empty
Line 4: 5,00
[AdminShop] is also accepted as an admin sell shop. Only operators can register admin shops. Stock is unlimited. Player payments are collected into MineBank's state treasury. The creator can also buy from the shop normally.
ADMIN BUY SHOP
Line 1: [AdminAnkauf]
Line 2: 16
Line 3: empty
Line 4: 3,00
The admin shop accepts the player's items and pays the player from MineBank's state treasury. Purchased items do not have to remain in the chest.
IMPORTANT SHOP RULES
- Only one shop can be attached to a single or double chest: buy or sell.
- A chest cannot buy and sell at the same time. This prevents instant resale exploits.
- Both halves of a double chest share one inventory and one shop registration.
- Shop chests and linked rating signs are protected against unauthorized access.
- Operators retain administrative access but can still trade normally at shops.
- Owners can sneak-right-click their own shop to test it without a second player. Test trades do not move money.
COMPANIES AND EMPLOYEES
Each player can belong to one company. A company may own any number of shop chests. Existing personal player shops are adopted when the company is created, and new shops created by company members are assigned automatically. All company shops share the company name and business account.
- /company create <Name> – create a company and MineBank business account
- /company rename <New Name> – rename the company and loaded company shop signs
- /company info – display company name, employee count and business balance
- /company add <Player> – add an online employee
- /company remove <Player> – remove an employee
- /company leave – leave as an employee
- /company claim – manually assign an existing personal shop to the company
- /company deposit <Amount> – transfer personal money to the business account
- /company withdraw <Amount> – withdraw money as the company owner
Employees can manage company chests and see shared shops in the Shop Computer. Only the owner can manage employees, rename the company and withdraw company money. The owner cannot simply leave the company.
RATINGS AND SHOP NAMES
After a real transaction, a customer can rate a shop or company from 1 to 5 stars. Owners and company members cannot rate their own business.
Linking a personal shop:
1. Place a sign anywhere with [Bewertung] on the first line.
2. Run /chestshop link.
3. Click your shop.
4. Click the rating sign.
For a company, its owner can place and right-click a [Bewertung] sign. It links to the company automatically.
Right-clicking a rating sign opens a clickable 1-to-5-star selection in chat. For security, the selection expires quickly and only works near the sign. Owners can also start renaming from this menu.
- /chestshop name <Name> – then click your own shop to name it
- /chestshop rate <1-5> – alternative command-based rating; then click the shop
DONATION SIGNS
Donation signs work without a chest. Place a sign anywhere, write one of the layouts below and right-click it once to register it.
Player or company donation:
Line 1: [Spende]
Line 2: empty
Line 3: empty
Line 4: 10,00
Every right-click donates the configured amount. If the creator belongs to a company, the money is transferred to its MineBank business account. Otherwise it is transferred to the creator's personal account. The sign displays the total amount collected.
State treasury donation:
Line 1: [AdminSpende]
Line 2: empty
Line 3: empty
Line 4: 10,00
Only operators can create this sign. Donations are deposited directly into MineBank's state treasury. No chest or stored items are required.
PLAYER-RUN LOTTERIES
Lottery signs also work without a chest. The creator must own or belong to a MineBank company with the CityShop lottery license. The license can be purchased through the Shop Computer's Business OS.
Line 1: [Lotterie]
Line 2: empty
Line 3: empty
Line 4: 10,00
The fourth line defines the stake for one play. Right-click the completed sign once to register it. Customers then right-click the sign to play.
Winning chances:
- 70%: no prize
- 20%: half of the stake
- 8%: twice the stake
- 2%: five times the stake
The stake is paid into the company's MineBank business account and prizes are paid from that account. The company must always be able to cover the maximum five-times prize. Company members cannot play their own lottery. The sign displays the number of games played.
SHOP COMPUTER AND BUSINESS OS
The placeable Shop Computer features a custom textured 3D model. Right-clicking it opens the dedicated CityShop Business OS instead of a standard chest menu.
The dashboard includes:
- company name, business balance and the player's company role
- overview of personal and company shops
- shop and company statistics
- branches
- employees and company roles
- combinable business licenses
- license purchases paid directly from the MineBank business account
- public market reports based on real CityShop prices
- production analysis
- scrollable lists for any number of entries
- a visible scrollbar
- custom first-person, third-person, inventory, ground and item-frame display
The market overview intentionally does not teleport players directly to shops.
SHOP COMPUTER RECIPE
Iron Ingot | Glass Pane | Iron Ingot
Iron Ingot | Redstone | Iron Ingot
Iron Ingot | Comparator | Iron Ingot
HOPPERS AND AUTOMATION
- Hoppers can automatically refill sell chests.
- Hoppers can automatically empty buy chests.
- Only the registered shop item counts as tradable stock.
- Accidentally inserted unrelated items are ignored by the shop system.
STATISTICS, HISTORY AND INACTIVITY
- Every real trade permanently records transaction count, item volume and turnover in the world.
- The latest 50 transactions are retained per shop.
- Offline owners receive a summary of sales and purchases on their next login.
- /chestshop stats displays personal trading statistics.
- /chestshop history is an operator command; run it and then click the shop sign to inspect.
- Player shops are disabled after 168 hours of owner inactivity by default. Chests and items are not deleted.
- Configure this duration through inactiveHours in serverconfig/chestshop-server.toml.
- Admin shops remain active.
- Removed shops are automatically cleaned from statistics and the Shop Computer.
SERVER OWNER NOTES
Back up the world before updates, as with any server-side economy mod.
- Always install mutually compatible CityShop and MineBank versions.
- Remove duplicate old JAR versions from the mods folder.
- Admin sell shops collect money into the state treasury; admin buy shops pay from it. The treasury therefore needs sufficient funds for purchases.
- CityShop stores shop, company, rating and statistics data server-side in the world.
CityShop 2.1.4 – Business OS Update
This major update transforms CityShop into a complete player-driven business and economy system.
Highlights:
- New custom CityShop Business OS
- MineBank business account and state treasury integration
- Companies, branches, employee roles and combinable licenses
- Company statistics, market reports and production analysis
- Scrollable shop and business overviews
- Improved shop computer with a completely new 3D model
- Correct inventory, first-person, third-person, ground and item-frame display
- Player and admin buy/sell shops
- Double chest and hopper support
- Shop ratings, histories and inactivity handling
- Numerous fixes and usability improvements
Requires MineBank 1.0.2 or newer.
Remove older CityShop JAR files before installing.
======================================================================
CURSEFORGE LINKS
======================================================================
Required dependency / Pflichtabhängigkeit:
======================================================================
DEUTSCH
======================================================================
KURZBESCHREIBUNG
CityShop ist ein umfangreicher, schildbasierter Kistenshop-Mod für Minecraft Forge. Spieler können eigene Verkaufs- und Ankaufsshops betreiben, Firmen mit gemeinsamen Shops und Firmenkonten gründen und ihre Geschäfte über einen platzierbaren Shop-PC verwalten. Adminshops handeln mit unbegrenztem Bestand und verwenden die MineBank-Staatskasse. Statistiken, Handelsverläufe, Bewertungen, Marktübersicht, Diagramme, Doppelkisten und Trichterunterstützung sind direkt enthalten.
PFLICHTABHÄNGIGKEITEN
- Minecraft 1.20.1
- Minecraft Forge 47.4.10 oder neuer innerhalb der Version 1.20.1
- Java 17
- MineBank 1.0.2 oder neuer
MineBank ist zwingend erforderlich. CityShop verwendet MineBank für Spielerkonten, Firmenkonten und die Staatskasse. CityRegion, CityJobs und CityPolice sind keine Pflichtabhängigkeiten von CityShop.
INSTALLATION
1. Installiere Minecraft Forge für Minecraft 1.20.1 (empfohlen: Forge 47.4.10).
2. Lege MineBank und CityShop in den Mods-Ordner der gleichen CurseForge-Instanz.
3. MineBank und CityShop müssen auf dem Server und bei allen beitretenden Spielern installiert sein.
4. Starte Minecraft beziehungsweise den Server neu.
5. Erstelle beziehungsweise verwende ein MineBank-Konto, bevor du mit Spielershops handelst.
SHOP ERSTELLEN
1. Stelle eine einzelne Kiste oder Doppelkiste auf.
2. Platziere beim Sneaken ein Schild direkt an der Kiste.
3. Lege das gewünschte Item oben links in die Kiste. Der Mod verwendet automatisch den übersetzten Namen des Items statt einer technischen Kennung wie minecraft:stone.
4. Beschrifte das Schild nach einem der folgenden Muster.
5. Klicke das Schild mit der rechten Maustaste an, um den Shop zu registrieren.
6. Fülle einen Verkaufsshop danach mit Ware beziehungsweise halte für einen Ankauf genug Geld und freien Kistenplatz bereit.
Die zweite Zeile ist die Menge pro Klick. Eine Menge von 16 bedeutet, dass bei jedem Handel 16 Items gekauft oder verkauft werden. Sie ist kein Gesamtlimit.
SPIELERSHOP – VERKAUF
Zeile 1: [Verkauf]
Zeile 2: 16
Zeile 3: leer
Zeile 4: 5,00
Alternativ wird [Shop] als Verkaufsshop erkannt. Kunden bezahlen den eingetragenen Gesamtpreis und erhalten pro Rechtsklick die eingetragene Itemmenge. Die Einnahmen gehen an den Besitzer oder an das zugehörige Firmenkonto.
SPIELERSHOP – ANKAUF
Zeile 1: [Ankauf]
Zeile 2: 16
Zeile 3: leer
Zeile 4: 3,00
Der Shopbesitzer kauft pro Klick die eingetragene Menge vom handelnden Spieler. Die Items landen in der Kiste. Bezahlt wird vom Konto des Besitzers oder vom Firmenkonto. Der Handel stoppt, wenn Items, Geld oder Kistenplatz fehlen.
ADMINSHOP – VERKAUF
Zeile 1: [AdminVerkauf]
Zeile 2: 16
Zeile 3: leer
Zeile 4: 5,00
Alternativ wird [AdminShop] als Admin-Verkauf erkannt. Nur OP-Spieler können Adminshops registrieren. Der Bestand ist unbegrenzt. Zahlungen der Spieler werden über MineBank in die Staatskasse eingezahlt. Auch der Ersteller darf am Adminshop einkaufen.
ADMINSHOP – ANKAUF
Zeile 1: [AdminAnkauf]
Zeile 2: 16
Zeile 3: leer
Zeile 4: 3,00
Der Adminshop nimmt die Items des Spielers an und bezahlt den Spieler aus der MineBank-Staatskasse. Die angenommenen Items müssen nicht in der Kiste gelagert werden.
WICHTIGE SHOPREGELN
- Pro Kiste beziehungsweise Doppelkiste ist genau ein Shop erlaubt: Ankauf oder Verkauf.
- Ein Shop kann nicht gleichzeitig an- und verkaufen. Das verhindert direkten Rückverkauf an derselben Kiste.
- Doppelkisten werden als ein gemeinsamer Bestand behandelt.
- Shopkisten und verbundene Bewertungsschilder sind vor unberechtigtem Zugriff geschützt.
- OP-Spieler behalten administrativen Zugriff, können aber normal an Shops handeln.
- Besitzer können sneaken und ihren eigenen Shop rechtsklicken, um den Handel ohne zweiten Spieler zu testen. Beim Test findet keine Geldbewegung statt.
FIRMEN UND MITARBEITER
Jeder Spieler kann einer Firma angehören. Eine Firma kann beliebig viele Shopkisten besitzen. Beim Gründen werden vorhandene persönliche Spielershops automatisch übernommen; neue Shops von Firmenmitgliedern werden automatisch der Firma zugeordnet. Name und Geldfluss gelten dadurch gemeinsam für alle Firmenshops.
- /company create <Name> – Firma und MineBank-Firmenkonto gründen
- /company rename <Neuer Name> – Firma und geladene Firmenshop-Schilder umbenennen
- /company info – Firmenname, Mitarbeiterzahl und Firmenkontostand anzeigen
- /company add <Spieler> – online befindlichen Mitarbeiter hinzufügen
- /company remove <Spieler> – Mitarbeiter entfernen
- /company leave – Firma als Mitarbeiter verlassen
- /company claim – anschließend einen vorhandenen eigenen Shop manuell der Firma zuweisen
- /company deposit <Betrag> – privates Geld auf das Firmenkonto einzahlen
- /company withdraw <Betrag> – als Firmenbesitzer Geld vom Firmenkonto auszahlen
Mitarbeiter dürfen Firmenkisten verwalten und sehen die gemeinsamen Shops im Shop-PC. Nur der Firmenbesitzer kann Mitarbeiter verwalten, die Firma umbenennen und Geld vom Firmenkonto auszahlen. Der Firmenbesitzer kann die Firma nicht einfach verlassen.
BEWERTUNGEN UND SHOPNAMEN
Nach einem echten Handel kann ein Kunde einen Shop beziehungsweise eine Firma mit 1 bis 5 Sternen bewerten. Eigene Shops oder die eigene Firma können nicht bewertet werden.
Persönlichen Shop verbinden:
1. Stelle an einem beliebigen Ort ein Schild mit [Bewertung] in der ersten Zeile auf.
2. Führe /chestshop link aus.
3. Klicke deinen Shop an.
4. Klicke danach das Bewertungsschild an.
Bei einer Firma genügt es, als Firmenbesitzer ein Schild mit [Bewertung] aufzustellen und rechtszuklicken. Es wird automatisch mit der Firma verbunden.
Ein Rechtsklick auf das Bewertungsschild zeigt eine klickbare Auswahl von 1 bis 5 Sternen. Die Auswahl ist aus Sicherheitsgründen nur kurz gültig und funktioniert nur in der Nähe des Schildes. Besitzer können dort außerdem die Umbenennung starten.
- /chestshop name <Name> – anschließend den eigenen Shop anklicken und benennen
- /chestshop rate <1-5> – alternative Bewertung per Befehl; anschließend den Shop anklicken
SPENDENSCHILDER
Spendenschilder funktionieren ohne Kiste. Stelle ein Schild an einer beliebigen Stelle auf, beschrifte es nach einem der folgenden Muster und registriere es einmal mit einem Rechtsklick.
Spende an einen Spieler oder eine Firma:
Zeile 1: [Spende]
Zeile 2: leer
Zeile 3: leer
Zeile 4: 10,00
Bei jedem Rechtsklick wird der eingetragene Betrag gespendet. Gehört der Ersteller einer Firma an, geht das Geld auf das MineBank-Firmenkonto. Ohne Firma geht es auf das persönliche Konto des Erstellers. Das Schild zeigt den insgesamt gesammelten Betrag an.
Spende an die Staatskasse:
Zeile 1: [AdminSpende]
Zeile 2: leer
Zeile 3: leer
Zeile 4: 10,00
Dieses Schild kann nur von OP-Spielern erstellt werden. Die Spenden werden direkt in die MineBank-Staatskasse eingezahlt. Eine Kiste oder eingelagerte Items werden nicht benötigt.
SPIELERBETRIEBENE LOTTERIEN
Lotterieschilder funktionieren ebenfalls ohne Kiste. Der Ersteller benötigt eine MineBank-Firma mit der CityShop-Lotterielizenz. Die Lizenz kann über das Business OS des Shop-PCs gekauft werden.
Zeile 1: [Lotterie]
Zeile 2: leer
Zeile 3: leer
Zeile 4: 10,00
Die vierte Zeile bestimmt den Einsatz für ein Spiel. Registriere das fertig beschriftete Schild einmal mit einem Rechtsklick. Danach können Kunden durch einen Rechtsklick spielen.
Gewinnchancen:
- 70 %: Niete
- 20 %: halber Einsatz
- 8 %: doppelter Einsatz
- 2 %: fünffacher Einsatz
Der Einsatz wird auf das MineBank-Firmenkonto eingezahlt und Gewinne werden von diesem Konto ausgezahlt. Die Firma muss den maximalen fünffachen Gewinn jederzeit absichern können. Firmenmitglieder dürfen nicht an ihrer eigenen Lotterie spielen. Das Schild zeigt die Anzahl der bisherigen Spiele an.
SHOP-PC UND BUSINESS OS
Der platzierbare Shop-PC besitzt ein eigenes texturiertes 3D-Modell. Ein Rechtsklick öffnet das speziell entwickelte CityShop Business OS statt eines gewöhnlichen Kistenmenüs.
Das Dashboard enthält:
- Firmenname, Firmenkontostand und eigene Firmenrolle
- Übersicht über persönliche Shops und Firmenshops
- Shop- und Firmenstatistiken
- Filialen
- Mitarbeiter und Firmenrollen
- kombinierbare Firmenlizenzen
- Lizenzkäufe direkt über das MineBank-Firmenkonto
- Marktberichte auf Grundlage echter CityShop-Preise
- Produktionsanalyse
- scrollbare Listen für beliebig viele Einträge
- sichtbare Scrollleiste
- eigene Darstellung in der Hand, im Inventar, auf dem Boden und im Bilderrahmen
Die Marktübersicht teleportiert Spieler bewusst nicht direkt zu den Shops.
REZEPT DES SHOP-PCs
Eisenbarren | Glasscheibe | Eisenbarren
Eisenbarren | Redstone | Eisenbarren
Eisenbarren | Komparator | Eisenbarren
TRICHTER UND AUTOMATISIERUNG
- Trichter können Verkaufskisten automatisch auffüllen.
- Trichter können Ankaufskisten automatisch leeren.
- Für den Handel zählt weiterhin ausschließlich das registrierte Shop-Item.
- Andere versehentlich eingespeiste Items werden nicht als Shopware gehandelt.
STATISTIK, VERLAUF UND INAKTIVITÄT
- Jeder echte Handel speichert Vorgang, Itemmenge und Umsatz dauerhaft in der Welt.
- Pro Shop werden die letzten 50 Handelsvorgänge gespeichert.
- Offline-Besitzer erhalten beim nächsten Login eine Zusammenfassung ihrer Verkäufe und Ankäufe.
- /chestshop stats zeigt die eigene Handelsstatistik.
- /chestshop history ist ein OP-Befehl. Danach wird das zu prüfende Shopschild angeklickt.
- Spielershops werden standardmäßig nach 168 Stunden Abwesenheit deaktiviert. Kisten und Items werden nicht gelöscht.
- Die Zeit ist in serverconfig/chestshop-server.toml über inactiveHours einstellbar.
- Adminshops bleiben aktiv.
- Entfernte Shops werden automatisch aus Statistik und Shop-PC bereinigt.
HINWEISE FÜR SERVERBETREIBER
Sichere die Welt vor Updates wie bei jedem serverseitigen Wirtschaftsmod.
- Installiere stets zueinander passende Versionen von CityShop und MineBank.
- Entferne alte doppelte JAR-Versionen aus dem Mods-Ordner.
- Admin-Verkäufe zahlen in die Staatskasse ein; Admin-Ankäufe zahlen aus der Staatskasse aus. Die Staatskasse benötigt daher für Ankäufe ausreichend Guthaben.
- CityShop speichert Shop-, Firmen-, Bewertungs- und Statistikdaten serverseitig in der Welt.
CityShop 2.1.4 – Business-OS-Update
Dieses große Update erweitert CityShop zu einem vollständigen, spielerbasierten Firmen- und Wirtschaftssystem.
Neu und verbessert:
- Eigenes CityShop Business OS
- Anbindung an MineBank-Firmenkonten und Staatskasse
- Firmen, Filialen, Mitarbeiterrollen und kombinierbare Lizenzen
- Firmenstatistiken, Marktberichte und Produktionsanalyse
- Scrollbare Shop- und Firmenübersichten
- Vollständig neues 3D-Modell für den Shop-PC
- Korrekte Darstellung im Inventar, in beiden Händen, auf dem Boden und im Bilderrahmen
- Spieler- und Adminshops für Ankauf und Verkauf
- Doppelkisten- und Trichterunterstützung
- Bewertungen, Handelsverläufe und automatische Inaktivitätsverwaltung
- Zahlreiche Fehlerbehebungen und Verbesserungen
MineBank 1.0.2 oder neuer wird benötigt.
Vor der Installation müssen ältere CityShop-JARs entfernt werden.
The CityShops Team
