MySB - My Scoreboard

A server-side only scoreboard management mod for Fabric 1.19.4. Players can pick and switch their own sidebar display through an intuitive chest GUI — without installing anything on the client.

Built for ASTRAL-SMP, a Japanese Minecraft Fabric server.

✨ Features

• ✅ 100% server-side — vanilla clients work out of the box
• ✅ Chest-based GUI — no commands to memorize
• ✅ Per-player scoreboard selection — each player picks their own sidebar
• ✅ Persistent settings — choices are saved across sessions
• ✅ Server-wide total statistics — aggregate stats across all players to encourage friendly competition
• ✅ Discord Bot integration — auto-post statistics to Discord forum channels on an hourly schedule
• ✅ Permission & rate limiting — safe for public servers
• ✅ Admin GUI — enable/disable stats, exclude players, manage fake players (Carpet)

📦 Installation

⚠️ Server-side only. Do NOT install on the client — it will have no effect.

1. Drop mysb-1.19.4-2.3.jar into your server's mods/ folder
2. Make sure Fabric API is also installed
3. Start the server

Players join with vanilla Minecraft 1.19.4 — no mods needed on their side.

🎮 Commands

Player commands

| Command | Description |
|---|---|
| /mysb | Open the scoreboard selection GUI |
| /mysb version | Show mod version |

Admin commands (OP required)

| Command | Description |
|---|---|
| /mysb reload | Reload configuration (OP4) |
| /mysb admin gui | Open the admin GUI (OP3+) |
| /mysb admin stats enable <stat> | Enable a statistic |
| /mysb admin stats disable <stat> | Disable a statistic |
| /mysb admin stats list | List enabled/disabled stats |
| /mysb admin exclude <player> | Exclude a player from totals |
| /mysb admin include <player> | Re-include an excluded player |
| /mysb admin fakeplayerscore enable\|disable | Toggle Carpet fake-player display |
| /mysb total list | List total statistics |
| /mysb total update | Manually refresh totals |
| /mysb total add <id> <displayName> <statType> | Add a custom total stat |
| /mysb total remove <id> | Remove a custom total stat |

Discord integration (OP3+)

| Command | Description |
|---|---|
| /mysbdiscord | Open Discord settings GUI |
| /mysbdiscord channel <ID> | Set the target forum channel |
| /mysbdiscord status | Show integration status |
| /mysbdiscord reconnect | Reconnect the Discord Bot |
| /mysbdiscord test | Send a test message |
| /mysbdiscord update | Force-update statistics |

📊 Available Total Stat Types

• Total Blocks Mined
• Total Blocks Placed
• Total Deepslate Mined
• Total Coral Blocks Mined
• Total Stained Glass Placed
• Total Anvils Placed
• Total Villager Trades
• Total All Ores Mined

🤖 Discord Bot Setup

1. Create a Discord Bot and get its token
2. Set the token in config/mysb/discord_config.properties
3. Invite the bot with these permissions: Send Messages, Create Threads, Use Slash Commands
4. Run /mysbdiscord channel <forum-channel-id> in-game
5. Statistics will auto-post every hour

🔧 Technical Specs

• Minecraft: 1.19.4
• Loader: Fabric
• Dependencies: Fabric API
• Environment: Server only
• Client compatibility: Vanilla clients

📄 License

MIT License — see LICENSE for details.

---

日本語版

サーバー側のみで動作するFabric 1.19.4用スコアボード管理Modです。プレイヤーはチェスト型GUIから自分のサイドバー表示を自由に選択・切り替えできます。クライアント側のインストールは一切不要、バニラクライアントでそのまま使えます。

日本のMinecraft FabricサーバーASTRAL-SMP向けに開発されました。

✨ 機能

• ✅ サーバー側のみで動作 — バニラクライアントでそのままOK
• ✅ チェスト型GUI — コマンドを覚える必要なし
• ✅ プレイヤーごとの個別スコアボード選択 — 各プレイヤーが自分の好きな表示を選べる
• ✅ 設定の永続化 — 選択はセッションを跨いで保存
• ✅ サーバー全体のトータル統計 — 全プレイヤーの統計を集計、競争意識を刺激
• ✅ Discord Bot連携 — Discordフォーラムチャンネルに統計を毎時自動投稿
• ✅ 権限管理 & レート制限 — 公開サーバーでも安心
• ✅ 管理者GUI — 統計の有効/無効切替、プレイヤー除外、Carpet fake player対応

📦 インストール

⚠️ サーバー側専用です。 クライアントには入れないでください(入れても効果はありません)。

1. mysb-1.19.4-2.3.jar をサーバーの mods/ フォルダに配置
2. Fabric API も導入
3. サーバー起動

プレイヤーはバニラのMinecraft 1.19.4で参加するだけ、追加Modは不要です。

⚙️ 技術仕様

• 対応バージョン: Minecraft 1.19.4
• ローダー: Fabric
• 依存: Fabric API
• 環境: サーバー専用
• クライアント互換性: バニラクライアント

📄 ライセンス

MIT License