User Tools

Site Tools


Sidebar

B3 Homepage


Main Links


Support Subjects


Related Links


This wiki was updated recently and all user accounts were reset. If you want to contribute to this documentation wiki drop me an email at xlr8or[at]bigbrotherbot[dot]net.

usage:teamkill_plugin

Teamkill Plugin

Whenever a user kills/bleeds a teammate they will be issued TK points. At a certain number a reprimand will automatically be issued. Should the team damage be an accident, the user that was offended can !forgive the offending user, thus clearing him of TK points. Should the team damage be intentional, a simple !grudge command will stop the offending user from being forgiven in future, thus speeding up the reprimand process.

For a complete description of commands see the “Commands”:/BigBrotherBot/big-brother-bot/manual-commands .

Configuration

Config location: b3/conf/plugin_tk.xml

settings

<settings name="settings">
	<!-- max_points: Maximum points before a player is kicked for tk damage. If a player reaches 150% this amount he will be kicked without warning. -->
	<set name="max_points">400</set>
	<!-- levels: Level definitions for tk point levels, comma seperated -->
	<set name="levels">0,1,2,20,40</set>
	<!-- round_grace: How many seconds after round start is considered fireing at spawn (0 = disabled) -->
	<set name="round_grace">7</set>
	<!-- issue_warning: Warning issued to players fireing at spawn. (before <round_grace> seconds after round start) -->
	<set name="issue_warning">sfire</set>
	<!-- grudge_enable: [yes/no] should the !grudge command be available -->
	<set name="grudge_enable">yes</set>
	<!-- private_messages: [yes/no] should messages sent privately to the offending player or should it be sent publicly ? -->
	<set name="private_messages">yes</set>
	<!-- damage_threshold: [0-100] how many damage points are enough will trigger a tk warning ? (100 damage points represent a kill) -->
	<set name="damage_threshold">100</set>
	<!-- warn_level: [0-100] only offenders in a B3 group of level lesser than warn_level will get warned -->
	<set name="warn_level">2</set>
	<!-- halflife: how many seconds after the start of the round will all players see their tk points halved. (0 = disabled) -->
	<set name="halflife">0</set>
	<!-- warn_duration: how long should tk warnings remain active. 30m = thirty minutes,  1h = one hour, 2d = two days -->
	<set name="warn_duration">1h</set>
</settings>

messages

<settings name="messages">
        <!-- ban: message given to banned players as a reason -->
        <set name="ban">^7team damage over limit</set>
        <!-- forgive: Message used when a player !forgives another.
             You can use keywords :
                $vname : victim's name
                $aname : attacker's name
                $point : tk points
        -->
        <set name="forgive">^7$vname^7 has forgiven $aname [^3$points^7]</set>
        <!-- grudged: Message used when a player !grudges another.
             You can use keywords :
                $vname : victim's name
                $aname : attacker's name
                $point : tk points
        -->
        <set name="grudged">^7$vname^7 has a ^1grudge ^7against $aname [^3$points^7]</set>
        <!-- forgive_many: Message used when a player !forgives many players.
             You can use keywords :
                $vname : the victim name
                $attackers : the list of attacker names
        -->
        <set name="forgive_many">^7$vname^7 has forgiven $attackers</set>
        <!-- forgive_warning: Warning displays when a user is about to be kicked for reaching the max_points.
             You can use keywords :
               $name : the player name
               $cid : the player database identifier
               $points : the number of damage points to forgive
        -->
        <set name="forgive_warning">^1ALERT^7: $name^7 auto-kick if not forgiven. Type ^3!forgive $cid ^7to forgive. [^3damage: $points^7]</set>
        <set name="no_forgive">^7no one to forgive</set>
        <!-- players: Message displayed for !forgivelist. "%s" will be replaced with the list of players that can be forgiven -->
        <set name="players">^7Forgive who? %s</set>
        <!-- forgive_info: Message displayed for !forgiveinfo
             You can use keywords :
               $name : the player name
               $points : the number of damage points to forgive
        -->
        <set name="forgive_info">^7$name^7 has ^3$points^7 TK points</set>
        <!-- forgive_clear: Message displayed for !forgiveclear
             You can use keywords :
               $name : the player name
               $points : the number of damage points to forgive
        -->
        <set name="forgive_clear">^7$name^7 cleared of ^3$points^7 TK points</set>
</settings>

level_#

TK level blocks define how TK points are acquired. A level_# block must be defined for each level defined by levels in [ settings ]. You do not have to make a level block for every level. You only have to define them for the levels in which the previous values change.

<settings name="level_0">
	<!--
	kill_multiplier: How many points times the damage dealt for kills
	damage_multiplier: How many points times the damage dealt for damage
	ban_length: How long bans last for players who reach max_points
	-->
	<set name="kill_multiplier">2</set>
	<set name="damage_multiplier">1</set>
	<set name="ban_length">2</set>
</settings>
<settings name="level_1">
	<set name="kill_multiplier">2</set>
	<set name="damage_multiplier">1</set>
	<set name="ban_length">2</set>
</settings>
<settings name="level_2">
	<set name="kill_multiplier">1</set>
	<set name="damage_multiplier">0.5</set>
	<set name="ban_length">1</set>
</settings>
<settings name="level_20">
	<set name="kill_multiplier">1</set>
	<set name="damage_multiplier">0.5</set>
	<set name="ban_length">0</set>
</settings>
<settings name="level_40">
	<set name="kill_multiplier">0.75</set>
	<set name="damage_multiplier">0.5</set>
	<set name="ban_length">0</set>
</settings>
usage/teamkill_plugin.txt · Last modified: 2013/01/24 00:00 (external edit)

Page Tools