CityShops

🏪 CityShops

Build real shops, businesses and a player-driven economy in Minecraft.

CityShops is a feature-rich shop and business mod for Minecraft Forge 1.20.1, designed especially for multiplayer, SMP, city and roleplay servers.

Create player-owned stores, buy and sell items, build companies with employees and branches, manage your business through the CityShops Business OS, and connect the entire economy to MineBank.

CityShops goes far beyond a simple chest shop.

Build supermarkets, convenience stores, warehouses, company stores, market stalls and complete shopping districts using functional shop systems and dedicated store furniture.

---

✨ What CityShops offers

🛒 Player Shops
Players can create their own shops and sell or purchase items from other players.

🏪 Modern Store Furniture
Create real-looking stores using dedicated CityShops furniture, including modern shop shelves, refrigerated displays and checkout counters.

💻 Business OS
Manage shops, companies, employees, branches, statistics and market information from the dedicated CityShops computer.

🏢 Companies & Employees
Create businesses, hire employees, manage permissions and operate multiple stores together.

💰 MineBank Economy Integration
Player accounts, business accounts and the state treasury are fully integrated through MineBank.

📊 Statistics & Transaction History
Track sales, purchases, turnover and recent transactions.

⭐ Shop & Company Ratings
Customers can rate shops and businesses after real transactions.

🌍 Public Market Overview
Compare real prices from active CityShops across the server.

📦 Inventory & Stock Management
Shops use real inventories and actual stored items.

⚙️ Hopper Automation
Automatically refill sell shops or remove purchased goods from buy shops.

🏛️ Admin Shops
Server operators can create unlimited-stock buy and sell shops connected to the MineBank state treasury.

🎁 Donation Systems
Create donation points for players, companies or the state treasury.

🎰 Player-Run Lotteries
Licensed businesses can operate their own lotteries using their MineBank business account.

---

🏬 Build real stores

CityShops is designed for servers that want shops to feel like actual businesses rather than simple command menus.

Use the available store furniture to create:

• Supermarkets

• Convenience stores

• Shopping centers

• Company stores

• Warehouses

• Food stores

• Hardware stores

• Player marketplaces

• RP businesses

• City shopping districts

Shop displays can show the configured item, transaction type, quantity and price directly at the store.

---

🛒 Player Shops

Players can create both:

SELL shops

The customer pays money and receives the configured item.

Revenue is transferred to the shop owner's account or the associated company account.

BUY shops

The shop purchases items from players.

Payment comes from the owner's account or company account, while purchased items are stored in the shop inventory.

CityShops checks:

• available stock

• available inventory space

• account balance

• configured item

• transaction amount

• shop permissions

This prevents invalid transactions and common shop exploits.

---

🏛️ Admin Shops

Server operators can create special Admin Shops.

Admin Shops can provide unlimited stock and interact directly with the MineBank state treasury.

Admin Sell Shop:

Player → pays money → State Treasury

Admin Buy Shop:

State Treasury → pays player

This allows server owners to create controlled economic sources and sinks.

---

🏢 Companies

CityShops includes a complete company system.

Players can create businesses and operate multiple shops together.

Companies support:

• Company names

• Business accounts

• Multiple shops

• Branches

• Employees

• Employee roles

• Permissions

• Shared shop management

• Business statistics

• Business licenses

Money earned by company shops can flow directly into the company's MineBank business account.

---

👥 Employees & Permissions

Business owners can hire other players.

Employees can receive permissions for specific business activities instead of automatically receiving full control.

This makes CityShops suitable for larger RP businesses with owners, managers and employees.

---

💻 CityShops Business OS

The dedicated Shop Computer opens the CityShops Business OS.

Instead of a normal Minecraft chest interface, players receive a dedicated business management system.

The Business OS includes access to:

• Company information

• Business balance

• Personal shops

• Company shops

• Branches

• Employees

• Employee roles

• Shop statistics

• Company statistics

• Business licenses

• Market reports

• Production analysis

Lists support scrolling for larger businesses.

---

📈 Market & Statistics

Every real transaction can contribute to the CityShops economy statistics.

CityShops tracks information such as:

• Number of transactions

• Items traded

• Turnover

• Shop history

• Company performance

The latest transactions are retained for individual shops.

Offline shop owners can also receive information about activity that occurred while they were away.

The market overview uses real CityShops prices from the server.

It intentionally does not teleport players directly to shops, keeping exploration and city infrastructure relevant.

---

⭐ Ratings

Customers can rate shops or companies after completing a real transaction.

Ratings range from:

⭐ to ⭐⭐⭐⭐⭐

Owners and company members cannot rate their own business.

This gives successful shops a reputation that is actually based on customer activity.

---

📦 Real Stock

Player shops do not generate items out of nowhere.

Sell shops require actual stock.

Buy shops require:

• sufficient money

• sufficient inventory space

Double chests are supported and treated as one shared shop inventory.

---

⚙️ Hopper Automation

CityShops supports Minecraft hopper automation.

Hoppers can:

• automatically refill sell shops

• automatically remove items from buy shops

Only the registered shop item counts as tradable stock.

Unrelated items accidentally inserted into the inventory are ignored by the shop system.

---

🎁 Donations

CityShops also supports donation systems without requiring a normal shop inventory.

Donations can be sent to:

• Players

• Companies

• MineBank state treasury

Donation points can track the amount collected.

---

🎰 Player-Run Lotteries

Businesses can operate player-run lotteries after obtaining the required business license.

Lottery stakes are deposited into the company's MineBank business account and winnings are paid from that same account.

The business must therefore actually be able to finance possible winnings.

---

💤 Inactive Shops

Player shops can automatically become inactive when their owner has not joined the server for a configurable amount of time.

By default:

168 hours / 7 days

The shop inventory and stored items are not deleted.

Server owners can configure the inactivity period.

Admin Shops remain active.

---

💰 Required Dependency: MineBank

MineBank is required.

CityShops uses MineBank for:

• Player accounts

• Company accounts

• Business transactions

• State treasury

• Admin Shops

• Business payments

Requirements

• Minecraft 1.20.1

• Minecraft Forge 47.4.10+

• Java 17

• MineBank 1.0.2+

MineBank on CurseForge:

https://www.curseforge.com/minecraft/mc-mods/minebank

---

📥 Installation

1. Install Minecraft Forge for Minecraft 1.20.1.

2. Install MineBank.

3. Install CityShops.

4. Place both mods in the mods folder.

5. Install the required mods on the server and connecting clients.

6. Start Minecraft or restart the server.

⚠️ Remove older duplicate CityShops JAR files before updating.

As with every economy mod, creating a world backup before major updates is recommended.

---

🏙️ Part of the City Mod Series

Building a complete Minecraft city or roleplay server?

CityShops is part of the City Mod Series.

🏠 CityRegion

CityRegion adds a complete real-estate and property system with features such as:

• Protected properties

• Buying & selling

• Renting

• Apartments

• Auctions

• Landlords

• Property management

CityRegion on CurseForge:

https://www.curseforge.com/minecraft/mc-mods/cityregion

CityShops + CityRegion + MineBank can form the foundation of a complete player-driven city economy.

Other City Mods such as CityJobs and CityPolice can be used independently and are not required by CityShops.

---

📚 Documentation / Wiki

Detailed guides, commands, permissions and tutorials are available in the official CityMods Wiki:

https://martiniiis.github.io/citymods-wiki/

🌐 The Wiki is currently available in German.

---

💬 Support & Discord

Need help, found a bug or have an idea for CityShops?

Join the official support Discord:

https://discord.gg/PVm9HchMRc

Bug reports, suggestions and feedback are welcome.

---

🚀 CityShops 2.4.2

CityShops continues to expand from a classic chest-shop system into a complete shop and business platform for Minecraft servers.

Version 2.4.2 includes the latest store systems and fixes, including corrected directional rendering for shop furniture such as checkout counters and refrigerated displays.

---

🇩🇪 DEUTSCH

🏪 CityShops

Baue echte Geschäfte, Unternehmen und eine spielergesteuerte Wirtschaft in Minecraft.

CityShops ist ein umfangreicher Shop- und Wirtschaftsmod für Minecraft Forge 1.20.1, der speziell für Multiplayer-, SMP-, City- und Roleplay-Server entwickelt wurde.

Erstelle Spielershops, kaufe und verkaufe Items, gründe Unternehmen mit Mitarbeitern und Filialen, verwalte deine Geschäfte über das CityShops Business OS und verbinde deine komplette Wirtschaft mit MineBank.

CityShops ist weit mehr als nur ein einfacher Chest-Shop-Mod.

Baue Supermärkte, kleine Geschäfte, Lagerhallen, Firmenshops, Marktplätze oder ganze Einkaufsviertel mit funktionierenden Shopsystemen und eigenen Ladenmöbeln.

---

✨ Das bietet CityShops

🛒 Spielershops
Spieler können eigene Verkaufs- und Ankaufsshops betreiben.

🏪 Moderne Ladenmöbel
Baue richtige Geschäfte mit speziellen CityShops-Regalen, Kühlregalen und Verkaufstheken.

💻 Business OS
Verwalte Shops, Firmen, Mitarbeiter, Filialen, Statistiken und Marktdaten über den CityShops-PC.

🏢 Firmen & Mitarbeiter
Gründe Unternehmen, stelle Mitarbeiter ein, verwalte Rechte und betreibe mehrere Shops gemeinsam.

💰 MineBank-Integration
Spielerkonten, Firmenkonten und die Staatskasse sind vollständig in das Wirtschaftssystem eingebunden.

📊 Statistiken & Handelsverlauf
Verfolge Verkäufe, Ankäufe, Umsatz und vergangene Transaktionen.

⭐ Shop- & Firmenbewertungen
Kunden können Shops und Unternehmen nach echten Käufen bewerten.

🌍 Öffentliche Marktübersicht
Vergleiche echte Preise aktiver CityShops auf dem Server.

📦 Echte Warenbestände
Spielershops arbeiten mit tatsächlichen Inventaren und eingelagerten Items.

⚙️ Trichter-Automatisierung
Verkaufsshops können automatisch aufgefüllt und Ankaufsshops automatisch geleert werden.

🏛️ Adminshops
Serverbetreiber können Shops mit unbegrenztem Bestand erstellen, die mit der MineBank-Staatskasse verbunden sind.

🎁 Spendensystem
Erstelle Spendenmöglichkeiten für Spieler, Firmen oder die Staatskasse.

🎰 Spielerbetriebene Lotterien
Unternehmen können mit entsprechender Lizenz eigene Lotterien betreiben.

---

🏬 Baue richtige Geschäfte

CityShops wurde für Server entwickelt, auf denen Geschäfte auch wirklich wie Geschäfte aussehen und funktionieren sollen.

Mit den vorhandenen Ladenmöbeln kannst du zum Beispiel bauen:

• Supermärkte

• Tante-Emma-Läden

• Einkaufszentren

• Firmenshops

• Lagerhäuser

• Lebensmittelgeschäfte

• Baumärkte

• Spielermärkte

• RP-Unternehmen

• komplette Einkaufsviertel

Shopanzeigen können direkt am Laden unter anderem das konfigurierte Item, Ankauf oder Verkauf, Menge und Preis anzeigen.

---

🛒 Spielershops

Spieler können sowohl Verkaufs- als auch Ankaufsshops betreiben.

Verkauf

Der Kunde bezahlt Geld und erhält die konfigurierte Ware.

Die Einnahmen gehen an den Shopbesitzer oder das zugehörige Firmenkonto.

Ankauf

Der Shop kauft Items von anderen Spielern.

Die Bezahlung erfolgt über das Konto des Besitzers oder das Firmenkonto. Die angekauften Items werden im Shopinventar gelagert.

CityShops überprüft dabei unter anderem:

• Warenbestand

• freien Inventarplatz

• Kontostand

• Shop-Item

• Handelsmenge

• Berechtigungen

Dadurch werden ungültige Transaktionen und typische Shop-Exploits verhindert.

---

🏛️ Adminshops

Serverbetreiber können spezielle Adminshops erstellen.

Diese können mit unbegrenztem Warenbestand arbeiten und direkt mit der MineBank-Staatskasse verbunden werden.

Admin-Verkauf:

Spieler → bezahlt → Staatskasse

Admin-Ankauf:

Staatskasse → bezahlt → Spieler

Dadurch können Serverbetreiber kontrollierte Geldquellen und Geldsenken für ihre Wirtschaft erstellen.

---

🏢 Firmen

CityShops enthält ein umfangreiches Firmensystem.

Spieler können Unternehmen gründen und mehrere Shops gemeinsam betreiben.

Unterstützt werden unter anderem:

• Firmenname

• Firmenkonto

• mehrere Shops

• Filialen

• Mitarbeiter

• Mitarbeiterrollen

• Berechtigungen

• gemeinsame Shopverwaltung

• Firmenstatistiken

• Firmenlizenzen

Einnahmen von Firmenshops können direkt auf das MineBank-Firmenkonto fließen.

---

👥 Mitarbeiter & Rechte

Firmenbesitzer können andere Spieler einstellen.

Mitarbeiter können unterschiedliche Rechte für die Verwaltung des Unternehmens erhalten, ohne automatisch vollständigen Zugriff auf die Firma zu bekommen.

Dadurch eignet sich CityShops auch für größere RP-Unternehmen mit Besitzern, Managern und Mitarbeitern.

---

💻 CityShops Business OS

Der eigene Shop-PC öffnet das speziell entwickelte CityShops Business OS.

Statt eines normalen Minecraft-Kistenmenüs erhalten Spieler eine eigene Unternehmensverwaltung.

Das Business OS bietet Zugriff auf:

• Firmeninformationen

• Firmenkontostand

• persönliche Shops

• Firmenshops

• Filialen

• Mitarbeiter

• Mitarbeiterrollen

• Shopstatistiken

• Firmenstatistiken

• Firmenlizenzen

• Marktberichte

• Produktionsanalyse

Auch größere Listen können gescrollt werden.

---

📈 Markt & Statistiken

Echte Transaktionen fließen in die Wirtschaftsstatistiken von CityShops ein.

Gespeichert werden unter anderem:

• Anzahl der Transaktionen

• gehandelte Items

• Umsatz

• Shopverlauf

• Firmenentwicklung

Für einzelne Shops werden die letzten Handelsvorgänge gespeichert.

Offline-Besitzer können beim nächsten Login Informationen über Verkäufe und Ankäufe erhalten, die während ihrer Abwesenheit stattgefunden haben.

Die Marktübersicht verwendet reale CityShops-Preise des Servers.

Spieler werden bewusst nicht direkt zu Shops teleportiert, damit Straßen, Städte und die Erkundung der Welt weiterhin eine Bedeutung haben.

---

⭐ Bewertungen

Nach einer echten Transaktion können Kunden einen Shop oder ein Unternehmen bewerten.

Bewertungen reichen von:

⭐ bis ⭐⭐⭐⭐⭐

Besitzer und Firmenmitglieder können das eigene Unternehmen nicht bewerten.

So entsteht eine tatsächliche Reputation auf Grundlage echter Kundenaktivität.

---

📦 Echte Warenbestände

Spielershops erzeugen ihre Waren nicht einfach aus dem Nichts.

Verkaufsshops benötigen tatsächlichen Warenbestand.

Ankaufsshops benötigen:

• ausreichend Geld

• ausreichend Inventarplatz

Doppelkisten werden unterstützt und als gemeinsames Shopinventar behandelt.

---

⚙️ Trichter-Automatisierung

CityShops unterstützt Minecraft-Trichter.

Trichter können:

• Verkaufsshops automatisch auffüllen

• Items aus Ankaufsshops automatisch abtransportieren

Für den Handel zählt ausschließlich das registrierte Shop-Item.

Andere versehentlich eingelagerte Items werden vom Shopsystem ignoriert.

---

🎁 Spenden

CityShops unterstützt außerdem Spendensysteme, für die kein normales Shopinventar erforderlich ist.

Spenden können gehen an:

• Spieler

• Firmen

• MineBank-Staatskasse

Dabei kann auch die insgesamt gesammelte Spendensumme erfasst werden.

---

🎰 Spielerbetriebene Lotterien

Unternehmen können mit der erforderlichen Firmenlizenz eigene Lotterien betreiben.

Einsätze werden auf das MineBank-Firmenkonto eingezahlt und Gewinne aus demselben Konto ausgezahlt.

Die Firma muss mögliche Gewinne deshalb tatsächlich finanzieren können.

---

💤 Inaktive Shops

Spielershops können automatisch deaktiviert werden, wenn ihr Besitzer längere Zeit nicht auf dem Server war.

Standard:

168 Stunden / 7 Tage

Shopinventar und eingelagerte Items werden dabei nicht gelöscht.

Serverbetreiber können diesen Zeitraum konfigurieren.

Adminshops bleiben aktiv.

---

💰 Pflichtabhängigkeit: MineBank

MineBank wird zwingend benötigt.

CityShops verwendet MineBank für:

• Spielerkonten

• Firmenkonten

• Geschäftstransaktionen

• Staatskasse

• Adminshops

• Firmenzahlungen

Voraussetzungen

• Minecraft 1.20.1

• Minecraft Forge 47.4.10+

• Java 17

• MineBank 1.0.2+

MineBank auf CurseForge:

https://www.curseforge.com/minecraft/mc-mods/minebank

---

📥 Installation

1. Minecraft Forge für Minecraft 1.20.1 installieren.

2. MineBank installieren.

3. CityShops installieren.

4. Beide Mods in den mods-Ordner legen.

5. Die benötigten Mods auf Server und Clients installieren.

6. Minecraft beziehungsweise den Server starten.

⚠️ Entferne beim Aktualisieren ältere doppelte CityShops-JARs aus dem Mods-Ordner.

Wie bei jedem Wirtschaftsmod empfiehlt sich vor größeren Updates ein Backup der Welt.

---

🏙️ Teil der City-Mod-Serie

Du baust eine komplette Minecraft-Stadt oder einen Roleplay-Server?

CityShops ist Teil der City-Mod-Serie.

🏠 CityRegion

CityRegion erweitert Minecraft um ein umfangreiches Immobilien- und Grundstückssystem mit Funktionen wie:

• geschützte Grundstücke

• Kaufen & Verkaufen

• Vermietung

• Wohnungen

• Auktionen

• Vermieter

• Grundstücksverwaltung

CityRegion auf CurseForge:

https://www.curseforge.com/minecraft/mc-mods/cityregion

CityShops + CityRegion + MineBank können gemeinsam die Grundlage für eine komplette spielergesteuerte Stadtwirtschaft bilden.

Weitere City-Mods wie CityJobs und CityPolice können unabhängig verwendet werden und sind keine Pflichtabhängigkeiten von CityShops.

---

📚 Dokumentation / Wiki

Ausführliche Anleitungen, Befehle, Berechtigungen und Tutorials findest du in der offiziellen CityMods-Wiki:

https://martiniiis.github.io/citymods-wiki/

🌐 Die Wiki ist aktuell auf Deutsch verfügbar.

---

💬 Support & Discord

Du brauchst Hilfe, hast einen Fehler gefunden oder eine Idee für CityShops?

Besuche unseren offiziellen Support-Discord:

https://discord.gg/PVm9HchMRc

Fehlermeldungen, Vorschläge und Feedback sind willkommen.

---

🚀 CityShops 2.4.2

CityShops entwickelt sich vom klassischen Chest-Shop-System immer weiter zu einer vollständigen Shop- und Unternehmensplattform für Minecraft-Server.

Version 2.4.2 enthält die aktuellen Shop-Systeme und Fehlerbehebungen, darunter korrigierte richtungsabhängige Darstellung von Ladenmöbeln wie Verkaufstheken und Kühlregalen.