Skip to content

Home

Jump to bottom
Brian Rivas edited this page Jul 1, 2014 · 20 revisions

#Welcome to the minecraft-roguelike wiki!

##Loot Customization

###Loot Categories

  • WEAPON: a weapon that spawns in weapon chests (Bows & Swords by default)
  • ARMOUR: Armour that spawns in armour chests.
  • BLOCK: spawns in the storage room, and in tool chests
  • JUNK: The random bits and bobs that spawn in all chests
  • ORE: Spawns in ore chests and in tool chests
  • TOOL: spawns in tool chests
  • POTION: spawns in potion and weapon chests
  • FOOD: spawns in starter, food and weapon chests
  • ENCHANTBOOK: spawns in middle slot in enchanting chests
  • ENCHANTBONUS: spawns 2 in enchanting chests
  • SUPPLY: spawns in supply chests
  • MUSIC: A record that spawns in the music room.
  • SMITHY: The sword in the anvil dungeon.

The config file is parsed as a list of changes to the categories. Categories have 5 levels, 0-4, corresponding to the 5 levels of the dungeon. You can either clear a category (all levels), add a piece of loot to a category level, or add a piece of loot to all levels of a category.

the default loot systems are added with a weight value of 1000, so you just make your additions relative to that (10 for 1%, or 2000 for 200% for example)

Example Configuration:

{
	"CustomLoot": [
		{"clear" : "FOOD"},
		{"addAll" : {"type" : "FOOD", "id" : 357, "meta" : 0, "min" : 2, "max" : 5, "weight" : 10}},
		{"add" : {"level" : 1, "type" : "FOOD", "id" : 322, "meta" : 0, "min" : 2, "max" : 5, "weight" : 10}},
		{"add" : {"level" : 1, "type" : "ORE", "id" : 331, "meta" : 0, "min" : 5, "max" : 10, "weight" : 200}}
	]
}

this first clears the food category, clearing the default loot from it, then adds cookies to all food levels, then adds golden apples to level 1 food. then adds redstone to level 1 ores.

Dungeon Themes

Configuration general structure

  • DungeonConfig: Array of configurations

    • Configurations

  • Configuration: container for a single dungeon configuration

    • "biomes" : Array of biome names dungeon theme applies to
    • "levels" : Array of indexes for dungeon levels

"levels" : "0", "1", "2", "3", "4"

  • "rooms" : The rooms present in a single level

  • "theme" : Information about

  • "rooms" : Array

    • "mode" : method for choosing
      • "single" : Will be added once.
      • "type" : A Dungeon (room) type
    • "random" : Will be selected randomly by weight relative to other randoms
      • "type" : A Dungeon (room) type
      • "weight" : The relative random weight scale for selection

  • "theme" : Contains blocks and segment information

    • "primary" : A BlockSet used for background walls
    • "secondary" : A BlockSet used for foreground walls
    • "segments" : An Array of Segment types
    • "arch" : A segment type used for regular arch ways

  • BlockSet: "primary" and "secondary" theme elements

    • "walls" : an IBlockFactory structure
    • "pillar" : an IBlockFactory structure
    • "stair" : must be a METABLOCK type

Type Lists

  • Dungeon (rooms) :

    • BRICK, CREEPER, CRYPT, ENCHANT, ENDER, FIRE,
    • MUSIC, NETHER, NETHERFORT, PIT, PRISON,
    • SLIME, SMITH, SPIDER, CAKE, LAB, CORNER,
    • MESS, ETHO, ENIKO, BTEAM, BAJ, OSSUARY, OBSIDIAN,
    • AVIDYA, STORAGE, NEBRIS, ASHLEA;

  • IBlockFactory :

    • METABLOCK, WEIGHTED, CHECKERS, JUMBLE, STRIPES;

  • Segment :

    • ARCH, FIRE, SHELF, INSET, MOSSYARCH, MOSSYMUSHROOM,
    • NETHERARCH, NETHERSTRIPE, JUNGLE;

How IBlockFactory Structures work

  • All IBlockFactory contain:

    • "type" : IBlockFactory type
    • "data" : Element containing information about the IBlockFactory

  • a METABLOCK is an atomic IBlockFactory type and cannot contain other IBlockFactory elements. all other IBlockFactory types can contain other IBlockFactory types, and METABLOCKS.

###IBlockFactory type rules

  • METABLOCK : an object,
    • "id" : int
    • "meta" : int - optional
    • "flag" : int - optional
  • WEIGHTED : Array of Weighted Random
    • "type" : IBlockFactory type
    • "data" : IBlockFactory data
    • "weight" int
  • CHECKERS : Array of (exactly two - checker pattern)
    • "type" : IBlockFactory type
  • JUMBLE : Array of evenly distributed but random
    • "type" : IBlockFactory type
    • "data" : IBlockFactory data
  • STRIPES : Array of striped diagonal pattern
    • "type" : IBlockFactory type
    • "data" : IBlockFactory data
Clone this wiki locally