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>
- addDrops: <list of drops which should be added to the final kill drop>
- 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>
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
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
