Custom Cursor

Overview¶

Custom Cursor is a feature that allows users to load a desired cursor shape instead of a general mouse cursor into the Hive UI. Users can reduce the disparity in cursor styles between the game and the Hive UI by applying customized cursors to UIs provided by Hive, such as the terms and conditions pop-up and login pop-up, in addition to the game.

Supported file types¶

The following file types are supported as custom cursors:

• CUR file
• ICO file
• PNG file

Operation priority¶

The priority for loading cursor files in Hive SDK is as follows:

• If CUR, ICO, PNG files exist: Read each file in the order of file format CUR → ICO → PNG and display it as a cursor.
• If the file name (e.g. customcursor) is the same: Only the file read first among customcursor.cur, ​​customcursor.ico, customcursor.png files is displayed as a cursor according to priority.

User settings¶

To use a custom cursor, you must set the resource folder and specify the hotspot.

Resource folder settings¶

Place the file in the customcursor.extension name format under the Resources folder.

Hotspot designation¶

The hotspot designation method according to the cursor file type is as follows.

• CUR file: Contains hotspot information, and displays the cursor accurately based on this.

• ICO and PNG files: Since they do not contain hotspot information, they default to (0,0) as the hotspot.

Precautions¶

When applying the Custom Cursor feature to the Hive SDK, please note the following:

• The maximum supported resolution is 256x256 pixels. If the resolution of each CUR, ICO, or PNG file exceeds 256x256, the cursor may not be displayed properly.

• ICO and CUR files support multiple image sizes, but the Hive SDK only displays the cursor in the default size specified in advance.

• PNG files also consider transparent areas as image areas. Therefore, to avoid problems with specifying the top left as (0,0) hotspot, it is recommended not to use a transparent area in the top left.