BioTrace Smart ID

BioTrace Smart ID v1.0.0

Tactical citizen ID, PvP scoreboard, and bounty system for Minecraft 1.20.1 Forge SMP servers.

Citizen ID

• Unique Citizen ID (CIV-XXXXXXXX) assigned on first join — persists through death
• SHOW ID button in inventory opens a tactical ID card (health, armor, food, status effects, ECG, barcode)
• Share your ID with nearby players (default 6 blocks, configurable)
• 3D player preview on the card
• ID card opens on the left of inventory (JEI-friendly layout)
• Fixed: SHOW ID sometimes failing until rejoin — server now always sends the card back and resyncs your ID on login

Scoreboard

• SCORES button opens an all-time leaderboard overlay
• Tracks K (kills), BK (bounty kills), D (deaths), LVL, and SCORE
• Highlights your row, top-3 rank colors, scrollbar, mouse wheel + keyboard navigation
• Press E (inventory) to close the scoreboard; SCORES closes inventory and opens the board
• Score formula: (Kills × 3) + (Bounty Kills × 6) − Deaths + (Level × 2) + Bonus

Bounty system

• Random bounty on an online player every 10 minutes (configurable)
• 30-minute cooldown after each bounty ends (expired or claimed)
• Bounty HUD at top-center with target name and timer
• Claiming a bounty: +1 normal kill and +1 bounty kill
• Target logging out expires the bounty and starts cooldown

Admin commands

Command Description

/biotrace bounty create [player]
Place a bounty (random if no player)

/biotrace bounty trigger
Force random bounty (ignores cooldown)

/biotrace scoreboard give
Grant bonus score

/biotrace scoreboard reset
Reset all scores

/biotrace scoreboard reset
Reset one player’s scores

Configuration

Server: config/biotracesmartid-common.toml
Bounty duration/cooldown, min players, score values, ID share range

Client: config/biotracesmartid-client.toml
Button positions, ID card side/margin, display duration