YAMAG: Yet Another Misskey Accuracy Game app

What's this app

これは「334」のような特定の時間に対しての投稿時間の精度を図るようなゲームの集計を行うアプリです。

Features (WIP)

• 特定時刻のノートの収集・ランキングの集計
  • 同着も含め10位以内を表示する（10人ではなく）
• Noteをhttpによる取得で集計する
  • Stream API (WebSocket)を使うものより、取得漏れ含め比較的安定して動作する
• 終了後に自分の投稿時刻と順位を表示する
• LTLではなくSTL(Hybrid Timeline)で動かすし他サーバーにも対応する
  • 一旦他サーバー対応はしない（競技の公平性を鑑みて）
• 累計でのランクイン回数や(TODO: 累計の合計レーティング)を表示する

How to use

前提

Node js v18.17.0
pnpm

• pnpm install(依存関係のインストール)
• 環境変数「SERVER_TOKEN」にMisskey.ioで取得したトークンを設定する
• 特定時刻をコード上で変更しておく（あとで変えられるようにする予定です）
• (返信機能を使う場合) DATABASE_URLを設定して、pnpm run migrateを実行
• 特定時刻が過ぎた後にコードを実行する(cron等を用いれば自動化できる)
  • pnpm buildをしておいて（前提なので一回でOK）
  • pnpm start
• 集計結果がノートされる

集計開始ノートを投稿する

• pnpm run remind

返信機能を利用する

• データベースの設定・migrate必須
• pnpm run mentions

ENV Config

環境変数、または.envファイルを用いることでアプリケーションの設定を変更可能です

SERVER_ORIGIN

• Misskeyサーバーのアドレス
• default "https://misskey.io"

SERVER_TOKEN (設定必須)

• Misskeyから取得したAPIのトークン
• 最低でもノートの作成・削除の権限は与えないと投稿が不可

DATABASE_URL

• PostgreSQLのURL
• 返信機能を使うには必須

RECORD_HOUR

• 記録を開始する時刻の時(24時間形式)
• default 3

RECORD_MINUTE

• 記録を開始する時刻の分(24時間形式)
• default 34

POST_TITLE

• 投稿時タイトル
• default "Today's 334 Top 10"

MATCHER

• 取得対象となる文字列を変更する場合に使います
• default

/(33-?4|:hanshin:)/

USER_NAME

• 自身のusername
  • 自身のノートをフライング含め集計しないために入れています
  • （※今後廃止してBotユーザー全部弾くようにするかも）
  • リプライの判定に使います
• default 334_t

REMINED_POST_TEXT

• 観測時投稿テキストを変更できます
• default "334観測中"

POST_DISABLED

• 値をTRUEに設定するとMisskeyにノートが投稿されなくなります
• 手元で集計のみ行いたい場合等にお使いください

DISABLE_MENTION_AROUND_TIME

• 値をTRUEに設定すると集計時刻の前後でのメンションに反応しないようにすることが可能です
• default FALSE

DISABLE_MENTION_SEC_BEFORE

• DISABLE_MENTION_AROUND_TIME と併用して使うオプションです
• メンションに反応しない時間を設定する際に集計時刻の何ミリ秒前から反応しないかを設定可能です
• default 60000

DISABLE_MENTION_SEC_AFTER

• DISABLE_MENTION_AROUND_TIME と併用して使うオプションです
• メンションに反応しない時間を設定する際に集計時刻の何ミリ秒後まで反応しないかを設定可能です
• default 60000

etc..

• dotenv導入済みなのでローカルなどで試す場合は.envのファイルを用意して配置すれば設定変更可能
  • 開発環境（NODE_ENV=development）の場合は.env.developmentが読み込まれる（.envは読み込まない）

Dockerを用いた構築

// TODO // この方法ではデータベースはローカルのものを使う、もしくは用意しないことも可能です

1. （任意）データベースを用意します
2. リポジトリよりbuild もしくは taichanne30/yamagイメージを利用します
3. docker runコマンドを用いて実行してください

Docker-Composeを用いた構築

この方法ではデータベースも同時に用意可能です

公式イメージを用いる場合

※こちらも参考にしてください( https://github.com/taichanNE30/yamag-docker-compose-example )

1. 適当なディレクトリを作成します
2. リポジトリ内のenv_templatesを参考に.env.app, .env.dbを作成します
3. 以下のdocker-compose.ymlを作成します

version: '3'
services:
  app:
    image: taichanne30/yamag:master
    restart: always
    links:
      - db
    networks:
      - int_net
      - ext_net
    env_file:
      - .env.app
  db:
    image: postgres:15.3-bullseye
    networks:
      - int_net
    env_file:
      - .env.db
    volumes:
      - ./postgres-data:/var/lib/postgresql/data
    ports:
      - "5432:5432"
networks:
  int_net:
    internal: true
  ext_net:

1. （初回起動時のみ）マイグレーションを実行する docker-compose run -it app pnpm run migrate
2. docker-compose up -d等で起動する

自分でビルドする場合（カスタムする場合など）

1. リポジトリをcloneします
2. リポジトリ内のenv_templatesを参考に.env.app, .env.dbを作成します
3. （初回起動時のみ）マイグレーションを実行する docker-compose run -it app pnpm run migrate
4. docker-compose up -d等で起動する

LICENCE

このプロジェクトはMPL-2.0を採用しています。 ライセンスに従った形での利用や改変は大歓迎です