tomachi-emojis-sync-perms

🔑 Tomachi Emojis Discord サーバー間でロール（権限）を同期するツールです。

概要

ソース Discord サーバーのロール情報を取得し、複数の宛先 Discord サーバーに同期します。Tomachi Emojis の複数サーバー間で権限を一元管理するために使用します。

機能

• ソースサーバーからロール情報を取得
• 複数の宛先サーバーにロールを同期
• 定期的な自動同期

必要要件

• Node.js（.node-version 参照）
• pnpm
• Discord Bot Token（適切な権限が必要）

インストール

# リポジトリのクローン
git clone https://github.com/tomacheese/tomachi-emojis-sync-perms.git
cd tomachi-emojis-sync-perms

# 依存関係のインストール
pnpm install

設定

設定は 2 つのファイルに分かれています。

data/config.json

Discord Bot のトークンを設定します。

{
  "discord": {
    "token": "your-discord-bot-token"
  }
}

data/linking.yml

サーバー間のロール同期設定を YAML 形式で記載します。

sourceGuild:
  guildId: "source-server-id"
  roles:
    - type: "admin"
      roleId: "role-id"

destGuilds:
  - guildId: "destination-server-id"
    roles:
      - type: "admin"
        roleId: "role-id"

使用方法

# 実行
pnpm start

# 開発モード（ファイル変更を監視）
pnpm dev

Docker での実行

Docker で実行する場合は、設定ファイルをコンテナにマウントする必要があります。

1. data/config.json と data/linking.yml を作成します
2. compose.yaml でボリュームマッピングを設定します

services:
  app:
    build: .
    volumes:
      - type: bind
        source: ./data/config.json
        target: /data/config.json
      - type: bind
        source: ./data/linking.yml
        target: /data/linking.yml
    init: true

3. コンテナを起動します

docker compose up -d

環境変数

設定ファイルのパスは環境変数でカスタマイズできます:

• CONFIG_PATH: 設定ファイルのパス（デフォルト: /data/config.json）
• LINKING_PATH: リンク設定ファイルのパス（デフォルト: /data/linking.yml）