File /global/playtester.c

See also:
/global/player.c

Written by Pinkfish

Started Tue Jun 25 11:27:05 PDT 2002

Inherits

Includes

Class Index

• playtester_data

Method index

• add_skill_level(string, int, mixed)
  Mask this and don't let the skill's be upped if we are mangleing the skills.
• advancement_restriction()
• disable_damage_log()
  This method disables logging of PT fake damage.
• disable_death_log()
  This method disables logging of PT fake deaths.
• disable_personal_pt_protection()
  This method resets the protect flag so that adjust_hp and do_death are not masked, i.
• disable_pt_protection()
  This method sets the PT as no longer being under room protection.
• enable_damage_log()
  This method enables logging of PT fake damage.
• enable_death_log()
  This method enables logging of PT fake deaths.
• enable_personal_pt_protection()
  This method sets the protect flag so that adjust_hp and do_death are masked.
• enable_pt_protection()
  This method sets the PT as being under room protection.
• pt_adjust_hp(int, object, object, string)
  This method adjusts the fake hitpoints.
• pt_do_death()
  This method replaces the normal do_death() when testing.
• pt_query_hp()
  This method returns the number of fake hitpoints.
• pt_set_hp(int)
  This method sets the fake hitpoints.
• query_contractable()
• query_in_pt_arena()
• query_log_damage()
  This method returns the status of the LOG_DAMAGE flag, i.
• query_log_death()
  This method returns the status of the LOG_DEATH flag, i.
• query_playtester()
  This method tells us if the object is a playtester or not.
• query_pt_area(object)
• query_pt_exec()
  This method returns if the player is a pt exec or not.
• query_pt_log_file()
  This method returns the log file for logging of PT fake deaths and damage.
• query_pt_protection()
  This method returns the status of the protect flag.
• query_real_skill_level(string)
  This returns the real unadulterated level of the pt.
• query_senior_playtester(string)
  This method returns if the player is a pt senior or not.
• query_skill(string)
  The playtester override for the query_skill function to allow various skill levels to be set.
• query_skill_mangle()
  This method returns the current skill mangle setting.
• query_skills_being_mangled()
  This method returns the current set of skills being mangled.
• remove_skill_mangle_level(string)
  This method removes a skill mangle level.
• set_pt_log_file(string)
  This method sets the log file for logging of PT fake deaths and damage.
• set_skill_mangle(int)
  This sets the mangle skills flag.
• set_skill_mangle_level(string, int)
  This sets the mangle level for the specific skill.

Public Functions

These are functions that everyone can access.

.

add_skill_level

varargs int add_skill_level(string skill,
                            int lvl,
                            mixed exp)


Mask this and don't let the skill's be upped if we are mangleing the skills.
advancement_restriction

int advancement_restriction()

disable_damage_log

void disable_damage_log()


This method disables logging of PT fake damage.
disable_death_log

void disable_death_log()


This method disables logging of PT fake deaths.
disable_personal_pt_protection

int disable_personal_pt_protection()


This method resets the protect flag so that adjust_hp and do_death are not masked, i.e. the player can be hurt in the normal(*) way. (*) Having "normal" ways to hurt people is quite sick... But it's fnu!
disable_pt_protection

int disable_pt_protection()


This method sets the PT as no longer being under room protection. Room protection does not expire and lasts until it is switched off. It also over-rides personal protection.

• Returns:
  1 on success, 0 on failure.

enable_damage_log

void enable_damage_log()


This method enables logging of PT fake damage.
enable_death_log

void enable_death_log()


This method enables logging of PT fake deaths.
enable_personal_pt_protection

int enable_personal_pt_protection()


This method sets the protect flag so that adjust_hp and do_death are masked.
enable_pt_protection

int enable_pt_protection()


This method sets the PT as being under room protection. Room protection does not expire and lasts until it is switched off. It also over-rides personal protection.

• Returns:
  1 on success, 0 on failure.
  pt_adjust_hp

  varargs int pt_adjust_hp(int hp,
                           object attacker,
                           object weapong,
                           string attack)
  

  
  This method adjusts the fake hitpoints.
  
  • Parameters:
    hp - The value to add to fake hitpoints
  • Returns:
    hp after adjustment
    pt_do_death

    object pt_do_death()
    

    
    This method replaces the normal do_death() when testing. It gives players a message about how it would have hurt if it had been for real.
    
    • Parameters:
      thing - The object that killed us.
    • Returns:
      A corpse
      pt_query_hp

      int pt_query_hp()
      

      
      This method returns the number of fake hitpoints.
      
      • Returns:
        The number of fake hitpoints
        pt_set_hp

        void pt_set_hp(int hp)
        

        
        This method sets the fake hitpoints.
        
        • Parameters:
          hp - The new value of fake hitpoints
          query_contractable

          int query_contractable()
          

          query_in_pt_arena

          int query_in_pt_arena()
          

          query_log_damage

          int query_log_damage()
          

          
          This method returns the status of the LOG_DAMAGE flag, i.e. whether PT fake damage is logged or not.
          
          • Returns:
            Status of LOG_DAMAGE flag
            query_log_death

            int query_log_death()
            

            
            This method returns the status of the LOG_DEATH flag, i.e. whether PT fake deaths are logged or not.
            
            • Returns:
              Status of LOG_DEATH flag
              query_playtester

              int query_playtester()
              

              
              This method tells us if the object is a playtester or not.
              
              • Returns:
                1 if the object is a creator, 0 if not.
                query_pt_area

                int query_pt_area(object ob)
                

                query_pt_exec

                int query_pt_exec()
                

                
                This method returns if the player is a pt exec or not.
                
                • Parameters:
                  player - the player to query
                • Returns:
                  1 if they are an exec, 0 if not
                  query_pt_log_file

                  string query_pt_log_file()
                  

                  
                  This method returns the log file for logging of PT fake deaths and damage. The default is /d/playtesters/log/pain.
                  
                  • Returns:
                    The filename of the log file.
                    query_pt_protection

                    int query_pt_protection()
                    

                    
                    This method returns the status of the protect flag. 2 means that they have their room protection enabled, 1 means that they have their personal protection enabled, 0 means that they are not.
                    
                    • Returns:
                      The value of the protect flag
                      query_real_skill_level

                      int query_real_skill_level(string skill)
                      

                      
                      This returns the real unadulterated level of the pt.
                      query_senior_playtester

                      int query_senior_playtester(string player)
                      

                      
                      This method returns if the player is a pt senior or not.
                      
                      • Parameters:
                        player - the player to query
                      • Returns:
                        1 if they are an senior, 0 if not
                        query_skill

                        int query_skill(string skill)
                        

                        
                        The playtester override for the query_skill function to allow various skill levels to be set.
                        query_skill_mangle

                        int query_skill_mangle()
                        

                        
                        This method returns the current skill mangle setting.
                        
                        • Returns:
                          the skill mangle setting
                          query_skills_being_mangled

                          mapping query_skills_being_mangled()
                          

                          
                          This method returns the current set of skills being mangled.
                          remove_skill_mangle_level

                          void remove_skill_mangle_level(string skill)
                          

                          
                          This method removes a skill mangle level.
                          set_pt_log_file

                          void set_pt_log_file(string str)
                          

                          
                          This method sets the log file for logging of PT fake deaths and damage. The default is /d/playtesters/log/pain.
                          
                          • Parameters:
                            str - The filename of the log file.
                            set_skill_mangle

                            void set_skill_mangle(int flag)
                            

                            
                            This sets the mangle skills flag.
                            
                            • Parameters:
                              flag - enable or disable mangling skills
                              set_skill_mangle_level

                              int set_skill_mangle_level(string skill,
                                                         int lvl)
                              

                              
                              This sets the mangle level for the specific skill.
                              
                              • Parameters:
                                skill - the skill to mangle
                                lvl - the level to set it to

                                Classes

                                These are nice data types for dealing with... Data!
                                • playtester_data

                                  class playtester_data {
                                                          int protect;
                                                          int hp;
                                                          string log_file;
                                                          int log_death;
                                                          int log_damage;
                                                          int turn_off;
                                                          int protection_counter;
                                                          int room_protection;
                                                          int skill_mangle;
                                                          mapping skills;
                                  }