NobleSteeds Wiki

Dependency Planning

• Vault plus an economy plugin is required for normal money-based market/shop use.
• Citizens is required for Storage, Market, and Shop NPC access points.
• MailboxGUI is optional for money mail and package payout delivery.
• Redis and MySQL/MariaDB are required for network mode.

Redis Setup

Redis is used for backend-to-backend coordination. Configure host, port, optional username/password, SSL, timeout, and the network-calls channel in network/config.yml. Keep Redis private to your server network and use credentials when it is not local-only.

MySQL / Storage Setup

Network mode expects MySQL/MariaDB in the main config.yml. The same database and table prefix should be used by each backend in the same NobleSteeds network.

Server IDs and Backends

Every backend needs a unique network.server-id. This ID is used for stable location routing, cross-backend mount safety, market payout routing, MailboxGUI payout routing, and loaded mount ownership checks.

Network Diagnostics

Use /ns admin network to view readiness, mode, server ID, storage requirement, Redis host/channel, messenger status, spawn safety manager, give/trade manager, timeout, coverage checks, and config file path.

Cross-Backend Safety

Pro network safety protects against duplicate mount spawning and remote loaded-mount conflicts. When one backend needs to call, restore, transfer, or sell a mount, Redis coordination allows other backends to save/despawn or refresh state first.

Market Setup

The bundled config enables the market by default, requires economy by default, enables /ns market, supports optional Market NPC access, and defines listing expiration plus min/default/max price limits.

market:
  enabled: true
  require-economy: true
  command-enabled: true
  listing-expiration-hours: 0
  min-price: 1.0
  default-price: 1000.0

Player Market

Players with noblesteeds.market can open the market, browse listings, list an active or stored owned mount, choose a money or item-currency price where enabled, view their listings, remove listings, buy eligible listings, and claim item-currency payouts with /ns market receive.

Admin Market Management

Admin tools include market listing review and removal. The language bundle includes stale owner checks so staff can identify listings where the seller no longer matches the saved mount owner.

Market Payouts

Money payouts normally use Vault. The config can send money sale payouts through MailboxGUI money mail, and item-currency payouts can be delivered through MailboxGUI package mail when enabled. If MailboxGUI is unavailable, NobleSteeds safely falls back to normal payout behavior.

Shop Setup

The admin-created shop is separate from the player market. The bundled config enables the shop and /ns shop by default and requires Vault economy for normal money purchases.

Player Shop

Players use /ns shop to browse staff-created mount entries and purchase a mount when they have funds and an available active claim slot. If claim fails after payment, the language bundle notes that the payment is refunded if payment was taken.

Admin Shop Management

Staff create entries with /ns admin shop add, list entries with /ns admin shop list, and remove entries with /ns admin shop remove <shopId>. Shop entries can define variant, speed, jump, health, breeding quality, price, and name.

Citizens NPC Setup

1. Install Citizens and restart the backend.
2. Create the NPCs you want players to use.
3. Open the NobleSteeds admin NPC registration tools.
4. Select Storage, Market, or Shop access and right-click the Citizens NPC to register it.
5. Test the NPC as a player with the matching command permission.

Storage NPC

Storage NPCs open the mount storage GUI. This can be useful if /ns storage is disabled and storage should only be available in specific server locations.

Market NPC

Market NPCs open the player market when market and economy requirements are satisfied.

Shop NPC

Shop NPCs open the NobleSteeds shop when the shop is enabled and economy requirements are satisfied.

Manage Registered NPCs

The registered NPC management flow lets admins inspect and remove registered Citizens NPC IDs without editing data files manually.

Core Player Commands

Pro Player Commands

Admin Commands

Permissions

Network Not Ready

• Run /ns admin network and check readiness lines.
• Confirm storage.type is MYSQL for network mode.
• Confirm Redis host, port, credentials, SSL, timeout, and firewall access.
• Confirm each backend has a unique server-id.

Market Hidden or Unavailable

• Confirm market.enabled and market.command-enabled.
• Confirm Vault and a compatible economy are installed when market.require-economy is true.
• Confirm players have noblesteeds.market.

Shop Hidden or Unavailable

• Confirm shop.enabled and shop.command-enabled.
• Confirm Vault/economy when shop.require-economy is true.
• Confirm shop entries exist and are enabled.

Citizens NPC Disabled

• Confirm Citizens is installed and enabled.
• Confirm the matching NPC setting is enabled in config.
• Confirm the NPC is registered as the correct Storage, Market, or Shop type.
• Confirm players have the permission for the command the NPC opens.

Claim Limit During Purchase or Restore

• Market and shop purchases need an available active mount slot.
• Stored market listings may require an active slot before unlisting/restoring.
• Grant a higher noblesteeds.claims.<amount> permission or ask the player to store/release another mount.

Can Free upgrade to Pro?

Yes. Back up the NobleSteeds folder and database first, then install Pro and enable Pro systems intentionally.

Does Pro support Velocity networks?

The bundled network config is written for backend servers behind a proxy such as Velocity. It does not require a Velocity plugin.

Does Pro require Redis?

Only for network mode. Standalone Pro market/shop/NPC installs can leave network mode disabled.

Does the market require Vault?

Normal money-based market and shop use require Vault plus an economy provider. Item-currency support is separate where enabled.

Can NPCs be disabled?

Yes. Storage, Market, and Shop NPC access each has config gating and Citizens must be installed for NPC workflows.