Safari

Plugin-Information

Think of safaris as hunting-jouneys

Each safari may be configured like this:

• specific mob-types which count for the safari progress
• specific day/night time hours during which mob-kills are valid
• required safari-points to start the safari (number of previously completed safaris)
• the kind of drops the player is rewarded upon completing his current safari

Rules

• Each player may enlist for one Safari at a time
• The Safari is persisted and does not require the player to complete it within one online-session

Commands

Player commands

The following commands are accessible for all players:

• /safari list - List all available safaris
• /safari info - See your current safari and your safari points/statistics
• /safari start <safariname> - Start the specified safari
• /safari stop - Cancel your current safari
• /safari showrecords - display current safari-record times (hours:minutes) and who accomplished this record

Administration-Commands

(only accessible for players with special permission or from the Minecraft server-console)

There are 2 admin-commands to de-/activate the Safaris for given worlds:

• /safari add_world <worldname> - to activate Safaris for this world
• /safari remove_world <worldname> - to deactivate Safaris for this world

Console-Commands

This command:

• /safari showrecords <playerName> May be used from the servers console in order to enable signs which might trigger console-commands. This is done in order to setup signs (or maybe areas) which send the current records to a given player (who is currently online)

Configuration

Server-Admins may configure the available safaris like this (all safaris are direct keys inside the "safaris" section:

• safaris:
  • <safariname> (e.g.: harmless):
    • description: <safari description> (e.g.Kill Mobs which are harmless (Cows, Chicken, Pig, Sheep))
    • name: <some name>
    • required_points: <how many points does the player need to gather to start this safari; at least 1 safari with 0 points should be available>
    • mobs_to_kill: <how many mobs does the player need to kill to complete this safari
    • types_of_mobs_to_kill: <list of mobs which are taken into account for kill-counter>
      • see: http://jd.bukkit.org/apidocs/org/bukkit/entity/EntityType.html for details
      • CHICKEN
      • COW
      • PIG
      • SHEEP
    • addDrops: <list of drops which should be added to the final kill drop>
      • see: http://www.minecraftwiki.net/wiki/Data_values#Item_IDs for item-ids
      • and http://dev.bukkit.org/server-mods/lessfood/ for configuration-syntax options
      • '289': 2 20
    • addRecordDrops: <list of drops which should be added to the final kill drop if the player achieved a new time-record for completing this safari>
      • see: http://www.minecraftwiki.net/wiki/Data_values#Item_IDs for item-ids
      • and http://dev.bukkit.org/server-mods/lessfood/ for configuration-syntax options
      • '289': 2 20

Installation

Pretty easy:

• Download the latest safari.jar file
• put it into your $MINECRAFTSERVER/plugins directory
• start your Minecraft-Server

Done :-)

Think about additional setup-steps:

• enabling/disabling safaris on given worlds (depends on your server-setup)
• configuring the supplied safari-configuration (adding/removing some or adjusting the drops/points limits)

Technical information

Changelog

Version 3.1

• Finished record-time stuff (new command "showrecords", which is also callable via Console like: safari showrecords toSomePlayer which will send the records to this player... might be usefull if you would setup signs which can then send console-commands)
• some formatting of messages (now with colors ;) )
• verified Plugin to be compatible with Bukkit 1.3.1 R1.0 (compiled it, started the server and did some safaris)
• start of team-safaris

Version 3

• fixed bug regarding mob-kills not counted
• initial "competition" feature implementation
• added configuration-support for "addRecordDrops" which will be used for rewarding a player if/when he/she creates a new record for a safari
• some syntax corrections and formatting

Version 2

• updated to craftbukkit-1.2.5-R5.0 (no real changes, just re-compile and test)
• Existing config.yml gets not overwritten anymore; fixes: https://github.com/FeaRiTail/Safari/issues/1
• added feedback about safari-progress; fixes: https://github.com/FeaRiTail/Safari/issues/2
• removed unnecessary build-command from build.xml

Version 1

• tested addDrops-configuration
• added some defaults for safari-drops upon completion
• translated the last german expressions to english
• added message when trying to enlist for non-existing safari

Version 0.1

• Releasing initial beta-version

Source Code

The complete source-code is available on github:

https://github.com/FeaRiTail/Safari