Skip to content

Config Settings

Jartan edited this page Feb 18, 2021 · 9 revisions

The Horizon config is intentionally minimalistic, making it as easy as possible to setup for new or inexperienced users.

cookie

A roblox .ROBLOSECURITY cookie must be entered here. For details on how to obtain this, please see the steps provided in the Quickstart page.

add_unvalued_to_value

Not all items have rolimons values. Set this to True if you want items without a rolimon value to have their RecentAveragePrice added to the total Value counters {give_roli_value} & {take_roli_value}.

From version v0.3.2-alpha, Horizon has support for Completed, Inbound, and Outbound notifications. All sections have the same setting names/functionality, so they will be covered just once.

enabled

This option enables or disables notifications for the type of trade that can be seen in brackets ([]) 2 lines above. Set to True to enable, or False to disable.

webhook

A discord webhook is essentially a URL that Horizon sends data to, which Discord receives and then displays for you in the channel you created it in.

For more information on how to create a Discord webhook and obtain a webhook url, please visit the Discord Support Intro to Webhooks page.

update_interval

How often to check for new trades.
Setting this lower than 10 seconds will likely result in ROBLOX rate-limiting your IP address, which will cause issues and slow down Horizon.
If you have other ROBLOX programs running on the same device/internet, I suggest increasing this to 30 seconds or above.

theme_name

The name of the theme that Horizon should use for this type of trade. This should be the name of the folder in which theme_setup.json is located in.

The default of basic_theme is acceptable.

webhook_content

The text you want sent alongside the notification. This can be anything up to 500 (?) characters. As of Horizon v0.3.2-alpha, keywords can be used within webhook_content that will be filled during runtime with data from the trade. See the Drawn Text section of the Creating a Theme Wiki page for details on how to use this. How to get IDs: https://support.discord.com/hc/en-us/articles/206346498-Where-can-I-find-my-User-Server-Message-ID
How to ping ping...
a User: <@UserID>
a Role: <@&RoleID>
everyone: @everyone
online users: @here

logging_level

This determines how much detail about what Horizon is doing should be saved to log files. Setting this too low will create huge log files in log folder.
Levels:
10 : DEBUG
20 : INFO
30 : WARNING
40 : ERROR
50 : CRITICAL

Unless Horizon is encountering issues, the default of 30 is usually acceptable.

testing

If set to True, Horizon will send a webhook notification for each of the enabled trade types.

double_check

If set to True, Horizon will wait ten seconds after detecting a new trade, check again for the trade, and if it still exists will send the notification. This is done to prevent outbound trades which seemingly get provided by ROBLOX accidentally in the Inbound section for a short period of time before it fixes itself.

This page is updated to Horizon v0.3.2-alpha
This concludes the documentation for horizon_config.ini. This documentation will be updated over time as more features are added.