Please read the overwolf.games.events documentation page to learn how to use Overwolf game events.
Sample Apps
Available Features
Game event status
It is highly recommended to communicate errors and warnings to app users.
Check the current game event status here. Alternately, you can easily check that status from your app itself, using our API.
GEP supports the following Minecraft versions:
Supported vanila versions:
- 1.12.2 - support all events except chat, statistics, scene and player_x
- 1.16 - 1.16.1 - support all events except chat and statistics
- 1.16.2 - support all events except chat
- 1.17 - 1.20.2 - full support
Supported mod-loaders:
- Forge 36.0.0 - 36.2.39
- Forge 39.0.0 - 48.0.6
- Fabric 0.14.0 - 0.14.22
addons (mods) event is supported from Minecraft versions 1.8 to 1.19 for both Forge and Fabric
gep_internal
Info Updates
key | Category | Values | Notes | Since GEP Ver. |
---|---|---|---|---|
gep_internal | gep_internal | Local + Public version number | See notes | 143.0 |
gep_internal note
Data Example:
{"info":{"gep_internal":{"version_info":"{"local_version":"157.0.1","public_version":"157.0.1","is_updated":true}"}},"feature":"gep_internal"}
game_info
Info Updates
key | Category | Values | Notes | Since GEP Ver. |
---|---|---|---|---|
scene | game_info | The name of the current scene. | See notes | 153.0 |
name | game_info | The name of the local player. | See notes | 153.0 |
player_X | game_info | The list of players in the current game. | See notes | 191.0 |
mc_version | game_info | The current Minecraftt version played. | See notes | 205.0 |
scene note
Data Example:
{"info":{"game_info":{"scene":"Title Screen"}},"feature":"game_info"}
{"info":{"game_info":{"scene":"Select World"}},"feature":"game_info"}
name note
Data Example:
{"info":{"game_info":{"name":"OverwoldDeBest"}},"feature":"game_info"}
player_X note
- A full players list is sent each time a player get in or out from the game
- The position of each player in the list can vary from time to time
- In case "players visibility toggle" is turned on, this info update will not send values
Data Example:
{"feature":"game_info","category":"game_info","key":"player_3","value":"Nor555"}
mc_version note
Data Example:
{"info":{"game_info":{"mc_version":"1.18.2"}},"feature":"game_info"}
match_info
Info Updates
key | Category | Values | Notes | Since GEP Ver. |
---|---|---|---|---|
server | match_info | The full id of the server. | See notes | 153.0 |
general_stats | match_info | All of the current general statistics. | See notes | 153.0 |
items_stats | match_info | All of the current item statistics. | See notes | 153.0 |
mobs_stats | match_info | All of the current mob statistics. | See notes | 153.0 |
location | match_info | Current player's location in the game. | See notes | 157.0 |
facing | match_info | The current direction the player is facing. | See notes | 157.0 |
Events
Event | Event Data | Fired When | Notes | Since GEP Ver. |
---|---|---|---|---|
match_start | null | When loading into map. | See notes | 153.0 |
match_end | null | When disconnecting from map. | See notes | 153.0 |
chat | text | When chat window is updated. | See notes | 187.0 |
server note
Data Example:
{"info":{"match_info":{"server":"Play.datblock.com"}},"feature":"match_info"}
note regarding statistics
To activate and extract the data out of the statistics you must open the main menu (ESC) and click on the statistics.
general_stats note
Data Example:
{
"info": {
"match_info": {
"general_stats": "[ {
"name": "damage_absorbed",
"value": "0"
},
{
"name": "fall_one_cm",
"value": "0 cm"
},
{
"name": "walk_one_cm",
"value": "79.65 m"
},
...
{"name":"enchant_item","value":"0"}]"}},
"feature":"match_info"}
items_stats note
Data Example:
{"info":
{"match_info":{"items_stats":"[
{"name":"rass","value":"4","stat_type":"stat_type.minecraft.mined"},
{"name":"ead_bush","value":"31","stat_type":"stat_type.minecraft.mined"},
{"name":"ft.wheat_seeds","value":"6","stat_type":"stat_type.minecraft.picked_up"},
{"name":"ft.beef","value":"1","stat_type":"stat_type.minecraft.picked_up"},
{"name":"ft.leather","value":"1","stat_type":"stat_type.minecraft.picked_up"}]"}},
"feature":"match_info"}
mobs_stats note
Data Example:
{"info":{"match_info":{"mobs_stats":"[{"name":"cow","value":"1","stat_type":"stat_type.minecraft.killed"}]"}},"feature":"match_info"}
location note
Data Example:
{"info":{"match_info":{"location":"{"x":-289.403,"y":60.9237,"z":474.063}"}},"feature":"match_info"}
{"info":{"match_info":{"location":"{"x":-289.669,"y":60.4237,"z":475.049}"}},"feature":"match_info"}
{"info":{"match_info":{"location":"{"x":-290.248,"y":59.9237,"z":476.861}"}},"feature":"match_info"}
{"info":{"match_info":{"location":"{"x":-290.754,"y":59.4237,"z":478.788}"}},"feature":"match_info"}
facing note
Data Example:
{"info":{"match_info":{"facing":"{"x":146.851,"y":1.34979}"}},"feature":"match_info"}
match_start note
Data Example:
{"events":[{"name":"match_start","data":"null"}]}
match_end note
Data Example:
{"events":[{"name":"match_end","data":"null"}]}
chat note
Data Example:
{"events":[{"name":"chat","data":"§7overwolfqa§7: hello"}]}
game_info
Info Updates
key | Category | Values | Notes | Since GEP Ver. |
---|---|---|---|---|
scene | game_info | The name of the current scene. | See notes | 153.0 |
name | game_info | The name of the local player. | See notes | 153.0 |
scene note
Data Example:
{"info":{"game_info":{"scene":"Title Screen"}},"feature":"game_info"}
{"info":{"game_info":{"scene":"Select World"}},"feature":"game_info"}
name note
Data Example:
{"info":{"game_info":{"name":"OverwoldDeBest"}},"feature":"game_info"}
mods
Info Updates
key | Category | Values | Notes | Since GEP Ver. |
---|---|---|---|---|
addon_xxx | mods | Addons list used by the player | See notes | 190.0 |
addon_xxx note
- addons (mods) supported from Minecraft versions 1.8 to 1.18 for both Forge and Fabric
Data Example:
{"info":{"mods":{"addon_153":"{"name":"xpbook","display_name":"XP Tome","version":"2.1.3"}"}},"feature":"mods"}
counters
Info Updates
key | Category | Values | Notes | Since GEP Ver. |
---|---|---|---|---|
ping | performance | Latency changes of the local player in the current game. | See notes | 191.0 |
ping note
Data Example:
{"feature":"counters","category":"performance","key":"ping","value":"157"}