✨ What is ShardCore?

ShardCore adds an independent Shards currency to your server and everything players need to earn and spend it: AFK zones, a GUI shop, quests, leaderboards, holograms and more. Every message, price, reward and menu is configurable from simple .yml files, and an in-game admin panel lets you edit most values without touching a file.

🚀 Features

🛡 Safety

• Balances are cached and saved asynchronously (every 2 minutes, on quit and on shutdown).
• Shop purchases check inventory space first and refund automatically if delivery fails.
• Click-spam protection on purchases and quest claims.
• Anti-exploit: blocks placed by players and spawner mobs don't count for quests or mob rewards.
• Works without PlaceholderAPI, LuckPerms or TAB.

📋 Requirements

• Server: Spigot, Paper or Purpur
• Minecraft: 1.20.x - 1.21.x - 26.x
• Java: 17 , 21 and 25
• Optional: PlaceholderAPI, LuckPerms, TAB

💬 Commands

🔑 Permissions

LuckPerms example: /lp group vip permission set shardcore.multiplier.vip true

📂 Configuration Files

Everything lives in plugins/ShardCore/. Edit, then run /shards reload.

language: en   # ar / en

anti-exploit:
  placed-blocks: true
  spawner-mobs: true

categories:
  blocks: {name: "&aBlocks", icon: GRASS_BLOCK, slot: 10}
  tools:  {name: "&6Tools",  icon: DIAMOND_PICKAXE, slot: 12}
items:
  diamond:
    category: ores
    material: DIAMOND
    amount: 1
    price: 100
    discount: 0          # percent
  steak:
    category: food
    material: COOKED_BEEF
    amount: 16
    price: 30
    max-per-day: 5       # daily purchase limit
    permission: ""       # optional

daily-reward:
  amount: 50
  cooldown-hours: 24
mob-reward:
  enabled: true
  chance: 100
  default: 1
  mobs: {ZOMBIE: 2, SKELETON: 2, CREEPER: 3, ENDERMAN: 5}
quests:
  kill_zombies:
    type: daily
    name: "&aKill 20 Zombies"
    event: KILL
    target: ZOMBIE
    amount: 20
    reward: 40

first-join:
  enabled: true
  amount: 100
achievements:
  enabled: true
  default: 5
  ignore-prefixes: ["recipes/"]
  overrides:
    "story/mine_diamond": 50
    "end/kill_dragon": 500

apply-to: [afk, mob, quest, daily, achievement, event]
multipliers:
  vip: 1.5
  mvp: 2.0
  legend: 3.0

refresh-seconds: 60
top-lines: 10
title: "&b&lTop Shards"
line-format: "&e#%pos% &f%player% &7- &e%amount%"

type: sqlite      # sqlite or mysql
mysql:
  host: localhost
  port: 3306
  database: shardcore
  user: root
  password: ""
backup:
  auto-enabled: true
  every-hours: 6
  keep: 10

🔧 Quick Setup

AFK zone

1. /shardadmin wand, then left click one corner and right click the opposite corner
2. /shardadmin zone create spawn
3. /shardadmin zone setreward spawn 10
4. /shardadmin zone setinterval spawn 60
5. /shardadmin zone setlimit spawn 1000 (0 = unlimited)

Shop item: hold the item, then /shardadmin shop add golden_apple food 150

Leaderboard: stand where you want it, then /shardadmin holo create top1

MySQL: set type: mysql in database.yml, restart, then /shardadmin db migrate.

🔌 PlaceholderAPI

Works with TAB, scoreboards and any PlaceholderAPI plugin.

👨‍💻 Developer API

ShardAPI.getBalance(uuid);
ShardAPI.give(uuid, 100, "reason");
ShardAPI.take(uuid, 50, "reason");
ShardAPI.transfer(from, to, 25);

Add the jar as compileOnly and depend: [ShardCore] in your plugin.yml. Works for online players, call from the main thread.

⚠ Good to know

• give, take and set work on online players only.
• MySQL is meant for a single server (don't share one database between servers).
• Operators receive the highest multiplier automatically; test with a normal player.
• After updating, delete messages.yml so the new messages generate.

❓ FAQ

Does it need Vault? No, it is fully standalone. Is data safe after a crash? Balances save every 2 minutes, on quit and on shutdown. Can I change the language? Yes: language: ar or en in config.yml. Which versions work? Tested on 1.21.11. 1.20.x and other 1.21.x should work but are untested.