sience / astray

Astray is a lua based maze, room and dungeon generation library for dungeon crawlers and rougelike video games

Astray

Astray is a lua based maze, room and dungeon generation library for dungeon crawlers and rougelike video games.

Quick Look

local astray = require('astray')

-- This maze generator can only generate uneven maps.
-- To get a 39x39 maze you need to Input
local height, width = 40, 40
--	Astray:new(width/2-1, height/2-1, changeDirectionModifier (1-30), sparsenessModifier (25-70), deadEndRemovalModifier (70-99) ) | RoomGenerator:new(rooms, minWidth, maxWidth, minHeight, maxHeight)
local generator = astray.Astray:new( height/2-1, width/2-1, 30, 70, 50, astray.RoomGenerator:new(4, 2, 4, 2, 4) )

local dungeon = generator:Generate()

local tiles = generator:CellToTiles( dungeon )

for y = 0, #tiles[1] do
    local line = ''
	for x = 0, #tiles do
		line = line .. tiles[y][x]
	end
	print(line)
end

Documentation

See the github wiki page for examples & documentation.

Installation

Just copy the astray folder wherever you want it (for example on a lib/ folder). Then write this in any Lua file where you want to use it:

local astray = require('lib/astray')

Specs

This work mainly based on the following ideas:

• http://dirkkok.wordpress.com/2007/11/21/generating-random-dungeons-part-1/
• http://inkwellideas.com/advice/random-dungeon-generators-reviewed/
• http://thomasbowker.com/2013/08/02/generating-a-dungeon/
• http://www.myth-weavers.com/generate_dungeon.php

Copyright

Copyright (c) <''2014''> <''Florian Fischer''>

License

Astray is distributed under the zlib/libpng License (http://opensource.org/licenses/Zlib)

astray's Issues

Sample prints to console instead of to Love window

See title.

Tilemap initial index mismatches lua standard

AFAIK Lua uses 1 as its first index ... you have used 0 as the first index as per other languages.

Seem to be getting double-sized tilemaps

What I am using now is...

local generator = astray.Astray:new( resolutionTilesX/2-1, resolutionTilesY/2-1, 30, 20, 90, astray.RoomGenerator:new(10,1,5,1,5) )
local dungeon = generator:Generate()
local tmp_tilemap = generator:CellToTiles(dungeon, symbols )

Broken character for main.lua example

I'm running Ubuntu 12.04, and I'm not recognizing the debug character used in drawdungeon in the example main.lua.