If you're curious about the mechanics of the configuration files and want a bit more information, this is for you. I've written short explanations for each of the values in the file, which should give you a better idea of the current possibilities. After this first post, I'll copy over the config files from the staff forums so you can use them as examples.
Please do not let the daunting format discourage you from submitting your maps. If you just submit the required kit information and dimensions, I am able to populate the configuration file for you. It may take a bit longer dependent on my schedule, but I have no problem writing the configuration files for any map that is accepted for the server. No need to lose any sleep or hair over this, but in the event that I am not around to write the file you can use this thread as a handy guide.
--------------------------------------------------
MapName: [Self-Explanatory]
Author: [Your Name Here]
BuildTime: [# of seconds that hunters have to build]
GameTime: [# of seconds in the survival phase (usually 600 for ten minutes)]
WorldTime: [0 for dawn, 6000 for midday, 12000 for dusk, 18000 for midnight]
SpawnProtectTime: [Unused?]
WorldWeather: [0 for clear, 1 for weather]
Team0: [Hunter Team Data]
SpawnType: [0 for regular, 1 for random (WIP), 2 for force-spawn]
SpawnLocation:
==: Vector
x: [x coordinate of spawn]
y: [y coordinate of spawn]
z: [z coordinate of spawn]
ChooseKit: [true for picking kits, false for random kits]
OneKitPerRound: [true for only one kit per hunter, false for new kit after death]
KitResetTime: [Minimum length of time between deaths for new kits. If the hunter dies before this is up, then they get the "HunterFree" kit (usually Scavenger)]
BoxChance: [% chance of random item or box]
Team1: [Survivor Team Data]
SpawnType: [0 for regular, 1 for random (WIP), 2 for force-spawn]
SpawnLocation:
==: Vector
x: [x coordinate of spawn]
y: [y coordinate of spawn]
z: [z coordinate of spawn]
ChooseKit: [true for picking kits, false for random kits]
Centre:
==: Vector
x: [x coordinate of center point]
y: [y coordinate of center point]
z: [z coordinate of center point]
WorldSize: [Distance from center to edge in blocks. Map dimensions must be square]
SkyLimit: [Maximum height at which players may place blocks (y coordinate)]
ResetInventory: [true to clear inventory at round start, false to carry over items]
CanUseLocate: [true for hunters to use /loc, false for no]
SurvivorRestrictedPlaceAll: [true to restrict all survivor block placements, false for no]
SurvivorRestrictedBreakAll: [true to restrict all survivor block breaks, false for no]
HunterRestrictedPlaceAll: [true to restrict all hunter block placements, false for no]
HunterRestrictedBreakAll: [true to restrict all hunter block breaks, false for no]
MysteryBoxChance: [% chance of mystery items]
All the following fields use Bukkit's item DB conventions - use http://jd.bukkit.org/apidocs/org/bukkit/Material.html to look up block and entity names.
SurvivorRestrictedBreak:
- [LIST OF BLOCKS TO RESTRICT SURVIVOR BREAKING]
SurvivorRestrictedPlace:
- [LIST OF BLOCKS TO RESTRICT SURVIVOR PLACING]
SurvivorRestrictedBreakEx:
- [LIST OF BLOCKS THAT SURVIVORS MAY BREAK AFTER ROUND STARTS]
HunterRestrictedPlace:
- [LIST OF BLOCKS TO RESTRICT HUNTER PLACING]
HunterRestrictedBreak:
- [LIST OF BLOCKS TO RESTRICT SURVIVOR BREAKING]
For each kit, provide a list of their items. The convention used here is:
- [ITEM NAME].[DAMAGE VALUE]|[AMOUNT]
A list of damage values may be seen at http://www.minecraftinfo.com/IDList.htm.
So for example, if you wanted the kit to include two swiftness II splash potions, you'd write:
- POTION.16418|2
[POTION is the name from http://jd.bukkit.org/apidocs/org/bukkit/Material.html, 16418 is the value from http://www.minecraftinfo.com/IDList.htm.]
As another example, if you wanted the kit to include four cave spider eggs, you'd write
- MONSTER_EGG.59|4
HunterFree: [HunterFree is the Scavenger kit]
Scavenger: [Scavenger is the default name, but you may change it here]
- [LIST OF KIT ITEMS]
Juggernaut: [Juggernaut is the uber kit for the Juggernaut]
Titan: [Titan is the default name, but you may change it here]
- [LIST OF KIT ITEMS]
HunterLeader: [HunterLeader is the kit for the first hunter]
Leader: [Leader is the default name, you may change it here]
- [LIST OF KIT ITEMS]
HunterStart: [HunterStart is a collection of kits that hunter have access to]
Kit1: [You may add as many or as few as you like, just specify their name and the list of items]
- [LIST OF KIT ITEMS]
Kit2:
- [LIST OF KIT ITEMS]
Kit3:
- [LIST OF KIT ITEMS]
SurvivorStart: [SurvivorStart is a collection of kits that survivors have access to]
Kit1: [You may add as many or as few as you like, just specify their name and the list of items]
- [LIST OF KIT ITEMS]
Kit2:
- [LIST OF KIT ITEMS]
Kit3:
- [LIST OF KIT ITEMS]
--------------------------------------------------
Enchanted items! http://blocktopia.net/forum/threads/so-you-want-to-make-a-map.8233/#post-181269
--------------------------------------------------
Potion effects! http://blocktopia.net/forum/threads/potion-effect-requests.9240/
--------------------------------------------------
Remember, formatting and spacing are very important! Check your format with http://yaml-online-parser.appspot.com/ when you are done, and work directly from an existing config file like the handy example below.
Please do not let the daunting format discourage you from submitting your maps. If you just submit the required kit information and dimensions, I am able to populate the configuration file for you. It may take a bit longer dependent on my schedule, but I have no problem writing the configuration files for any map that is accepted for the server. No need to lose any sleep or hair over this, but in the event that I am not around to write the file you can use this thread as a handy guide.
--------------------------------------------------
MapName: [Self-Explanatory]
Author: [Your Name Here]
BuildTime: [# of seconds that hunters have to build]
GameTime: [# of seconds in the survival phase (usually 600 for ten minutes)]
WorldTime: [0 for dawn, 6000 for midday, 12000 for dusk, 18000 for midnight]
SpawnProtectTime: [Unused?]
WorldWeather: [0 for clear, 1 for weather]
Team0: [Hunter Team Data]
SpawnType: [0 for regular, 1 for random (WIP), 2 for force-spawn]
SpawnLocation:
==: Vector
x: [x coordinate of spawn]
y: [y coordinate of spawn]
z: [z coordinate of spawn]
ChooseKit: [true for picking kits, false for random kits]
OneKitPerRound: [true for only one kit per hunter, false for new kit after death]
KitResetTime: [Minimum length of time between deaths for new kits. If the hunter dies before this is up, then they get the "HunterFree" kit (usually Scavenger)]
BoxChance: [% chance of random item or box]
Team1: [Survivor Team Data]
SpawnType: [0 for regular, 1 for random (WIP), 2 for force-spawn]
SpawnLocation:
==: Vector
x: [x coordinate of spawn]
y: [y coordinate of spawn]
z: [z coordinate of spawn]
ChooseKit: [true for picking kits, false for random kits]
Centre:
==: Vector
x: [x coordinate of center point]
y: [y coordinate of center point]
z: [z coordinate of center point]
WorldSize: [Distance from center to edge in blocks. Map dimensions must be square]
SkyLimit: [Maximum height at which players may place blocks (y coordinate)]
ResetInventory: [true to clear inventory at round start, false to carry over items]
CanUseLocate: [true for hunters to use /loc, false for no]
SurvivorRestrictedPlaceAll: [true to restrict all survivor block placements, false for no]
SurvivorRestrictedBreakAll: [true to restrict all survivor block breaks, false for no]
HunterRestrictedPlaceAll: [true to restrict all hunter block placements, false for no]
HunterRestrictedBreakAll: [true to restrict all hunter block breaks, false for no]
MysteryBoxChance: [% chance of mystery items]
All the following fields use Bukkit's item DB conventions - use http://jd.bukkit.org/apidocs/org/bukkit/Material.html to look up block and entity names.
SurvivorRestrictedBreak:
- [LIST OF BLOCKS TO RESTRICT SURVIVOR BREAKING]
SurvivorRestrictedPlace:
- [LIST OF BLOCKS TO RESTRICT SURVIVOR PLACING]
SurvivorRestrictedBreakEx:
- [LIST OF BLOCKS THAT SURVIVORS MAY BREAK AFTER ROUND STARTS]
HunterRestrictedPlace:
- [LIST OF BLOCKS TO RESTRICT HUNTER PLACING]
HunterRestrictedBreak:
- [LIST OF BLOCKS TO RESTRICT SURVIVOR BREAKING]
For each kit, provide a list of their items. The convention used here is:
- [ITEM NAME].[DAMAGE VALUE]|[AMOUNT]
A list of damage values may be seen at http://www.minecraftinfo.com/IDList.htm.
So for example, if you wanted the kit to include two swiftness II splash potions, you'd write:
- POTION.16418|2
[POTION is the name from http://jd.bukkit.org/apidocs/org/bukkit/Material.html, 16418 is the value from http://www.minecraftinfo.com/IDList.htm.]
As another example, if you wanted the kit to include four cave spider eggs, you'd write
- MONSTER_EGG.59|4
HunterFree: [HunterFree is the Scavenger kit]
Scavenger: [Scavenger is the default name, but you may change it here]
- [LIST OF KIT ITEMS]
Juggernaut: [Juggernaut is the uber kit for the Juggernaut]
Titan: [Titan is the default name, but you may change it here]
- [LIST OF KIT ITEMS]
HunterLeader: [HunterLeader is the kit for the first hunter]
Leader: [Leader is the default name, you may change it here]
- [LIST OF KIT ITEMS]
HunterStart: [HunterStart is a collection of kits that hunter have access to]
Kit1: [You may add as many or as few as you like, just specify their name and the list of items]
- [LIST OF KIT ITEMS]
Kit2:
- [LIST OF KIT ITEMS]
Kit3:
- [LIST OF KIT ITEMS]
SurvivorStart: [SurvivorStart is a collection of kits that survivors have access to]
Kit1: [You may add as many or as few as you like, just specify their name and the list of items]
- [LIST OF KIT ITEMS]
Kit2:
- [LIST OF KIT ITEMS]
Kit3:
- [LIST OF KIT ITEMS]
--------------------------------------------------
Enchanted items! http://blocktopia.net/forum/threads/so-you-want-to-make-a-map.8233/#post-181269
--------------------------------------------------
Potion effects! http://blocktopia.net/forum/threads/potion-effect-requests.9240/
--------------------------------------------------
Remember, formatting and spacing are very important! Check your format with http://yaml-online-parser.appspot.com/ when you are done, and work directly from an existing config file like the handy example below.
Code:
MapName: Desert
Author: Unknown
BuildTime: 180
GameTime: 600
WorldTime: 13000
SpawnProtectTime: 5000
WorldWeather: 0
Team0:
SpawnType: 0
SpawnLocation:
==: Vector
x: 85.5
y: 64.0
z: 134.5
ChooseKit: false
OneKitPerRound: false
KitResetTime: 120
BoxChance: 15
Team1:
SpawnType: 0
SpawnLocation:
==: Vector
x: 85.5
y: 64.0
z: 134.5
ChooseKit: false
Centre:
==: Vector
x: 85.5
y: 64.0
z: 134.5
WorldSize: 50
SkyLimit: 256
ResetInventory: true
CanUseLocate: true
SurvivorRestrictedPlaceAll: false
SurvivorRestrictedBreakAll: false
HunterRestrictedPlaceAll: false
HunterRestrictedBreakAll: false
MysteryBoxChance: 5
SurvivorRestrictedBreak:
- BEDROCK
SurvivorRestrictedPlace:
- BEDROCK
- SAND
- SANDSTONE
- DIRT
- TRAPDOOR
- WOOL
SurvivorRestrictedBreakEx:
- TORCH
- LONG_GRASS
HunterRestrictedPlace:
- BEDROCK
HunterRestrictedBreak:
- IRON_ORE
- DIAMOND_ORE
Kit:
HunterFree:
Scavenger:
- WOOD_SWORD
Juggernaut:
Titan:
- DIAMOND_HELMET
- DIAMOND_CHESTPLATE
- DIAMOND_LEGGINGS
- DIAMOND_BOOTS
- DIAMOND_SWORD
- BOW
- GRILLED_PORK|16
- WOOL|64
- POTION.8258|1
- POTION.5|1
- POTION.5|1
- POTION.5|1
- POTION.8257|1
- ARROW|64
HunterLeader:
Leader:
- STONE_SWORD
- BOW
- ARROW|8
HunterStart:
Warrior:
- STONE_SWORD
- DIRT|32
Archer:
- BOW
- ARROW|16
Scout:
- IRON_PICKAXE
- DIRT|64
SurvivorStart:
Chef:
- WOOD_SWORD
- BREAD|8
Knight:
- STONE_SWORD
- POTION.5|1
Archer:
- BOW
- ARROW|8