Update manual

docs/en/manuals/physics-events.md

@@ -31,7 +31,9 @@ If a listener is set, [physics messages](/manuals/physics-messages) will no long
 
 ## Event Data Structure
 
-Each physics event provides a `data` table containing specific information relevant to the event.
+The listener is called with `self` and an `events` table. The `events` table is an array containing all physics events collected for the callback. Each entry is an event table with a `type` field containing the hashed event name and additional fields specific to that event type.
+
+The event tables contain the following data:
 
 1. **Contact Point Event (`contact_point_event`):**
 This event reports a contact point between two collision objects. It is useful for detailed collision handling, such as calculating impact forces or custom collision responses.

docs/es/manuals/physics-events.md

@@ -31,7 +31,9 @@ Si se define un listener, los [mensajes de físicas](/manuals/physics-messages)
 
 ## Estructura de datos de eventos
 
-Cada evento de físicas proporciona una tabla `data` que contiene información específica relevante para el evento.
+El listener se invoca con `self` y una tabla `events`. La tabla `events` es un array que contiene todos los eventos de físicas recopilados para la llamada. Cada entrada es una tabla de evento con un campo `type` que contiene el nombre del evento en formato hash y campos adicionales específicos de ese tipo de evento.
+
+Las tablas de eventos contienen los siguientes datos:
 
 1. **Evento de punto de contacto (`contact_point_event`):**
 Este evento informa de un punto de contacto entre dos objetos de colisión. Es útil para un manejo detallado de colisiones, como calcular fuerzas de impacto o respuestas de colisión personalizadas.

docs/ko/manuals/physics-events.md

@@ -31,7 +31,9 @@ end
 
 ## 이벤트 데이터 구조
 
-각 물리 이벤트는 해당 이벤트와 관련된 특정 정보를 담은 `data` 테이블을 제공합니다.
+리스너는 `self`와 `events` 테이블을 인자로 받아 호출됩니다. `events` 테이블은 콜백을 위해 수집된 모든 물리 이벤트를 담은 배열입니다. 각 항목은 해시된 이벤트 이름이 들어 있는 `type` 필드와 해당 이벤트 유형별 추가 필드로 구성된 이벤트 테이블입니다.
+
+이벤트 테이블에는 다음 데이터가 포함됩니다:
 
 1. **접촉점 이벤트 (`contact_point_event`):**
 이 이벤트는 두 충돌 오브젝트 사이의 접촉점을 보고합니다. 충격력 계산이나 커스텀 충돌 응답처럼 세부적인 충돌 처리를 할 때 유용합니다.

docs/pl/manuals/physics-events.md

@@ -31,7 +31,9 @@ Jeśli słuchacz zostanie ustawiony, [wiadomości fizyki](/manuals/physics-messa
 
 ## Struktura danych zdarzeń
 
-Każde zdarzenie fizyki udostępnia tabelę `data` zawierającą konkretne informacje istotne dla danego zdarzenia.
+Słuchacz jest wywoływany z argumentami `self` i tabelą `events`. Tabela `events` jest tablicą zawierającą wszystkie zdarzenia fizyki zebrane dla danego wywołania. Każdy element jest tabelą zdarzenia z polem `type`, które zawiera zahaszowaną nazwę zdarzenia, oraz dodatkowymi polami specyficznymi dla danego typu zdarzenia.
+
+Tabele zdarzeń zawierają następujące dane:
 
 1. **Zdarzenie punktu kontaktu (`contact_point_event`):**
 To zdarzenie raportuje punkt kontaktu między dwoma obiektami kolizji. Jest przydatne przy szczegółowej obsłudze kolizji, na przykład do obliczania sił uderzenia albo własnych reakcji na kolizję.

docs/pt/manuals/physics-events.md

@@ -31,7 +31,9 @@ Se um listener for definido, [mensagens de física](/manuals/physics-messages) n
 
 ## Estrutura de dados dos eventos
 
-Cada evento de física fornece uma tabela `data` contendo informações específicas relevantes para o evento.
+O listener é chamado com `self` e uma tabela `events`. A tabela `events` é um array que contém todos os eventos de física coletados para a chamada. Cada entrada é uma tabela de evento com um campo `type` que contém o nome do evento em formato hash e campos adicionais específicos desse tipo de evento.
+
+As tabelas de eventos contêm os seguintes dados:
 
 1. **Evento de ponto de contato (`contact_point_event`):**
 Este evento relata um ponto de contato entre dois objetos de colisão. Ele é útil para tratamento detalhado de colisões, como calcular forças de impacto ou respostas de colisão personalizadas.

docs/ru/manuals/physics-events.md

@@ -32,7 +32,9 @@ end
 
 ## Структура данных события
 
-Каждое физическое событие передает таблицу `data`, содержащую специфичную для этого события информацию.
+Обработчик вызывается с `self` и таблицей `events`. Таблица `events` представляет собой массив, содержащий все физические события, собранные для данного вызова. Каждый элемент — это таблица события с полем `type`, содержащим хэшированное имя события, и дополнительными полями, специфичными для данного типа события.
+
+Таблицы событий содержат следующие данные:
 
 1. **Событие точки контакта (`contact_point_event`):**
 Это событие сообщает о точке контакта между двумя объектами столкновения. Оно полезно для детальной обработки столкновений, например для расчета силы удара или реализации собственного отклика на столкновение.

docs/zh/manuals/physics-events.md

@@ -31,7 +31,9 @@ end
 
 ## 事件数据结构
 
-每个物理事件都提供一个包含与事件相关的特定信息的 `data` 表。
+监听器调用时会传入 `self` 和一个 `events` 表。`events` 表是一个数组，其中包含为此次回调收集的所有物理事件。每个元素都是一个事件表，其 `type` 字段包含散列后的事件名称，并包含该事件类型特有的其他字段。
+
+事件表包含以下数据：
 
 1. **接触点事件 (`contact_point_event`)：**
 此事件报告两个碰撞对象之间的接触点。它对于详细的碰撞处理很有用，例如计算冲击力或自定义碰撞响应。