TelegramボットでCraftlandマップの.metaを解析・編集するツール

Tool

概要

Craftland / Free Fireのカスタムマップで使われる.meta(メタ)ファイルを対象に、マップ情報の解析とマップコード(Place)の差し替えを行うTelegramボットです。ユーザーはTelegram上で.metaファイルを送信するだけで、マップ名、UID、所有者、マップタイプ、色付きの説明文などを抽出して表示でき、必要ならファイル内のマップコードを新しい値に書き換えた修正版をダウンロードできます。本リポジトリはシンプルに実装されており、main.py一つで動く軽量構成です。

GitHub

リポジトリの統計情報

  • スター数: 1
  • フォーク数: 0
  • ウォッチャー数: 1
  • コミット数: 6
  • ファイル数: 3
  • メインの言語: Python

主な特徴

  • Telegramボット経由で.metaファイルを解析し、マップの主要メタ情報を抽出して表示
  • .meta内のマップコード(Place)を指定値に置き換え、修正ファイルを生成して送信
  • テキスト部とバイナリ部の両方を読み取り、色付き記述などの文字列情報を維持・解析
  • 単一のmain.pyで完結する軽量実装(導入が容易)

技術的なポイント

このプロジェクトは、.metaファイルが持つ「テキスト領域」と「バイナリ領域(あるいは固定長データ)」の混在を前提に、バイトストリームと文字列解析を組み合わせて実装されています。Telegram Bot APIを介してファイルを受け取り、サーバ上でバイト単位で読み出してから正規表現やバイト列検索でUIDやPlaceタグを探索します。説明文に含まれる色コードやタグはエスケープや制御文字を考慮して抽出・復元され、表示用に整形します。Place(マップコード)の差し替えはバイナリ上の該当オフセットを上書きする形で行われるため、元のファイル長や並びを保持する処理が重要です。実装上の注意点として、文字コード(UTF-8や特定のエンコーディング)やバッファサイズ、置換後の長さが元と異なる場合のパディング/トリミング、バックアップの生成などがデリケートです。本リポジトリは最小限の依存で動作する設計になっており、ローカル実行または小規模なホスティング環境で稼働させやすい点が特徴です。エラー処理は基本的なバリデーション(ファイル形式チェック、必須フィールドの有無)を提供しますが、実運用では追加の安全対策(署名検証や事前バックアップ)を推奨します。

プロジェクトの構成

主要なファイルとディレクトリ:

  • LICENSE: file(ライセンス情報)
  • README.md: file(プロジェクトの説明、使い方、機能一覧)
  • main.py: file(Telegramボットの本体。ファイル受信、解析、置換、送信のロジックを包含)

main.pyはボットのエントリポイントで、Telegram APIの受信イベントを監視してアップロードされたファイルを取得、解析関数群に渡して結果を作成し、ユーザーに解析内容や修正済みファイルを返却する流れで構成されています。依存は最低限に抑えられ、外部ライブラリを使う場合でもREADMEに記載された手順でセットアップ可能です。

まとめ

シンプルで実用的なTelegramベースの.meta解析・置換ツール。導入が容易でカスタマイズしやすい。

リポジトリ情報:

READMEの抜粋:

BOT-TELEGRAM-Change-Craftland-Map-Place


🧾 README.md

# 🔍 Meta Analyzer & Map Modifier Bot (Telegram)

بوت تيليجرام ذكي لتحليل وتعديل ملفات `.meta` الخاصة بخوادم **Craftland / Free Fire Custom Maps**.  
يُظهر تفاصيل دقيقة عن الخريطة، ويمكنه استبدال كود الخريطة داخل الملف بسهولة.

---

## ⚙️ المميزات

- تحليل كامل لملفات `.meta` (نصوص + بيانات ثنائية)
- استخراج:
  - اسم الخريطة
  - UID
  - صاحب الخريطة
  - نوع الخريطة (الكود)
  - الوصف الكامل مع ألوان النصوص
  - آخر ت...
```