Configure NxShards: Database, Shop, Wand, and Messages

Customize the NxShards config.yml — database backend, shop items, selection wand, transfer limits, and every plugin message in one file.

NxShards configuration is split across a few YAML files inside plugins/NxShards/. config.yml holds the database backend, transfer limits, wand material, and messages; shop.yml defines the GUI shop and its action-based purchase flow.

File Location

plugins/
└── NxShards/
    ├── config.yml
    ├── shop.yml
    └── database.db   # SQLite only

After editing config.yml, run /shards reload to apply changes without restarting the server.

Database

Choose between MySQL (multi-server sync) and SQLite (local storage):

storage:
  type: SQLITE          # MYSQL | SQLITE
  host: "127.0.0.1"
  port: 3306
  database: "minecraft"
  username: "root"
  password: "yourpassword"

SQLite stores data in plugins/NxShards/database.db. Use MySQL when you need a shared Shards balance across multiple servers.

Transfer Limits

Protect the economy by capping how many Shards a player can send through /shards pay:

transfer:
  max-amount: 10000     # Maximum Shards per /shards pay
  cooldown-seconds: 5   # Optional cooldown between transfers

Selection Wand

Customise the wand material and visual feedback used by /shards wand:

wand:
  material: BLAZE_ROD
  display-name: "&6Shards Zone Wand"
  lore:
    - "&7Left-click to set Position 1"
    - "&7Right-click to set Position 2"

Shop

The GUI opened by /shards shop lives in a dedicated shop.yml file. Each item defines its icon, slot, and a list of actions that run sequentially when a player clicks it. The most common action is [shards] <amount> which charges the player; other actions execute console commands, send messages, play sounds, or show titles.

shop:
  title: "&8Tienda de Shards"
  rows: 3
  items:
    example_item:
      material: DIAMOND
      name: "&bDiamante Gratis"
      lore:
        - "&7Costo: &b5 Shards"
        - "&7"
        - "&eClick para comprar"
      slot: 13
      actions:
        - "[shards] 5"
        - "[console] give %player% diamond 1"
        - "[message] &aHas comprado un diamante!"
        - "[title] &a¡Compra Exitosa!;&b1x Diamante"
        - "[sound] ENTITY_PLAYER_LEVELUP"

Available Actions

Action	Description
[shards] <amount>	Charges the player the given number of Shards. Aborts the chain if the balance is insufficient.
[console] <command>	Runs a command from the console. Supports %player%.
[player] <command>	Forces the player to run a command.
[message] <text>	Sends a chat message to the buyer. Supports & color codes.
[title] <title>;<subtitle>	Shows a title and subtitle, separated by ;.
[sound] <SOUND_NAME>	Plays a Bukkit sound to the buyer.

Messages

Every user-facing string is editable in the same file. Use legacy & colour codes:

messages:
  prefix: "&8[&6Shards&8] &7"
  balance: "&aYou have &6%amount% Shards&a."
  pay-sent: "&aYou sent &6%amount% Shards &ato &e%target%&a."
  pay-received: "&aYou received &6%amount% Shards &afrom &e%sender%&a."
  not-enough: "&cYou don't have enough Shards."
  zone-enter-title: "&6AFK Zone"
  zone-enter-subtitle: "&7You are now earning Shards"
  zone-bossbar: "&6Earning Shards — &e%zone%"
  no-permission: "&cYou don't have permission."

AFK Zone Defaults

Set fallback values used when admins don’t supply an interval or amount on /shards zone create:

zones:
  default-interval-seconds: 60
  default-amount: 1
  bossbar:
    color: GOLD          # GOLD | RED | GREEN | BLUE | YELLOW | PINK | WHITE | PURPLE
    style: SOLID         # SOLID | SEGMENTED_6 | SEGMENTED_10 | SEGMENTED_12 | SEGMENTED_20

Reloading

Apply changes with:

/shards reload

This reloads the configuration, messages, and the in-memory AFK zone registry without disconnecting players.