DiscordPort

DiscordPort

DiscordPort is a Spigot/Paper plugin that connects your Minecraft server to Discord with zero friction.

Features

• Two-way chat relay — Messages flow between Minecraft and Discord in real time, with player skin avatars via webhook.
• Event notifications — Join, quit, death, advancement, and server start/stop are all relayed to Discord.
• Status channels — Keep voice channel names updated with live player count, TPS, and RAM usage.
• Persistent status embed — A single Discord message that always shows your server's current state. Update it with /status.
• Account linking — Players run /link in-game, then confirm with /link <code> on Discord. Optionally enforce linking before joining.
• Log channel — Stream your server console to Discord, and optionally run commands from it.
• 20 languages — Language is auto-detected from your OS on first startup.
• 35+ placeholders — {TPS}, {ONLINE_PLAYERS}, {RAM_USAGE}, and many more for full customization.

Compatibility

Minecraft: 1.18 – 26.x
Java: 17+

Setup

1. Create a Discord Bot

• Go to discord.com/developers/applications → New Application
• Open the Bot tab → Add Bot → Reset Token → copy the token

2. Enable Intents

• On the Bot tab, enable Server Members Intent and Message Content Intent → Save Changes

3. Invite the Bot

• Go to OAuth2 → URL Generator → check bot + applications.commands
• Permissions: Send Messages, Read Message History, Manage Webhooks, Manage Channels
• Open the generated URL in your browser and invite the bot to your server

4. Get IDs

• Enable Developer Mode in Discord settings
• Right-click your server icon → Copy Server ID → paste as bot.guild_id
• Right-click your text channel → Copy Channel ID → paste as the route id

5. Configure & Start

• Drop the JAR into plugins/, start the server — plugins/DiscordPort/config.yml is generated
• Fill in bot.token, bot.guild_id, and your channel IDs, then restart

DiscordPort は、MinecraftサーバーとDiscordをシームレスに繋ぐ Spigot/Paper プラグインです。

機能一覧

• 双方向チャット中継 — MinecraftとDiscordのメッセージをリアルタイムで相互転送。Webhookでプレイヤーのスキンをアイコンとして表示。
• イベント通知 — 参加・退出・死亡・進捗解除・サーバー起動/停止をDiscordに通知。
• ステータスチャンネル — ボイスチャンネルの名前をプレイヤー数・TPS・RAM使用量でリアルタイム更新。
• 永続ステータス埋め込み — サーバーの現状を常に表示し続けるDiscordメッセージ。/status で設置。
• アカウント連携 — ゲーム内で /link → Discordで /link <コード> で連携完了。連携必須モードにも対応。
• ログチャンネル — サーバーコンソールをDiscordへストリーミング。Discordからコマンド実行も可能。
• 20言語対応 — 初回起動時にOSから言語を自動検出。
• 35種以上のプレースホルダー — {TPS}, {ONLINE_PLAYERS}, {RAM_USAGE} など、メッセージを自由にカスタマイズ。

対応環境

Minecraft: 1.18 〜 26.x
Java: 17以上

導入手順

1. Discord Botを作成する

• discord.com/developers/applications → New Application
• Bot タブ → Add Bot → Reset Token → トークンをコピー

2. Intentsを有効にする

• Bot タブ → Server Members Intent と Message Content Intent を ON → Save Changes

3. Botを招待する

• OAuth2 → URL Generator → bot + applications.commands にチェック
• 権限: Send Messages、Read Message History、Manage Webhooks、Manage Channels
• 生成URLをブラウザで開いてサーバーに招待

4. IDを取得する

• Discord設定 → 詳細設定 → 開発者モード を ON
• サーバーアイコンを右クリック → IDをコピー → bot.guild_id に貼り付け
• テキストチャンネルを右クリック → IDをコピー → ルートの id に貼り付け

5. 設定して起動

• JARを plugins/ に入れてサーバーを起動 → plugins/DiscordPort/config.yml が自動生成
• bot.token、bot.guild_id、チャンネルIDを記入して再起動