Add files via upload

archive/README_OLD.md

@@ -0,0 +1,188 @@
+# Discord-Backup-Bot
+ソースコードの2次配布、販売はお控えください
+### ~~⚠️このBotは1サーバー / 1Botを想定してコーディングされています⚠️~~  
+↑今は複数のサーバーに対応させたモデルか1サーバーだけのモデルか選べるので関係ないです
+### 宣伝
+もしBot/ソースコードを気に入っていただけたら僕のサーバーで寄付(PayPay)してくれると非常に励みになります！！  
+Botが対応するので24時間いつでもだいじょうぶです！  
+このリポジトリにスターをつけてくれるのも超うれしいです！！  
+↓サーバー↓ (僕やこのソース/Botを使う方とのコンタクトもここです)  
+https://discord.gg/aSyaAK7Ktm  
+## Botについて
+ソースを公開していますがコーディング、ホスティングの過程を省きたい場合は僕がすでにデプロイしているものを使ってみてください  
+↓バックアップBot↓  
+https://discord.com/api/oauth2/authorize?client_id=1152222169154199552&permissions=8&scope=bot  
+↓メンバーブーストBot↓  
+https://discord.com/api/oauth2/authorize?client_id=1178210441307115550&permissions=8&scope=bot  
+### BotのHTMLは [Ame-x](https://github.com/EdamAme-x) さんが作成してくれました！！
+しかも無償で。Thankyou very much!!!
+## 2023/12/15：OAuth2トークンの有効期限について
+### メンバーブーストに使っているトークンですが、どうやら1週間で期限が切れるみたいです
+対策としては403が返されたときにリフレッシュトークンを使ってアクセストークンを再発行することです  
+```python
+API_ENDPOINT = 'https://discord.com/api/v10'
+CLIENT_ID = ['アプリケーションID']
+CLIENT_SECRET = ['アプリケーションシークレット']
+REDIRECT_URI = "リダイレクト先"
+data = {
+        'client_id': CLIENT_ID,
+        'client_secret': CLIENT_SECRET,
+        'grant_type': 'refresh_token',
+        'refresh_token': 'ここにリフレッシュトークン',
+        'redirect_uri': REDIRECT_URI
+        }
+        headers = {
+        'Content-Type': 'application/x-www-form-urlencoded'
+        }
+```
+こんな感じでデータとヘッダーを設定したらリクエストする時につけてあげます
+```python
+requests.post('%s/oauth2/token' % API_ENDPOINT, data=data, headers=headers)
+```
+こんな感じでくっついてきます
+```
+{'token_type': 'Bearer', 'access_token': 't7KOqezBkvQbBCiKyRG3aW4GfwJD4Q', 'expires_in': 604800,
+ 'refresh_token': 'tnKw3UtwqrernhImzDkEEP4eJwkiQh', 'scope': 'guilds.join identify'}
+```
+返り値に新しいアクセストークンと新しいリフレッシュトークンがくっついてきます！  
+リフレッシュトークンも毎回更新されるようです！  
+ここのソースコードのお好きなところにくっつけて使ってあげてください！
+## 2023/1/13：v4リリース！
+変更点は以下の通りです  
+- 稚拙なコードを改善  
+  特にトークンやファイルパスを複数回入力してようなところ  
+  パスはv4pathに記述するようになりました
+- /callの追加先サーバーIDを削除  
+- /callのデータサーバーIDを"all"と入力すると認証した人全員を追加するように変更  
+- サーバーごとに異なるトークンになるのを防ぐため参照元は常にuserdata.jsonになるように変更  
+  この変更でリフレッシュトークンを使うように改造する難易度が下がりました  
+
+callをたくさん使いたい...？非同期スリープを使ってあげてください....
+
+こんな感じです  
+v3をリリースしたときと今では僕自身の技術力が違いすぎてコードに余計なところが多かったです
+## 2023/11/29：v3リリース！
+変更点は以下の通りです  
+- /callコマンド専用のファイルを作り、/callが使われてもBotが停止しなくなりました  
+  このコードだと/callは1回しか使えないです、call中に/callを使うとBotから返信されます  
+  callされているかの判定は同じディレクトリにあるnow.jsonで行っています
+- 気持ち程度にstateの引数を暗号化するようにしました  
+  ここでバラしたら元も子もないですが、URLはそれぞれ16進と8進に変えられてninFlaskV3内でintにデコードします
+
+
+now.jsonは相対パスで入力しているので、変更する必要がある場合はコードの編集ソフトかメモ帳かでnow.jsonを検索してください  
+ベースとなっているのはnin2でnin2 -> ninV2 -> ninV3になっています  
+通常のnin.pyの機能やninV2aが使いたい方は僕のコードを参考にするなり自分なりに考えるなどで各自編集してください  
+#### FlaskV3aについて
+もともとFlask-Discoed-Extendedでなにか便利な機能があるか探るのも含めてロールの付与はFlaskDEの "Discord.Utilities.add_role" を使ってたんですが、べつにこれ以外の機能は使わなかったしむしろログが増えてじゃまになるだけだったのでやっぱりリクエストする方がスマートだと考え、GitHubのリファレンスモデルにもリクエストで完結するninFlaskV3a (インポートの関係上名前はそのままにフォルダだけ分けました) をアップロードしました  
+リクエストの方がシンプルなコードでできるのでもう改造してた人もいるかもしれませんがいちおう追記しておきます
+## 2023/11/19：429TooManyRequestについて
+Replitでホスティングをすると/call時にTooManyRequestが発生するようです  
+1回のリクエストにクールタイムは2分ほど必要でまともに使えないのでReplitはこのBotのホスティングに適さないです
+## 2023/11/17：チェックボタンを押さなくても認証ができるv2をアップロードしました  
+基本的な動作はなにも変わらないのでボタンを押したい方や興味ない方はv1でOKです  
+動作させるまでの手順がほんの少しだけ増えたので最後に記載しておきます
+## 2023/9/15：サーバーごとに別のファイルに保存するバージョンも作りました
+招待は↓から！  
+https://discord.com/api/oauth2/authorize?client_id=1152222169154199552&permissions=8&scope=bot  
+ローカルに構築するかた向けに最後の方にそっちのセットアップ方法も書いておきます
+## Botのセットアップ
+### Pythonを使える環境と脳みそ、ある程度のファイル操作とネットワーク知識、Botアカウントの作成と編集ができることが前提に話が進みます
+
+以下のPythonモジュールをインストールしておきます
+- discord.py
+- requests
+- flask
+
+Discord Developer Portalにアクセス  
+https://discord.com/developers/applications  
+名前はなんでもいいのでアプリケーションを作成しましょう  
+作成したらまずOAuth2のGeneralからCLIENT IDとCLIENT SECRETを控えておきます  
+![1](image/1.png)  
+その下にあるRedirectsにFlaskサーバーを建てる場所を入力します  
+Flaskサーバーのデフォルトポートは5000なのでポートには5000と記入しておきます  
+##### この時末尾に"/"を入れるのを忘れないで！
+![2](image/2.png)  
+そうしたら1つ下にあるURL GeneratorのSCOPESで"identify"と"guilds.join"を選択、  
+SELECT REDIRECT URLにはさっき入力したアドレスを選択して認証に必要なURLを作成しましょう  
+このURLも後で使うので控えておきます  
+![3](image/3.png)  
+必要に応じてインテントの設定もしておいてください  
+もちろんBotなのでBotのトークンもコピーしておいてください  
+![7](image/7.png)  
+これでDeveloper Portalから必要になる情報は以上です  
+いったんDeveloper Portalを離れてローカル環境で編集します
+## ローカルでの作業
+リポジトリからnin.pyとninFlask.pyをダウンロードします  
+このBotはjson形式でユーザー情報を保存するので好きなところに好きな名前でjsonファイルを作ってください  
+この時作ったjsonファイルには {} とだけ記載しておいて、jsonとしてちゃんと機能するようにしておいてください  
+- 僕は"userdata.json"という名前で作成しました
+
+そうしたらエディターかメモ帳かでnin.pyとninFlask.pyを開きます  
+- 僕はVisual Studio Codeを使いました
+
+nin.pyとninFlask.py両方に記入欄があるので、記入欄に書いてある情報を入力していきます  
+上に貼り付けた僕の環境では下の画像のようになりました  
+###### nin.py
+![4](image/4.png)  
+###### ninFlask.py
+![6](image/6.png)
+![5](image/5.png)  
+これで2つとも保存すれば編集はおしまいです！おつかれさまでした！  
+nin.pyを実行すればBotが稼働します！  
+Botをサーバーに参加させて動作確認してみてください！
+### サーバーに接続できない、500が返される
+- ちゃんとポートが開放されているかチェックしてください
+- 自分のグローバルIPに自分のグローバルIPから接続することはできません、ローカルで動作チェックをするならローカルIPを使ってください  
+### /callや/request1をしてもユーザーの追加に失敗する
+- Botが参加していないサーバーには参加させることができません
+- 追加しようとしたあいてがアプリケーション認証を切っていると追加できません  
+  対策もありません、もういっかい認証してもらうしかないです
+### ロール付与に失敗する
+- Botにそのロールを付与する権限があるか確認してください  
+  また、付与できる状態かどうかも確認してください
+## Botコマンド
+- button  
+  登録リンクとロール付与のボタンを表示します  
+  タイトルと説明を省くとテンプレートの文章を送ります
+- call  
+  jsonに保存されたユーザー全員を追加します、誤爆には充分気をつけてください
+- request1  
+  指定したIDのユーザーを追加します  
+  サーバーIDを入力するとBotが参加している別のサーバーにも参加させることができます
+- check  
+  指定したユーザーIDの情報が登録されているか確認します
+- datacheck  
+  jsonに何人の情報が登録されているか確認します
+- delkey  
+  指定したユーザーIDの登録情報を削除します
+## コンタクト
+#### サポートサーバー  
+https://discord.gg/aSyaAK7Ktm  
+僕のDiscord -> .taka.  
+###### 余談ですがこのREADMEを書いてる途中に停電してデータふっとびました、悲しいです  
+###### わかりにくいとこがあったら指摘していただけるとありがたいです
+###### 最近、質問を多数いただいているのですがグローバルIPアドレスやjsonファイルの使い方みたいな初歩的すぎるものは自分で調べてくださいそれでもわからないならBotを作るのは向いてませんあとここの説明文はちゃんと読んでくださいすでに書いてあることを質問するのはやめてくださいおねがいします
+
+## サーバーごとに別ファイルを作る版、nin2の使い方
+![9](image/9.png)  
+こんな感じでuserdata.jsonの他にサーバーID.jsonも作ってくれるバージョンです  
+/callを使うとき、データサーバーIDの欄にIDを入力すると入力したIDのサーバーで登録したひとだけが追加されます  
+nin.pyとの違いはipath2にサーバーID.jsonが保存される"フォルダーのパス"を入力することくらいです  
+僕の環境では↓のようになりました  
+![8](image/8.png)  
+これだけでuserdata.json(全サーバーごっちゃのデータ)とサーバーID.json(IDのサーバーで登録したひとだけのデータ)の両方が作成され  
+マルチサーバーに対応させることができるようになりました  
+ninFlask.pyはそのままでだいじょうぶです
+
+## チェックボタンを押す必要のなくなったv2の使い方
+Flask Discord Extendedが必要になります  
+- pip install Flask-Discord-Extended
+
+FlaskのファイルにもBotのトークンとipath2の入力が必要になりました
+![10](image/10.png)  
+これだけです  
+バグとかおかしなとこがあれば連絡してくれると非常に助かります！！  
+##### v2alphaについて  
+nin(Flask)V2aのファイルはロールIDの受け渡しがjson経由になったものです  
+機能の変更はありませんがalpha版じゃないものとalpha版は混同して使うことができないので気をつけてください