Installation Guide

Installation Guide

This guide walks you through installing Bazaar and its dependencies on a Fabric server.

Requirements

Requirement	Details
Minecraft	1.21.1
Fabric Loader	Latest stable
Fabric API	Matching your Minecraft version
Cobblemon	Compatible version
Ceremony	Bundled with Bazaar or installed as a standalone mod
Impactor	Required at runtime for economy and currency
LuckPerms	Recommended for permission management

Optional:

• Redis 6+ if you want cross-server sync
• Velocity if you run a proxy
• FabricProxyLite or CrossStitch for proxy-side plugin messaging

Installation Steps

1. Download the latest bazaar-<version>.jar.
2. Download the required dependencies.
3. Stop the server.
4. Drop the jars into mods/.
5. Start the server once so Bazaar can extract its bundled configs and assets.

Verify Installation

Check your console for a successful Bazaar startup line, then run:

/bazaar

If the command resolves and shows usage, Bazaar is loaded.

Directory Structure

On first start, Bazaar extracts this layout:

config/bazaar/
├── config.conf             # Main runtime config
├── channels.conf           # AH channel definitions
├── fees.conf               # Global fee defaults
├── limits.conf             # Per-player limits and caps
├── retention.conf          # Stats retention windows
├── security.conf           # Detector thresholds
├── grouping.conf           # Analytics grouping rules
├── presets.conf            # Optional preset replacements
├── price-control.conf      # Optional minimum listing prices
├── messages.conf           # Optional text overrides
├── sounds.conf             # Notification and UI sound cues
├── discord-webhooks.conf   # Discord webhook endpoints and rules
├── pokemon-visuals.conf    # Pokemon naming and aspect labels
├── item-rendering.conf     # Web item icon discovery
├── pokemon-rendering.conf  # Web Pokemon model and skin discovery
├── web-theme.conf          # Active dashboard theme selection
├── gui/                    # HOCON GUI definitions
├── tooltips/               # Tooltip templates and overrides
└── themes/                 # Dashboard preset JSON and CSS files

Updating

Bazaar does not overwrite your extracted configs on update. If a newer version adds fields, merge them into your live .conf files manually.

To regenerate a specific config file, delete it and restart the server. To regenerate all GUI configs, delete config/bazaar/gui/ and restart.

Troubleshooting

Dashboard unreachable The dashboard is disabled by default. Set web.enabled = true in config/bazaar/config.conf, configure web.port, and set web.publicBaseUrl if the dashboard or its assets must be reachable from outside the server box.

Players cannot list items or Pokemon Grant the relevant Bazaar permission nodes through LuckPerms. See Quick Start and Permissions.

Cross-server sync is not working Confirm Redis is reachable from all servers, role is set correctly in config.conf, and every server is running the same Bazaar version.

Next Steps

1. Quick Start
2. GTS
3. Cross-Server Setup