minecraft 0.2.1 → 0.3.0

data/CHANGES.md

@@ -1,3 +1,18 @@
+0.3.0 (2011-08-29)
+------------------
+
+* Added `!warptime`, `!stop`, `!welcome`, `!memo`, `!disco`, `!dnd`, `!disturb`, `!printdnd`, `!todo`, `!finished`.
+* Moved time commands out of `method_missing`.
+* Added capability for users to not be disturbed by teleporting or `all` commands.
+* Removed `add_command` calls, now indexes information from source code on initialization.
+* Added more documentation (back at 100% coverage).
+* Added many more test suites.
+* Misc. bug fixes including lots of command feedback.
+* Shortcuts and kits can now be accessed with `:` instead of `!s` or `!kit`.
+* `!help` is now dynamic and includes command-specific help.
+* Coloured terminal output.
+* Basic word wrapped output.
+
 0.2.1 (2011-08-22)
 ------------------
 

data/README.md

@@ -70,6 +70,18 @@ Please refer to `Minecraft::Extensions#initialize`.
     !board <user>                 # Check a users points.
     !board                        # View the leaderboard of points.
     !om <noms>                    # Give golden apples equivalent to the number of noms.
+    !warptime                     # Prints the current time rate.
+    !warptime <rate>              # Adds <rate> seconds every ten seconds to time.
+    !stop                         # Stops all the users timers.
+    !welcome                      # Changes the welcome message during runtime.
+    !memo <user> <message>        # Leaves a memo for the user.
+    !disco                        # Turns time into a dancefloor.
+    !dnd                          # Toggles the users do-not-disturb status.
+    !disturb <user>               # An op can remove a user from the DND list.
+    !printdnd                     # Prints the list of do-not-disturbed users.
+    !todo                         # Prints the list of items todo.
+    !todo <item>                  # Adds a todo list item.
+    !finished <item>              # Removes an item from the todo list.
 
 Development Path
 ----------------

data/bin/minecraft

@@ -19,6 +19,7 @@ opts = Slop.parse :help => true do
   banner "Usage: minecraft [options]"
 
   option :n, :no_run,          "Don't run the Minecraft server instance."
+  option :no_colour,           "Don't have coloured output on the server side."
   option :u, :update,          "Download the latest version of the Minecraft server jarfile."
   option :s, :min_memory,      "Specify the minimum amount of memory to allocate.", :optional => true
   option :x, :max_memory,      "Specify the maximum amount of memory to allocate.", :optional => true

data/lib/minecraft/commands.rb

@@ -4,6 +4,189 @@ module Minecraft
   module Commands
     include Data
 
+    # Allows a user to specify a periodic (once every ten seconds) time change.
+    #
+    # @param [String] user The requesting user.
+    # @param [Integer] time_change Amount of time to add (can be negative or
+    # positive) every ten seconds.
+    # @example
+    #   warptime("basicxman", "5")
+    #   warptime("basicxman")
+    # @note ops: op
+    def warptime(user, time_change = nil)
+      if time_change.nil?
+        return @server.puts "say Current rate: #{@time_change} every ten seconds." if @time_change
+        return @server.puts "say No custom rate specified."
+      end
+
+      time_change = time_change.to_i
+      if time_change < 0
+        @time_change = [-1000, time_change].max
+      else
+        @time_change = [1000, time_change].min
+      end
+      @server.puts "say New rate: #{@time_change} every ten seconds."
+    end
+
+    # Adds a memo for the specified user.
+    #
+    # @param [String] user The requesting user.
+    # @param [String] target_user The target user.
+    # @param args The memo.
+    # @example
+    #   memo("basicxman", "mike_n_7", "Hi!")
+    # @note ops: none
+    def memo(user, target_user, *args)
+      target_user = target_user.downcase
+      if @memos.has_key? target_user and @memos[target_user].length == 5
+        return @server.puts "say #{target_user} has too many memos already!"
+      end
+
+      @memos[target_user] ||= []
+      @memos[target_user] << [user, args.join(" ")]
+      say "Memo for #{target_user} added. Will be printed next time s/he logs in."
+    end
+
+    # Stops all timers for a user.
+    #
+    # @param [String] user The requesting user.
+    # @example
+    #   stop("basicxman")
+    # @note ops: hop
+    def stop(user)
+      @timers.delete user
+      @server.puts "say #{user} has stopped all his/her timers."
+    end
+
+    # Changes or appends to the welcome message.  Use !welcome + foo to add foo.
+    #
+    # @param [String] user The requesting user.
+    # @param args The welcome message.
+    # @example
+    #   welcome("basicxman", "Welcome", "to", "the", "server")
+    #   welcome("basicxman", "+", "%")
+    # @note ops: op
+    def welcome(user, *args)
+      if args.first == "+"
+        @welcome_message += " " + args[1..-1].join(" ")
+        @server.puts "say Appended to welcome message."
+      else
+        @welcome_message = args.join(" ")
+        @server.puts "say Changed welcome message."
+      end
+      display_welcome_message("basicxman")
+    end
+
+    # Changes to dawn.
+    #
+    # @example
+    #   dawn()
+    # @note ops: op
+    def dawn()
+      change_time(:dawn)
+    end
+
+    # Changes to dusk.
+    #
+    # @example
+    #   dusk()
+    # @note ops: op
+    def dusk()
+      change_time(:dusk)
+    end
+
+    # Changes to day.
+    #
+    # @example
+    #   day()
+    # @note ops: op
+    def day()
+      change_time(:day)
+    end
+
+    # Changes to night.
+    #
+    # @example
+    #   night()
+    # @note ops: op
+    def night()
+      change_time(:night)
+    end
+
+    # Changes to morning.
+    #
+    # @example
+    #   morning()
+    # @note ops: op
+    def morning()
+      change_time(:morning)
+    end
+
+    # Changes to evening.
+    #
+    # @example
+    #   evening()
+    # @note ops: op
+    def evening()
+      change_time(:evening)
+    end
+
+    # Toggles disco.
+    #
+    # @param [String] user The requesting user.
+    # @example
+    #   disco("basicxman")
+    # @note ops: op
+    def disco(user)
+      @disco ||= false
+      if @disco
+        @server.puts "say Disco ends."
+        @disco = false
+      else
+        @server.puts "say #{user} has requested disco, s/he likely can't actually dance."
+        @disco = true
+      end
+    end
+
+    # Stops users from disturbing you.
+    #
+    # @param [String] user The requesting user.
+    # @example
+    #   dnd("basicxman")
+    # @note ops: none
+    def dnd(user)
+      user.downcase!
+      if @userdnd.include? user
+        @server.puts "say #{user} is ready to be disturbed. *cough*"
+        @userdnd.reject! { |u| u == user }
+      else
+        @server.puts "say #{user} does not wish to be disturbed."
+        @userdnd << user
+      end
+    end
+
+    # Removes somebody from the DND list.
+    #
+    # @param [String] user The requesting user.
+    # @param [String] target_user The target user.
+    # @example
+    #   disturb("basicxman", "mike_n_7")
+    # @note ops: op
+    def disturb(user, target_user)
+      @server.puts "say #{target_user} is being disturbed by #{user}!"
+      @userdnd.reject! { |u| u == target_user.downcase }
+    end
+
+    # Prints the users who do not wish to be disturbed.
+    #
+    # @param [String] user The requesting user.
+    # @example
+    #   printdnd()
+    # @note: ops: op
+    def printdnd()
+      @server.puts "say #{@userdnd.join(", ")}"
+    end
+
     # Gives a user a specific amount of points, the quantity is capped
     # depending on the privileges of the user.
     #
@@ -13,13 +196,22 @@ module Minecraft
     # @example
     #   points("basicxman", "mike_n_7")
     #   points("basicxman", "mike_n_7", "50")
+    # @note ops: none
     def points(user, target_user, num_points = 1)
-      if user.downcase == target_user.downcase
+      target_user = target_user.downcase
+      num_points = num_points.to_i
+      if user.downcase == target_user
         @server.puts "say Did you just try to give yourself points? Sure, minus twenty."
         @userpoints[target_user] ||= 0
         @userpoints[target_user] -= 20
+        return
+      elsif num_points < 0
+        @server.puts "say Subtracting points? For shame."
+        @userpoints[user] ||= 0
+        @userpoints[user] -= num_points
+        return
       end
-      num_points = [num_points.to_i, cap_points(user)].min
+      num_points = [num_points, cap_points(user)].min
       @userpoints[target_user] ||= 0
       @userpoints[target_user] += num_points
       @server.puts "say #{user} has given #{target_user} #{num_points} points for a total of #{@userpoints[target_user]}."
@@ -32,6 +224,7 @@ module Minecraft
     # @example
     #   board("basicxman")
     #   board("basicxman", "mike_n_7")
+    # @note ops: none
     def board(user, target_user = nil)
       if target_user.nil?
         leaderboard = {}
@@ -54,18 +247,6 @@ module Minecraft
       end
     end
 
-    # Caps the quantity of points able to be given based on requesting user.
-    #
-    # @param [String] user The requesting user.
-    # @return [Integer] Maximum quantity of points.
-    # @example
-    #   cap_points("basicxman")
-    def cap_points(user)
-      return 1000 if is_op? user
-      return 500  if is_hop? user
-      return 1
-    end
-
     # Initiates or votes for a specific user to be kicked, since half-ops and
     # regular connected players cannot kick users they can initiate a vote
     # instead.
@@ -76,6 +257,7 @@ module Minecraft
     # @example
     #   kickvote("basicxman", "blizzard4U")
     #   kickvote("basicxman")
+    # @note ops: none
     def kickvote(user, target_user = nil)
       return @server.puts "say No user #{target_user} exists." unless @users.include? target_user
       return vote(user) if target_user.nil?
@@ -96,6 +278,7 @@ module Minecraft
     # @param [String] user The requesting user.
     # @example
     #   vote("basicxman")
+    # @note ops: none
     def vote(user)
       unless submit_vote(user, @last_kick_vote)
         @server.puts "say No kickvote was initiated, dummy."
@@ -108,6 +291,7 @@ module Minecraft
     # @param [String] target_user The user which currently has a kickvote.
     # @example
     #   cancelvote("basicxman", "blizzard4U")
+    # @note ops: op
     def cancelvote(user, target_user)
       if @kickvotes.has_key? target_user
         @kickvotes.delete(target_user)
@@ -122,77 +306,20 @@ module Minecraft
     # @param [String] user The requesting user.
     # @example
     #   kickvotes("basicxman")
+    # @note ops: op
     def kickvotes(user)
       @kickvotes.each do |target_user, data|
         @server.puts "say #{target_user}: #{data[:tally]} #{data[:votes].map { |u| u[0] + u[-1] }.join(", ")}"
       end
     end
 
-    # Submits a kickvote.
-    #
-    # @param [String] user The requesting user who is voting.
-    # @param [String] target_user The user being voted against.
-    # @return [Boolean] Returns true if the kickvote has been initiated yet.
-    # @example
-    #   submit_vote("basicxman", "blizzard4U")
-    def submit_vote(user, target_user)
-      return unless @users.include? target_user
-      if @kickvotes.has_key? target_user
-        if @kickvotes[target_user][:votes].include? user
-          @server.puts "say You have already voted."
-        else
-          @kickvotes[target_user][:votes] << user
-          @kickvotes[target_user][:tally] += kick_influence(user)
-          check_kickvote(target_user)
-        end
-        return true
-      else
-        return false
-      end
-    end
-
-    # Checks a kickvote entry to see if the tally number has crossed the
-    # threshold, if so, kicks the user.
-    #
-    # @param [String] user The specified user.
-    # @example
-    #   check_kickvote("blizzard4U")
-    def check_kickvote(user)
-      if @kickvotes[user][:tally] >= @vote_threshold
-        @server.puts "say Enough votes have been given to kick #{user}."
-        @server.puts "kick #{user}"
-        @kickvotes.delete(user)
-      end
-    end
-
-    # Computes the influence a user has for kickvotes.
-    #
-    # @param [String] user The specified user.
-    # @return [Integer] The influence level.
-    # @example
-    #   kick_influence("basicxman")
-    def kick_influence(user)
-      return 3 if is_op? user
-      return 2 if is_hop? user
-      return 1
-    end
-
-    # Checks to see if any kickvotes are expired.
-    def expire_kickvotes
-      @kickvotes.each do |target_user, data|
-        if Time.now > data[:start] + @vote_expiration
-          @server.puts "say The kickvote for #{target_user} has expired."
-          @kickvotes.delete(target_user)
-        end
-      end
-    end
-
     # Kicks a random person, the requesting user has a higher cance of being
     # picked.
     #
     # @param [String] user The requesting user.
     # @example
     #   roulette("basicxman")
+    # @note ops: op
     def roulette(user)
       users = @users + [user] * 3
       picked_user = users.sample
@@ -200,24 +327,13 @@ module Minecraft
       @server.puts "kick #{picked_user}"
     end
 
-    # Changes the time of day.
-    #
-    # @param [String] time The time of day to change it to.
-    # @example
-    #   change_time("morning")
-    def change_time(time)
-      return false unless TIME.include? time
-      @server.puts "time set #{TIME[time]}"
-      @server.puts "say #{TIME_QUOTES[time]}" unless TIME_QUOTES[time] == ""
-      return true
-    end
-
     # Gives half-op privileges to the target user.
     #
     # @param [String] user The requesting user.
     # @param [String] target_user The target user to be hop'ed.
     # @example
     #   hop("basicxman", "blizzard4U")
+    # @note ops: op
     def hop(user, target_user)
       @hops << target_user.downcase unless @hops.include? target_user.downcase
       @server.puts "#{target_user} is now a hop, thanks #{user}!"
@@ -229,6 +345,7 @@ module Minecraft
     # @param [String] target_user The target user to be de-hop'ed.
     # @example
     #   dehop("basicxman", "blizzard4U")
+    # @note ops: op
     def dehop(user, target_user)
       @hops.reject! { |u| u == target_user.downcase }
       @server.puts "#{target_user} has been de-hoped, thanks #{user}!"
@@ -244,6 +361,8 @@ module Minecraft
     #   give("basicxman", "cobblestone", "9m")
     #   give("basicxman", "flint", "and", "steel", "1")
     #   give("basicxman", "4")
+    # @note ops: hop
+    # @note all: is putting out.
     def give(user, *args)
       item, quantity = items_arg(1, args)
       item = resolve_item(item)
@@ -251,14 +370,6 @@ module Minecraft
       construct_give(user, item, quantity)
     end
 
-    # Validates a kit group, if the kit cannot be found it executes the
-    # !kitlist command.
-    def validate_kit(group = "")
-      return true if KITS.include? group.to_sym
-      @server.puts "say #{group} is not a valid kit."
-      kitlist
-    end
-
     # Kit command takes a group name and gives the contents of the kit to the
     # target user.
     #
@@ -266,6 +377,8 @@ module Minecraft
     # @param [String] group Label of the kit.
     # @example
     #   give("basicxman", "diamond")
+    # @note ops: hop
+    # @note all: is providing kits to all.
     def kit(user, group)
       KITS[group.to_sym].each do |item|
         if item.is_a? Array
@@ -282,7 +395,10 @@ module Minecraft
     # @param [String] target User to teleport to.
     # @example
     #   tp("basicxman", "mike_n_7")
+    # @note ops: hop
+    # @note all: is teleporting all users to their location.
     def tp(user, target)
+      return if check_dnd(target)
       @server.puts "tp #{user} #{target}"
     end
 
@@ -290,9 +406,9 @@ module Minecraft
     #
     # @param [String] user Current (target) user.
     # @example
-    #   tp("basicxman")
-    def tpall(user, *args)
-      @users.each { |u| tp(u, user) }
+    #   tpall("basicxman")
+    def tpall(user)
+      @users.each { |u| tp(u, user) unless @userdnd.include? u.downcase }
     end
 
     # Gives a golden apple to the specified user.
@@ -300,6 +416,8 @@ module Minecraft
     # @param [String] user Target user.
     # @example
     #   nom("basicxman")
+    # @note ops: hop
+    # @note all: is providing noms to all.
     def nom(user)
       @server.puts "give #{user} 322 1"
     end
@@ -310,6 +428,8 @@ module Minecraft
     # @param args noms!
     # @example
     #   om("basicxman", "nom", "nom", "nom")
+    # @note ops: hop
+    # @note all: is noming everybody, gross.
     def om(user, *args)
       args.length.times { nom(user) }
     end
@@ -321,6 +441,7 @@ module Minecraft
     # @example
     #   property("basicxman", "spawn-monsters")
     #   property("basicxman")
+    # @note ops: op
     def property(user, key = nil)
       if key.nil?
         (@server_properties.length / 3.0).ceil.times do |n|
@@ -340,6 +461,7 @@ module Minecraft
     # @example
     #   uptime("basicxman")
     #   uptime("basicxman", "mike_n_7")
+    # @note ops: none
     def uptime(user, target_user = nil)
       target_user ||= user
       unless @users.include? target_user
@@ -362,7 +484,8 @@ module Minecraft
     #
     # @example
     #   rules()
-    def rules(*args)
+    # @note ops: none
+    def rules()
       @server.puts "say #{@rules}"
     end
 
@@ -372,6 +495,7 @@ module Minecraft
     # @param [String] user The requesting user.
     # @example
     #   list("basicxman")
+    # @note ops: none
     def list(user)
       l = @users.inject("") do |s, u|
         pre, suf = "", ""
@@ -397,9 +521,11 @@ module Minecraft
     # @example
     #   addtimer("basicxman", "cobblestone")
     #   addtimer("basicxman", "arrow", "10")
+    # @note ops: hop
     def addtimer(user, *args)
       item, duration = items_arg(30, args)
       item = resolve_item(item)
+      return @server.puts "say Timer was not added." if item.nil?
       @timers[user] ||= {}
       @timers[user][item] = duration
       @server.puts "say Timer added for #{user}.  Giving item id #{item} every #{duration} seconds."
@@ -411,10 +537,16 @@ module Minecraft
     # @param args item
     # @example
     #   deltimer("basicxman", "cobblestone")
+    # @note ops: hop
     def deltimer(user, *args)
       item = args.join(" ")
       item = resolve_item(item)
-      @timers[user][item] = nil if @timers.has_key? user
+      if @timers.has_key? user
+        @timers[user].delete item
+        @server.puts "say #{item} timer is deleted."
+      else
+        @server.puts "say #{item} timer did not exist."
+      end
     end
 
     # Prints the requesting users current timers.
@@ -422,6 +554,7 @@ module Minecraft
     # @param [String] user The requesting user.
     # @example
     #   printtimer("basicxman")
+    # @note ops: hop
     def printtimer(user)
       unless @timers.has_key? user || @timers[user].length == 0
         @server.puts "say No timers have been added for #{user}."
@@ -436,8 +569,9 @@ module Minecraft
     # initialized).
     #
     # @example
-    #   printtimer("basicxman")
-    def printtime(user)
+    #   printtimer()
+    # @note ops: op
+    def printtime()
       @server.puts "say Timer is at #{@counter}."
     end
 
@@ -450,12 +584,14 @@ module Minecraft
     # @example
     #   s("basicxman", "cobble", "give", "cobblestone", "64")
     #   s("basicxman", "mike", "tp", "mike_n_7")
+    # @note ops: hop
     def s(user, *args)
-      return @server.puts "say You need to specify a shortcut silly!" if args.length == 0
-
       shortcut_name = args.slice! 0
       if args.length == 0
-        @server.puts "say #{shortcut_name} is not a valid shortcut for #{user}." unless @shortcuts.has_key? user and @shortcuts[user].has_key? shortcut_name
+        unless @shortcuts.has_key? user and @shortcuts[user].has_key? shortcut_name
+          return kit(user, shortcut_name) if KITS.include? shortcut_name.to_sym
+          @server.puts "say #{shortcut_name} is not a valid shortcut for #{user}."
+        end
         return call_command(user, @shortcuts[user][shortcut_name].first, *@shortcuts[user][shortcut_name][1..-1]) if args.length == 0
       end
 
@@ -470,7 +606,8 @@ module Minecraft
     # @param [String] user The requesting user.
     # @example
     #   shortcuts("basicxman")
-    def shortcuts(user, *args)
+    # @note ops: hop
+    def shortcuts(user)
       labels = @shortcuts[user].keys.join(", ") if @shortcuts.has_key? user
       @server.puts "say Shortcuts for #{user}: #{labels}."
     end
@@ -480,7 +617,15 @@ module Minecraft
     # @param [String] user The requesting user.
     # @example
     #   help("basicxman")
-    def help(user)
+    # @note ops: none
+    def help(user, command = nil)
+      unless command.nil?
+        return @server.puts "say #{command} does not exist." unless @commands.has_key? command.to_sym
+        command_signature(command.to_sym)
+        say(@commands[command.to_sym][:help])
+        return
+      end
+
       commands = @commands.keys.inject([]) { |arr, key|
         priv = @commands[key][:ops]
         if is_op? user
@@ -491,17 +636,205 @@ module Minecraft
           priv == :none ? arr << key : arr
         end
       }.map { |s| "!" + s.to_s }
-      @server.puts "say Commands: #{commands.join(", ")}"
+      say(commands.join(", "))
     end
 
     # Prints the list of available kits to the connected players.
     #
     # @example
     #   kitlist()
-    def kitlist(*args)
+    # @note ops: none
+    def kitlist()
       @server.puts "say Kits: #{KITS.keys.join(", ")}"
     end
 
+    # Adds or prints the current todo list items.
+    #
+    # @param [String] user The requesting user.
+    # @param args The item.
+    # @example
+    #   todo("basicxman", "foo")
+    #   todo("basicxman")
+    # @note ops: none
+    def todo(user, *args)
+      if args.length == 0
+        @todo_items.each_with_index do |item, index|
+          @server.puts "say #{index + 1}. #{item}"
+        end
+        return
+      end
+
+      item = args.join(" ")
+      @todo_items << item
+      @server.puts "say Added item."
+    end
+
+    # Removes an item from the todo list.
+    #
+    # @param [String] user The requesting user.
+    # @param args The item.
+    # @example
+    #   finished("basicxman", "foo")
+    #   finished("basicxman", "2")
+    # @note ops: none
+    def finished(user, *args)
+      item = args.join(" ")
+      if item.to_i.to_s == item
+        index = item.to_i - 1
+      else
+        index = @todo_items.find_index(item)
+      end
+      return @server.puts "say Item does not exist." if index.nil? or @todo_items[index].nil?
+      @todo_items.slice! index
+      @server.puts "say Hurray!"
+    end
+
+    private
+
+    # Prints the command signature options for a specified command.
+    #
+    # @param [Symbol] command The command method.
+    # @example
+    #   command_signature(:give)
+    def command_signature(command)
+      params = method(command).parameters || []
+
+      return if params.length == 0
+      params.slice! 0 if params[0][1] == :user
+      if params.length == 1
+        name = params[0][1].to_s.gsub("_", " ")
+        type = params[0][0]
+        case type
+        when :opt
+          say("!#{command}")
+          say("!#{command} '#{name}'")
+        when :rest
+          say("!#{command} 'arguments', '...'")
+        when :req
+          say("!#{command} '#{name}'")
+        end
+      elsif params.length == 2
+        first_name = params[0][1].to_s.gsub("_", " ")
+        second_name = params[1][1].to_s.gsub("_", " ")
+        type = params[1][0]
+        case type
+        when :rest
+          say("!#{command} '#{first_name}', 'arguments', '...'")
+        when :opt
+          say("!#{command} '#{first_name}'")
+          say("!#{command} '#{first_name}', '#{second_name}'")
+        end
+      end
+    end
+
+    # Checks if the user does not wish to be disturbed and prints an error
+    # notice if so.
+    #
+    # @param [String] user The requesting user.
+    # @return [Boolean] Returns true if the user does not wish to be disturbed
+    # (should cancel action).
+    # @example
+    #   check_dnd("basicxman")
+    def check_dnd(user)
+      if @userdnd.include? user.downcase
+        say("#{user} does not wish to be disturbed, don't be a jerk!")
+        return true
+      else
+        return false
+      end
+    end
+
+    # Validates a kit group, if the kit cannot be found it executes the
+    # !kitlist command.
+    def validate_kit(group = "")
+      return true if KITS.include? group.to_sym
+      @server.puts "say #{group} is not a valid kit."
+      kitlist
+    end
+
+    # Changes the time of day.
+    #
+    # @param [String] time The time of day to change it to.
+    # @example
+    #   change_time("morning")
+    def change_time(time)
+      return false unless TIME.include? time
+      @server.puts "time set #{TIME[time]}"
+      @server.puts "say #{TIME_QUOTES[time]}" unless TIME_QUOTES[time] == ""
+      return true
+    end
+
+    # Checks a kickvote entry to see if the tally number has crossed the
+    # threshold, if so, kicks the user.
+    #
+    # @param [String] user The specified user.
+    # @example
+    #   check_kickvote("blizzard4U")
+    def check_kickvote(user)
+      if @kickvotes[user][:tally] >= @vote_threshold
+        @server.puts "say Enough votes have been given to kick #{user}."
+        @server.puts "kick #{user}"
+        @kickvotes.delete(user)
+      end
+    end
+
+    # Computes the influence a user has for kickvotes.
+    #
+    # @param [String] user The specified user.
+    # @return [Integer] The influence level.
+    # @example
+    #   kick_influence("basicxman")
+    def kick_influence(user)
+      return 3 if is_op? user
+      return 2 if is_hop? user
+      return 1
+    end
+
+    # Checks to see if any kickvotes are expired.
+    def expire_kickvotes
+      @kickvotes.each do |target_user, data|
+        if Time.now > data[:start] + @vote_expiration
+          @server.puts "say The kickvote for #{target_user} has expired."
+          @kickvotes.delete(target_user)
+        end
+      end
+    end
+
+    # Submits a kickvote.
+    #
+    # @param [String] user The requesting user who is voting.
+    # @param [String] target_user The user being voted against.
+    # @return [Boolean] Returns true if the kickvote has been initiated yet.
+    # @example
+    #   submit_vote("basicxman", "blizzard4U")
+    def submit_vote(user, target_user)
+      return unless @users.include? target_user
+      if @kickvotes.has_key? target_user
+        if @kickvotes[target_user][:votes].include? user
+          @server.puts "say You have already voted."
+        else
+          @kickvotes[target_user][:votes] << user
+          @kickvotes[target_user][:tally] += kick_influence(user)
+          check_kickvote(target_user)
+        end
+        return true
+      else
+        return false
+      end
+    end
+
+    # Caps the quantity of points able to be given based on requesting user.
+    #
+    # @param [String] user The requesting user.
+    # @return [Integer] Maximum quantity of points.
+    # @example
+    #   cap_points("basicxman")
+    def cap_points(user)
+      return 1000 if is_op? user
+      return 500  if is_hop? user
+      return 1
+    end
+
     # Helper method for printing the final give statements to the server.  If a
     # quantity is above the default upper bound (64) it will print multiple
     # statements.