Skip to main content

Data Collection

The collection proxy runs in transparent pass-through mode, without modifying any packets, only analyzing and recording heartbeat data to the data pool.

Page Layout

┌─────────────────────────────────────────────────────────┐
│ Listen Port: [1080] [Start Collection] [Stop] ● Run │
│ │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │ Complete │ │ Fragment │ │ Sticky │ │ Records │ │
│ │ 125 │ │ 3 │ │ 0 │ │ 88 │ │
│ └──────────┘ └──────────┘ └──────────┘ └──────────┘ │
│ │
│ [Game Config] [Signatures] [ID Filters] [Records] │
│ ┌───────────────────────────────────────────────────┐ │
│ │ (Current tab content area) │ │
│ └───────────────────────────────────────────────────┘ │
│ │
│ Packet List │
│ Header Filter: [☑01] [☑0A] [☐FF]... [Show All] [Hide] │
│ ┌────┬──────┬──────┬──────┬────────┬────┬────┬───┐ │
│ │ ID │ Type │Header│ Time │ GameID │Bits│Size│...│ │
│ ├────┼──────┼──────┼──────┼────────┼────┼────┼───┤ │
│ │ │ │ │ │ │ │ │ │ │
│ └────┴──────┴──────┴──────┴────────┴────┴────┴───┘ │
└─────────────────────────────────────────────────────────┘

Top Control Bar

Listen Port

The collection proxy listens on port 1080 by default (range 1-65535). Point the game client's SOCKS5 proxy to this port to begin collection.

Start and Stop

Click "Start Collection"/"Stop Collection" to control the service. Running status is displayed on the right.

Real-time Statistics

Four statistics cards at the top display in real-time:

CardColorDescription
CompleteGreenNon-fragmented packet count
FragmentYellowTCP-fragmented packet count
StickyRedMultiple packets merged together
RecordsBlueRecords displayed in the current list

Tab 1: Game Configuration

Manage game type labels identified during collection.

  • Current Type: Dropdown to select the current game type for collection
  • Delete: Remove the selected game type
  • Add New Game Type: Enter a name and click "Add" to create a new type
info

The game type list syncs to the heartbeat simulation page's game type filter dropdown.

Tab 2: Signature Management

The signature system provides more precise packet matching than simple header type filtering.

Left Panel: Signature List

Displays all configured signatures, each showing:

  • Enable Toggle: CheckBox to enable/disable
  • Signature Name
  • Feature Pattern: Byte matching pattern (e.g., 01 0A 00 23)
  • Match Mode: Header and other matching methods
  • Purpose Description
  • Category Tag and Priority
  • Delete Button

The top shows "Enabled X/Y" statistics.

Right Panel: Settings & Actions

System Settings:

SettingDescription
Enable Signature SystemMaster toggle
Fallback to Legacy MatchingFall back to header type matching when signatures don't match
Apply TemplateDropdown to select pre-built signature templates

Add Custom Signature:

  1. Enter signature name
  2. Enter feature pattern (e.g., 01 0A 00 23)
  3. Click "Add Signature"

Tab 3: Special ID Filters

Define which GameID data should be collected.

Left Side: Rule List

Displays all filter rules, each containing:

  • Rule Name
  • Enable Toggle: ToggleSwitch to enable/disable
  • Match Type Tag
  • Pattern Info
  • Delete Button

Shows "No filter rules" when the list is empty.

Right Side: Add New Rule

  1. Enter rule name
  2. Select match type (dropdown)
  3. Enter match pattern
  4. Click "Add Rule"

An example hint card at the bottom explains common rule patterns.

Tab 4: Records & Filters

Left Side: Record Controls

SettingDescription
Enable Packet RecordingToggleSwitch toggle
Max RecordsMaximum packets in memory (50-5000, default 200)
Clear ListManually delete all displayed collection records

Current record statistics are shown below.

Right Side: Target Address Filtering

Filter collection scope by connection target using radio buttons:

Filter TypeDescription
NoneCollect from all connections
By IPOnly collect from connections to specified IP
By DomainOnly collect from connections to specified domain
By PortOnly collect from connections to specified port

After selecting a filter type, enter the target in the "Filter Value" field, click "Apply Filter" to activate, or "Clear" to resume full collection. Current filter status is displayed.

tip

If unsure what data to collect, start with "None" mode to observe traffic, then set up filtering after identifying targets.

Bottom Packet List

Header Filter Bar

Check which header types to display in the list. Use "Show All"/"Hide All" buttons for quick operations.

Data Grid

ColumnDescription
IDSequence number
TypePacket type
HeaderHeader bytes
TimeCollection time
GameIDExtracted player identifier
BitsGameID byte length
SizePacket size
StatusProcessing status
StoredWhether stored in data pool
Skip ReasonReason for filtering or skipping
Data PreviewHex preview of raw data