Escapers Zone

Code: Select all

#include <ze_zombie_classes_const>
 
/*****************************************/
/************   FORWARDS    **************/
/*****************************************/
 
/**
 * Called when determining whether a class should be available to a player.
 *
 * Possible return values are:
 *  - ZE_CLASS_AVAILABLE (show in menu, allow selection)
 *  - ZE_CLASS_UNAVAILABLE (show in menu, don't allow selection)
 *  - ZE_CLASS_DONT_SHOW (don't show in menu, don't allow selection)
 *
 * @param id            Player index.
 * @param classid       Internal zombie class ID.
 */
forward ze_select_zombie_class_pre(id, classid)
 
/**
 * Called right after a player selects a class from the menu.
 *
 * @param id            Player index.
 * @param classid       Internal zombie class ID.
 */
forward ze_select_zombie_class_post(id, classid)
 
/*****************************************/
/************** NATIVES ******************/
/*****************************************/
 
/**
 * Returns a player's current zombie class ID.
 *
 * @param id        Player index.
 * @return          Internal zombie class ID, or ZE_WRONG_ZOMBIE_CLASS if not yet chosen.
 */
native ze_get_current_zombie_class(id)
 
/**
 * Returns a player's next zombie class ID (for the next infection).
 *
 * @param id        Player index.
 * @return          Internal zombie class ID, or ZE_WRONG_ZOMBIE_CLASS if not yet chosen.
 */
native ze_get_next_zombie_class(id)
 
/**
 * Sets a player's next zombie class ID (for the next infection).
 *
 * @param id        Player index.
 * @param classid   A valid zombie class ID.
 * @return          True on success, false otherwise.
 */
native ze_set_next_zombie_class(id, classid)
 
/**
 * Returns the default maximum health for a specific zombie class.
 *
 * Note: does not take into account any kind of HP multipliers.
 *
 * @param id        Player index.
 * @param classid   A valid zombie class ID.
 * @return          Maximum amount of health points, -1 on error.
 */
native ze_get_zombie_class_health(id, classid)
 
/**
 * Registers a custom class which will be added to the zombie classes menu of ZP.
 *
 * Note: The returned zombie class ID can be later used to identify
 * the class when calling the zp_get_user_zombie_class() natives.
 *
 * @param name          Caption to display on the menu.
 * @param description   Brief description of the class.
 * @param health        Class health.
 * @param speed         Class maxspeed (can be a multiplier).
 * @param gravity       Class gravity multiplier.
 * @return              An internal zombie class ID, or ZE_WRONG_ZOMBIE_CLASS on failure.
 */
native ze_register_zombie_class(const name[], const description[], health, speed, gravity)
 
/**
 * Returns a zombie class' ID.
 *
 * @param name      Class name to look for.
 * @return          Internal zombie class ID, or ZE_WRONG_ZOMBIE_CLASS if not found.
 */
native ze_get_zombie_class_id(const real_name[])
 
/**
 * Returns a zombie class' name.
 *
 * @param classid   A valid zombie class ID.
 * @param name      The buffer to store the string in.
 * @param len       Character size of the output buffer.
 * @return          True on success, false otherwise.
 */
native ze_get_zombie_class_name(classid, name[], len)
 
/**
 * Returns a zombie class' description.
 *
 * @param classid       A valid zombie class ID.
 * @param description   The buffer to store the string in.
 * @param len           Character size of the output buffer.
 * @return              True on success, false otherwise.
 */
native ze_get_zombie_class_desc(classid, description[], len)
 
/**
 * Returns number of registered zombie classes.
 *
 * @return          Zombie class count.
 */
native ze_get_zombie_class_number()
 
/**
 * Shows menu with available zombie classes to a player.
 *
 * @param id        Player index.
 */
native ze_open_zombie_classes_menu(id)
 
/**
 * Appends text to a class being displayed on the zombie classes menu.
 * Use this on the class select pre forward.
 *
 * @param text      Additional text to display.
 */
native ze_add_zombie_class_menu_text(const text[])