#if defined _pex_included
    #endinput
#endif

#define _pex_included

/**
 * Called when the PEX configuration file has been reloaded.
 *
 * @param first_time  True if the file is read for the first time, false otherwise
 *
 * @noreturn
 */
forward pex_config_file_reloaded(bool:first_time)

/**
 * Called when the user's extras have been updated.
 *
 * @param id          Client index
 * @param on_connect  True if the forward was called when the client connected,
 *                    false otherwise
 *
 * @noreturn
 */
forward pex_user_extras_updated(id, bool:on_connect)

/**
 * Returns the name of the PEX configuration file.
 *
 * @param buffer      Buffer to store the filename in
 * @param len         Maximum buffer length
 *
 * @noreturn
 */
native pex_get_config_file(buffer[], len)

/**
 * Returns the extra value from a given extra.
 *
 * @param id          Client index
 * @param extra       Extra to get the value from
 * @param buffer      Buffer to store the extra value in
 * @param len         Maximum buffer length
 *
 * @noreturn
 */
native pex_get_extra_value(id, extra[], buffer[], len)

/**
 * Returns the name of the PEX extras list file.
 *
 * @param buffer      Buffer to store the filename in
 * @param len         Maximum buffer length
 *
 * @noreturn
 */
native pex_get_list_file(buffer[], len)

/**
 * Returns the number of total extras currently loaded.
 *
 * @return            Number of currently loaded extras
 */
native pex_get_total_extras()

/**
 * Returns the number of extras that the user currently has.
 *
 * @param id          Client index
 *
 * @return            Number of extras that the user has
 */
native pex_get_user_extras(id)

/**
 * Reloads the PEX configuration file
 *
 * @note This function won't work unless used in plugin_init()
 *
 * @param extra       Extra name
 * @param description Description for the extra
 * @param value       Extra value description (if available)
 *
 * @noreturn
 */
native pex_register_extra(extra[], description[], value[] = "")

/**
 * Reloads the PEX configuration file
 *
 * @noreturn
 */
native pex_reload_config_file()

/**
 * Reloads the user's extras.
 *
 * @param id          Client index
 *
 * @noreturn
 */
native pex_reload_user_extras(id)

/**
 * Checks whether the user has a specific extra.
 *
 * @param id          Client index
 * @param extra       Extra
 *
 * @return            True if the user has the extra, false otherwise
 */
native bool:pex_user_has_extra(id, extra[])